Installing interactively with a new installation of WebSphere Application Server

You can install IBM® Business Monitor with a new installation of WebSphere® Application Server. The IBM Business Monitor product launchpad program provides you with a single location to start the installation process and to 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 IBM Business Monitor to return to the IBM Business Monitor page.
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 Install to start the installation of WebSphere Application Server Network Deployment and IBM Business Monitor, and optionally, IBM Installation Manager, IBM Cognos BI, and DB2 Express. The IBM Installation Manager window opens.

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

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

   IBM Installation Manager

   This option is not displayed if you already have the supported version of IBM Installation Manager installed. If IBM Installation Manager is not installed or if you have an existing installation, which is a lower version, ensure that the check box is selected.

   IBM WebSphere Application Server Network Deployment

   Ensure that this check box is selected.

   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 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 WebSphere Application Server and 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 select any available updates at this stage for installation. Alternatively, you can use Installation Manager to install the required fixes after successfully installing IBM Business Monitor.

8. 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.
9. On the Location page, accept the default installation locations for Installation Manager or specify other locations:

   Shared Resources Directory

   If IBM Business Monitor is the first package to be installed using Installation Manager, specify a directory to which Installation Manager caches artifacts that can be shared by multiple packages. You can specify the shared resources directory only the very first time that you install a package, and you cannot change the directory location unless you uninstall all packages.

   Installation Manager Directory

   If you chose to install Installation Manager, specify an installation location for this package. If Installation Manager is already installed, you do not need to specify a location.

   Tip:

   1. Ensure that your installation paths do not contain parentheses.
   2. Ensure that your installation paths do not contain spaces.
10. On the next Location page, specify the single location into which WebSphere Application Server and IBM Business Monitor will be installed in a package group. A package group is a directory that contains resources that packages share with other packages in the same group.

    Create a new package group

    Select this option. A package group name is automatically assigned.

    Installation Directory

    Specify an installation location for the package group or accept the default path. WebSphere Application Server, IBM Business Monitor, and any other dependent packages will be installed into this location.

    Tip:

    1. Ensure that your installation path does not contain parentheses.
    2. If you are installing DB2 Express, your installation path cannot contain National Language Strings (NLS).
    3. Ensure that your installation path does not contain spaces.
    4. Keep the installation path as short as possible. Otherwise, you might run into problems later when the paths of other components, when added to this path, exceed the 255-character path limit.

11. On each of the Features pages that are displayed in turn, make the following selections:
    1. Choose all the languages to be supported when you use this software. Under Translations Supported by All Packages, English is selected by default for the English version. To install other language versions, select one or more languages under Translations Supported by Only Some Packages.
    2. For each package, expand the plus symbol where available, to view and select the package features that you want to install.

       For the WebSphere Application Server package, the EJBDeploy tool for pre-EJB 3.0 modules feature is required to ensure that all Business Monitor Server 8.5.5 components work correctly. This feature is selected by default.

       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.

       As you choose the features, Installation Manager automatically enforces any dependencies with other features and shows the updated disk space requirements for the installation. To see any dependency relationships between features, you can select Show Dependencies. You can also click a feature to view its brief description under Details.

    3. 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.