AIX: Configuring historical data collection by using the command-line interface on AIX® and Linux systems

After you install the monitoring agents in an existing IBM® Tivoli® Monitoring environment, you must configure historical data collection if you intend to generate reports based on this data.

About this task

If you installed Tivoli Monitoring for Tivoli Storage Manager by using the standard installation method, historical data collection was configured for you automatically. If you are using the native IBM Tivoli Monitoring installer, then you must manually configure historical data collection.

You can also configure historical data collection from within the Tivoli Enterprise Portal. However, it is much quicker using the command-line interface because there are many attribute groups that must be configured.

You must configure history configuration to have the data from the monitored servers stored in the WAREHOUS database. This is a requirement if you plan to use Tivoli Common Reporting to view historical reports.

The following commands can be copied and pasted in to a terminal session window. Be sure to adjust any of the variables such as your password, to match your installation environment before pasting them in to a terminal session.

Procedure

To configure historical data collection and summarization and pruning, complete the following steps:

Issue the following commands and specify the sysadmin ID and password, and the CandleManage directory:
```
export admin=sysadmin
export pswd=your_password 
export CANDLE_HOME=/opt/tivoli/tsm/reporting/itm
```

Paste the following text in the same terminal window:

Tip: Remember to change the sysadmin ID and password variables to match the values that you specified during installation.

export warehouseinterval=1h
export collectioninterval=1h
export summarization=HDWMQY
export type="Tivoli Storage Manager"
cd $CANDLE_HOME/bin
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK CLIENT NODE STORAGE"
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK CLIENT MISSED FILES"
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK CLIENT NODE STORAGE"
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK DATABASE" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK SCHEDULE" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK STORAGE POOL" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK TAPE USAGE" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK TAPE VOLUME" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK NODE ACTIVITY" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK SERVER" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK STORAGE DEVICE" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK ACTIVITY LOG" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK OCCUPANCY" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK REPLSTATUS" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK REPLDETAILS" 
./tacmd histconfiguregroups -u $admin -w $pswd -t "$type" -i $warehouseinterval 
  -c $collectioninterval -d $summarization -o "KSK ACTIVITY SUMMARY"

Start collecting data by issuing the following commands:

./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  CLIENT NODE STORAGE"
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  CLIENT MISSED FILES"
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  CLIENT NODE STORAGE"
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  DATABASE" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  SCHEDULE" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  STORAGE POOL" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  TAPE USAGE" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  TAPE VOLUME" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  NODE ACTIVITY" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  SERVER" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  STORAGE DEVICE" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  ACTIVITY LOG" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  OCCUPANCY" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  REPLSTATUS" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  REPLDETAILS" 
./tacmd histstartcollection -u $admin -w $pswd -t "$type" -o "KSK 
  ACTIVITY SUMMARY"