Distribuzione dell'applicazione server Rational Team Concert incluso su Tomcat

IBM® Rational Asset Manager richiede IBM Rational Team Concert, che controlla le funzioni del ciclo di vita che è possibile utilizzare per gestire lo sviluppo degli asset. Se non si dispone già di Rational Team Concert, è inclusa una versione limitata dal prodotto che è possibile distribuire su un server Tomcat.

Prima di iniziare

Se è già stata distribuita e configurata un'applicazione server Rational Team Concert, è possibile utilizzare l'applicazione esistente invece di installare una nuova applicazione. Per configurare Rational Team Concert affinché funzioni con Rational Asset Manager, vedere Configurazione di un server Rational Team Concert affinché funzioni con Rational Asset Manager.

È necessario avere diritto di accesso amministrativo e ai file per un server Tomcat installato e in esecuzione.

Prima di svolgere questa attività, completare le seguenti operazioni:
  1. Richiamo dei file di applicazione
  2. Creazione del database per i cicli di vita

È necessario disporre di un certificato di sicurezza per il server Tomcat. La versione inclusa di Rational Team Concert richiede una connessione sicura.

Informazioni su questa attività

È possibile migliorare le prestazioni e la stabilità di Rational Asset Manager installando le relative applicazioni Web e i file di applicazione per IBM Rational Team Concert incluso, su server Tomcat separati. In questa documentazione, la directory di installazione per il server Tomcat per Rational Asset Manager è indicata come tomcat_install_directory. La directory di installazione per il server Tomcat per Rational Team Concert è tomcat_for_rtc_install_directory. Se tutte le applicazioni Web vengono installate sullo stesso server Tomcat, le directory saranno le stesse.

