Linux: Installing monitoring agents, or application support files in an existing IBM Tivoli Monitoring environment on AIX® and Linux systems

If you have an existing IBM® Tivoli® Monitoring server that does not have Tivoli Monitoring for Tivoli Storage Manager installed, you can run the native IBM Tivoli Monitoring installation wizard to install more monitoring agents. If you do not want to install the agent, you can install only the application support files, which are required by the Tivoli Enterprise Monitoring server and Tivoli Enterprise Portal server to monitor Tivoli Storage Manager servers.

Before you begin

Restrictions to know before you begin:
These procedures are for experienced IBM Tivoli Monitoring users only, and are not intended for novice Tivoli Monitoring for Tivoli Storage Manager users. Do not install this option if you previously installed Tivoli Monitoring for Tivoli Storage Manager. Doing so can interfere with future uninstallations or upgrades of Tivoli Monitoring for Tivoli Storage Manager. You must use Tivoli Monitoring for Tivoli Storage Manager only with IBM Tivoli Monitoring, version 6.3.0 FP2 or later. See the system requirements for your operating system for more requirements. Ensure that you meet all system requirements.

Restrictions to know before you begin:

These procedures are for experienced IBM Tivoli Monitoring users only, and are not intended for novice Tivoli Monitoring for Tivoli Storage Manager users.
Do not install this option if you previously installed Tivoli Monitoring for Tivoli Storage Manager. Doing so can interfere with future uninstallations or upgrades of Tivoli Monitoring for Tivoli Storage Manager.
You must use Tivoli Monitoring for Tivoli Storage Manager only with IBM Tivoli Monitoring, version 6.3.0 FP2 or later. See the system requirements for your operating system for more requirements.
Ensure that you meet all system requirements.

Procedure

To install the monitoring agent or application support files with a user ID that has root privileges, complete the following steps:

Download the package from one of the following websites:
- Go to Passport Advantage® site at http://www.ibm.com/software/lotus/passportadvantage/.
- Go to the Tivoli Storage Manager support site at http://www.ibm.com/support/entry/portal/Overview/Software/Tivoli/Tivoli_Storage_Manager for maintenance fixes, and updates.
The file name for installing only the monitoring agent, or only the application support files, can be recognized by the word AGENT in capital letters, for example:
```
7.1.0.000-TIV-TSMRPT-AGENT-Linux.bin
```
From a command line, go to the following directory:
```
cd install_dir/bin
```
where the install_dir is the IBM Tivoli Monitoring installation directory. The default directory is /opt/IBM/ITM.

Stop all of the Tivoli Storage Manager processes and agent instances by using the CandleManage application, or the command-line interface.

Tip: Always stop processes by issuing the itmcmd commands, or from the Manage Tivoli Enterprise Monitoring Services application. Do not stop processes by using the operating system.

Stop the processes by using CandleManage: Stop the processes by using the command-line interface:

Stop the processes by using CandleManage:	Stop the processes by using the command-line interface:
Run the CandleManage program by issuing the following command: `./CandleManage &`	Display the agents that are running by issuing the following command, and checking the output for the list of services that are running: `./cinfo -r` Stop the Summarization and Pruning agent by issuing the following command: `./itmcmd agent stop sy` Stop the Warehouse Proxy by issuing the following command: `./itmcmd agent stop hd` Stop the Tivoli Enterprise Portal server by issuing the following command: `./itmcmd agent stop cq` Stop the Tivoli Enterprise Monitoring server by issuing the following command: `./itmcmd server stop tems_server` Stop all of the Tivoli Storage Manager instances by issuing the following command: `./itmcmd agent -o instance_name stop sk` Stop all of the IBM Eclipse server by issuing the following command: `./itmcmd server -o stop kf`

Run the CandleManage program by issuing the following command:
```
./CandleManage &
```

Display the agents that are running by issuing the following command, and checking the output for the list of services that are running:
```
./cinfo
 -r
```
Stop the Summarization and Pruning agent by issuing the following command:
```
./itmcmd agent stop sy
```
Stop the Warehouse Proxy by issuing the following command:
```
./itmcmd
agent stop hd
```
Stop the Tivoli Enterprise Portal server by issuing the following command:
```
./itmcmd agent stop cq
```
Stop the Tivoli Enterprise Monitoring server by issuing the following command:
```
./itmcmd server stop tems_server
```
Stop all of the Tivoli Storage Manager instances by issuing the following command:
```
./itmcmd agent -o instance_name stop
sk
```
Stop all of the IBM Eclipse server by issuing the following command:
```
./itmcmd
server -o stop kf
```

