You must upgrade your license server and file a request for updated license keys. For more information about the required version of Rational License Server, see Installing Rational License Key Server.
You will also have to stop and restart your application server several times.
You can improve the performance and stability of Rational Asset Manager by installing its web applications and the application files for the included IBM Rational Team Concert on separate Tomcat servers. Throughout this document, the installation directory for the Tomcat server for Rational Asset Manager is referred to as tomcat_install_directory. The installation directory for the Tomcat server for Rational Team Concert is tomcat_for_rtc_install_directory. If you are installing all the web applications on the same Tomcat server, the directories are the same.
Rational License Key Server is included with the Rational Asset Manager installation media. You can also retrieve the latest version of Rational License Server through your Passport Advantage account, or through the IBM Support Portal.
This process requires that you shut down all applications that use Rational Licensing Server, uninstall your existing Rational Licensing Server, update your license files, and install Rational Common Licensing server. For Windows, see Configuring a license server for Windows; for AIX® or Linux, see Configuring a license server for UNIX.
For Linux for zSeries, continue to use Rational License Server for UNIX and Linux 7.0.0.1.-Djava.library.path="tomcat_install_directory\shared\lib"
-Djava.library.path=tomcat_install_directory/shared/lib
set JAVA_OPTS=-Djava.library.path="tomcat_install_directory\lib"
export JAVA_OPTS="-Djava.library.path=tomcat_install_directory/lib"
<!--
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
-->
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
SET JAVA_OPTS=" -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
For Linux:export JAVA_OPTS=" -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
keytool -genkey -alias tomcat -keystore tomcat_for_rtc_install_directory/.keystore
When you run that command, you will be prompted for a password for the keystore file. The default password is changeit, but you should specify a different one. You will have to remember that password to input it into the server.xml file later.
If you are using an IBM JRE, many versions include the IBM tool ikeyman in the IBM_Java_JRE_install_location/jre/bin/ directory. You can use this tool to create and manage security certificates on the server. For more information about using the iKeyman tool, see iKeyman User's Guide.
We also include a simple certificate in the rtc_install_dir/jazz/server/ folder; the certificate file is ibm-team-ssl.keystore
<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"
/>
For more information about configuring SSL for Tomcat, see Apache Tomcat 7 SSL Configuration HOW-TO and Apache Tomcat Configuration reference.
You can download the file from Oracle.
set ORACLE_JDBC=oracle_jar_dir
set SQLSERVER_JDBC=sqlServer_jar_dir
set JAZZ_INSTALL_DIR=rtc_install_dir
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=rtc_install_dir
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"
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
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
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=secure_port
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
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
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=secure_port
com.ibm.team.repository.db.override.versioncheck=true
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
com.ibm.team.scm.tmpdir=team_temp_dir
com.ibm.team.repository.server.repourl.port.http=unsecure_port
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=secure_port
repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
<user username="admin" password="" roles="admin,manager,JazzAdmins" />
If you are installing the applications on the same Tomcat server, add the JazzAdmins role to the existing admin user.
You can find the existing rtc_install_dir location in the Tomcat startup file. In the startup file, search for the line that contains JAZZ_INSTALL_DIR=; the value of the JAZZ_INSTALL_DIR variable is the location of the current Rational Team Concert files.
set JAZZ_INSTALL_DIR=new_rtc_install_dir
JAZZ_INSTALL_DIR=new_rtc_install_dir
Original file name | New file name | Resulting context path | What is it? |
---|---|---|---|
com.ibm.ram.repository.web.tomcat_runtime.war | ram.war | ram | Rational Asset Manager primary web application for Tomcat |
com.ibm.ram.repository.web.ws.tomcat_runtime.war | ram.ws.war | ram.ws | Rational Asset Manager web services application for Tomcat |
ramhelp.war | ram.help.war | ram.help | Rational Asset Manager help and user assistance application |
rmcabdgovernprocess.war | ram.process.war | ram.process | Documentation application for asset-based development and governance processes |
If you installed the Rational Asset Manager Eclipse client plug-ins by using the Eclipse update manager, before you install the latest version of Rational Asset Manager, use the Eclipse configuration manager to remove any features that are named Rational Asset Manager. To use the Eclipse configuration manager, in Eclipse, click .
For Rational Asset Manager version 7.5.1 and later, the URL for the internal Rational Team Concert server changed from https://host:port/jazz to https://host:port/ramjazz. If you are upgrading from a Rational Asset Manager release earlier than 7.5.1, revise the URL references and tell your users which changes they must make.