IBM WebSphere Message Broker Monitoring, WebSphere MQ Monitoring, and WebSphere MQ Configuration agents, Version 7.1

Installing from the command line

Instructions for installing an agent on a UNIX or Linux system are as follows:

Important: If you are upgrading an ITCAM configuration agent for WebSphere® MQ from a previous version, the existing mc.cfg and mc.ini configuration files are overwritten. If you want to keep your existing configuration files, create a backup before proceeding.

Log on to the system where you want to install an agent.
Remember: If you used a non-root user ID to install an IBM® Tivoli® Monitoring component on this computer and you want to install the agent in the directory where the IBM Tivoli Monitoring component is installed, you must use the same user ID to install the agent.
Run the following command to create a temporary directory on the computer on which you plan to install an agent. Make sure that the full path of the directory does not contain any spaces:
```
mkdir dir_name
```
Mount the product installation DVD for UNIX or Linux systems to the temporary directory that you created.
Run the following commands:
```
cd dir_name
./install.sh
```
where dir_name is the temporary directory that you created.
When prompted for the IBM Tivoli Monitoring directory, press Enter to accept the default (/opt/IBM/ITM) or type the full path to the installation directory and press Enter.
If a message is displayed stating that the directory already exists and asking whether to use it, type 1 and press Enter.
If a message containing a list of running processes and warning you that running products will be restarted during installation is displayed, to continue with installation, type 1 and press Enter.

The following prompt is displayed. Type 1 to start the installation and press Enter.

Select one of the following:
 1) Install products to the local host. 
 2) Install products to depot for remote deployment (requires TEMS). 
 3) Install TEMS support for remote seeding.
 4) Exit install. 
Please enter a valid number:

The first part of the software license agreement is displayed.

Press Enter to view latter parts of the agreement. After you have finished viewing the agreement, enter 1 to accept it or 2 to reject it and press Enter.
Remember: You must accept the agreement to continue with the installation process.
When you are prompted for the encryption key, enter a 32-character key, or press Enter to use the default. The encryption key is used to secure password transmission and other sensitive data across your IBM Tivoli Monitoring environment. The default is IBMTivoliMonitoringEncryptionKey.

The following prompt is displayed. Type 1 to select IBM Tivoli Monitoring components and press Enter.

Product packages are available for this operating system and component support 
   categories:

 1) IBM Tivoli Monitoring components for this operating system
 2) Tivoli Enterprise Portal Browser Client support
 3) Tivoli Enterprise Portal Desktop Client support
 4) Tivoli Enterprise Portal Server support
 5) Tivoli Enterprise Monitoring Server support
 6) Other operating systems

Type the number or type "q" to quit selection

To confirm the selection, type 1 and press Enter. A numbered list of available components is displayed as follows:

1) Tivoli Enterprise Services User Interface Extensions V06.22.02.00
2) WebSphere MQ Configuration Agent V07.10.00.00
3) WebSphere MQ Monitoring Agent V07.10.00.00
4) Websphere Message Broker Monitoring Agent V07.10.00.00
5) all of the above

Type the number that corresponds to the agent that you want to install on this computer and press Enter. If you want to install more than one component, use a comma (,) or space to separate the numbers for each component.
- Select WebSphere MQ Configuration Agent if you want to install the ITCAM configuration agent for WebSphere MQ.
- Select WebSphere MQ Monitoring Agent if you want to install the ITCAM agent for WebSphere MQ.
- Select WebSphere Message Broker Monitoring Agent if you want to install the ITCAM agent for WebSphere Message Broker.
A list of the components to be installed is displayed. Type 1 and press Enter to confirm the selection and start the installation process.
After all the components are installed, you are asked whether you want to secure this IBM Tivoli Monitoring installation. Type your choice and press Enter.
When you are asked whether you want to install additional products or product support packages. Type 2 and press Enter to exit the installation process.

You have finished installing the agents. The next step is to Configuring to connect an agent to the Tivoli Enterprise Monitoring Server.

Important: ITCAM agent for WebSphere MQ, ITCAM configuration agent for WebSphere MQ, and ITCAM agent for WebSphere Message Broker are 32-bit systems regardless of whether your operating system is 32-bit or 64-bit.

Remember:

If you want to run the agent with another user ID that is different from the one that you used to install the agent, you must follow the steps in Changing the file permissions for agents before you can start the agent.
If you installed the ITCAM agent for WebSphere Message Broker as a root user, you cannot run the agent as the root user. The user ID that is used to run the agent must belong to the mqm and mqbrkrs user groups. You must also change the agent file permissions to ensure that this user ID can run the agent successfully. For instructions, see Changing the file permissions for agents.

Feedback