zWBMInstall.sh script

Depending on the option you use when you run the zWBMInstall.sh script, the script installs IBM Business Monitor for z/OS, uninstalls IBM Business Monitor for z/OS, or just validates the arguments and prerequisites without altering the system. When you are installing IBM Process Server, you must run the zWBMInstall.sh script on every node in your configuration before augmenting the node.

Run the command from the IBM Business Monitor for z/OS path name created by the SMP/E installation. By default the location is /usr/lpp/zWBM/V7R5M1/zos.config/bin. This location also contains a script called zSMPInstall.sh, which is run automatically when you run the zWBMInstall.sh script; do not manually run the zSMPInstall.sh script.

Syntax

>>-zWBMInstall.sh-- -smproot--installation_file_system_root----->

>-- -runtime--configuration_file_system_root-------------------->

>--+- -prereqonly-------------------------------------------------------------+-->
   +- -install----------------------------------------------------------------+   
   |                                                  .---------------------. |   
   |                                                  V                     | |   
   '- -uninstall-- -response--response_file_location----+-----------------+-+-'   
                                                        '--Zkeyword=value-'       

>--+------------------------------------+----------------------><
   |          .-*=all=disabled--------. |   
   '- -trace--+-----------------------+-'   
              +-*=all=enabled---------+     
              '-Installer=all=enabled-'     

Required parameters

-prereqonly

This parameter validates the prerequisites and verifies arguments.

-runtime configuration_file_system_root

When you run zWBMInstall.sh, you are extending IBM Business Monitor for z/OS features into the directory specified by the -runtime parameter value. The standard path to this directory for a stand-alone configuration is /WebSphere/V7R0/AppServer, and the standard path to this directory for a deployment manager configuration is /WebSphere/V7R0/DeploymentManager. This is a WebSphere Application Server installation.

-smproot installation_file_system_root

The root of the installation file system for IBM Business Monitor for z/OS created by SMP/E. For example, /usr/lpp/zWBM/V7R5M1.

Optional parameters

-install

When this parameter is used, the zWBMInstall.sh script performs the following tasks:

• Validates the prerequisites.
• Creates the symbolic links from the IBM Business Monitor for z/OS installation file system to the WebSphere Application Server lib and bin directories in the configuration file system.
• Updates the code base permissions.
• Updates the administrative console with the IBM Business Monitor product definitions, including definitions for the following components:
  • IBM Business Monitor core resources
  • Common Event Infrastructure (CEI)

-response response_file_location

The absolute path of the response file that you used when you ran the zWBMConfig.sh script on the node. This enables the uninstaller to remove the configuration as well as uninstall the product from the node. For example, if you have taken a copy of the sample response file before editing it, the location of the response file could be /u/clare/DmgrDB2.rsp.

-trace

The command writes to the appropriate trace file. You can enter one of the following values:

• To record no trace information, type *=all=disabled. If you do not specify the -trace parameter, this value is used by default.
• To record all trace information, type *=all=enabled.
• To record trace information about only the Installer group of Java™ classes, type Installer=all=enabled. The trace is written to the file zWBMInstall.trace in AppServer_Root/logs/wbm.

-uninstall

When you use this parameter, the zWBMInstall.sh script performs the following tasks:

• Disables IBM Business Monitor features by running Configuration Manager scripted actions. This removes any IBM Business Monitor administrative console plug-in extensions.
• Removes profile augmentation using WSPROFILE scripted actions. This un-augments the default profile.
• Deletes post-installation files.
• Removes code base permissions.

You must specify the -response parameter so that the uninstaller can undo the configuration during the uninstallation.

-Zkeyword=value

Overrides keyword values in the response file. You can specify the -Z parameter multiple times, once for each keyword that you want to override. For example, -ZnodeName=NODE1.