Aggiornamento di una versione precedente su Tomcat

Utilizzare questa guida per aggiornare una versione precedente di IBM® Rational Asset Manager su Apache Tomcat.

Prima di iniziare

Importante: Se si desidera effettuare un aggiornamento da Rational Asset Manager, Versione 7.1.1.1 o da una versione precedente, è necessario installare IBM Rational Team Concert, che richiede un ulteriore database e un certificato sicuro per il server Tomcat.

È necessario aggiornare il server delle licenze e compilare una richiesta per le chiavi di licenza aggiornate. Per ulteriori informazioni sulla versione richiesta di Rational License Server, vedere Installazione di Rational License Key Server.

Sarà anche necessario arrestare e riavviare l'application server diverse volte

È 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.

Informazioni su questa attività

Questa struttura mostra le operazioni necessarie per eseguire l'aggiornamento all'ultima versione di Rational Asset Manager:
  1. Prepararsi ad eseguire l'aggiornamento e il backup dei file importanti e dei database: passi 14.
  2. Richiamare i file dell'applicazione dell'ultima versione di Rational Asset Manager: passo 5.
  3. Se l'aggiornamento viene effettuato dalla versione 7.1.1.1 o precedente, creare un database aggiuntivo: passo 6.
  4. Chiudere il server Tomcat: passo 7.
  5. Aggiornare il server delle licenze a Rational Common Licensing 8.1.2: passo 8.
  6. Copiare i nuovi file dell libreria condivisa di Rational Asset Manager e di Rational Common Licensing 8.1.2 e modificare di conseguenza i file di avvio del server Tomcat: passi 911.
  7. Configurare il server Tomcat per il single sign-on: passo 12.
  8. Richiamare i file dell'applicazione corrente per il Rational Team Concert incluso: passi 1314.
  9. Se l'aggiornamento viene effettuato dalla versione V7.1.1.1 o precedente e si necessita di Rational Team Concert, installarlo sull'application server: passi 1724.
  10. Se l'aggiornamento viene effettuato dalla versione V7.1.1.1 o precedente, configurare Rational Team Concert: passi 2531.
  11. Se l'aggiornamento viene effettuato dalla versione 7.2 o precedente, aggiornare il Rational Team Concert incluso: passo 33.
  12. Rimuovere i file dell'applicazione esistente per Rational Asset Manager ed installare le nuove versioni delle applicazioni: passi 3439.
  13. Accedere a Rational Asset Manager e migrare il repository: passo 40.
  14. Se l'aggiornamento viene effettuato dalla V7.1.1.1 o precedente, configurare Rational Asset Manager per la connessione a Rational Team Concert: passo 42.
  15. Modificare le impostazioni per la connessione al nuovo server Rational Common Licensing: passo 43.
  16. Aggiornare gli eventuali client Eclipse: passo 44.

