Guide to install Rational Asset Manager

Create a custom guide for installing IBM Rational Asset Manager server

This guide describes installing the IBM® Rational® Asset Manager server applications. To install Rational Asset Manager on an Eclipse client, see Installing Rational Asset Manager Eclipse client using Eclipse Update Manager.

Select options that best describe your installation environment

Choose an edition of Rational Asset Manager:
Choose the operating system for your application server:
Choose your application server:
Choose your database server:
Choose whether or not you need to install a new IBM Rational Team Concert™ server:
Choose your preferred method to install the product:

To Install Rational Asset Manager:

Know where you will store asset and index information

Rational Asset Manager requires three hard drive or file server folders: a persist folder for storing assets and files, a local folder for temporary files, and an index folder for the search index.

These folders could be on a file server, and the persist folder can be on an instance of IBM Rational ClearCase.

The setup of these folders affects the performance of Rational Asset Manager in advanced configurations. For more information about capacity planning, see the capacity planning guidelines.

Get and extract the Rational Asset Manager installation media

Depending on the type of download, will need up to eight gigabytes (8 GB) of hard drive space to download and extract the Rational Asset Manager installation media

Either use Passport Advantage to download and verify the Rational Asset Manager installation media, or download every installation .zip file from the download site on IBM.com.

Extract all of the .zip files to the same directory.

Install Rational Common License Key Server and license keys

You will need the following resources:

Rational Asset Manager communicates with Rational License Server to manage and distribute product licenses. You must install the latest version of Rational License server.

You can install Rational License Server from the launchpad program in the disc1 folder. For more information, see Installing Rational License Server

You need to install your license keys on Rational License Server. You will configure Rational Asset Manager to use the license keys later.

Install DB2 database server

You will need a server on which to install IBM DB2.

The Rational Asset Manager installation media includes IBM DB2 version 9.7. You can install IBM DB2 from the launchpad program in the disc1 folder. For more information, see Installing DB2 and Registering the DB2 license key.

Install Websphere Application Server and deploy the Rational Asset Manager server setup application

Choose to use the full version of Websphere Application Server that came with the Rational Asset Manager media. If you choose to use the full Websphere Application Server, install the full version of WebSphere Application Server first and choose the options for an existing WebSphere Application Server during the deployment of the Rational Asset Manager server setup application.

Install WebSphere Application Server and use Installation Manager to deploy the server setup application to WebSphere Application Server

You will need the following information:

  • The file path of the application server profile
  • The URL for the server
  • If application server security is enabled, the user ID and password for the application server administrator
  • The name of the server

Installation Manager will deploy the server setup application to WebSphere Application Server.

Installation Manager will also place files that you can use create databases for Rational Asset Manager in package_group\ram\DatabaseScripts

For more information, see Installing Rational Asset Manager server by using Installation Manager and select the options for installing to an existing WebSphere Application Server.

If you do not have access to a graphical user interface (GUI) for Installation Manager, you can install over the command line silently with response files or using the console mode. For more information, see Installing silently with Installation Manager or Installing by using console mode.

Retrieve the Rational Asset Manager server application files and database scripts

You can retrieve the installation files directly from the installation media. To do so, see Retrieving the Rational Asset Manager server files from the installation media.

Create the database for assets

You will need the following permissions and information:

  • Access to a database server that is installed and running
  • The location of the installation directory for DB2
  • The "write" permission for the directory that contains the SQL database scripts
  • The user name and password of a database user who can create new tables
  • The user name and password of a database user who can create new tables and new users

To create the asset database for DB2, see Creating the DB2 database with helper scripts.

To create the asset database for Oracle, see Creating the database for Oracle.

To create the asset database for Microsoft SQL Server, see Creating the database for Microsoft SQL Server.

Create the databases for lifecycles

You will need the following permissions and information:

  • Access to a database server that is installed and running
  • The location of the installation directory for DB2
  • The user name and password of a database user who can create new tables
  • The user name and password of a database user who can create new tables and new users

You must create two additional databases for custom lifecycles.

To create the lifecycle database, see Creating the lifecycle database for DB2.

To create the lifecycle database, see Creating the database for Oracle.

To create the lifecycle database, see Creating the database for Microsoft SQL Server.

Deploy the server setup application to WebSphere Application Server

You will need the following resources:

  • An application server that is running
  • Administrative access to WebSphere Application Server
  • The server setup application .ear file (com.ibm.ram.repository.setup.web.ear)

To deploy the server setup application to WebSphere Application Server, see Deploying Rational Asset Manager on WebSphere Application Server.

To deploy the server setup application to a WebSphere Application server cluster, see Manually deploying the server setup application to WebSphere Application Server cluster.

You only need to deploy the server setup application file; to deploy the other application files, you will use the server setup application.

Create a single application server instance on your application server cluster for Rational Team Concert