Enter the following command in the directory where you extracted the installation files:
```
./install.sh
```
Optionally: If you are installing from the DVD media, go to the top-level directory on the DVD and issue the following command:
```
./install.sh
```
Press Enter to accept the /opt/IBM/ITM path as the default directory, or specify the full path to a different directory. If the specified directory does not exist, enter y when prompted to create it.
Tip: If you are installing into an existing IBM Tivoli Monitoring environment, choose the same directory where IBM Tivoli Monitoring is installed. For example, if you installed IBM Tivoli Monitoring in the /opt/IBM/ITM directory, specify /opt/IBM/ITM as the destination folder for this installation.

Enter 1 at the prompt to Install products to the local host. For example:

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:  1

Enter 1 to accept the license agreement.

When the list of products that can be installed is displayed, you can choose to install the monitoring agent, or you can install only the application support files. To install the monitoring agent, you would select number 1 and after that completes, you would specify a value of 2, to install the support files for Tivoli Enterprise Portal Browser Client support. After that completes, you would specify a value of 3, and so on, until you specified all of the support files. If you are installing only the application support files, you would begin by selecting 2, then 3, then 4, and finally 5. For example:

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
[number "1" or "IBM Tivoli Monitoring components for this operating system" 
is default]:2

Installing the monitoring agent:	Installing the application support files:
Use this option if you intend to create and configure an agent instance on the Tivoli Enterprise Monitoring server. Enter the number that corresponds to the `IBM Tivoli Monitoring components for this operating system` option. Enter a 32-character encryption key, or press `Enter` to use the default key. Restriction: All agents must use the same encryption key that was specified during installation of the monitoring server. The default encryption key is: `IBMTivoliMonitoringEncryptionKey`.	You must install the application support files so that the Tivoli Monitoring for Tivoli Storage Manager agent can display Tivoli Storage Manager data in Tivoli Enterprise Monitoring server and Tivoli Enterprise Portal server. Enter the number that corresponds to the `Tivoli Enterprise Portal Browser Client Support` option. Enter the number that corresponds to the `Tivoli Enterprise Portal Desktop Client Support` option. When prompted again, Enter the number that corresponds to the `Tivoli Enterprise Portal Server Support` option. When prompted again, Enter the number that corresponds to the `Tivoli Enterprise Monitoring Server Support` option.

Installing the monitoring agent:

Installing the application support files:

Use this option if you intend to create and configure an agent instance on the Tivoli Enterprise Monitoring server.

Enter the number that corresponds to the IBM Tivoli Monitoring components for this operating system option.
Enter a 32-character encryption key, or press Enter to use the default key.
Restriction: All agents must use the same encryption key that was specified during installation of the monitoring server. The default encryption key is: IBMTivoliMonitoringEncryptionKey.

You must install the application support files so that the Tivoli Monitoring for Tivoli Storage Manager agent can display Tivoli Storage Manager data in Tivoli Enterprise Monitoring server and Tivoli Enterprise Portal server.

Enter the number that corresponds to the Tivoli Enterprise Portal Browser Client Support option.
Enter the number that corresponds to the Tivoli Enterprise Portal Desktop Client Support option.
When prompted again, Enter the number that corresponds to the Tivoli Enterprise Portal Server Support option.
When prompted again, Enter the number that corresponds to the Tivoli Enterprise Monitoring Server Support option.

Reconfigure the Tivoli Enterprise Portal server by issuing the following command, follow the prompts, and accept all default values:
```
/opt/IBM/ITM/bin/itmcmd config -A cq
```
Start the Tivoli Enterprise Portal server by issuing the following command:
```
/opt/IBM/ITM/bin/itmcmd agent start cq
```
Restart any agents that you stopped at the beginning of this installation.

What to do next

After you complete the installation, you must configure Tivoli Enterprise Portal to collect and retain historical data for reports. See Linux: Configuring historical data collection by using the command-line interface on AIX and Linux systems.

You can also create and configure an agent instance. See Creating and configuring the agent instance.