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
- Verify that all of the repository servers are set to the same current date, time, and time zone.
- On Linux, AIX®,
or Linux for zSeries, increase
the number of file descriptors a process might have open at once to
at least 65535:
- To view the current number of descriptors that can be open at once, in the command line type: ulimit -n
- If the limit is not at least 65535, increase the limit with the following command: ulimit -n 65535
- Configure the application security and authentication settings
for WebSphere Application Server:
- 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
- Click Security.
- Click Global security.
- In the Administrative Security section, if the Enable administrative security check box is selected, select the Enable application security check box.
- Click Apply.
- In the Messages window, click Save directly to the master configuration.
- Stop, and then restart the server.
- In a web browser, log in to the WebSphere Application Server administrative
console. By default, this is located
at:
- 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.
- 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.
- 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).
- On the Introduction page, indicate the type of database
and user authentication to use:
- Select the database application that you will be using from the Database vendor list.
- 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.
- 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.
- 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.
- Click Next.
- 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.
- 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.
- 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.
- 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:
- Select one or more applications to deploy.
- 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.
- Click Deploy Applications. A separate page opens to show the progress. The process to deploy one or more applications can take several minutes.
- Click Next to review the results.
- On the Summary page, click Next.
What to do next
Feedback