Installing IBM Business Monitor silently using the command line

You can install IBM® Business Monitor from the command line either with a new or an existing installation of WebSphere® Application Server.

Before you begin

Complete the preinstallation tasks that are described in Preparing to install, if you have not done so already.

Although the installation process automatically checks for prerequisite operating system patches, review the System requirements for IBM Business Monitor if you have not already done so. The system requirements list all supported operating systems and the operating system fixes and patches that you must install to have a compliant operating system. It also lists the required levels of all prerequisite software.

IBM Installation Manager is a common installer that can be used to install and maintain many IBM software products and applications, including WebSphere Application Server and IBM Business Monitor. If you are installing IBM Business Monitor on an existing installation of WebSphere Application Server, ensure that the WebSphere Application Server version has been updated to the required level. See the System requirements for IBM Business Monitor for more information.

If you are installing from electronic installation images, ensure that you have downloaded all the required images. If you are installing from the DVD images, obtain the compressed files from the DVDs. In both cases, extract all of the files from the compressed files to the same location on your hard disk. Overwrite directories, if prompted.

About this task

If you do not have the prerequisite base products necessary for IBM Business Monitor installation, you must install them as part of the silent installation. The required base products are:
  • Installation Manager.
    For Linux operating systemFor UNIX operating systemNote: If you are installing IBM Business Monitor in group mode, you must use an instance of IBM Installation Manager that is installed in group mode. For more information, see the Installation Manager information center topic Administrator, nonadministrator, and group mode.
  • WebSphere Application Server Network Deployment
The silent installation performs the following tasks:
  • Installs Installation Manager if it is not already installed or updates it to the appropriate level if it is installed
  • Installs the required base products and IBM Business Monitor
IBM Business Monitor uses IBM Cognos® Business Intelligence for reporting, and also requires the use of a database server. If you have an existing, remote IBM Cognos Business Intelligence installation, or an existing DB2 database server, you can configure them for use with IBM Business Monitor. Otherwise, you can choose to install IBM Cognos BI and DB2® Express® as part of the IBM Business Monitor installation, providing you have the administrative privileges of an Administrator user on Windows, or a root user on Linux or UNIX.
Note: On Power 8, IBM Cognos BI V10.2.1.2 is not supported and cannot be installed. Instead, install IBM Cognos BI V10.2.1.2 on a remote server and configure it to work with IBM Business Monitor by following the steps in the topic Configuring IBM Business Monitor and Business Space to use an existing IBM Cognos BI service. On Ubuntu, the option to install IBM Cognos BI with IBM Business Monitor is not available.

This procedure assumes that you are running the installation by using images that have been downloaded and extracted to the same directory.