Procedura

  1. Verificare che tutti i server del repository siano impostati sulla stessa data, ora e fuso orario correnti.
  2. Richiamare i file di applicazione sull'archivio appropriato per Tomcat e per il sistema operativo utilizzato. I file di applicazione si trovano nella cartella archive_extract_location/apps/tomcat/.
  3. Per Windows: Per Linux: Per AIX: Estrarre i file della libreria per Rational Licensing Key Server V8.1.2 nella cartella tomcat_for_rtc_install_directory\shared\lib:
    Importante: Non completare questo passo su Linux per zSeries
    1. Individuare ed estrarre il file archive_extract_location\sharedLibs\rlsclients_rlsibmratl_812.zip.
    2. Nel file .zip decompresso, individuare il file rlsibmratl812.zip per il proprio sistema operativo e la propria architettura. Ad esempio, il file per Windows a 32 bit è nella directory win32.
    3. Estrarre il contenuto del file rlsibmratl812.zip appropriato.
    4. Copiare il contenuto estratto del file rlsibmratl812.zip nella directory tomcat_for_rtc_install_directory\shared\lib.
    Se si installa Rational Asset Manager e Rational Team Concert sullo stesso application server, questo passo è già stato completato.
  4. Nel supporto di installazione, individuare il file archive_extract_location/apps/tomcat/RTC-server.zip.
  5. Estrarre RTC-server.zip in una ubicazione sull'unità disco rigido, indicata in queste istruzioni come dir_installazione_rtc.
  6. Trovare il file dir_installazione_rtc/jazz/server/ramjazz_war.ear ed estrarlo. Per estrarre i file .ear, è possibile utilizzare un programma di utilità gratuito, ad esempio 7-Zip. Dal package ramjazz_war.ear estratto, copiare il file ramjazz.war nella directory tomcat_for_rtc_install_directory/webapps/.
  7. Configurare una porta sicura sul server Tomcat per Rational Team Concert:
    1. Creare un certificato di sicurezza che identifichi il server Tomcat per Rational Team Concert per le connessioni SSL. È possibile utilizzare il comando Java JDK keytool per creare un certificato autofirmato. In alternativa, è possibile richiedere un certificato firmato da un'autorità di certificazione attendibile.
      Per ulteriori informazioni sulla creazione di certificati autofirmati con il comando keytool, consultare la documentazione di Oracle Java. È possibile creare un certificato autofirmato con il seguente comando di esempio keytool:
      keytool -genkey -alias tomcat -keystore tomcat_for_rtc_install_directory/.keystore

      Quando si esegue questo comando, verrà richiesta una password per il file di archivio chiavi. La password predefinita è changeit, e sarà necessario specificarne una diversa. Prendere nota della password che dovrà essere successivamente immessa nel file server.xml.

      Se si utilizza un IBM JRE, molte versioni includono il tool IBM ikeyman nella directory ubicazione_installazione_IBM_Java_JRE/jre/bin/. È possibile utilizzare questo tool per creare e gestire certificati di sicurezza sul server. Per ulteriori informazioni sull'uso del tool iKeyman, consultare la iKeyman User's Guide.

      È incluso anche un certificato semplice nella cartella dir_installazione_rtc/jazz/server/; il file del certificato è ibm-team-ssl.keystore

    2. Nel file tomcat_for_rtc_install_directory\conf\server.xml, individuare il tag <Connector> con l'attributo scheme="https". Il file predefinito include un tag <Connector> di esempio per la porta 8443 con commento.
    3. Copiare e incollare il seguente testo:
      <Connector port="8443"
           maxHttpHeaderSize="8192" 
           maxThreads="150"
           minSpareThreads="25" 
           maxSpareThreads="75"
           enableLookups="false"
           disableUploadTimeout="true"
           connectionTimeout="20000"
           acceptCount="100"
           scheme="https"
           secure="true" 
           clientAuth="false"
           keystoreFile="keystore_file"
           keystorePass="keystore_password"
           sslProtocol="keystore_protocol"
           algorithm="keystore_algorithm"
           URIEncoding="UTF-8" />
      Dove:
      • keystore_file è il nome file del file di archivio chiavi. Può essere un percorso assoluto o relativo a partire dalla directory root del server Tomcat (tomcat_for_rtc_install_directory). Se è stato utilizzato il comando semplice, sarà .keystore. Se si utilizza il certificato incluso, sarà dir_installazione_rtc/jazz/server/ibm-team-ssl.keystore.
      • keystore_password è la password del file di archivio chiavi. Se si utilizza il file di archivio chiavi incluso, è ibm-team .
      • keystore_protocol è il protocollo per l'archivio chiavi. Molto probabilmente è TLS o SSL_TLS. Se si utilizza il file di archivio chiavi incluso, è SSL_TLS .
      • keystore_algorithm è l'algoritmo X509 per l'archivio chiavi. Molto probabilmente è SunX509 o IbmX509, in base all'origine del certificato. Se si utilizza il file di archivio chiavi incluso, è IbmX509 .
    4. È possibile modificare il valore porta per utilizzare una porta accanto a 8443 per il connettore non SSL (per impostazione predefinita, la porta 8080). Se si modifica il valore della porta, modificare anche il valore dell'attributo redirectPort in modo che corrisponda al numero di porta del connettore SSL.

    Per ulteriori informazioni sulla configurazione di SSL per Tomcat, vedere Apache Tomcat 5.5 SSL Configuration HOW-TO e Apache Tomcat Configuration reference.

  8. Per Oracle:Per Microsoft SQL Server: Copiare il file .jar appropriato dal provider del database:
    • Per Oracle: Copiare il file ojdbc14.jar nella cartella dir_installazione_rtc/jazz/server/oracle (potrebbe essere necessario creare la cartella oracle).

      È possibile scaricare il file da Oracle. Se si utilizza Oracle 11, scaricare il package di Oracle 10g per individuare il file ojdbc14.jar.

    • Per Microsoft SQL Server: Copiare il seguente file nella cartella dir_installazione_rtc/jazz/server/sqlserver (potrebbe essere necessario creare la cartella sqlserver):
      • sqljdbc.jar (È possibile scaricare questo file da Microsoft).
  9. Configurare le impostazioni della proprietà di avvio di Tomcat:
    1. Individuare il file di avvio Tomcat ed aprirlo in un editor di testo. Su Windows, questo file è tomcat_for_rtc_install_directory\bin\startup.bat. Su Linux, AIX o Linux for zSeries, il file è tomcat_for_rtc_install_directory/bin/startup.sh.
    2. Nel file di avvio, immettere il seguente testo:
      • Per Windows: Sostituire ogni carattere spazio in dir_installazione_rtc con %20:
        set ORACLE_JDBC=oracle_jar_dir
        set SQLSERVER_JDBC=sqlServer_jar_dir
        set JAZZ_INSTALL_DIR=dir_installazione_rtc
        set JAVA_OPTS=-Djava.awt.headless=true -Djava.library.path="tomcat_for_rtc_install_directory\shared\lib" -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
      • Per Linux:Per AIX:Per Linux per zSeries:
        ORACLE_JDBC=oracle_jar_dir
        SQLSERVER_JDBC=sqlServer_jar_dir
        JAZZ_INSTALL_DIR=dir_installazione_rtc
        export JAVA_OPTS="-Djava.awt.headless=true -Djava.library.path=tomcat_for_rtc_install_directory/shared/lib -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
      Dove:
      • dir_installazione_rtc è la directory estratta del file RTC-server.zip. In Windows, sostituire ogni carattere spazio in dir_installazione_rtc con %20
      • Per Oracle: oracle_jar_dir è la directory per il file ojdbc14.jar (dir_installazione_rtc/jazz/server/oracle)
      • Per Microsoft SQL Server: sqlServer_jar_dir è la directory del file sqljdbc.jar (dir_installazione_rtc/jazz/server/sqlserver)
      • tomcat_for_rtc_install_directory è la directory di installazione per il server Tomcat
      • Per Windows: Per Linux:Per AIX: Se si sta installando Rational Asset Manager e Rational Team Concert sullo stesso application server, utilizzare la variabile di sistema JAVA_OPTS per sostituire la variabile creata durante la configurazione dello script di avvio per il server Tomcat per Rational Asset Manager; questa dichiarazione include ancora l'opzione -Djava.library.path.
  10. Trovare e ridenominare il file delle proprietà del server Jazz appropriato:
    1. Nella directory dir_installazione_rtc/jazz/server/conf/ramjazz/, individuare il file teamserver.properties e ridenominarlo in teamserver.derby.properties.
    2. Individuare il file appropriato per il server di database utilizzato:
      • Per DB2:Per Windows:Per DB2 su Windows: teamserver.db2.win32.properties
      • Per DB2:Per Linux:Per AIX:Per Linux per zSeries:Per DB2 su Linux, AIX o Linux per zSeries: teamserver.db2.linux.properties
      • Per Oracle: teamserver.oracle.properties
      • Per SQL Server: teamserver.sqlserver.properties
    3. Ridenominare il file in teamserver.properties.
  11. In un editor di testo, aprire il file teamserver.properties e modificarlo come segue (per il provider del database):
    • Per DB2:
      1. Individuare le seguenti righe:
        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
      2. Modificare il valore di com.ibm.team.repository.db.jdbc.location per l'ubicazione del server DB2 utilizzato e il nome del database per i cicli di vita:
        1. Sostituire localhost:50000 con il percorso e la porta del database DB2.
          Suggerimento: Nella finestra comandi DB2, immettere db2 get dbm cfg, quindi individuare la riga che contiene SVCENAME, che indica il nome o il numero della porta DB2. Se questo comando visualizza un numero, utilizzarlo come numero di porta (invece di 50000 riportato nell'esempio precedente). Se il comando restituisce un nome non numerico, determinare il numero di porta assegnato a questo nome ed utilizzarlo come numero di porta. Su Linux, il file /etc/services contiene l'associazione tra i nomi e i numeri di porta; su Windows, il file C:\windows\system32\drivers\etc\services contiene l'associazione. Per ulteriori informazioni, rivolgersi all'amministratore del database o consultare la documentazione del database.
        2. Sostituire JAZZ con il nome del database per i cicli di vita.
        3. Sostituire db2admin con il nome utente per il database DB2.
          Nota: L'utente DB2 deve avere le autorizzazioni per creare le tabelle, i tablespace e per modificare la configurazione del database. Gli utenti DB2 vengono creati dal sistema operativo.
      3. Nella proprietà com.ibm.team.repository.db.jdbc.password, specificare la password dell'utente.
        Nota: Non modificare il testo password={password} nella proprietà com.ibm.team.repository.db.jdbc.location.
      4. Nel file teamserver.properties, aggiungere le seguenti proprietà:
        Dove:
        • porta_non_sicura è la porta non sicura per il server Tomcat (per impostazione predefinita, 8080)
        • porta_sicura è il numero della porta sicura per il server Tomcat (per impostazione predefinita, 8443)
        • dir_temp_team è un percorso assoluto di una directory per la memorizzazione dei file temporanei
        com.ibm.team.scm.tmpdir=dir_temp_team
        com.ibm.team.repository.server.repourl.port.http=porta_non_sicura
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=porta_sicura
    • Per Oracle:
      1. Individuare le seguenti righe:
        com.ibm.team.repository.db.vendor = ORACLE
        com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. Modificare il valore di com.ibm.team.repository.db.jdbc.location per l'ubicazione del server Oracle utilizzato e il nome del database per i cicli di vita:
        1. Sostituire jazzDBUser con il nome utente per il database Oracle (ad esempio, RAMSCHEMA).
        2. Sostituire @localhost:1521 con l'ubicazione e la porta del database Oracle. Se l'ubicazione non è localhost, è necessario anteporre all'ubicazione due barre retroverse (//); ad esempio, @//oracleserver.example.com:1521.
        3. Sostituire ORCL con il nome del database del ciclo di vita; ad esempio rtcdb.
      3. Nella proprietà com.ibm.team.repository.db.jdbc.password, sostituire JazzDBpswd con la password per l'utente Oracle specificata precedentemente.
        Nota: Non modificare il testo {password} nella proprietà com.ibm.team.repository.db.jdbc.location.
      4. Nel file teamserver.properties, aggiungere le seguenti proprietà:
        Dove:
        • porta_non_sicura è la porta non sicura per il server Tomcat (per impostazione predefinita, 8080)
        • porta_sicura è il numero della porta sicura per il server Tomcat (per impostazione predefinita, 8443)
        • dir_temp_team è un percorso assoluto di una directory per la memorizzazione dei file temporanei
        com.ibm.team.scm.tmpdir=dir_temp_team
        com.ibm.team.repository.server.repourl.port.http=porta_non_sicura
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=porta_sicura
      5. Se si utilizza Oracle 11: nel file teamserver.properties, aggiungere la seguente proprietà:
        com.ibm.team.repository.db.override.versioncheck=true
    • Per Microsoft SQL Server:
      1. Individuare le seguenti righe:
        com.ibm.team.repository.db.vendor = SQLSERVER
        com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. Modificare il valore di com.ibm.team.repository.db.jdbc.location per l'ubicazione di SQL Server utilizzato e il nome del database per i cicli di vita:
        1. Sostituire @localhost:1433 con l'ubicazione e la porta del database SQL Server.
        2. Sostituire jazz con il nome del database del ciclo di vita; ad esempio, RTCDB.
        3. Sostituire jazzDBUser con il nome utente per il database SQL Server.
      3. Nella proprietà com.ibm.team.repository.db.jdbc.password, sostituire JazzDBpswd con la password per l'utente SQL Server specificato in precedenza.
        Nota: Non modificare il testo {password} nella proprietà com.ibm.team.repository.db.jdbc.location.
      4. Nel file teamserver.properties, aggiungere le seguenti proprietà:
        Dove:
        • porta_non_sicura è la porta non sicura per il server Tomcat (per impostazione predefinita, 8080)
        • porta_sicura è il numero della porta sicura per il server Tomcat (per impostazione predefinita, 8443)
        • dir_temp_team è un percorso assoluto di una directory per la memorizzazione dei file temporanei
        com.ibm.team.scm.tmpdir=dir_temp_team
        com.ibm.team.repository.server.repourl.port.http=porta_non_sicura
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=porta_sicura
  12. Creare le tabelle per Rational Team Concert:
    1. Aprire una finestra di riga comandi e passare alla directory dir_installazione_rtc/jazz/server/.
    2. Immettere il seguente comando:
      • Per Windows:
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • Per Linux:Per AIX:Per Linux per zSeries:
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  13. Configurare il server Tomcat per la sicurezza utenti. Se si desidera utilizzare la sicurezza LDAP, utilizzare prima la sicurezza basata su file per configurare le applicazioni, e dopo aver configurato le applicazioni, passare all'autenticazione LDAP. Per ulteriori informazioni, vedere Configurazione autenticazione LDAP per Tomcat.
    1. In un editor di testo, aprire il file tomcat_for_rtc_install_directory\conf\tomcat-users.xml. Nuovamente, se le applicazioni vengono installate nello stesso server Tomcat, questo file è lo stesso file in cui sono state modificate le impostazioni di sicurezza utente per le applicazioni Rational Asset Manager.
    2. Tra i tag <tomcat-users>, immettere il seguente testo:
      <role rolename="JazzUsers"/>
      <role rolename="JazzAdmins"/>
      <role rolename="JazzDWAdmins"/>
      <role rolename="JazzGuests"/>
    3. Aggiungere un utente chiamato admin ed assegnare a tale utente i ruoli admin, manager e JazzAdmins. Per aggiungere questo utente, copiare ed incollare il seguente testo tra i tag <tomcat-users>
      <user username="admin" password="" roles="admin,manager,JazzAdmins" />

      Se le applicazioni vengono installate sullo stesso server Tomcat, aggiungere il ruolo JazzAdmins all'utente creato quando sono state modificate le impostazioni di sicurezza utente per le applicazioni Rational Asset Manager.

  14. Avviare il server Tomcat per Rational Team Concert.
    Per avviare Tomcat, eseguire il seguente file:
    • Per Windows:tomcat_for_rtc_install_directory\bin\startup.bat
    • Per Linux:Per AIX:Per Linux per zSeries:tomcat_for_rtc_install_directory/bin/startup.sh
  15. Configurare Rational Team Concert affinché funzioni con Rational Asset Manager. È necessario configurare i diritti amministrativi e creare una project area in Rational Team Concert.

Feedback