Distribuzione degli application server Rational Asset Manager su Tomcat 5.5

È possibile installare manualmente IBM® Rational Asset Manager su un'installazione di Apache Tomcat.

Prima di iniziare

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

È necessario conoscere l'ubicazione dei seguenti file JDBC .jar per il server di database:
  • Per IBM DB2:db2jcc_license_cu.jar e db2jcc.jar
  • Per Oracle:ojdbc5.jar. Se si utilizza Oracle 10, utilizzare comunque il file ojdbc5.jar per Oracle 11. È possibile scaricare i file da Oracle.
  • Per Microsoft SQL Server:sqljdbc.jar. È possibile scaricare i file da Microsoft.

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.

Nota: Se si desidera distribuire Rational Asset Manager e Rational Team Concert incluso su diverse applicazioni server Tomcat sulla stessa macchina, assicurarsi di aver configurato i diversi server Tomcat affinché utilizzino diverse porte sicure e non sicure per evitare conflitti. Per ulteriori informazioni sulle porte in Tomcat 5.5, consultare la documentazione di Apache Tomcat.

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. Estrarre i file della libreria condivisa nella cartella tomcat_install_directory\shared\lib:
    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.
    3. Se si desidera installare Rational Team Concert su un server Tomcat diverso, copiare il contenuto estratto dal file sharedLib.zip nella directory tomcat_for_rtc_install_directory\shared\lib dell'altro server Tomcat.
  4. 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.
  5. Per Windows: Per Linux:Per AIX: Modificare lo script di avvio per il server Tomcat per Rational Asset Manager:
    Importante: Se l'installazione viene effettuata su Linux for zSeries, non completare questo passo
    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. Nel file di avvio, 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"
  6. 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
  7. Per modificare il percorso di contesto delle applicazioni, ridenominare i file di applicazione WAR. Utilizzare i seguenti nomi.
    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
  8. Configurare il server Tomcat affinché Rational Asset Manager possa accedere al database:
    1. In un editor di testo, aprire il file tomcat_install_directory\conf\server.xml.
    2. Individuare tutte le righe in server.xml che iniziano con <Connector e che contengono port="8080" o port="8009". Modificare l'inizio di queste righe in <Connector URIEncoding="UTF-8".
    3. Tra i tag di apertura e chiusura per le risorse Global JNDI, <GlobalNamingResources> e </GlobalNamingResources>, immettere il seguente testo per la propria versione di Tomcat.
      Nota: Per i valori nome_utente e password, immettere un ID utente e una password con accesso di amministrazione completo al database. Ad esempio, l'attributo "url" potrebbe essere jdbc:db2://localhost:50000/RAMDB
    Immettere questo testo per il proprio server di database, sostituendo le seguenti variabili:
    • Negli attributi username e password, sostituire nome_utente e password con un ID utente e una password con pieno accesso di amministrazione al database server.
    • Nell'attributo url, sostituire nome_server_completo e numero_porta_database con l'indirizzo server e il numero di porta per il database e sostituire nome_database_Rational_Asset_Manager con il nome del database per gli asset. Ad esempio, per DB2, l'attributo url potrebbe essere simile a jdbc:db2://localhost:50000/RAMDB.
    • I valori mostrati per maxWait, maxActive e maxIdle sono valori di esempio e possono essere modificati in base alle prestazioni richieste.
    • Per IBM DB2:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.ibm.db2.jcc.DB2Driver"
      username="nome_utente"
      password="password"
      url="jdbc:db2://nome_server_completo:numero_porta_database/nome_database_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Per Oracle:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="oracle.jdbc.driver.OracleDriver"
      username="nome_utente"
      password="password"
      url="jdbc:oracle:thin:@nome_server_completo:numero_porta_database:nome_database_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Per Microsoft SQL Server:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
      username="nome_utente"
      password="password"
      url="jdbc:microsoft:sqlserver://nome_server_completo:numero_porta_database:nome_database_Rational_Asset_Manager"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
  9. 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" />
  10. Copiare i seguenti file JAR nella cartella tomcat_install_directory\common\lib:
    • Per IBM DB2:
      • db2jcc_license_cu.jar
      • db2jcc.jar
    • Per Oracle:
      • ojdbc5.jar (È possibile scaricare questo file da Oracle. Se si utilizza Oracle 10, scaricare un package per Oracle 11 per trovare il file ojdbc5.jar).
    • Per Microsoft SQL Server:
      • sqljdbc.jar (È possibile scaricare questo file da Microsoft).
    Questi file sono resi disponibili dal provider del database, probabilmente nella cartella /java/ dell'installazione del database.
  11. 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_install_directory\conf\tomcat-users.xml.
    2. Aggiungere un utente chiamato admin ed assegnare a tale utente i ruoli admin e manager. Per aggiungere questo utente, copiare ed incollare il seguente testo tra i tag <tomcat-users>>
      <user username="admin" password="" roles="admin,manager" />

      Questo utente deve essere chiamato admin.

  12. In base alla configurazione, distribuire o configurare Rational Team Concert.

Feedback