GUIRT setup

Note prima dell'installazione

Oplon Global Distributed Gateway GUI Reliability Tools (GUIRT d'ora in avanti) è uno strumento end-to-end realizzato per eseguire test ripetitivi su applicazioni in ambienti desktop.

Oplon Global Distributed Gateway è un prodotto destinato ad ambienti mission critical pertanto solo personale che ha effettuato il corso ed ha superato l'esame è autorizzato a certificare l'installazione e manutenzione dei prodotti in esercizio. Tutte le persone certificate sono dotate di attestato di partecipazione ai corsi e superamento della prova di esame rilasciati da Oplon.

Preparazione all'installazione

Per ottenere OplonGlobal Distributed Gateway GUIRT è sufficiente eseguire il download attraverso il sito web www.oplon.net. L'immagine compressa scaricata contiene una licenza d'uso RECORDER a scopo demo/prototipizzazione senza limitazione di tempo ma con la limitazione nel non poter salvare il risultato del recording. È possibile sbloccare OplonGlobal Distributed Gateway GUIRT attraverso l'acquisto delle licenze d'uso in qualsiasi momento.

Compatibility Matrix e dimensionamento

Oplon Global Distributed Gateway GUIRT è una applicazione PORTABLE distribuita e disponibile direttamente da download. Per ottenere le credenziali di accesso allo scaricamento è sufficiente inviare una e-mail a Oplon: customercare@oplon.net.

Immagini direttamente disponibili dal sito:

  • Portable zipped image compatible from Windows VISTA or upper

Il dimensionamento delle machine per ospitare un player o il recorder può andare da 512MB a 1GB di spazio RAM utilizzato.

Predisposizione dell'ambiente di registrazione (Recording) e riproduzione (Playing)

Per eseguire sia le registrazioni sia le riproduzioni attraverso OPLON GUIRT è opportuno osservare alcune raccomandazioni al fine di poter realizzare le tracce in un desktop ed essere sicuri di poterle riprodurre all'infinito in un Desktop adibito a player posizionato in qualsiasi luogo sia esso locale o remoto.

Di seguito in forma di elenco le raccomandazioni più importanti (P=Player, R=Recorder):

1) P/R - I desktop OPLON GUIRT Player devono essere impostati con la stessa risoluzione video con la quale verranno generate le tracce attraverso OPLON GUIRT Recorder

2) P/R - I desktop OPLON GUIRT Player devono essere impostati con la stessa lingua / keyboard / preferenze data e ora con la quale verranno generate le tracce attraverso OPLON GUIRT Recorder

3) P/R - E' opportuno impostare lo sfondo del desktop in tinta pastello e non variabile e non animato per non compromettere eventuali test visuali su porzioni di desktop

4) P -- L'accesso da remoto ad un Player NON deve essere effettuato via RDP in quanto alla disconnessione del client RDP il desktop grafico non è più utilizzabile per confronti visuali. Per accedere da remoto sono utilizzabili dei prodotti come vnc che non presentano questo problema

5) P - All'avvio di windows deve essere abilitato il login automatico con un utente predefinito per permettere di avviare automaticamente il player in caso di eventuali restart di windows

6) P - Il salva schermo deve essere disabilitato

Portable-App installation

OplonGlobal Distributed Gateway GUIRT è una applicazione PORTABLE ed è distribuita attraverso un'immagine compressa (zip) facilmente installabile in un qualsiasi sistema desktop windows locale o remoto. Essendo una applicazione portable non interferisce con le applicazioni già installate.

Per eseguire l'installazione è quindi sufficiente eseguire il download dello zip e una volta ottenuto posizionarsi nella directory di partenza (consigliato C:) ed ed eseguire in sequenza:

1) Verifica degli spazi disco (1,5GB liberi)

2) Unzip dell'immagine LBL_WINPXXXYYYXXX_Complete.zip

3) image1 Si otterrà come risultato l'aggiunta della directory TCOProject in C:

4) image2 (facoltativo ma consigliato) andare in C:TCOProjecttools ed eseguire dosboxwXP_2003x86x64.reg. Questo tool facilita l'apertura della finestra "Prompt dei comandi" posizionando il mouse su una directory del file manager e premendo il tasto destro del mouse apparirà "Apri finestra DOS).

