Installing interactively on an existing installation of WebSphere Application Server

You can install IBM® Business Monitor on an existing installation of WebSphere® Application Server. The IBM Business Monitor product launchpad program provides you with a single location to update WebSphere Application Server if required, start the IBM Business Monitor installation process, and to also view release information for IBM Business Monitor.

1. Go to the directory into which the images were extracted, and start the launchpad.
   • Run launchpad.sh from the root location.
   • Run launchpad64.exe from the root location. To install or run IBM Business Monitor on Windows, you must elevate your Microsoft Windows user account privileges. Whether you are an administrative user or a non-administrative user, right-click launchpad64.exe and select Run as administrator.
2. Optional: If you see a message that prompts you to update the launchpad, click Update to receive the latest updates. The updates are installed and your launchpad is restarted automatically.
   If you do not have access to the Internet and want updates to the launchpad to be installed from a local directory, you can use a properties file to tell the Installation Manager where to find the updates. Create the following file:

   • /home/user/bpm_updates.properties
   • C:\HOMEPATH\bpm_updates.properties
     • On Windows, the HOMEPATH environment variable points to C:\Users\user_name\

   For more information about Installation Manager updates, see Installation Manager updates.

   Note: Ensure that you have read/write access to the folders that are specified in the bpm_updates.properties file.
   The file uses a launchpad prefix, followed by a dot. The part of the name after the prefix and the dot can be anything you want, which enables you to point to multiple locations for launchpad upgrades. The locations can be either local directories or URLs. For example:

   launchpad.1=http://test/launchpad
   launchpad.2=C:\launchpad_updates

3. Optional: On the IBM Business Monitor page of the launchpad, click Database scripts for information about how to run the IBM Business Monitor database scripts to create and configure the required databases and database tables. The databases and database tables can be created either before or after the IBM Business Monitor installation.
4. Click Installation on existing WebSphere Application Server.
5. Indicate whether you want to install as an administrative user:
   • If you are in the Administrator group on Windows, or if you are a root user on a Linux or UNIX system, you can install as an administrative user. To do so, ensure that Install as administrative user is selected.
     Tip: You must select this option if you intend to install IBM Cognos Business Intelligence or DB2 Express during the IBM Business Monitor installation.
   • If you are not an administrative user, or if you want to install using your user name without administrative privileges, clear Install as administrative user.
6. Click Update to update WebSphere Application Server Network Deployment.
   1. When Installation Manager opens, click Update to install available updates.
   2. On the Update Packages page, select the IBM WebSphere Application Server V8.5 package group and then click Update all. You might be prompted to provide your IBM ID and password to connect to the IBM service repositories.
      Note: WebSphere Application Server Network Deployment must be updated only if it is not already at the fix pack level required by IBM Business Monitor. IBM Business Monitor can be installed only on top of the supported version of WebSphere Application Server Network Deployment. See the system requirements for more information.
   3. To install the updates, click Next and follow the instructions on each page.
   4. Close the Installation Manager and return to the launchpad application.
7. Click Install to start the installation of IBM Business Monitor, and optionally, IBM Cognos BI and DB2 Express. The Installation Manager window opens. If you see a message indicating that WebSphere Application Server Network Deployment is already installed, click Cancel.

   As you complete the pages of the Installation Manager, you can use the Next button to proceed or the Back button to return to a previous page.

8. On the Install Packages page of the Installation Manager window, update the default selections if necessary, to indicate which packages you want to install:

   IBM WebSphere Application Server Network Deployment

   Ensure that this check box is clear.

   IBM Business Monitor

   Ensure that this check box is selected.

   IBM DB2 Express 64 bit

   Clear this check box if one of these conditions apply:

   • You have an existing installation of DB2 Express.
   • You already have a database that you intend to use.
   • You are not an administrative user. (DB2 Express installation requires administrative privileges.)

   IBM Cognos Business Intelligence 64 bit

   Not available on Ubuntu. Clear this check box if one of these conditions apply:

   • You have an existing installation of IBM Cognos BI.
   • You are not an administrative user. (IBM Cognos BI installation requires administrative privileges.)
   • You are installing on a POWER 8 system.

   If you are connected to the Internet and want to check for the latest fix pack or refresh pack and recommended interim fixes for IBM Business Monitor, click Check for Other Versions, Fixes, and Extensions. You might be prompted to provide your IBM ID and password to connect to the IBM service repositories. You can either download any available updates at this stage, or click Cancel to continue installing without downloading the fixes from the Internet. After successfully installing IBM Business Monitor, you can use Installation Manager to install the required fixes.

9. On the Licenses page, read, and then accept, the license agreements for the packages that you selected for installation.
   Tip: On the left side of the License page, you can click Software License Agreement under each package name to display and read each license agreement.
10. On the Location page, review the selections:
    • The default selection of Use the existing package group indicates that IBM Business Monitor and any other selected packages will be installed into the directory that contains the existing WebSphere Application Server installation.
    • The Installation Directory field identifies where WebSphere Application Server is installed.
11. On each of the Features pages that are displayed in turn, make the following selections:
    1. For each package, expand the plus symbol where available, to view and select the package features that you want to install. You can click a feature to view its brief description under Details.
       For the IBM Business Monitor package, you must choose one of the following features by selecting the appropriate check box:

       • Business Monitor Server Production: Select this feature (the default) to use the server in production.
       • Business Monitor Server Non-production: Select this feature to use the server only for test, staging, or development.
         Restriction: Do not mix production and non-production servers in the same cell.

       Installation Manager automatically enforces any feature dependencies and shows the disk space requirements for the installation.

    2. If you chose to install the DB2 Express package, specify the credentials for the database administrative user:
       • If you already have a database, enter the credentials for the database.
       • If you chose to install DB2 Express, enter a user name and password for DB2. The default administrative user name is bpmadmin. Choose a password that complies with the password policy of your system (for example, Windows 2008).
         Restriction: User names must not contain National Language Strings (NLS).

       You can click Re-Validate to validate the connection to an existing database.

12. On the Summary page, review your installation package choices and then click Install to start the installation of IBM Business Monitor. A progress indicator shows the percentage of the installation completed.
13. On the final Install Packages page, a message confirms the success of the process.
    1. Optional: Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. Under Which program do you want to start?, indicate whether you want the Profile Management Tool to start when you exit, in order to create a profile. Alternatively, select None if you want to open this tool later, or if you want to use another method to create the required profiles.
    3. Click Finish to close the Installation Manager.