Configurazione di un WebSphere Application Server

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:
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.
  1. 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).
  2. 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/.

  3. 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:

    1. Fare clic su Server > Server delle applicazioni.
    2. Fare clic su server1.
    3. Fare clic su Gestione di processo e Java > Definizione processo.
    4. Fare clic su Java Virtual Machine.
    5. Aggiungere il valore 100 a Heap iniziale.
    6. Aggiungere il valore 1000 a Dimensione di heap massima.
    7. Fare clic su Applica.
    8. 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.
    9. Fare clic su Proprietà personalizzate
    10. 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
    11. Nella sezione Salva sulla configurazione principale, fare clic su Salva.
    Importante: Solo per Solaris, è necessario anche aggiungere il seguente argomento di riga comandi Java:
    -XX:MaxPermSize=256m
    Per ulteriori informazioni, consultare il capitolo 2, "Configuring a Solaris environment for WebSphere Application Server" del redbook IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System.
  4. Riavviare WebSphere per installare l'applicazione Jazz
    Nei seguenti esempi di riga comandi, WASInstallDir rappresenta l'ubicazione dove WebSphere Application Server è installato sul server.
    • Su Windows, il valore predefinito per la directory di installazione di WebSphere è:
      C:\Program Files\IBM\WebSphere\AppServer
      È possibile riavviare il server con i seguenti comandi su Windows:
      cd WASInstallDir\bin 
      stopServer.bat server1 [per un server protetto, includere: -username {utente_LDAP} -password {password_LDAP}] 
      startServer.bat server1
    • Su Linux, il valore predefinito per la directory di installazione di WebSphere è:
      /opt/IBM/WebSphere/AppServer
      È possibile riavviare il server con i seguenti comandi su Linux:
      cd WASInstallDir/bin 
      ./stopServer.sh server1 [per un server protetto, includere: -username {utente_LDAP} -password {password_LDAP}] 
      ./startServer.sh server1
    1. Aprire la console di gestione per WebSphere Application Server.
    2. Fare clic su Applicazioni > Installa nuova applicazione.
    3. Sotto Percorso della nuova applicazione, fare clic su File system locale.
    4. Sotto Percorso completo, immettere:
      JazzInstallDir/server/jazz.war
    5. Impostare Root contesto su /jazz.
    6. Fare clic su Avanti e continuare con le restanti operazioni di Installa nuova applicazione.
    7. Scegliere Fine.
    8. Nella sezione Salva sulla configurazione principale, fare clic su Salva.
    9. Fare clic su Applicazioni > Applicazioni Enterprise.
    10. 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


Feedback

Il supporto è stato valido? È possibile fornire un feedback a Jazz.net (è richiesta la registrazione) lasciando dei commenti nei forum o tramite l'inoltro di un bug