5) Aprire una finestra "Prompt dei comandi" in: C:TCOProjectbinLBLLBLLoadBalancer image3

6) Eseguire lblsetenv.bat

Alla prima esecuzione oltre a impostare le variabili d'ambiente di seguito riportate il batch copierà alcuni file necessari.

Non sarà necessario modificare le variabili d'ambiente se si è scelto di installare in C:TCOProject altrimenti dovranno essere modificate.

set LBL_HOME=C:TCOProjectbinLBLLBLLoadBalancer set LBL_GUIRECORDER_HOME=C:TCOProjectbinLBLLBLGUIReliabilityTools set LBL_SETUP_HOME=C:TCOProjectbinLBLLBLSetup set LBL_JAVA_HOME=C:TCOProjectbinJavajdk1.8.0_144

image4

7) Eseguire quindi lblsetup.bat e si aprirà la finestra di impostazione dell'indirizzo a cui accedere attraverso console web ed i login password degli utenti root e di delega per altri sistemi. image5

8) Con il tasto tab spostarsi su Choose per scegliere l'indirizzo di ascolto dell'interfaccia web image6

9) Impostare le password dell'utente root e dell'utente di delega ed eseguire il <save & exit> NB Salvare in un posto sicuro le credenziali root e di delega.

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

10) A questo punto è possibile avviare il modulo principale attraverso il comando "goPlayer" per avviare OPLON GUIRT Player:

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

11) image9 Con il browser digitare l'indirizzo selezionato in https con la porta 4444 es.: https://192.168.xxx.xxx:4444

12) image10 Digitare il login (se non modificato con lblsetup.bat è "root") e digitare la password per accedere alla dashboard

13) Per accedere al modulo OPLON GUIRT Player selezionare:

image11 Reliability Tools -> GUI Player

14) image12 L'interfaccia visualizzerà tutti i moduli player censiti nel catalogo nodi, in questo caso solamente un nodo essendo la prima installazione e non avendo ancora inserito licenze e addizionato nodi. Selezionando con il mouse "Edit" è possibile accedere alle funzioni di caricamento delle tracce da eseguire...

image13

15) Selezionando invece "Desktop" è possibile visualizzare quanto accade nel desktop remoto (visualizzazione possibile in dipendenza dal tipo di accesso effettuato)

image14

16) Per eseguire il lancio della componente OPLON GUIRT Recorder posizionarsi nella directory: C:TCOProjectbinLBLLBLLoadBalancer

image15

17) Da file manager eseguire lblguirecorder.bat ed apparirà una finestra che avverte della mancanza della licenza, premere ok (la licenza la imposteremo nei seguenti capitoli).

image16

18) Una volta confermato il messaggio apparirà la console di registrazione che permetterà di creare, provare, salvare e caricare le tracce prima di essere messe in produzione dai player.

image17

Installazione delle licenze RECORDER

Per installare le licenze OPLON GUIRT Recorder è sufficiente eseguire:

1) Posizionarsi nella directory: C:TCOProjectbinLBLLBLGUIReliabilityToolsconf

2) image18 Copiare il file di licenza license.xml fornito da Oplon (Assicurarsi che la licenza sia quella corretta prelevata dalla directory di pertinenza).

Il risultato dovrà essere simile alla seguente immagine :

3) Aprire il prompt dei comandi in :TCOProjectbinLBLLBLLoadBalancer

4) Da file manager eseguire il comando lblguirecorder.bat

5) Dopo la visualizzazione dello splash screen apparirà il recorder pronto per eseguire la prima registrazione

image17

Installazione delle licenze CATALOG

Per installare le licenze OPLON GUIRT Catalog, cioè quelle che permettono all'interfaccia web di aggiungere nodi in gestione in maniera aggregata, eseguire:

1) Posizionarsi nella directory: C:TCOProjectbinLBLLBLLoadBalancerlibconf

2) image19 Copiare il file di licenza license.xml fornito da Oplon (Assicurarsi che la licenza sia quella corretta prelevata dalla directory di pertinenza).

Il risultato dovrà essere simile alla seguente immagine :

