Notes before installation
Oplon Global Distributed Gateway GUI Reliability Tools (GUIRT from now on) is an end-to-end tool built to perform repetitive tests on applications in desktop environments.
Oplon Global Distributed Gateway it is a product intended for mission critical environments therefore only staff who have completed the course and passed the exam are authorized to certify the installation and maintenance of the products in operation. All certified persons are provided with a certificate of participation in the courses and passing the exam Oplon.
Preparing to install
To obtain Oplon Global Distributed Gateway GUIRT, simply download through the website www.oplon.net. The downloaded compressed image contains a RECORDER use license for demo/prototyping purposes without limitation of time but with the limitation in not being able to save the recording result. You can unlock Oplon Global Distributed Gateway GUIRT by purchasing your licenses at any time.
Compatibility Matrix and Sizing
Oplon Global Distributed Gateway GUIRT is a distributed PORTABLE application that is available directly from download. To get your download login credentials, simply send an email to Oplon NETWORKS SRL: customercare@Oplon.net.
Images directly available from the site:
- Portable zipped image compatible from Windows VISTA or upper
Machine sizing to accommodate a player or recorder can range from 512MB to 1GB of RAM space used.
Preparing the Recording and Playing Environment
To perform both recordings and reproductions through Oplon GUIRT it is advisable to observe some recommendations in order to be able to make tracks on a desktop and be sure to play them indefinitely in a Desktop used as a player located in any place, local or remote.
Below, in the form of the most important recommendations (P-Player, R-Recorder):
1) P/R - Oplon GUIRT Player desktops must be set at the same video resolution with which traces will be generated through Oplon GUIRT Recorder
2) P/R - Oplon GUIRT Player desktops must be set with the same language/keyboard/date and time preferences with which traces will be generated through Oplon GUIRT Recorder
3) P/R - It is advisable to set the desktop background in pastel and non-variable and non-animated color to avoid compromising any visual tests on desktop portions
4) P -- Remote access to a Player must NOT be done via RDP because when the RDP client is disconnected, the graphical desktop is no longer usable for visual comparisons. To log in remotely, you can use products such as vnc that do not have this problem
5) P - When windows starts, automatic login with a default user must be enabled to allow the player to be automatically started in case of any windows restarts
6) P - The save screen must be disabled
Portable-App installation
Oplon Global Distributed Gateway GUIRT is a PORTABLE application and is distributed through a compressed image (zip) that can be easily installed on any local or remote windows desktop system. Being a portable application does not interfere with applications already installed.
To perform the installation, simply download the zip and once you have obtained to position yourself in the source directory (recommended C:) and run sequentially:
1) Checking disk spaces (1.5GB free)
2) Unzip image LBL_WINPXXXYYYXXX_Complete.zip
3)
You will get the TCOProject directory added to C:
4)
(optional but recommended) go to
C:-TCOProject-tools and run dosboxwXP_2003x86x64.reg. This tool
makes it easy to open the "Command Prompt" window by hovering over
a file manager directory and pressing the right mouse button will
appear "Open DOS Window").
5) Open a "Command Prompt" window in:
C:-TCOProject-bin-LBL-LBLLoadBalancer
6) Run lblsetenv.bat
On the first run, in addition to setting the following environment variables, the batch will copy some necessary files.
You won't need to change the environment variables if you chose to install it in C:-TCOProject otherwise they will need to be changed.
set LBL_HOME-C:-TCOProject-bin-LBL-LBLLoadBalancer set LBL_GUIRECORDER_HOME-C:-TCOProject-bin-LBL-LBLREliabilityTools set LBL_SETUP_HOME-C:-TCOProject-bin-LBL-LBLSetup set LBL_JAVA_HOME-C:-TCOProject-bin-Java-jdk1.8.0_144
7) Then run lblsetup.bat and the address setting window to access
through web consoles and the password logins of root users and
delegation for other systems will
open.
8) Use the tab key to move to Choose to choose the listening address of
the web
interface
9) Set the passwords of the root user and the delegation user and run
the <save & exit>
NB Save root and delegation credentials to a secure place.
10) You can now start the main module using the "goPlayer" command to start Oplon GUIRT Player:
11)
With your browser, type the selected address in
https with port 4444 e.g.: https://192.168.xxx.xxx:4444
12)
Type login (if not modified with
lblsetup.bat is "root") and type the password to access the
dashboard
13) To access the Oplon GUIRT Player module, select:
Reliability Tools -> GUI Player
14)
The interface will display all player
modules recorded in the node catalog, in this case only one node
being the first installation and having not yet entered licenses and
added nodes.
By selecting "Edit" with the mouse, you can access the track
loading functions to be performed...
15) Selecting "Desktop" instead allows you to see what is happening on the remote desktop (possible view depending on the type of access logged on)
16) To launch the Oplon GUIRT Recorder component, navigate to the directory: C:-TCOProject-bin-LBL-LBLLoadBalancer
17) From file manager run lblguirecorder.bat and a window will appear that warns of the lack of license, press ok (the license we will set in the following chapters).
18) Once confirmed the message will appear the recording console that will allow you to create, test, save and load tracks before being put into production by the players.
Installing RECORDER licenses
To install Oplon GUIRT Recorder licenses, simply run:
1) Navigate to the directory: C:-TCOProject-bin-LBL-LBLREliabilityTools-conf
2)
Copy
the license.xml file provided by Oplon (Make sure that the
license is the correct one from the relevant directory).
The result should look like the following image:
3) Open the command prompt at :-TCOProject-bin-LBL-LBLLoadBalancer
4) From file manager, run the command lblguirecorder.bat
5) After the splash screen display will appear the recorder ready to make the first recording
Installing CATALOG licenses
To install Oplon GUIRT Catalog licenses, that is, those that allow the web interface to add nodes under management in aggregate, run:
1) Navigate to the directory: C:-TCOProject-bin-LBL-LBLLoadBalancer-lib-conf
2)
Copy the license.xml file provided by
Oplon (Make sure that the license is the correct one from the
relevant directory).
The result should look like the following image:
3) You can now start the main module by using the "goPlayer.bat"
command in the directory C:-TCOProject-bin-LBL-LBLLoadBalancer
4)
With your browser, type the selected
address in https with port 4444 e.g.: <https://192.168.xxx.xxx:4444>
5)
Type login (if not modified with
lblsetup.bat is "root") and type password to access the dashboard
then check through the selection of settings in the top right
6)
If the Nodes and Clusters choices also
appear, and you can enter the two selections the license has been
successfully acquired.
Installing PLAYER licenses
To install Oplon GUIRT Player licenses, that is, those that allow the web interface to add nodes in management in aggregate, run:
1) Navigate to the directory: C:-TCOProject-bin-LBL-LBLLoadBalancer-procsProfiles-G10_LBLGUIPlayer-conf
2)
Copy the license.xml file provided by
Oplon (Make sure that the license is the correct one from the
relevant directory).
The result should look like the following image:
3)
You can now use Oplon GUIRT Player:
PLAYER Start when the desktop starts
On all supported windows systems, you can run Oplon GUIRT Player at startup by following these steps:
1)
Press the Windows key at the same time and the
stratup window will appear
2)
Type the command shell:startup
then confirm with ok
3)
Copy the goPlayer.bat file from the directory
C:-TCOProject-bin-LBLLoadBalancer to the startp directory
4)
Logout and any login if automatic
login has not yet been enabled, the main form will start
automatically and will be ready to receive remote login via web
browser
PLAYER start in background / foreground
To enable or disable the player start with command prompt window and run the player in the background or foreground you can use the -batch parameter when the go.bat starts:
Start in foreground - C: TCOProject-bin-LBL-LBLLoadBalancer-go.bat
Start in backgound - C: TCOProject-bin-LBL-LBLLoadBalancer-goPlayer.bat
To stop all Oplon modules launched in the foreground run from prompt: Ctrl-C or type shutdown
To stop all Oplon modules launched in the background by windows task managers, stop the javaw process and then all associated java processes.
Update to new release version
To update to a new release version, you must have the zip-formatted package that shows the name with the final deployment version "_patch" e.g.:
LBL_WINPXXXYYYXXX_patch.zip
Once you have the deployment patch, simply position yourself on the windows machine where the installation is located and unzip it within the directory C:-TCOProject
The result must be as follows (with the numbering for the downloaded release):
After running the unzip open the command prompt window in the patch directory:
And run the batch:
LBL_UPDATE_FROM_0XX0XX0XX_TO_0YY0YY0YY_LastBuild.bat
Using different centralized trace DMs
To use traces on different databases, you must modify the database parameters as follows in the dependency of the database used.
Parameters can be edited through interface: Modules->Statisic broker Advanced -> Edit
For real-time extraction of summary data, you must run the following table creation scripts in the DB with the significant values contained in the files for each individual specific DB:
C:-TCOProject-bin-LBL-LBLLoadBalancer-legacyBin-DatabasesScript:
GUIRT_TABLES_MYSQL.sql
GUIRT_TABLES_ORACLE.sql
GUIRT_TABLES_SQLSERVERl.sql