GUI Reliability Tools setup

Back

LBL®Global Distributed Gateway GUI Reliability Tools (GUIRT hereafter) is a tool end-to-end made to perform repetitive tests on applications in desktop environments.

LBL®Global Distributed Gateway is a product destined for mission critical environments therefore only staff who made the course and has passed the examination is authorized to certify the installation and maintenance of products in operation. All Certified People are equipped with certificate of participation in the courses and overcoming of the exam issued by TCOGROUP SRL.

Preparing to Install

To obtain LBL®Global Distributed GUIRT Gateway is sufficient to perform the download through the web site www.oplon.net. The compressed image  downloaded contains a license to use the recorder with purpose demo/prototyping without limitation of time but with the limitation in not being able to save the result of recording. You can unlock LBL®Global Distributed GUIRT Gateway through the purchase of licenses to use at any time.

Compatibility Matrix and sizing

LBL®Global Distributed GUIRT Gateway is a application PORTABLE distributed and available directly from the download. To obtain your login credentials to download is sufficient to send an e-mail to TCOGROUP SRL: Customercare@oplon.net.

Images available directly from the site:

  • Portable zipped image compatible from Windows Vista or upper

The dimensioning of the machine to accommodate a player or recorder can go from 512MB to 1GB of RAM space used.

Preparing Your Environment for recording (recording and playback (playing)

To perform both the recordings or reproductions through LBL GUIRT is appropriate to observe some recommendations in order to make the tracks in a desktop and be sure to be able to play indefinitely in a Desktop used as a player positioned in any place whether local or remote.

Below in the form of a list of the most important recommendations which (P=Player, R=Recorder):

  1. P/R – DESKTOPS LBL GUIRT Player must be set with the same video resolution with which will be generated tracks through LBL GUIRT Recorder
  2. P/R – DESKTOPS LBL GUIRT Player must be set up with the same language / keyboard / Date & Time preferences with which will be generated tracks through LBL GUIRT Recorder
  3. P/R – it is appropriate to set the desktop background in pastel hue and not variable and not animated in order not to jeopardize any visual test on portions of the desktop
  4. – Remote access to a player must not be carried out via RDP since the disconnection of the RDP client the graphical desktop is no longer usable for visual comparisons. To access remotely are usable products as vnc that do not exhibit this problem
  5. P – Windows Startup must be enabled automatic login with a default user in order to allow to automatically start the player in the event of any restart windows
  6. P – The save screen must be disabled

Portable-App installation

LBL®Global Distributed GUIRT Gateway is a portable application and is distributed through a compressed image (zip) easily installable in any Windows desktop system local or remote. Being a portable application does not interfere with the applications already installed.

To perform the installation is thus sufficient to download the zip file and once positioned in the starting directory recommended (C:\) and and run in sequence:

  1. Verification of disk space (1.5GB free)
  2. Unzip the image LBL_WINPXXXYYYXXX_complete.zip

  3. Will result in the addition of TCOProject directory in C:\ 

  4. (Optional but recommended) go to C:\TCOProject\tools and perform dosboxwXP_2003x86x64.reg. This tool facilitates the opening of the window “Command Prompt ” by placing the mouse on a directory in the file manager and by pressing the right mouse button will appear “Open DOS window).
  5. Open a window “Command Prompt ” in: C:\TCOProject\bin\LBL\LBLLoadBalancer

  6. Perform lblsetenv.bat

The first run in addition to set the environment variables below the batch will copy some necessary files.

It will not be necessary to modify the environment variables if you chose to install in C:\TCOProject otherwise will need to be modified.

Set LBL_HOME=C:\TCOProject\bin\LBL\LBLLoadBalancer

Set LBL_GUIRECORDER_HOME=C:\TCOProject\bin\LBL\LBLGUIReliabilityTools

Set LBL_SETUP_HOME=C:\TCOProject\bin\LBL\LBLSetup

