Deploying application files by using the server setup application

The server setup application is a browser-based web application for IBM® WebSphere® Application Server that helps you deploy the other Rational® Asset Manager applications and configure the database, security, performance, and repository settings. You can use the server setup application to later modify these settings instead of using the Administration pages within Rational Asset Manager web client.

Before you begin

Procedure

  1. Verify that all of the repository servers are set to the same current date, time, and time zone.
  2. For Linux:For AIX:For Linux for zSeries:On Linux, AIX®, or Linux for zSeries®, increase the number of file descriptors a process might have open at once to at least 65535:
    1. To view the current number of descriptors that can be open at once, in the command line type: ulimit -n
    2. If the limit is not at least 65535, increase the limit with the following command: ulimit -n 65535
  3. Configure the application security and authentication settings for WebSphere Application Server:
    1. In a web browser, log in to the WebSphere Application Server administrative console. By default, this is located at:
      • For WebSphere Application Server: http://localhost:9060/ibm/console
    2. Click Security.
    3. Click Global security.
    4. In the Administrative Security section, if the Enable administrative security check box is selected, select the Enable application security check box.
    5. Click Apply.
    6. In the Messages window, click Save directly to the master configuration.
    7. Stop, and then restart the server.
  4. For WebSphere: If you use a WebSphere Application Server cluster and you need to install Rational Team Concert, you must create a stand-alone application server instance on your cluster for Rational Team Concert. To do so, see Creating an application server instance for Rational Team Concert on a WebSphere Application Server distributed server cluster. If you are not using a cluster, you do not have to do this; Rational Team Concert and Rational Asset Manager can be installed on the same application server.
  5. If you manually deployed the server setup application (you did not use Installation Manager), on the same machine that you deployed the server setup application, create a folder that contains the following application server files:
    • com.ibm.ram.repository.web_runtime.ear
    • RTC-Server_401.zip
    • RTC-Server_3013.zip
    • ramhelp_war.ear
    • rmcabdgovernprocess_war.ear

    For more information about retrieving these files, see Retrieving the server application files directly from the installation media.

    If you are unable to access the machine that you deployed the server setup application to, you will be able to upload the files later.

  6. Open the server setup application by navigating a web browser to http://machine_name:port_number/Server_Setup_Context_Root.
    The default URL for the server setup application is:
    • http://localhost:9080/ram.setup for an installation of Rational Asset Manager with an existing WebSphere Application Server.
    • For a WebSphere Application Server Network Deployment cluster, if you used Installation Manager to deploy the server setup application, the hostname and port number will be for the application that you specified in Installation Manager. If you deployed the application in the admin console, you can access it on any application server on the cluster after the nodes have been synchronized.
      Restriction: To create and use a cluster of application servers, you must have IBM WebSphere Application Server Network Deployment (ND), which is not bundled with IBM Rational Asset Manager.
    If security is enabled on the application server, you will be prompted for the user ID and password for an application server administrator.
  7. On the Introduction page, indicate the type of database and user authentication to use:
    1. Select the database application that you will be using from the Database vendor list.
    2. Select the type of user authentication for the Rational Asset Manager web application to use:
      • LDAP: User information is stored in a Lightweight Directory Access Protocol (LDAP) repository. To access the repository, you need administrative information.
      • File: User information is stored in a custom user registry, as defined for your application server. This information might be displayed in the list as the name of the custom registry as defined for the application server. An example custom user registry is File, where user information is stored in a flat file on the server. If you are not using any of the other types of authentication, select this option.
        Tip: File-based authentication is not intended for use in a production environment. An LDAP or custom user registry supports common security practices such as rules for password patterns, password expiration, and account lockouts to prevent enumeration attacks. File-based authentication does not support these features.
      • Federated Repository: User information is stored in multiple repositories, such as LDAP repositories. This type of authentication is managed by WebSphere Application Server.
      • Local Operating System: User information is stored in the user accounts database on the local operating system. This type of authentication is managed by WebSphere Application Server.
    3. Rational Asset Manager requires Rational Team Concert. Select if you must installRational Team Concert from the Rational Team Concert server list:
      • I need to install a new Rational Team Concert server.: Install a new, limited version of Rational Team Concert to your application server. If you are using a WebSphere Application Server cluster, you must create a single application server instance for Rational Team Concert.
      • I have a Rational Team Concert server and would like to use that.: You will configure an existing Rational Team Concert to work with Rational Asset Manager.
    4. Confirm that the Server or Cluster listed is the one that you want to configure. If you must create a Network Deployment cluster for Rational Asset Manager, see the WebSphere Application Server documentation.
    5. Click Next.
  8. In the Step 1: Locate Installation Files section, click Provide the directory which contains the following files on the server and then type the directory on the file system on the server that is running the server setup application where the new web application files are located. If you used Installation Manager, the files will be at the package_group_location\ram\apps\was directory. The following files must be in that directory:
    • com.ibm.ram.repository.web_runtime.ear
    • RTC-Server_401.zip
    • RTC-Server_3013.zip
    • ramhelp_war.ear
    • rmcabdgovernprocess_war.ear

    If you deployed the server setup application to an application server that is part of a cluster and you are accessing that application server, to upload the files to the server that is running the server setup application, click Upload the files to the server; then click Browse and select each of the required files.

  9. To verify that all required application files are in the directory, or to upload them to the server, click Verify Installation files. If you uploaded the application files, the server setup application saves them to a temporary directory. A message verifies if all the required files are present.
  10. If you are using a WebSphere Application Server cluster, you might see a message that says that you do not have enough Java heap memory to deploy the applications. If you see this message, the server setup application has increased the heap memory to the recommended setting. To make this change take affect, click the restart of the server link. Your server might be unavailable for several minutes while it restarts. After you deploy the applications, you can change the heap memory settings for your application servers.
  11. In the Step 2: Select the applications and documentation to install section, applications that are successfully deployed are indicated with the cluster or server name that they are deployed on. To deploy Rational Asset Manager web applications:
    1. Select one or more applications to deploy.
    2. From the Clusters and servers or Servers list, select the clusters or servers to deploy to. You cannot deploy Rational Team Concert to a cluster; use the single server that you created in step 4.
      Note: If you require users to authenticate (for example, through the application server or an external firewall) to access the Rational Asset Manager help application, you must deploy the Rational Asset Manager help application on the same server or cluster as the Rational Asset Manager web application.
    3. Click Deploy Applications. A separate page opens to show the progress. The process to deploy one or more applications can take several minutes.
    4. Click Next to review the results.
    5. On the Summary page, click Next.

What to do next

Feedback