Evaluation installation

Complete these tasks to install a simple, stand-alone configuration that you can use to evaluate WSRR.

1

Before installing, ensure you have prepared your system as described in Preparing Linux systems for installation.

Starting the launchpad

The launchpad for WSRR is the single point of reference for installing the entire server environment, which can include WSRR, WebSphere Application Server Network Deployment, a web server, and additional supporting software and documentation.

The launchpad application is available on the product DVD and on downloaded installation images. You must have Firefox Version 4 or later to run the launchpad. This version of Firefox is not available on Solaris or AIX; to install interactively, you must use Installation Manager directly.

Access the media in one of the following ways, depending on whether you are installing from the product DVD or from images downloaded from Passport Advantage.
  • If you are installing on Linux from the product DVD, insert the product disk labeled WSRR Version 8.5 into the disk drive. Mount the disk drive if necessary. If autorun is enabled on your workstation, the WSRR launchpad program automatically opens. If autorun is not enabled, start the launchpad manually by entering the following command:
    DVD_root/launchpad.sh
  • If you are installing on Solaris or AIX from the product DVD, insert the product disk labeled WSRR Version 8.5 into the disk drive. Mount the disk drive if necessary. Start Installation Manager as root manually by entering the following command:
    DVD_root/install.sh
    Start Installation Manager as a non-root user manually by entering the following command:
    DVD_root/userinst.sh
  • If you are installing on Linux from images downloaded from Passport Advantage, complete the following steps:
    1. Navigate to the directory into which you extracted the images.
    2. Enter the following command to start the launchpad:
      extract_directory/launchpad.sh
  • If you are installing on Solaris or AIX from images downloaded from Passport Advantage, complete the following steps:
    1. Navigate to the directory into which you extracted the images.
    2. Enter the following command to start Installation Manager as root:
      extract_directory/install.sh
      or enter the following command to start Installation Manager as a non-root user:
    3. extract_directory/userinst.sh
On Linux systems, the launchpad opens. If you have a problem starting the launchpad, use the troubleshooting information in Troubleshooting the launchpad application to correct the problem. If the launchpad did not initialize in the language used on your system, select your language in the Select a language field.
The launchpad checks your system when it starts, and can detect the following problems:
  • The ulimit settings are checked. If the ulimit value is too low, you are warned to increase the value to at least 8799. (See Process file descriptor limit.) After adjusting the ulimit value, log out and log back in again, then restart the launchpad.
  • The following message appears if you do not have the required version of the GTK library installed:
    Your operating system failed the launchpad prerequisites check. Required GTK Library
for running IBM Installation Manager is not available in underlying OS. Please install
GTK Library and restart your installation.
    You must update your server with the latest GTK library before you continue the installation.
1

Evaluation installation on Linux

Select Evaluation installation to complete an installation on a stand-alone server with the minimum of user interaction.

An evaluation installation completes the following tasks:
  • Installs Installation Manager
  • Installs WebSphere® Application Server (64-bit version if installing on a 64-bit system, 32-bit version otherwise).
  • Installs DB2® Express® Edition
  • Installs WSRR
  • Creates a stand-alone server profile
The launchpad from which you run a typical installation requires Firefox 4.0 or later. You must run the launchpad as root.

There is a check built into the typical installation for the ulimit settings on Linux systems. If the ulimit value is too low, you are warned to increase the value to at least 8799. See Setting process file descriptor limit. After adjusting the ulimit value, log out and log back in again, then restart the launchpad.

Before running the installation, you must prepare your system, see Preparing your Linux system.

To complete a typical installation:
  1. Specify the host name and location for the installation, or accept the default values, and specify a password for the user IDs that the installation creates for WebSphere Application Server and DB2 Express. (Use a DNS routable hostname, or localhost, do not use an IP address). Click Next.
    Note:
    • The user IDs for which you specify passwords must not already exist. If they exist with different passwords, then the installation will fail. If the user IDs already exist, use custom installation.
    • If you use an embedded DB2 Express database, then the password that you specify must comply with any local security policies regarding password complexity or length.
  2. Select whether to install an embedded DB2 Express database, or use an existing database (DB2 Express is only available if you have not got DB2 already installed). Click Next.
  3. If you chose to use an existing database, specify the following details:
    1. Database type
    2. Hostname of system hosting the database
    3. Port to connect to the database
    4. Username and password for connecting to the database
    5. Select Create database to create a new database for WSRR, or specify the name of an existing database in which to create the WSRR tables
    6. Optionally test the database connection
    If you chose to install an embedded DB2 Express database, the following user IDs and passwords are configured, using the password that you specified in step 1:
    Key Default value
    db2.instance.username db2inst
    db2.instance.password as specified in step 1
    db2.fenced.username db2fenc
    db2.fenced.password as specified in step 1
    db2.das.username dasusr
    db2.das.password as specified in step 1
    The following user ID and password parameter values are then passed to WebSphere Application Server when the WSRR profile is created:
    Value Parameter
    db2inst -wsrrDbUserID
    as specified in step 1 -wsrrDbPassword
  4. Click Next.
  5. Read through the license agreement and then select I accept the terms in the license agreement. Click Next.
  6. By default, Installation Manager creates a new package group for your installation. Accept this setting by clicking Next.
  7. Installation Manager validates that the selected features can be installed, and reports any problems that are found (for example, running process or wrong operating system level). If there are problems, you must correct them, otherwise click Next.
  8. Check the information on the summary page, and if you are happy, click Install. When the installation is complete, a page displays the status of the installation and which packages have been successfully installed.
  9. Click Finish.
  10. After the installation has completed, make a note of the information displayed for future reference (this includes user names and passwords).
2

Loading and activating the WSRR configuration profile

The server must be running for you to load and activate the configuration profile. You can load and activate the profile by using the WSRR Web UI.

  1. Open the web UI by opening a browser and entering the URL http://hostname:port/ServiceRegistry for unsecure systems, or https://hostname:port/ServiceRegistry for secure systems. hostname is the name of the system on which you installed WSRR, and port is the connection port which, by default, is 9080 for unsecure systems and 9443 for secure systems. For example, https://myhost:9443/ServiceRegistry.
  2. In the Configuration perspective, select Manage Profiles > Configuration Profiles.
  3. Click Load Configuration Profile.
  4. Browse for the file WAS_INSTALL\WSRR\config\GovernanceEnablementProfile_v85.zip, or enter the path.
  5. Specify a name for the profile, for example, GEP.
  6. Click OK to load the profile.
  7. In the Configuration Profiles collection, select the profile you loaded and click Make Active.