Set LBL_JAVA_HOME=C:\TCOProject\bin\Java\jdk1.8.0_144


  1. Then perform lblsetup.bat and opens the window for setting the address to be accessed via web console and the login password of the root user and delegation to other systems.
  2. Using the tab key to move to Choose to choose the Listen address of the web interface

  3. Set the password of the root user and user of delegation and run the <Save & Exit>

    NB save in a safe place the root credentials and delegation.


  4. At this point it is possible to start the main module through the command “goPlayer” to start LBL GUIRT Player: 


  5.  With the browser type the address selected in https with the port 4444 es.: https://192.168.xxx.xxx:4444

  6.  Type the login (if not modified with lblsetup.bat is “root”) and type the password to access the dashboard
  7. To access the module LBL GUIRT Player select:


Reliability Tools -> GUI Player


  1. The interface will display all modules player listed in the catalog nodes, in this case only one node being the first installation and having not yet inserted licenses and added nodes. 

    Select with the mouse “Edit” you can access the functions of loading tracks to run…


  1. Selecting instead “Desktop” you can view what happens in remote desktop (display possible depending on the type of access made) 

  1. To perform the launch of component LBL GUIRT Recorder go to the directory:

    C:\TCOProject\bin\LBL\LBLLoadBalancer


  1. From the File manager lblguirecorder run.bat and a window will appear which warns of the lack of a license, press ok (License The we’ll set in the following chapters).

  1. Once confirmed the message will appear the recording console that will create, try, save and load your tracks before being put into production by the player.

Installing licenses RECORDER

To install licenses LBL GUIRT Recorder is sufficient to perform:

  1. Navigate to the directory C:\TCOProject\bin\LBL\LBLGUIReliabilityTools\conf

  2. Copy the license file license.xml provided by TCOGROUP (make sure that the license is the correct one taken from the directory of relevance).

    The result should be similar to the following image :

  3. Open the command prompt in :\TCOProject\bin\LBL\LBLLoadBalancer 
  4. From the File manager run command lblguirecorder.bat 
  5. After the display of the splash screen will appear the recorder ready to perform your first recording

Installing licenses CATALOG

To install licenses LBL GUIRT Catalog, i.e. those which allow the web interface to add nodes in the management in an aggregate manner, run:

  1. Navigate to the directory C:\TCOProject\bin\LBL\LBLLoadBalancer\lib\conf

  2.  Copy the license file license.xml provided by TCOGROUP (make sure that the license is the correct one taken from the directory of relevance).

    The result should be similar to the following image : 

  3. At this point it is possible to start the main module through the command “goPlayer.bat” in the directory C:\TCOProject\bin\LBL\LBLLoadBalancer 



  4.  With the browser type the address selected in https with the port 4444 es.: https://192.168.xxx.xxx:4444

  5.  Type the login (if not modified with lblsetup.bat is “root”) and type the password to access the dashboard and then verify through the selection of settings in the top right

  6. If appear choices also Nodes and Clusters and you can enter in the two selections the license was acquired correctly.

Installing licenses PLAYER

To install licenses LBL GUIRT Player, i.e. those which allow the web interface to add nodes in the management in an aggregate manner, run:

  1. Navigate to the directory C:\TCOProject\bin\LBL\LBLLoadBalancer\procsProfiles\G10_LBLGUIPlayer\conf

  2.  Copy the license file license.xml provided by TCOGROUP (make sure that the license is the correct one taken from the directory of relevance).

    The result should be similar to the following image : 


  3. At this point it is possible to use LBL GUIRT Player: 

Start the player at the start of the desktop

In all  supported Windows systems it is possible to perform LBL GUIRT Player at startup through the following procedure:


  1. Simultaneously press the Windows Key + R and window will appear stratup

  2. Type the command shell:startup and then confirm with OK

  3. Copy the file goPlayer.bat from the directory C:\TCOProject\bin\LBL\LBLLoadBalancer directory startp


  4. Perform logout and login possible if it has not yet been enabled automatic login , the main module will start automatically and will be ready to receive the login of remote connection via web browser

