Con l'adattatore della riga comandi, è possibile utilizzare una macchina di test di destinazione
per l'esecuzione da riga comandi. È necessario registrare l'adattatore sulla macchina di test di destinazione
per eseguire gli script della riga comandi.
Prima di iniziare
- Assicurarsi che la piattaforma su cui si pianifica di eseguire l'adattatore di riga comandi
supporti almeno un minimo di Java versione 1.5 o successive .
- Il file eseguibile java.exe
deve essere accessibile nel percorso della macchina di test di
destinazione.
- Per avviare l'adattatore, è necessario avere questa informazione:
- L'URL del repository jazz, che generalmente è https://qmserver:port/qm
- Un ID utente che abbia licenze appropriate per l'accesso come adattatore
- La password per tale utente
- Il nome dell'area progetto, se non corrisponde all'area progetto Quality
Management predefinita
- L'applicazione Quality Management deve essere eseguita sul server.
Importante: È possibile eseguire più di
un adattatore su una macchina di test di destinazione, ma ogni adattatore deve essere un processo separato
con un nome univoco specificato nell'opzione -adapterName.
Informazioni su questa attività
L'adattatore della riga comandi deve essere impostato ed avviato sulla
macchina di test di destinazione.
Procedura
Completare questi passi sulla macchina di test di destinazione:
- Ottenere il file
install-location\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip
dalla macchina di installazione. Un amministratore del server con accesso in lettura al server potrebbe
richiedere il file compresso
al posto dell'utente.
- Estrarre il file RQMCommmandLineAdapter.zip in una
cartella sulla macchina di test di destinazione.
- Opzionale: Personalizzare i risultati degli script effettivi,
che vengono mostrati nel record di esecuzione del testcase o nel record di esecuzione
della suite di test. Per ulteriori informazioni, consultare
Personalizzazione dell'adattatore della riga comandi.
- Se si utilizza la versione 5.0 o successive e si desidera che gli adattatori della riga comandi
soddisfino richieste multiple in parallelo, è possibile abilitare quella funzione,
che è disabilitata per impostazione predefinita. La funzione viene abilitata
aggiungendo una proprietà. Se non si aggiunge la proprietà o se la si imposta
ad un valore non valido, quando vengono inviati test multipli all'adattatore, vengono
messi in coda per essere eseguiti come sono stati ricevuti.
Suggerimento: L'utilizzo dell'adattatore
della riga comandi per eseguire i test in parallelo è migliore per i test
con esecuzione lunga. L'adattatore seleziona i test uno per uno in base alla sua capacità
di eseguire ciascun test. Seleziona uno script, ne avvia l'esecuzione e poi
seleziona un altro script da eseguire. Se gli script sono corti, potrebbe
sembrare che vengano eseguiti in modo sequenziale.
Per abilitare l'esecuzione di test in parallelo
su un adattatore della riga comandi:- Sulla macchina di test di destinazione, aprire il file CommandLine.properties
o un file preferenze equivalente.
- Aggiungere le seguenti proprietà al file: com.ibm.rqm.commandline.maxservedrequests=N
dove N è il numero massimo di test
da eseguire contemporaneamente.
- Se l'adattatore della riga comandi è attivo, riavviarlo.
Quando viene raggiunto il massimo specificato, i test che vengono
inviati all'adattatore vengono messi in coda per l'esecuzione come lo spazio diventa disponibile.
- Avviare l'adattatore della riga comandi.
- Per
avviare l'adattatore della riga comandi per la prima volta:
Eseguire il file batch con gli argomenti della riga comandi come mostrato:
C:\ start.bat -repository https://qmserver:port/qm -user userid -password password [-adapterName Nome-adattatore]
[-projectArea area progetto] [-sleepTime tempo di
sospensione] [-configFile file di configurazione]
Per ulteriori informazioni, consultare
Personalizzazione dell'adattatore della riga comandi.
Eseguire
lo script shell con gli argomenti della riga comandi come mostrato:
$ start.sh -repository https://qmserver:port/qm -user userid -password password [-adapterName Nome-adattatore]
[-projectArea area progetto] [-sleepTime tempo di
sospensione] [-configFile file di configurazione]
Dove:
- qmserver è il nome host o l'indirizzo IP del server
QM (quality management).
- port è la porta su cui è in esecuzione il server QM
(Quality Management)
- userid è un ID utente registrato per QM (Quality
Management) che dispone della licenza per l'esecuzione di un adattatore.
- password è la password dell'ID utente immesso.
- adapter-name è un nome adattatore assegnato
dall'utente.
- project area è il nome del progetto a cui è stato
eseguito l'accesso.
- sleep time è l'intervallo di polling per le attività. L'impostazione predefinita è 5 secondi.
- configuration file è il file per l'archiviazione e la
lettura delle impostazioni per questo adattatore. Il nome file predefinito è config.ini.
L'adattatore genera un file di configurazione per contenere
le informazioni di registrazione. Il file di configurazione è o il file config.ini
o il file che viene specificato nell'opzione -configFile.
Tali informazioni vengono riutilizzate al riavvio dell'adattatore.
- Per
riavviare l'adattatore della riga comandi da un file config.ini:
:
Eseguire il file batch senza argomenti:
C:\ start.bat
:
Eseguire lo script shell senza argomenti della riga comandi:
$ start.sh
Nota: Il file di configurazione deve essere contenuto nella directory da cui
viene avviato l'adattatore.
Risultati
Il sistema genera un messaggio che è come questo messaggio:
Avvio dell'adattatore …
Il file di configurazione adapterConfig.ini non esiste, l'adattatore utilizzerà gli argomenti passati
Client HTTP correttamente creato
L'adattatore è collegato
Adattatore della riga comandi creato
Operazioni successive
È possibile verificare lo stato dell'adattatore sull'applicazione
Quality Management sulla macchina di test facendo clic su
. Prima di provare
ad eseguire un test su un adattatore della riga comandi in esecuzione, assicurarsi che
lo stato sia verde.