Questo argomento descrive come configurare Jazz Team Server per l'utilizzo con WebSphere Application Server. Questa
configurazione presume che si stia installando Jazz Team Server sullo
stesso computer di WebSphere Application Server.
Prima di iniziare
Prima di iniziare questa procedura, è necessario che siano state completate le seguenti operazioni:
- WebSphere Application server è già installato.
- Il database è stato creato e il file teamserver.properties è aggiornato con le impostazioni del database.
- Abilitazione del login non sensibile al maiuscolo/minuscolo (facoltativo): se il metodo di autenticazione
del server delle applicazioni consente il login non sensibile al maiuscolo/minuscolo, è possibile fare
in modo che anche l'applicazione Jazz l'accetti. È possibile abilitare l'accettazione
del login non sensibile al maiuscolo/minuscolo servendosi della proprietà
"Utilizza corrispondenza ID utente non sensibile al maiuscolo/minuscolo" nella pagina Proprietà avanzate dell'interfaccia
utente Web di amministrazione. Il valore predefinito è invariato; gli amministratori devono
sostituire esplicitamente questa proprietà per abilitare il login non sensibile al maiuscolo/minuscolo.
- L'opzione Java™ 2 Security deve essere disattivata.
Se questa opzione è attivata in WebSphere Application Server, non sarà possibile avviare Jazz Team Server .war.
- Assicurarsi che l'impostazione di sicurezza WAS "Utilizza i dati di autenticazione disponibili quando si accede ad un URI non protetto" sia selezionata. Se si sta utilizzando WAS Integrated Solutions Console, è possibile eseguire questa operazione nel seguente modo:
- Accedere a Sicurezza -> Proteggi gestione, applicazioni e infrastruttura -> Sicurezza Web - Impostazioni generali.
- Selezionare la casella di spunta per "Utilizza i dati di autenticazione disponibili quando si accede ad un URI non protetto".
- Jazz Team Server include
i file richiesti per eseguire un server basato su Apache Tomcat completo. Per un'installazione WebSphere, occorre solo un sottoinsieme dei file di Jazz Team Server; tali file devono
essere inseriti in una directory sul computer del server WebSphere. Ulteriori istruzioni fanno riferimento a tale directory come directory di installazione di Jazz Team Server o, abbreviata,
JazzInstallDir. Da questa directory, utilizzare:
- Il file JazzInstallDir/server/tomcat/webapps/jazz.war.
- La directory JazzInstallDir/server/update-site.
- La directory JazzInstallDir/server/conf.
- Il database repository predefinito in JazzInstallDir/repositoryDB.
- Gli strumenti repository in JazzInstallDir/repotools.
- La directory JazzInstallDirserver/license-update-site.
- La directory JazzInstallDir/server/nl1-update-site.
- la directory JazzInstallDir/server/nl2-update-site.
Suggerimento: Quando si utilizza IBM® Installation
Manager, i file di Jazz Team Server possono
essere installati in una directory dell'applicazione Web. Durante il processo di installazione, non installare il
server delle applicazioni Apache Tomcat incluso; in questo modo, l'Installation Manager chiederà una directory di applicazione
Web e installerà solo i file necessari per WebSphere.
La directory predefinita è C:\Program Files\IBM\JazzTeamServer su Windows® oppure /opt/IBM/JazzTeamServer su Linux®.
Alla directory di installazione si fa riferimento come JazzInstallDir in
questa procedura. Se si utilizza IBM Installation Manager per installare i file nella directory delle applicazioni Web di WebSphere Application Server, non è necessario spostare
i file manualmente come descritto in precedenza.
Informazioni su questa attività
Nota: Questo documento non spiega come configurare SSL o l'autenticazione WebSphere, poiché si tratta di un argomento complesso. Delle informazioni dettagliate sulle varie opzioni di codifica e autenticazione per WebSphere sono disponibili nel centro
informazioni di WebSphere. Per ulteriori
informazioni, accedere al
centro informazioni di WebSphere e
cercare
Protezione delle applicazioni e del relativo ambiente.
L'interfaccia utente Web Jazz richiede che l'autenticazione sia
configurata per eseguire l'autorizzazione e personalizzare l'applicazione.
- Esaminare e aggiornare l'ubicazione del database nel file teamserver.properties
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
Nota: Questa è una configurazione DB2 di esempio. Il file teamserver.properties deve essere aggiornato in
base al fornitore del database (Oracle/MS-SQL).
- Verificare o aggiornare il livello di WebSphere Application Server.
Jazz Team Server richiede WebSphere Application Server Versione 6.1
con applicata la Cumulative Fix di IBM Java SDK 1.5 SR5 o successive oppure che sia installato WebSphere Application
Server Versione 7.0 con almeno 7.0.0.3. L'aggiornamento SDK di IBM Java SDK 1.5 SR6 è disponibile
dall'indirizzo http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492. Con WebSphere 6.1
e IBM Java SDK GA, Jazz
inizia a notificare gli "errori proxy" dopo un certo numero di operazioni.
È necessario ottenere le i-fix di WebSphere Application
Server corrispondenti per le correzioni a IBM Java SDK
1.5 SR9 o IBM Java SDK
1.6 SR4 necessarie per una corretta esecuzione di IBM Rational Team Concert 2.0. Altrimenti, alcuni servizi nel server potrebbero non essere avviati correttamente. Le i-fix sono disponibili sotto i loro corrispondenti
APAR di WebSphere Application Server. 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 il fixpack 19 di WebSphere Application Server
6.1 prima di installare la 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/.
- Aggiornare gli argomenti JVM.
Jazz Team Server richiede delle
impostazioni specifiche sulla Java Virtual
Machine in cui viene eseguito.
Occorre innanzitutto fare in modo che sappia dove trovare alcuni file di configurazione. Questa operazione viene eseguita impostando una proprietà di sistema
JAZZ_HOME. Questa proprietà utilizza un URL piuttosto che un percorso semplice, quindi il valore deve essere
specificato come un URL in stile file://.
La seconda proprietà richiesta per la JVM Jazz consiste
nel fornire ad essa un'assegnazione massima di memoria superiore a quella predefinita, utilizzando l'impostazione -Xmx. Deve essere
impostata in base alla dimensione del team supportata dal server e dalla capacità di memoria del server dove è in
esecuzione Jazz Team Server. Un tipico team di medie dimensioni può
utilizzare un valore di -Xmx1536M, fornendo 1536 MB di memoria heap per il processo Jazz Team Server.
Se ci si sta connettendo a un database Oracle oppure SQL Server, è necessario aggiungere una proprietà
denominata "ORACLE_JDBC" o "SQLSERVER_JDBC". Impostare la proprietà sul percorso
file assoluto (non un URL) ai driver jdbc appropriati.
Delle altre proprietà di sistema che devono essere impostate per controllare alcune
modalità di funzionamento del server sono incluse qui di seguito. Queste sono le specifiche di impostazione di queste
proprietà JVM nella console di gestione di WebSphere; sostituire a JazzInstallDir la
propria directory di installazione di Jazz Team Server:
- Fare clic su .
- Fare clic su server1.
- Fare clic su .
- Fare clic su Java Virtual Machine.
- Aggiungere il valore 100 a Heap iniziale.
- Aggiungere il valore 1000 a Dimensione di heap massima.
- Fare clic su Applica.
- Fare clic su Log e traccia. Fare clic su Modifica i livelli di dettaglio di log. Jazz Team Server utilizza
il motore di creazione di report BIRT. Per evitare che le voci informative BIRT vengano scritte nel
file di log di WebSphere, impostare il livello di registrazione su severe per
i package org.eclipse.birt.*. Fare clic su Applica.
- Fare clic su Proprietà personalizzate
- Aggiungere le seguenti proprietà: Fare clic su Nuovo;
immettere il Nome e il Valore e fare quindi clic su OK.
- Nome: java.awt.headless Valore: true
- Nome: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin Valore:
true
- Nome: JAZZ_HOME Valore: file:///JazzInstallDir/server/conf
- Nella sezione Salva sulla configurazione principale, fare clic su Salva.
- Riavviare WebSphere per installare l'applicazione Jazz
Nei seguenti esempi di riga comandi,
WASInstallDir
rappresenta l'ubicazione dove WebSphere Application Server
è installato sul server.
- Aprire la console di gestione per WebSphere Application
Server.
- Fare clic su .
- Sotto Percorso della nuova applicazione, fare clic su File system locale.
- Sotto Percorso completo, immettere:
JazzInstallDir/server/jazz.war
- Impostare Root contesto su /jazz.
- Fare clic su Avanti e continuare con le restanti operazioni di Installa nuova applicazione.
- Scegliere Fine.
- Nella sezione Salva sulla configurazione principale, fare clic su Salva.
- Fare clic su .
- Selezionare la casella accanto a jazz_war; fare clic su Avvia.
Dovrebbe essere visualizzata una freccia verde che indica che l'applicazione è stata
avviata correttamente.
Operazioni successive
Una volta avviato il server, procedere a
Esecuzione della procedura guidata di configurazione.
Per ulteriori
informazioni su questo argomento, visitare i seguenti link:
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