Start the player in the background / foreground

To enable or disable the start of player with Window command prompt and run the player in the background or in the foreground you can use the parameter batch – at the start of the go.bat:

Start in the foreground – C:\ TCOProject\bin\LBL\LBLLoadBalancer\ go.bat

Start in backgound – C:\ TCOProject\bin\LBL\LBLLoadBalancer goPlayer\.bat

To perform the stop of all modules LBL launched in the foreground run from the command prompt: CTRL+C or type shutdown

To perform the stop of all modules LBL launched in the background the windows task manager to perform the stop of the process javaw and therefore of all the processes associated with java.

Update to new release version

To perform the update to a new release version is necessary to dispose of the package in zip format that lists the name with the version of the distribution with final “_patch” es.:

LBL_WINPXXXYYYXXX_PATCH.zip

Once the patch distribution is sufficient to stand in the machine windows where there is the installation and run the unzip inside the directory C:\TCOProject

The result must be the following (with the numbering on the release discharged):

Once you unzip open window command prompt in the directory patch:

And run the batch:

LBL_UPDATE_FROM_0XX0XX0XX_TO_0YY0YY0YY_LastBuild.bat

Use of different DB of centralized trace

To use the trace on different databases is necessary to modify the parameters of the database as follows depending on the database used.

The parameters can be changed through the interface: Modules->Statisic broker Advanced -> Edit 

MySQL (library: mysql-connector-java-5.1.10-bin.jar)=====//INTERCEPTOR FOR GUIRTDBLoaderInterceptorClass=”dwhInterceptors.LBLDWHGUIRTInterceptor”

DBDriver=”com.mysql.jdbc.driver”DBProtocol=”jdbc:mysql:”DBName=”//___hostname______portnumber___/___dbname___”DBLogin=”root”DBPassword=”adminadmin”DBDateFormat=”yyyy-MM-DD

 00:00″DBTimeFormat=”1970-01-01 HH:mm:ss”DBTimeIsDate=”true”DBVarcharLimit=”3500″ORACLE (library: ojdbc6)======//INTERCEPTOR FOR GUIRTDBLoaderInterceptorClass=”dwhInterceptors.LBLDWHGUIRTInterceptor”

DBDriver=”oracle.jdbc.driver.OracleDriver”DBProtocol=”jdbc:oracle:”DBName=”thin:@___hostname______portnumber______dbname___”DBLogin=”system”DBPassword=”adminadmin”DBDateFormat=”yyyy-MM-DD

 00:00″DBTimeFormat=”1970-01-01 HH:mm:ss”DBSetDateFormat=”ALTER SESSION set NLS_DATE_FORMAT = &apos;YYYY-MM-DD

 HH24:I:SS&apos;”

SQL SERVER==========//INTERCEPTOR FOR GUIRTDBLoaderInterceptorClass=”dwhInterceptors.LBLDWHGUIRTInterceptor”DBInitialConnectionPool=”1″DBMaxConnectionPool=”1″DBDriver=”com.microsoft.sqlserver.jdbc.SQLServerDriver”DBProtocol=”jdbc:sqlserver:”DBName=”//___hostname___:1433;databaseName=LBL”DBLogin=”sa”DBPassword=”___pwd____”DBDateFormat=”yyyy-dd-MM 00:00″DBTimeFormat=”1970-01-01 HH:mm:ss”

DBMaxHistoryDays=”-1″

DBMaxScriptBatch=”200″>

For the extraction real-time data synthesis is necessary to perform in DB The following script to create tables with the significant values contained in the file for every single specific DB:

C:\TCOProject\bin\LBL\LBLLoadBalancer\legacyBin\DatabasesScript:

GUIRT_TABLES_mysql.sql

GUIRT_TABLES_ORACLE.sql

GUIRT_TABLES_SQLSERVERl.sql