3) A questo punto è possibile avviare il modulo principale attraverso il comando "goPlayer.bat" nella directory C:TCOProjectbinLBLLBLLoadBalancer image20

4) image9 Con il browser digitare l'indirizzo selezionato in https con la porta 4444 es.: <https://192.168.xxx.xxx:4444>

5) image21 Digitare il login (se non modificato con lblsetup.bat è "root") e digitare la password per accedere alla dashboard quindi verificare attraverso la selezione di impostazioni in alto a destra

6) image22 Se appaiono anche le scelte Nodes e Clusters ed è possibile entrare nelle due selezioni la licenza è stata acquisita correttamente.

Installazione delle licenze PLAYER

Per installare le licenze OPLON GUIRT Player, cioè quelle che permettono all'interfaccia web di aggiungere nodi in gestione in maniera aggregata, eseguire:

1) Posizionarsi nella directory: C:TCOProjectbinLBLLBLLoadBalancerprocsProfilesG10_LBLGUIPlayerconf

2) image23 Copiare il file di licenza license.xml fornito da Oplon (Assicurarsi che la licenza sia quella corretta prelevata dalla directory di pertinenza).

Il risultato dovrà essere simile alla seguente immagine :

3) image24 A questo punto è possibile utilizzare OPLON GUIRT Player:

Start del PLAYER all'avvio del desktop

In tutti i sistemi windows supportati è possibile eseguire OPLON GUIRT Player all'avvio attraverso la seguente procedura:

1) image25 Premere contemporaneamente il tasto Windows+R e apparirà la finestra di stratup

2) image26 Digitare il comando shell:startup quindi confermare con ok

3) image27 Copiare il file goPlayer.bat dalla directory C:TCOProjectbinLBLLBLLoadBalancer alla directory di startp

4) image28 image29 Eseguire logout ed eventuale login se ancora non è stato abilitato il login automatico, il modulo principale partirà in automatico e sarà pronto a ricevere il login di collegamento remoto tramite web browser

Start del PLAYER in background / foreground

Per abilitare o disabilitare lo start del player con finestra command prompt ed eseguire il player in background o in foreground è possibile utilizzare il parametro -batch all'avvio del go.bat:

Start in foreground - C: TCOProjectbinLBLLBLLoadBalancer go.bat

Start in backgound - C: TCOProjectbinLBLLBLLoadBalancer goPlayer.bat

Per eseguire lo stop di tutti i moduli OPLON lanciati in foreground eseguire da prompt: CTRL+C oppure digitare shutdown

Per eseguire lo stop di tutti i moduli OPLON lanciati in background da task manager di windows eseguire lo stop del processo javaw e quindi di tutti i processi associati java.

Update to new release version

Per eseguire l'update ad una nuova release version è necessario disporre del package in formato zip che riporta il nome con la versione della distribuzione con finale "_patch" es.:

LBL_WINPXXXYYYXXX_patch.zip

Una volta ottenuta la patch della distribuzione è sufficiente posizionarsi nella macchina windows dove è presente l'installazione ed eseguire l'unzip all'interno della directory C:TCOProject

Il risultato deve essere il seguente (con la numerazione relativa alla release scaricata):

image30

Una volta eseguito l'unzip aprire la finestra command prompt nella directory patch:

image31

Ed eseguire il batch:

LBL_UPDATE_FROM_0XX0XX0XX_TO_0YY0YY0YY_LastBuild.bat

Utilizzo di differenti DB di trace centralizzati

Per utilizzare i trace su database differenti è necessario modificare i parametri del database come di seguito in dipendenza del database utilizzato.

I parametri possono essere modificati attraverso interfaccia: Modules->Statisic broker Advanced -> Edit

image32

Per l'estrazione real-time dei dati di sintesi è necessario eseguire nel DB i seguenti script di creazione delle tabelle con i valori significativi contenuti nei file per ogni singolo specifico DB:

C:TCOProjectbinLBLLBLLoadBalancerlegacyBinDatabasesScript:

GUIRT_TABLES_MYSQL.sql

GUIRT_TABLES_ORACLE.sql

GUIRT_TABLES_SQLSERVERl.sql