Procedura

  1. Prima di effettuare l'aggiornamento, creare una copia di backup completa del repository, database, file di asset e impostazioni dell'application server attenendosi alle istruzioni riportate in Creazione di un backup di un repository Rational Asset Manager.
  2. Se il tema o i messaggi email sono stati modificati, prima di aggiornare il server Rational Asset Manager, scaricare il tema corrente e i file dei messaggi di posta (nella pagina Amministrazione > Tool) quindi, dopo aver aggiornato il server, riapplicare il tema e i messaggi. Per ulteriori informazioni, vedere Migrazione del tema.
  3. Verificare che tutti i server del repository siano impostati sulla stessa data, ora e fuso orario correnti.
  4. Se si utilizza Rational Asset Manager, versione 7.0.0.2 o precedente, verificare che il job server sia abilitato. Per abilitare il job server:
    1. Accedere al client Web Rational Asset Manager come amministratore del repository.
    2. Fare clic su Amministrazione.
    3. Nella barra laterale di Amministrazione repository, fare clic su Strumenti.
    4. Nella barra dell'indirizzo del browser, sostituire tools.faces con advancedConfiguration.faces ed andare a tale indirizzo. Ad esempio, http://example.com:9080/com.ibm.ram.repository.web/admin/repository/advancedConfiguration.faces
    5. Nella pagina Impostazioni avanzate, nella sezione Opzioni job, selezionare Abilita job server.
    6. Fare clic su Salva.
    7. Riavviare l'application server.
  5. 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/.
  6. Se l'aggiornamento viene effettuato a partire dalla versione 7.1.1.1 o da una versione precedente: creare il database per i cicli di vita dell'asset:
  7. Arrestare il server o i server Tomcat. Il repository e tutte le altre applicazioni sul server dovranno essere offline.
  8. Per Windows:Per Linux:Per AIX: Migrare Rational Licensing Server a Rational Common Licensing V8.1.2 o a una versione successiva. Per ulteriori informazioni, vedere Migrazione da Rational Licensing Server v7.1.x o da una versione precedente a Rational Common Licensing.

    Rational License Key Server è incluso nel supporto di installazione di Rational Asset Manager. È anche possibile richiamare l'ultima versione di Rational License Server mediante l'account Passport Advantage o nel Rational Download Center.

    Per eseguire questo processo sarà necessario chiudere tutte le applicazioni che utilizzano Rational Licensing Server, disinstallare il Rational Licensing Server esistente, aggiornare i file di licenza e installare il server Rational Common Licensing. Per Windows, vedere Configurazione di un server delle licenze per Windows; per AIX o Linux, vedere Configurazione di un server delle licenze per UNIX.

    Per Linux per zSeries, continuare ad utilizzare Rational License Server per UNIX e Linux 7.0.0.1.
  9. Estrarre i file della libreria condivisa nella cartella \shared\lib per i server Tomcat:
    1. Individuare ed estrarre il file archive_extract_location\apps\tomcat\sharedLib.zip.
    2. Copiare l'intero contenuto del file sharedLib.zip estratto nella directory tomcat_install_directory\shared\lib.
  10. Per Windows: Per Linux: Per AIX: Estrarre i file della libreria per Rational Licensing Key Server V8.1.2 nella cartella tomcat_install_directory\shared\lib:
    Importante: Se l'installazione viene effettuata su Linux for zSeries, non completare questo passo
    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 l'intero contenuto del file rlsibmratl812.zip estratto nella directory tomcat_install_directory\shared\lib.
  11. Per Windows:Per Linux:Per AIX: Modificare lo script di avvio per il server Tomcat per Rational Asset Manager
    1. Individuare il file di avvio Tomcat ed aprirlo in un editor di testo. Su Windows, questo file è tomcat_install_directory\bin\startup.bat. Su Linux, AIX o Linux per zSeries è tomcat_install_directory/bin/startup.sh.
    2. Cercare una riga che contiene JAVA_OPTS=.
      • Se la variabile di ambiente JAVA_OPTS è già impostata, aggiungere la seguente opzione e valore:
        • Per Windows:
          -Djava.library.path="tomcat_install_directory\shared\lib"
        • Per Linux:Per AIX:
          -Djava.library.path=tomcat_install_directory/shared/lib
      • Se la variabile di ambiente JAVA_OPTS non è impostata, immettere il seguente testo:
        • Per Windows:
          set JAVA_OPTS=-Djava.library.path="tomcat_install_directory\shared\lib"
        • Per Linux:Per AIX:
          export JAVA_OPTS="-Djava.library.path=tomcat_install_directory/shared/lib"
  12. Configurare il server Tomcat per accessi singoli per tutte le applicazioni:
    1. In un editor di testo, aprire il file tomcat_install_directory\conf\server.xml.
    2. Ricercare il seguente testo:
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. Eliminare il commento all'elemento <Valve>:
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  13. Nel supporto di installazione, individuare il file archive_extract_location/apps/tomcat/RTC-server.zip.
  14. Estrarre RTC-server.zip in una ubicazione sull'unità disco rigido, indicata in queste istruzioni come dir_installazione_rtc.
  15. In base alla situazione, installare e configurare o aggiornare Rational Team Concert:
    • Se l'aggiornamento viene effettuato dalla versione 7.1.1.1 o da una versione precedente: installare e configurare Rational Team Concert incluso. Procedere con l'operazione 16.
    • Se l'aggiornamento viene effettuato dalla versione 7.2 o da una versione successiva: aggiornare Rational Team Concert incluso. Procedere con l'operazione 33.
  16. In base alla situazione, installare e configurare o solo configurare Rational Team Concert:
    • Se è necessario installare e configurare Rational Team Concert: passare al passo 17.
    • Se si dispone di un'applicazione Rational Team Concert esistente e si desidera configurarla affinché funzioni con Rational Asset Manager: passare al passo 25.
  17. 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/.
  18. 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.

  19. 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).
  20. 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.
  21. 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.
  22. 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
  23. 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
  24. Configurare l'autorizzazione utente per Rational Team Concert incluso.
    • Per la sicurezza basata su file:
      1. In un editor di testo, aprire il file tomcat_for_rtc_install_directory\conf\tomcat-users.xml.
      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 si sta effettuando l'installazione delle applicazioni sullo stesso server Tomcat, aggiungere il ruolo JazzAdmins all'utente admin esistente.

    • Per l'autenticazione LDAP: configurare il server Tomcat per l'autenticazione LDAP, quindi configurare quattro gruppi LDAP con gli stessi nomi dei quattro ruoli precedentemente menzionati. In alternativa, è possibile associare i gruppi LDAP esistenti ai ruoli del server Jazz come descritto nel Tech Tip TN0030: User Management in Tomcat. Seguire i passi 23 nella sezione Configurazione di Rational Team Concert su Tomcat affinché utilizzi LDAP dell'argomento.
  25. 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
  26. Avviare l'interfaccia Web di amministrazione di Rational Team Concert in un browser Web all'indirizzo https://nome_macchina:porta_sicura/jazz/admin/. Osservare https; la connessione deve essere sicura.
  27. Accedere con l'ID utente e la password dell'amministratore di Rational Team Concert. Se nessun utente ha ancora effettuato l'accesso a Rational Team Concert, utilizzare l'ID utente e la password dell'amministratore dell'application server.
  28. Se si utilizza una nuova installazione di Rational Team Concert: configurare l'utente di amministrazione per Rational Team Concert:
    1. Se si presenta un errore sul "richiamo delle informazioni sullo stato del server", chiudere e riavviare sia il server di database che l'application server ed effettuare nuovamente l'accesso.
    2. Nell'interfaccia Web di amministrazione di Rational Team Concert, fare clic su Gestione utente. Ignorare eventuali errori su un registro esterno non configurato.
    3. Fare clic su Crea utente.
    4. Immettere i seguenti dettagli:
      1. Nome utente: l'ID utente dell'amministratore dell'application server
      2. ID utente: l'ID utente dell'amministrazione dell'application server
      3. Indirizzo email: un indirizzo email valido per l'amministratore dell'application server
    5. Nella sezione Licenza per l'accesso al client, selezionare Rational Team Concert - Sviluppatore per assegnare la licenza di sviluppatore a tale utente.
    6. Fare clic su Salva.
    7. Scollegarsi, quindi accedere nuovamente all'interfaccia Web di amministrazione come amministratore dell'application server.
  29. Importare il template del processo dei cicli di vita in Rational Team Concert:
    1. Nell'interfaccia Web di amministrazione di Rational Team Concert, fare clic su Gestione template di processo. Se non è possibile visualizzare il link Gestione template di processo, scollegarsi ed accedere nuovamente all'interfaccia Web di amministrazione.
    2. Fare clic su Importa template e passare al file com.ibm.ram.lifecycle.zip nella cartella archive_extract_location/DatabaseScripts/. Fare clic su OK. Viene visualizzato il template del ciclo di vita RAM.
  30. Creare una nuova project area in Rational Team Concert:
    1. Nell'interfaccia Web di amministrazione di Rational Team Concert, fare clic su Gestione project area. Se non è possibile visualizzare il link Gestione project area, scollegarsi ed accedere nuovamente all'interfaccia Web di amministrazione.
    2. Fare clic su Crea project area.
    3. Immettere i seguenti dettagli relativi alla project area:
      • Nome progetto: Ciclo di vita RAM
      • Riepilogo: Project area controllo ciclo di vita Rational Asset Manager
      • Descrizione: Quest'area è utilizzata per gestire i cicli di vita per Rational Asset Manager
    4. Fare clic su Salva.
  31. Assegnare i membri e i ruoli progetto appropriati per la project area:
    1. Nella pagina Gestione project area, fare clic sulla project area Ciclo di vita RAM.
    2. Nella sezione Amministratori, fare clic su Aggiungi. Ricercare e selezionare l'utente amministratore creato. Se si utilizza un'applicazione+ Rational Team Concert esistente, è anche possibile selezionare un utente diverso come amministratore di questa project area.
    3. Nella sezione Membri, fare clic su Aggiungi; quindi cercare e selezionare lo stesso utente selezionato come amministratore della project area.
    4. Dopo aver aggiunto l'amministratore, fare clic sull'icona Ruoli del processo accanto al nome dell'amministratore.
    5. Nella finestra Modifica ruoli del processo, nell'elenco Ruoli disponibili, selezionare Amministrazione e fare clic su Aggiungi.
    6. Fare clic su Fine.
    7. Fare clic su Salva.
  32. Se l'aggiornamento viene effettuato dalla versione 7.1.1.1 o da una versione precedente: procedere con il passo 34.
  33. Se l'aggiornamento viene effettuato dalla versione 7.2 o da una versione successiva, aggiornare Rational Team Concert incluso:
    1. Dal supporto di installazione, estrarre il file RTC-Server.zip in una nuova ubicazione sull'unità disco rigido, che in queste istruzioni è indicata come nuova_rtc_install_dir.
    2. Dalla vecchia cartella rtc_install_dir/jazz/server/conf/jazz/, copiare il file teamserver.properties nella nuova cartella nuova_rtc_install_dir/jazz/server/conf/jazz/.

      L'ubicazione rtc_install_dir esistente è riportata nel file di avvio di Tomcat. Nel file di avvio, cercare la riga che contiene JAZZ_INSTALL_DIR=; il valore della variabile JAZZ_INSTALL_DIR è il percorso dei file Rational Team Concert correnti.

    3. 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.
    4. Nel file di avvio Tomcat, cercare la riga che contiene JAZZ_INSTALL_DIR=. Modificare il valore dei seguenti elementi, dove nuova_rtc_install_dir è la directory estratta al passo 33.a:
      • Per Windows: (sostituire i caratteri spazio in nuova_rtc_install_dir con %20 ):
        set JAZZ_INSTALL_DIR=nuova_rtc_install_dir
      • Per Linux:Per AIX:Per Linux per zSeries::
        JAZZ_INSTALL_DIR=nuova_rtc_install_dir
    5. Avviare il server Tomcat.
    6. In un browser Web, immettere il seguente URL: https://host:porta_sicura/jazz/admin?internal, dove host è l'indirizzo IP o il nome server, e porta_sicura è la porta sicura per il server Tomcat.
    7. Accedere come amministratore dell'application server.
    8. Nella barra laterale, in Tool interni, fare clic su Reimposta server.
    9. Fare clic su Richiedi reimpostazione server.
    10. Arrestare e riavviare il server Tomcat. L'applicazione inclusa Rational Team Concert è adesso aggiornata.
  34. Arrestare il server Tomcat per Rational Asset Manager.
  35. Rimuovere i vecchi file di applicazione Web .war di Rational Asset Manager installati su Tomcat:
    1. Passare alla directory tomcat_install_directory/webapps/.
    2. Prendere nota dei nomi delle cartelle e dei file per ogni applicazione Web Rational Asset Manager. Nelle versioni precedenti di Rational Asset Manager, erano suggeriti i seguenti nomi per tali cartelle (in altre parole, i percorsi di contesto delle applicazioni):
      • /com.ibm.ram.repository.web.tomcat_runtime
      • /com.ibm.ram.repository.web.ws.tomcat_runtime
      • /help/
      • /abdprocess/
    3. Eliminare i seguenti file delle applicazioni:
      • com.ibm.ram.repository.web.tomcat_runtime.war
      • com.ibm.ram.repository.web.ws.tomcat_runtime.war
      • ramhelp.war
      • rmcabdgovernprocess.war
      I nomi file potrebbero essere diversi dai nomi nell'elenco, in base al tipo di installazione effettuato per le applicazioni sul server.
    4. Eliminare le cartelle associate per tali applicazioni.
  36. Dalla directory archive_extract_location/apps/tomcat/, copiare i seguenti file nella directory tomcat_install_directory/webapps/:
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • ramhelp.war
    • rmcabdgovernprocess.war
  37. Per modificare il percorso di contesto delle applicazioni, ridenominare i file di applicazione WAR. Utilizzare gli stessi percorsi di contesto precedenti. I nomi dei file e i percorsi del contesto per le nuove installazioni sono i seguenti:
    Tabella 1. Percorsi di contesto per i file di applicazione Web di Rational Asset Manager
    Nome file originale Nuovo nome file Percorso di contesto risultante Cos'è?
    com.ibm.ram.repository.web.tomcat_runtime.war ram.war ram Applicazione Web principale Rational Asset Manager per Tomcat
    com.ibm.ram.repository.web.ws.tomcat_runtime.war ram.ws.war ram.ws Applicazione di servizi Web Rational Asset Manager per Tomcat
    ramhelp.war ram.help.war ram.help Applicazione di guida e assistenza utenti Rational Asset Manager
    rmcabdgovernprocess.war ram.process.war ram.process Applicazione di documentazione per lo sviluppo basato su asset e la gestione dei processi
  38. Svuotare la cache per il server Tomcat. Eliminare la directory tomcat_install_directory/work/.
  39. Riavviare il server Tomcat per Rational Asset Manager.
  40. Migrare il repository Rational Asset Manager alla versione più recente:
    1. In un browser Web, aprire il client Web Rational Asset Manager. La prima volta in cui si apre il client Web dopo l'aggiornamento, viene visualizzato un messaggio che indica che è necessario migrare il repository.
    2. Se necessario, accedere con un ID utente con autorità di amministratore repository.
      Nota: Per SQL Server, se un database Rational Asset Manager non ha la serie di collazione in una sequenza che termina con _BIN2 (ad esempio, Latin1_General_BIN2) verrà visualizzata la pagina Configurazione manuale richiesta contenente un messaggio. Sarà possibile quindi ricreare il database ed impostare l'opzione di collazione in modo che rilevi la differenza tra maiuscole e minuscole affinché funzioni correttamente con Rational Asset Manager o accettare che possano verificarsi conflitti non previsti relativi alla differenza tra maiuscole e minuscole.
    3. Fare clic su Migra. Per i repository di grandi dimensioni, la migrazione potrebbe richiedere alcuni minuti; durante la migrazione alcune informazioni contenute nel repository potrebbero non essere disponibili.
    4. Al termine del processo di migrazione, fare clic su Home.
  41. Dopo aver migrato il repository, arrestare e riavviare l'application server.
  42. Se l'aggiornamento viene effettuato dalla versione 7.1.1.1 o da una versione precedente: configurazione delle impostazioni per la connessione a Rational Team Concert da Rational Asset Manager:
    1. Nel client Web Rational Asset Manager, fare clic su Amministrazione.
    2. Fare clic su Configurazione.
    3. Nella sezione Percorso interno di Rational Team Concert, immettere le seguenti informazioni:
      1. Percorso: l'URL sicuro del server Rational Team Concert configurato. Ad esempio, https://localhost:9443/ramjazz. Prendere nota della connessione https e del numero della porta sicura.
      2. Utente: il nome dell'utente in Rational Team Concert amministratore per la project area "Cicli di vita RAM".
      3. Password: la password per l'utente amministratore della project area "Cicli di vita RAM".
      4. Timeout: la quantità di tempo, in secondi, per consentire a Rational Asset Manager di stabilire una connessione a Rational Team Concert. L'impostazione predefinita è 120.
  43. Per l'aggiornamento, è necessario inviare una richiesta per una nuova chiave di licenza. Sarà necessario acquisire una nuova licenza server e nuove licenze utente autorizzato. Andare al Centro chiavi di licenza Rational: http://www-01.ibm.com/software/rational/support/licensing/ Se viene visualizzato un errore relativo a Rational License Server, regolare la configurazione della licenza:
    1. Fare clic su Amministrazione
    2. Nella pagina Amministrazione, fare clic su Configurazione.
    3. Nella sezione Licenza e versione, per selezionare il tipo di licenza che verrà utilizzata da questo repository, selezionare Standard Edition o Enterprise Edition.
    4. Nella parte inferiore della pagina, fare clic su Salva.
    5. È possibile che venga visualizzato nuovamente l'errore relativo al server delle licenze. Fare clic su Riprova connessione al server delle licenze.
  44. Aggiornare l'applicazione Rational Asset Manager Eclipse utilizzando lo stesso metodo utilizzato per installarla. Per ulteriori informazioni sull'installazione del client Eclipse, vedere Installazione del client Eclipse Rational Asset Manager.
    Nota: Prima di installare l'ultima versione del client Eclipse Rational Asset Manager, disinstallare il plug-in del client Eclipse Rational Asset Manager.

    Se è stato installato il client Eclipse Rational Asset Manager V7.0.0.2 in un'applicazione Eclipse V3.3 esistente utilizzando Installation Manager, utilizzare Installation Manager per disinstallare il client. Non è possibile utilizzare Eclipse Configuration Manager per disinstallare Rational Asset Manager dal client Eclipse.

    Se i plug-in del client Eclipse Rational Asset Manager sono stati installati utilizzando il gestore aggiornamenti Eclipse, prima di installare l'ultima versione di Rational Asset Manager, utilizzare il gestore aggiornamenti Eclipse per rimuovere qualsiasi funzione chiamata Rational Asset Manager. Per utilizzare il gestore della configurazione Eclipse, fare clic su Guida > Aggiornamenti software > Gestisci configurazione.


Feedback