Questo argomento descrive la procedura di configurazione di IBM® Rational Quality
Manager
da utilizzare con WebSphere® Application Server. In questa configurazione si suppone che l'installazione del server
Jazz avvenga sulla stessa macchina di Websphere Application Server.
Pianificazione della configurazione
Prima di iniziare questa procedura, completare le seguenti attività:
- Jazz Team Server richiede WebSphere Application Server
Versione 6.1 con IBM Java™ SDK 1.5 SR5 o correzione cumulativa
successiva applicata o WebSphere Application
Server Versione 7.0 con almeno la versione 7.0.0.3 installata.
L'aggiornamento IBM Java SDK
1.5 SR6 SDK è disponibile all'indirizzo http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492.
Con WebSphere 6.1 e
GA IBM Java SDK, senza questa correzione, Jazz viene avviato per segnalare "errori proxy", dopo un certo numero di operazioni.
Procurarsi le i-fix WebSphere Application Server
corrispondenti per IBM Java SDK 1.5 SR9 o IBM Java SDK
1.6 SR4, necessarie per eseguire correttamente IBM Rational Team Concert 2.0. Altrimenti, alcuni servizi nel server potrebbero non essere avviati correttamente. Le i-fix sono disponibili nelle APAR WebSphere Application Server
corrispondenti. Per IBM Java SDK 1.5/WebSphere Application Server 6.1,
l'APAR è PK85942 ed è possibile scaricare i file da ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/.
Installare almeno WebSphere Application
Server 6.1 fixpack 19, prima di l'i-fix JRE. Per IBM Java SDK
1.6/WebSphere Application Server 7.0, l'APAR è PK 86771 ed è possibile scaricare i file da ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/.
- Il file teamserver.properties viene aggiornato con le impostazioni database.
- Fare riferimento alla propria documentazione WebSphere per la configurazione della
sicurezza e per disattivare la proprietà che non rispetta la distinzione tra maiuscole e minuscole.
- L'opzione Java 2 Security deve essere disattivata. Se tale opzione è attivata in WebSphere Application Server,
impedirà l'avvio di jazz.war.
- Verificare che l'impostazione di sicurezza WAS "Utilizza dati di autenticazione disponibile quando si accede ad un URI non
protetto" sia selezionata. Per eseguire tale operazione in WAS Integrated Solutions Console:
- Nella versione 6.1, accedere a Sicurezza -> Infrastruttura, applicazioni e gestione sicura -> Sicurezza Web - Impostazioni
generali. Nella versione 7, accedere a Sicurezza->Sicurezza globale->Sicurezza Web e SIP->Impostazioni generali.
- Selezionare la casella di controllo "Utilizza dati di autenticazione disponibile quando si accede ad un URI non
protetto".
Configurazione di WebSphere Application Server
Per configurare
WebSphere Application Server:
- Se non è già in esecuzione, avviare il servizio di
WebSphere Application Server.
- Accedere alla console di gestione di WebSphere Application
Server.
- Eseguire l'autenticazione con il server come risorsa di gestione.
Nota: la persona che ha installato il software
WebSphere ha specificato l'ID utente e la password della risorsa di gestione al momento
dell'installazione.
- Dopo l'autenticazione, fare clic su .
- Individuare la sezione Infrastruttura server della pagina di configurazione server1, espandere
Java e gestione processi e fare clic su Definizione processi.
- nella pagina Definizione processi, accedere alla sezione Proprietà aggiuntive e fare clic su Java Virtual Machine.
- Aumentare la dimensione massima di heap a 1000 e fare clic su Applica.
- Nella sezione Argomenti JVM generici della pagina Java Virtual Machine, includere i
seguenti argomenti JVM. Accertarsi di aggiungere gli argomenti JVM su una riga.
Esempio
Windows®:
-Dcom.ibm.team.server.configURL=file:///D:/RQM20/server/conf/jazz/teamserver.properties -Dlog4j.configuration=file:///D:/RQM20/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///D:/RQM20/server/conf/jazz/provision_profiles -Dcom.ibm.team.repository.discovery.document.location=file:///D:/RQM20/server/conf/jazz/services.xml -Dcom.ibm.team.repository.friends.config.location=file:///D:/RQM20/server/conf/jazz/friendsconfig.rdf -Dcom.ibm.rqm.create.samples=false -Xss768k
Esempio
Linux®:
-Dcom.ibm.team.server.configURL=file:///opt/IBM/RQM20/server/conf/jazz/teamserver.properties -Dlog4j.configuration=file:///opt/IBM/RQM20/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=///opt/IBM/RQM20/server/conf/jazz/provision_profiles -Dcom.ibm.team.repository.discovery.document.location=file:///opt/IBM/RQM20/server/conf/jazz/services.xml -Dcom.ibm.team.repository.friends.config.location=file:///opt/IBM/RQM20/server/conf/jazz/friendsconfig.rdf -Dcom.ibm.rqm.create.samples=false -Xss768k
dove
D:/RQM20 è la directory di installazione su Windows e opt/IBM/RQM20
è la directory di installazione su Linux.
Tali valori devono essere codificati, il che
richiede la sostituzione degli eventuali spazi nei percorsi file con
%20. Ad esempio,
C:\Program
Files diventa
C:\Program%20Files.
Se i valori degli argomenti JVM non vengono immessi correttamente, WebSphere Application
Server non viene avviato.
In tal caso, non è possibile utilizzare l'interfaccia Web di WebSphere Application Server
per correggere tale errore; è necessario individuare il file server.xml, modificarlo e avviare WebSphere Application
Server. Generalmente, il file si trova in questo contesto:
c:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\qwin268Node01Cell\nodes\qwin268Node01\servers\server1\server.xml
Nota: gli argomenti
JVM citati nella guida di Rational Team Concert non contengono gli argomenti JVM completi
necessari per una corretta distribuzione di Rational Quality Manager.
- In Proprietà aggiuntive, fare clic su Proprietà personalizzate.
- Fare clic su Nuovo e aggiungere tali valori:
- Salvare le modifiche al file di configurazione principale.
- Arrestare e riavviare WebSphere Application
Server.
Nota: se il server non si riavvia, consultare manualmente gli argomenti JVM generica. Tali argomenti si trovano
nel file server.xml che, in un'installazione tipica, si trova nella seguente posizione:
C:\Program Files\ibm\WebSphere\AppServer\profiles\AppSrv01\config\cells\enable01
Node01Cell\nodes\enable01Node01\servers\server1\server.xml
Impostazioni della sicurezza per WebSphere Application Server
Per
migliorare il supporto per installazioni OAuth tramite WebSphere Application Server, è
necessario utilizzare la seguente impostazione di sicurezza Web:
- Utilizzando WAS Integration Solutions Console, accedere a .
- Verificare che l'opzione Utilizza dati di autenticazione disponibile quando si accede ad un URI non
protetto sia selezionata.
Configurazione del prodotto e della guida di Rational Quality Manager
su WebSphere Application
Server
Per configurare il prodotto e la guida di IBM Rational Quality Manager
in un ambiente WebSphere Application Server:
- Avviare l'interfaccia della console di gestione WebSphere ed eseguire l'autenticazione
con il server utilizzando l'ID utente di gestione di WebSphere Application Server.
- Espandere Applicazioni e fare clic su Installa nuova applicazione.
- In Percorso alla nuova applicazione, accedere alla posizione del file jazz.war sul
File system locale e selezionare il file.
- Immettere la root di contesto come /jazz e fare clic su Avanti.
Nota: è possibile
trovare il file jazz.war in RQM_install_dir\server\tomcat\webapps\jazz.war.
- Continuare a fare clic su Avanti fino a visualizzare la schermata Riepilogo e quindi fare clic su
Fine per installare la nuova applicazione.
- Verificare che sia stata installata l'applicazione jazz_war e fare clic su Salva per salvare le modifiche
al file di configurazione principale.
- Tornare alla pagina Installa nuova applicazione.
- Accedere alla posizione del file help.war sul file system locale e selezionare il file. Immettere la root di contesto come
/help e fare clic su Avanti.
Nota: è possibile
trovare il file help.war in RQM_install_dir\server\tomcat\webapps\help.war.
- Continuare a fare clic su Avanti fino a visualizzare la schermata Riepilogo e quindi fare clic su
Fine per installare la nuova applicazione.
- Verificare che sia stata installata l'applicazione help_war e fare clic su Salva per salvare le modifiche
al file di configurazione principale.
- Espandere la sezione Applicazione enterprise nell'opzione Applicazioni.
- Selezionare jazz_war e fare clic su Avvia.
- Selezionare help_war e fare clic su Avvia.
Configurazione di LDAP su WebSphere Application Server per
Rational Quality Manager
Per configurare
LDAP:
- Dalla console di gestione Websphere, fare clic su .
- Aggiornare le impostazioni di sicurezza nel modo seguente:
- Abilitare la sicurezza di gestione: on
- Abilitare la sicurezza dell'applicazione: on
- Definizioni realm disponibili/repository account utente:Registro LDAP autonomo
- Nella sezione Repository account utente, fare clic su Configura e fornire le Proprietà generali.
- Nome utente di gestione primario - Proprio ID utente
- Identità utente server - Identità server generata automaticamente
- Tipo di server LDAP - Personalizzato
- Timeout di ricerca - 120 secondi
- Fare clic su Applica e salvare le modifiche.
- Nella sezione Configurazione, fare clic su Verifica connessione.
- Nella sezione Proprietà aggiuntive, fare clic su LDAP (Lightweight Directory Access Protocol) avanzato.
- Specificare i campi Proprietà generali nel modo seguente:
- Filtro utente:
(&(emailaddress=%v)(objectclass=ePerson))
- Filtro gruppo:
(&(cn=%v)(|(objectclass=groupOfNames)(objectclass=groupOfUniqueNames)))
- Associazione ID utente:
*:emailaddress
- Associazione ID membro gruppo: (sostituire ibm con il proprio ID)
ibm-allGroups:member;ibm-allGroups:uniqueMember
- Modalità di associazione certificato:
EXACT_DN
- Al termine, fare clic su Applica e salvare le modifiche.
- Fare clic su Applica e Salva per ognuna delle schermate per confermare ciascuna
impostazione.
Nota: nell'ultima pagina, verificare che Definizione realm corrente sia impostato su
Registro LDAP autonomo.
- Arrestare e riavviare WebSphere Application
Server.
- Una volta riavviato WebSphere Application
Server, convalidare le modifiche accedendo alla console di gestione.
- Per associare gruppi di utenti alle specifiche applicazioni, fare clic su
.
- Nell'elenco di applicazioni enterprise, selezionare l'applicazione jazz_war e fare clic su Arresta.
- Una volta arrestata l'applicazione, fare clic sull'applicazione jazz_war per aprirla per la modifica.
- Nella sezione Proprietà dettagli, fare clic su Ruolo di sicurezza per associazione utente/gruppo.
- Selezionare uno specifico gruppo, ad esempio JazzAdmins e JazzUsers e fare clic su Ricerca gruppi.
Tali gruppi
sono associati ad ogni implementazione Jazz e devono essere associati ad un particolare gruppo
LDAP contenente gli utenti autorizzati. Tali gruppi devono essere impostati sul server LDAP prima di eseguire questa associazione.
- Immettere una stringa di ricerca per restituire i propri nomi gruppo dal server LDAP. Fare clic su Ricerca per eseguire la query.
- Dall'elenco di gruppi disponibili restituiti, selezionare lo specifico gruppo e spostarlo nella colonna Selezionati.
- Fare clic su OK per associare i gruppi LDAP ai gruppi Jazz.
- Associare il gruppo LDAP adeguato per tutti i gruppi Jazz:
- JazzAdmins
- JazzDWAdmins
- JazzUsers
- JazzGuests
Nota: non abilitare l'opzione Tutti autenticati?.
- Salvare le modifiche e riavviare l'applicazione jazz_war.
- Uscire dalla console di gestione e arrestare la finestra del browser.
Configurazione del registro personalizzato di WebSphere Application
Server
Nota: è possibile utilizzare le istruzioni presenti in questa sezione durante la valutazione di
Rational Quality Manager.
Queste istruzioni non sono utili in un ambiente di produzione reale se si utilizza LDAP.
Per configurare le credenziali utente
tramite il registro personalizzato di WebSphere Application
Server:
- Creare una directory denominata WAS_Security in un percorso che si desidera ed aggiungere i file users.props e groups.props.
Per informazioni sul formato di questi file, vedere user.props e groups.props.
- Fare clic su e selezionare Registro personalizzato autonomo dalla sezione
Repository account utente; quindi fare clic sul pulsante Procedura guidata di configurazione
della sicurezza.
- Nel passo 1 della Procedura guidata di configurazione della sicurezza, selezionare
Abilita sicurezza dell'applicazione.
- Nel passo 2, selezionare Registro personalizzato autonomo.
- Nel passo 3, Configura repository utente, aggiungere un
Nome utente di gestione primario e un nome e un valore sia per usersFile (users.props) che per
groupsFile (groups.props):
- Nel passo 4, consultare il riepilogo e fare clic su Fine.
- Salvare le modifiche facendo clic su Salva direttamente nella configurazione principale. Da
, selezionare jazz.war
e fare clic su Arresta (a meno che non siano già state arrestate come indicato da una X rossa).
- Selezionare il link jazz.war e Ruolo di sicurezza per associazione utente/gruppo.
- Selezionare JazzAdmins e fare clic su Ricerca gruppi:
- Fare clic su Ricerca gruppi e selezionare admins dall'elenco disponibile.
- Aggiungere all'elenco selezionato. Ripetere i passi 9 e 10 per JazzDWAdmins, selezionando nuovamente
admins.
- Per JazzUsers e JazzGuests, seguire i passi 9 e 10, selezionando users per i ruoli.
- Salvare le modifiche facendo clic su Salva direttamente nella configurazione principale.
- Per completare la configurazione di WebSphere Application
Server, riavviare WebSphere Application
Server.
Avvio di WebSphere Application
Server come servizio Windows
Con Rational Quality Manager,
è possibile creare script di test che facciano riferimento a test esistenti creati
con altri strumenti di test. Tali test automatizzati possono essere salvati su macchine di test locali o su posizioni di rete
condivise. I test salvati su posizioni di rete condivise sono accessibili tramite condivisioni UNC (Universal Naming
Convention).
Per impostazione predefinita, quando WebSphere Application Server
viene eseguito come servizio Windows, accede come account di sistema locale. In tal caso,
è possibile che Rational Quality Manager non
sia in grado di accedere a condivisioni UNC poiché l'account di sistema locale non dispone delle credenziali di sicurezza. Di conseguenza,
accertarsi di impostare il servizio Windows di
WebSphere Application Server per accedere come specifico account utente con credenziali
di sicurezza. In questo modo, il servizio può connettersi a qualsiasi condivisione UNC corrispondente alle credenziali di sicurezza
di tale account utente.