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.
È 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
- Verificare che tutti i server del repository siano impostati sulla stessa data, ora e fuso orario correnti.
- 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/.
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
- Individuare ed estrarre il file
archive_extract_location\sharedLibs\rlsclients_rlsibmratl_812.zip.
- 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.
- Estrarre il contenuto del file
rlsibmratl812.zip appropriato.
- 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.
- Nel supporto di installazione, individuare il file
archive_extract_location/apps/tomcat/RTC-server.zip.
- Estrarre RTC-server.zip in una ubicazione sull'unità disco rigido,
indicata in queste istruzioni come dir_installazione_rtc.
- 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/.
- Configurare una porta sicura sul server Tomcat per
Rational Team Concert:
- 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
- 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.
- 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 .
- È 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.

Copiare il file .jar appropriato
dal provider del database:
- Configurare le impostazioni della proprietà di avvio di Tomcat:
- 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.
- Nel file di avvio, immettere il seguente testo:
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



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"
- Trovare e ridenominare il file delle proprietà del server
Jazz appropriato:
- Nella directory
dir_installazione_rtc/jazz/server/conf/ramjazz/,
individuare il file teamserver.properties e ridenominarlo in
teamserver.derby.properties.
- Individuare il file appropriato per il server di database utilizzato:

Per DB2 su Windows:
teamserver.db2.win32.properties



Per DB2 su
Linux, AIX o Linux per zSeries:
teamserver.db2.linux.properties
teamserver.oracle.properties
teamserver.sqlserver.properties
- Ridenominare il file in teamserver.properties.
- In un editor di testo, aprire il file teamserver.properties
e modificarlo come segue (per il provider del database):

- 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
- 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:
- 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.
- Sostituire JAZZ con il nome del database
per i cicli di vita.
- 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.
- 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.
- 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

- 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
- 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:
- Sostituire jazzDBUser con il nome utente per il database
Oracle (ad esempio, RAMSCHEMA).
- 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.
- Sostituire ORCL con il nome del database del ciclo di vita; ad esempio rtcdb.
- 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.
- 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
- Se si utilizza Oracle 11: nel file teamserver.properties,
aggiungere la seguente proprietà:
com.ibm.team.repository.db.override.versioncheck=true

- 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
- 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:
- Sostituire @localhost:1433 con l'ubicazione e la porta del
database SQL Server.
- Sostituire jazz con il nome del database del ciclo di vita;
ad esempio, RTCDB.
- Sostituire jazzDBUser con il nome utente per il database
SQL Server.
- 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.
- 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
- Creare le tabelle per
Rational Team Concert:
- Aprire una finestra di riga comandi e passare alla directory
dir_installazione_rtc/jazz/server/.
- Immettere il seguente comando:
- 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.
- 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.
- Tra i tag <tomcat-users>, immettere il seguente testo:
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
- 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.
- Avviare il server Tomcat
per Rational Team Concert.
Per avviare Tomcat, eseguire il seguente file:
tomcat_for_rtc_install_directory\bin\startup.bat


tomcat_for_rtc_install_directory/bin/startup.sh
- Configurare
Rational Team Concert affinché funzioni
con Rational Asset Manager.
È necessario configurare i diritti amministrativi e creare una project area
in Rational Team Concert.