IBM Tivoli Monitoring, Version 6.3

Installing the monitoring agent

Objective

To install the Monitoring Agent for IBM i OS.

Background information

This procedure uses the Restore Licensed Program to complete installation of the Monitoring Agent for IBM i OS.

You can install the Monitoring Agent for IBM i OS from a PC or from an iSeries® computer, whichever method is more convenient at your site. This procedure includes instructions for both methods.

Required authorization role

Sign on as QSECOFR or with a profile with an equivalent special authority (SPCAUT):

*ALLOBJ
*AUDIT
*IOSYSCFG
*JOBCTL
*SAVSYS
*SECADM
*SERVICE
*SPLCTL

Before you begin

Before beginning this procedure, install IBM Tivoli Monitoring and the Tivoli Enterprise Portal as described in the IBM Tivoli Monitoring Installation and Setup Guide and complete the procedures in Preparing for installation if necessary.

When you finish

Configure the Monitoring Agent for IBM i OS as described in Configuring the monitoring agent.

Procedure

From an IBM i OS command line, ensure that the QALWOBJRST system value is set to *ALL. To do this, follow these steps:
1. Enter the following command:
```
WRKSYSVAL QALWOBJRST
```
2. Select 5 (Display) and verify that the value is set to *ALL.
3. Press Enter to continue.
4. If the value of QALWOBJRST is set to *ALL, go to step 3. If the value of QALWOBJRST is not set to *ALL, make note of the values and go to step 2.
If the value of QALWOBJRST is not set to *ALL, follow these steps:
1. On the Work with System Values window, enter 2 to change the values.
2. On the Change System Value window, change the existing values to *ALL and press Enter.
3. Press F3.
From an IBM i OS command line, enter the following command to create an IBM i OS CCCINST library for the Monitoring Agent for IBM i OS installation if this library does not already exist:
```
CRTLIB LIB(CCCINST)
```
Enter the following command to create a save file in the CCCINST library for the Monitoring Agent for IBM i OS:
```
CRTSAVF CCCINST/A4520CMA TEXT('ITM 62 IBM i OS')
```
Note: When pasting this command to an IBM i OS session, the single quote (') characters that enclose the text string might be missing. If this happens, manually add the single quote (') characters for the command to work.
Transfer the software for the Monitoring Agent for IBM i OS to the target IBM i OS. Do one of the following:
- From a PC, follow these steps:
  1. Insert the IBM Tivoli Monitoring, V 6.2.3 product CD into the PC CD-ROM drive.
  2. From a DOS command prompt, enter the following command to start an FTP session:
```
ftp computer_name
```
    where computer_name is the name of the target IBM i OS.
  3. Enter the following command to change to the file type to binary:
```
binary
```
  4. Enter the following command to transfer the software for the monitoring agent:
```
put cdrom_drive_letter:\OS400\TMAITM6\A4520CMA.SAV 
CCCINST/A4520CMA (replace
```
  5. Enter the following command to end the FTP session:
```
bye
```
- From an IBM i OS system, follow these steps:
  1. Insert the IBM Tivoli Monitoring, V6.2.3 product CD into the CD-ROM drive.
  2. Enter the following command to create a work folder:
```
WRKFLR
```
  3. Select 1 (Create Folder) and specify the following name for the folder:
```
A4FLR
```
  4. Enter the following command:
```
WRKLNK QOPT
```
    The Work with Object Links window displays the qopt object link.
  5. Select 5 (Next Level) at the qopt object link to select the next object link, the volume ID of the CD-ROM. Make note of this volume ID for use in the remainder of this procedure.
  6. Continue to select 5 for each link level until the /QOPT/volume_id/OS400/TMAITM6 path is displayed, where volume_id is the volume ID of the CD-ROM drive from step 5.e.
  7. Look for the A4520CMA.SAV file and enter the following command to copy this save file to the QDLS directory:
```
CPY OBJ('/QOPT/volume_id/OS400/TMAITM6/A4520CMA.SAV') TODIR('/QDLS/A4FLR')
```
    where volume_id is the volume ID of the CD-ROM drive from step 5.e.
  8. Enter the following command to start an FTP session:
```
ftp computer_name
```
    where computer_name is the name of the target IBM i OS system.
  9. Enter the following command to change to the file type to binary:
```
binary
```
  10. Enter the following command:
```
NAMEFMT 1
```
  11. Enter the following command to transfer the software for the monitoring agent:
```
put /QDLS/A4FLR/A4520CMA.SAV /QSYS.LIB/CCCINST.LIB/A4520CMA.SAVF
```
  12. Enter F3 and select 1 to end the FTP session.
From an IBM i OS command line, install the software for the Monitoring Agent for IBM i OS. Do one of the following:
- If you are installing the monitoring agent on a system that is set to the English language (language ID 2924), enter the following command:
```
RSTLICPGM LICPGM(5724C04) DEV(*SAVF) SAVF(CCCINST/A4520CMA)
```
- If you are installing the monitoring agent on a system that is not set to language ID 2924, enter the following two commands:
```
RSTLICPGM LICPGM(5724C04) DEV(*SAVF) RSTOBJ(*PGM)
SAVF(CCCINST/A4520CMA)

RSTLICPGM LICPGM(5724C04) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924)
SAVF(CCCINST/A4520CMA) LNGLIB(QKA4LNG)
```
The Software Agreement display is shown. Use the function keys described along the bottom of the screen to select the appropriate language version of the agreement to display, and to accept or decline the agreement. The agreement must be accepted before the agent installation can continue.
If you plan to install other monitoring agents, leave the value of QALWOBJRST set to *ALL until you are finished. If you do not plan to install other monitoring agents, change the value of QALWOBJRST to the values you recorded in 1.d.
Optional: Enter the following command to delete the installation library, which is no longer needed:
```
DLTLIB CCCINST
```
Optional: Delete the A4520CMA.SAV file from your folder. Follow these steps:
1. Enter the following command:
```
WRKDOC FLR(A4FLR)
```
2. Enter 4 for the A4520CMA.SAV file.
3. Press Enter to return to the command line.
4. Enter the following command to delete the installation folder:
```
WRKFLR
```
5. Enter 4 for the A4FLR folder.
6. Press F3 to return to the command line.

Feedback