GUIRT setup

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) image1 You will get the TCOProject directory added to C:

4) image2 (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 image3

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

image4

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. image5

8) Use the tab key to move to Choose to choose the listening address of the web interface image6

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.

![](./images/image7.png)

10) You can now start the main module using the "goPlayer" command to start Oplon GUIRT Player:

![](./images/image8.png)

11) image9 With your browser, type the selected address in https with port 4444 e.g.: https://192.168.xxx.xxx:4444

12) image10 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:

image11 Reliability Tools -> GUI Player

14) image12 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...

image13

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)

image14

16) To launch the Oplon GUIRT Recorder component, navigate to the directory: C:-TCOProject-bin-LBL-LBLLoadBalancer

image15

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).

image16

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.

image17

Installing RECORDER licenses

To install Oplon GUIRT Recorder licenses, simply run:

1) Navigate to the directory: C:-TCOProject-bin-LBL-LBLREliabilityTools-conf

2) image18 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

image17

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) image19 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 image20

4) image9 With your browser, type the selected address in https with port 4444 e.g.: <https://192.168.xxx.xxx:4444>

5) image21 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) image22 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) image23 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) image24 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) image25 Press the Windows key at the same time and the stratup window will appear

2) image26 Type the command shell:startup then confirm with ok

3) image27 Copy the goPlayer.bat file from the directory C:-TCOProject-bin-LBLLoadBalancer to the startp directory

4) image28 image29 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):

image30

After running the unzip open the command prompt window in the patch directory:

image31

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

image32

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