You must create a single applications server instance on your WebSphere Application Server for Rational Team Concert. To do so, see Creating an application server instance for Rational Team Concert on a WebSphere Application Server cluster.

Use the server setup application to deploy and configure the application files

You will need the following resources:

  • The server setup application deployed on a running WebSphere Application Server
  • Administrative access to WebSphere Application Server
  • The ability to stop and restart your server
  • The context root of the server setup application that you chose when you used Installation Manager
  • The context root of the server setup application that you chose when you deployed to the application server
  • The user name and password of a database user with database administration privileges
  • The user name and password of the database user that you assigned to your databases
  • The address and port number of the database server
  • The name(s) of the database(s) that you created
  • The db2cc.jar and db2cc_license_cu.jar files for your database application
  • The ojdbc14.jar file for your database application
  • The ojdbc6.jar (for WebSphere Application Server) file for your database application
  • The sqljdbc.jar and sqljdbc4.jar files for your database application
  • If you are using LDAP authentication: vendor, mapping, and user information for the LDAP server
  • The location and port number of your Rational License server
  • The location of the three folders(persist, local, and index) that Rational Asset Manager requires for storage
  • The user name and password for the administrator for Rational Team Concert

Use the server setup application to deploy the other Rational Asset Manager applications to WebSphere Application Server, create DB2 databases, configure the database connections, configure users and security, configure Rational Asset Manager server, and tune your database and application server for maximum performance.

To use the server setup application, see Deploying applications and configuring Rational Asset Manager.

Deploy the Rational Asset Manager server application files to Tomcat and configure the database connection

You will need the following resources:

  • Administrative access to your Apache Tomcat server
  • The secure (by default, 8080) and unsecure (by default, 8443) port numbers for your Tomcat server
  • The Tomcat server application files that you retrieved from the installation media
  • The ability to stop and restart your server
  • The user name and password of the database user for your database server
  • The address and port number of the database server
  • The name(s) of the database(s) that you created
  • The db2cc.jar and db2cc_license_cu.jar files for your database application
  • The ojdbc14.jar and ojdbc6.jar file for your database application
  • The sqljdbc.jar file for your database application

See Deploying the Rational Asset Manager server applications on Apache Tomcat.

Deploy the Rational Team Concert server application files to Tomcat

You will need the following resources:

  • Administrative access to your Apache Tomcat server
  • The secure (by default, 8080) and unsecure (by default, 8443) port numbers for your Tomcat server
  • A security certificate for your server
  • The Tomcat server application files that you retrieved from the installation media
  • The ability to stop and restart your server
  • The user name and password of the database user for your database server
  • The address and port number of the database server
  • The name(s) of the database(s) that you created
  • The ojdbc14.jar file for your database application
  • The sqljdbc.jar file for your database application

IBM® Rational® Asset Manager requires IBM Rational Team Concert, which controls the lifecycle functions that allow you to manage the development of assets over time. We include a limited version of Rational Team Concert that you can deploy to a Tomcat server. See Deploying the included Rational Team Concert server application on Apache Tomcat.

Configure Rational Team Concert to work with Rational Asset Manager

You will need the following resources:

  • The Tomcat server application files that you retrieved from the installation media
  • The ability to stop and restart your Tomcat server
  • The user name and password for the administrator for Rational Team Concert

You must add and configure a project area on your Rational Team Concert application. See Configuring a Rational Team Concert server to work with Rational Asset Manager.

Configure your operating system

You will need the following permissions:

  • Root permission for the operating system
  • Access to set environmental variables for your shell
  • The fileset for X Virtual Frame Buffer

You must configure your operating system for Rational Asset Manager:

Configure email settings

You will need the default return email address, default return email name, and the location of your Simple Mail Transfer Protocol (SMTP) server.

Sign on to the web client and configure email settings. To configure the settings for email notifications, see Configuring email settings.

Configure Rational Asset Manager

You will need the following information:

  • The Rational License server location and port number
  • The location of the three folders (persist, local, and index) that Rational Asset Manager requires for storage
  • The administrator and default return email addresses for and the location of your Simple Mail Transfer Protocol (SMTP) server

To configure Rational Asset Manager, sign on to the web client and complete the following tasks:

You have installed Rational Asset Manager Server!

You are now ready to use Rational Asset Manager.

Depending on your configuration, you might have to view optional configuration settings in the Help.

As you repository grows and more users access the system, you may need to adjust your hardware or software settings to improve or maintain performance. For more information, see Tuning the performance of Rational Asset Manager and Rational Asset Manager system and capacity planning guidelines.

Install the Rational Asset Manager Eclipse client

If you want to use the Rational Asset Manager Eclipse client, you can install it into an existing Eclipse IDE. For more information, see Installing Rational Asset Manager into an Eclipse IDE.

You can also use Installation Manager to install the Rational Asset Manager Eclipse client. For more information, see Installing Rational Asset Manager Eclipse client with Installation Manager.