Procedure

  1. Run the following Installation Manager command to generate encrypted passwords that can be used to securely connect to DB2.
    Important: If you are running Windows, start your command prompt by right-clicking and selecting Run as administrator.
    For Windows operating system
    extract_directory\IM64\tools\imutilsc -silent -nosplash encryptString password_to_encrypt
    For Linux operating system
    extract_directory/IM64/tools/imutilsc -silent -nosplash encryptString password_to_encrypt
  2. Read the terms of the license agreement in the product license files that are stored in the following subdirectory:
    • For Windows operating systemextract_directory\LICENSES
    • For UNIX operating systemFor Linux operating systemextract_directory/LICENSES
    You can accept these terms when you install the product.
  3. Run the following command:
    Important: If you are running Windows, start your command prompt by right-clicking and selecting Run as administrator.
    For Windows operating system
    extract_directory\IM64\tools\imcl install list_of_package_IDs -acceptLicense -installationDirectory location -repositories repository -properties key=value,key=value -showVerboseProgress -log logName.log
    For UNIX operating systemFor Linux operating system
    extract_directory/IM64/tools/imcl install list_of_package_IDs -acceptLicense -installationDirectory location -repositories repository -properties key=value,key=value -showVerboseProgress -log logName.log
    where:
    • list_of_package_IDs is a list of the IDs for the products and features that you want to install. You must include the required features. The syntax is packageID,feature,feature, with multiple products separated by spaces. You can omit the package IDs and features of any products that are already installed.
      Important: If your system does not have a graphical user interface, you will not be able to use the showVerboseProgress as shown on the sample invocation.
      Table 1. Package IDs
      Product Package ID Feature Description
      IBM Business Monitor com.ibm.websphere.MON.v85 Monitor.Production Business Monitor Server Production. Specify this feature if you are installing Business Monitor for production use.
      Monitor.NonProduction Business Monitor Server Non-production. Specify this feature if you are installing Business Monitor only for development, test, or staging purposes.
      WebSphere Application Server Network Deployment com.ibm.websphere.ND.v85 core.feature Required. WebSphere Application Server core content.
      ejbdeploy Pre-Enterprise JavaBeans (EJB) 3.0 modules.
      thinclient Stand-alone thin clients and resource adapters.
      embeddablecontainer Embeddable EJB container.
      samples Sample applications feature.
      com.ibm.sdk.6_64bit 64-bit SDK. This feature can be selected only on a 64-bit system.
      Installation Manager com.ibm.cic.agent agent_core Installation Manager core content.
      agent_jre Installation Manager Java Runtime Environment (JRE).
      DB2 Express for Linux 64-bit com.ibm.ws.DB2EXP.linuxia64 n/a DB2 must match the operating system and bit version.
      DB2 Express for Windows 64-bit com.ibm.ws.DB2EXP.winia64 n/a DB2 must match the operating system and bit version.
      IBM Cognos BI for Windows x64 (64-bit) com.ibm.ws.cognos.v1021.winia64 n/a IBM Cognos BI must match the operating system and the WebSphere Application Server bit version.
      IBM Cognos BI for AIX PPC 64-bit com.ibm.ws.cognos.v1021.aix64 n/a IBM Cognos BI must match the operating system and the WebSphere Application Server bit version.
      IBM Cognos BI for Linux x86-64 (64-bit) com.ibm.ws.cognos.v1021.linuxia64 n/a IBM Cognos BI must match the operating system and the WebSphere Application Server bit version.
      IBM Cognos BI for Solaris SPARC (64-bit) com.ibm.ws.cognos.v1021.solaris64 n/a IBM Cognos BI must match the operating system and the WebSphere Application Server bit version.
      IBM Cognos BI for Linux on System z com.ibm.ws.cognos.v1021.zlinux64 n/a IBM Cognos BI must match the operating system and the WebSphere Application Server bit version.
    • -acceptLicense indicates that you accept the terms of all the license agreements.
    • location is the path to the directory where you want to install the products. If you want to install into an existing supported instance of WebSphere Application Server Network Deployment, specify its directory.
      Tip:
      • Ensure that your installation path does not contain parentheses.
      • For Windows operating systemFor Linux operating systemIf you are installing DB2 Express, your installation path cannot contain National Language Strings (NLS).
      • For Linux operating systemFor UNIX operating systemEnsure that your installation path does not contain spaces.
      • For Windows operating systemKeep 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.
    • repository is the extract_directory/repository path to which you extracted the repository files. For more than one repository, separate the repository locations with commas.
    • key=value is a list of the keys and values that you want to pass to the installation, separated by commas. Do not put spaces between the commas.Create encrypted passwords by using the IBM Installation Manager, as described in step 1.
      Note: The keys prefixed user.db2 in the following table are applicable only when you install DB2 Express, which you must do as an administrative user.
      Table 2. Keys
      Key Description
      user.select.64bit.image If you are installing on a 64-bit operating system, add the following line exactly:
      user.select.64bit.image,com.ibm.websphere.ND.v85=true
      The default value is false.
      user.db2.admin.username Windows only. User name with authority to access the DB2 database. The default value is bpmadmin.
      user.db2.admin.password Windows only. Encrypted password for the user name with authority to access the DB2 database. Choose a password that complies with the password policy of your system (for example, Windows 2008).
      user.db2.port Port for the DB2 database. The default value is 50000.
      user.db2.instance.username Linux only. DB2 instance user name. The default value is bpminst.
      user.db2.instance.password Linux only. Encrypted password for the DB2 instance user name.
      user.db2.fenced.newuser Linux only. The value true is for a new user. The value false is for an existing user. If the value is false, then the user.db2.fenced.password is not needed.
      user.db2.fenced.username Linux only. Fenced user name. The default value is bpmfenc.
      user.db2.fenced.password Linux only. Encrypted password for the fenced user name.
      user.db2.das.newuser Linux only. The value true is for a new user. The value false is for an existing user. If the value is false, then the user.db2.das.password is not needed.
      user.db2.das.username Linux only. Administration server (DAS) user name. The default value is bpmadmin.
      user.db2.das.password Linux only. Encrypted password for the administration server user name.
    • logName is the name of the log file to record messages and results.
    Running this command installs the product with the default features. If you want to install specific features or make other changes, see the reference link for the command-line arguments for imcl.

Results

Installation Manager installs the list of products and writes a log file to the directory that you specified. The log file is empty if there are no errors or warnings.

Example

The following examples install IBM Business Monitor (for use in a production environment), WebSphere Application Server Network Deployment, IBM Cognos BI, and DB2 Express.

For Windows operating system
imcl install com.ibm.websphere.MON.v85,Monitor.Production com.ibm.websphere.ND.v85,core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_64bit com.ibm.ws.cognos.v1021.winia64 com.ibm.ws.DB2EXP.winia64 -acceptLicense -installationDirectory C:\IBM\MON85 -repositories D:\temp\MonServer\repository\WBM -properties user.db2.admin.username=bpmadmin,user.db2.admin.password=Vvrs88V/a9BUdxwodz0nUg== -showVerboseProgress -log silentinstall.log
For Linux operating system
imcl install com.ibm.websphere.MON.v85,Monitor.Production com.ibm.websphere.ND.v85,core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_64bit com.ibm.ws.cognos.v1021.linuxia64 com.ibm.ws.DB2EXP.linuxia64 -acceptLicense -installationDirectory /usr/IBM/MON85 -repositories usr/tmp/MonServer/repository/WBM -properties user.db2.instance.username=bpmadmin,user.db2.instance.password=Vvrs88V/a9BUdxwodz0nUg== -showVerboseProgress -log silentinstall.log

The following examples install IBM Business Monitor (for development, test, or staging purposes), WebSphere Application Server Network Deployment, and IBM Cognos BI.

For AIX operating system
imcl install com.ibm.websphere.MON.v85,Monitor.NonProduction com.ibm.websphere.ND.v85,core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_64bit com.ibm.ws.cognos.v1021.aix64 -acceptLicense -installationDirectory /usr/IBM/MON85 -repositories usr/tmp/MonServer/repository/WBM -showVerboseProgress -log silentinstall.log
For Solaris operating system
imcl install com.ibm.websphere.MON.v85,Monitor.NonProduction com.ibm.websphere.ND.v85,core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_64bit com.ibm.ws.cognos.v1021.solaris64 -acceptLicense -installationDirectory /usr/IBM/MON85 -repositories usr/tmp/MonServer/repository/WBM -showVerboseProgress -log silentinstall.log

What to do next

For Windows operating systemTo enhance your ability to access IBM Business Monitor data, you can additionally install the IBM Business Monitor add-in for Microsoft Excel from the launchpad or from a setup file. This add-in is used to import IBM Business Monitor data for instances, alerts, and key performance indicators (KPIs) into a Microsoft Excel spreadsheet. After you import the data into a spreadsheet, you can use any of the features in Microsoft Excel to manipulate and present the data. For more information about installing and using this add-in, see Monitoring from your desktop.

After you install IBM Business Monitor, you must configure the product by creating profiles, setting up database tables, and configuring the environment. You can use tools such as Profile Management Tool, the manageprofiles command, and the monConfig command to complete these steps.

Only profiles that are created with the Profile Management Tool or manageprofiles command can be used in production.

Parent topic: Installing IBM Business Monitor silently
Related reference:
System requirements for IBM Business Monitor
IBM Installation Manager information center
Command-line arguments for imcl
Related information:
Directory conventions
Installation and profile creation log files