IBM Tivoli Monitoring, Version 6.3

cinfo

Description

Use the cinfo command to view the following information for your monitoring server:
  • An inventory of installed IBM® Tivoli® products
  • The configuration settings for products
  • The configuration settings for products in the context of the actual variables used by the installation program
  • A list of running IBM Tivoli processes (such as agents or monitoring server)
  • A validated list of running IBM Tivoli processes, after first performing an update on the tracking database, to remove stale PIDs (processes logged as "running" but not found when attempting to verify by using the ps command)
  • The product name, version, build information, and installation date for all of the products installed in the installation directory

The command can be run in several ways.

Typing cinfo enables this menu: 
-- CINFO Menu --
1) Show products installed in this CandleHome
2) Show which products are currently running
3) Show configuration settings
4) Exit CINFO
The command can also be run without a menu, so the three numbered options above can be invoked as: 
cinfo -i
cinfo -r
cinfo -c all or cinfo -c <pc>
Typing cinfo -? displays this help: 
cinfo [-h candle_directory] [-b] [-c product] [-d] [-e] [-e product] [-g] [-i] [-o] 
[-o product] [-p product] [-r] [-R] [-s product] [-t] [-t product]
-b Dumps an inventory of installed products with build information
-c <product> Displays configuration prompts and configuration values
-d Dumps an inventory of installed products
-e or -e <product> Displays the product name, version, build information and 
application support propagation status for installed agents
-g Enable globalization
-i Displays an inventory of installed products
-o or -o <product> Lists configured instances
-p <product> Shows associated platform codes for the specified product
-r Shows running processes
-R Shows running processes, after updating a tracking database
-s <product> Displays configuration parameters and settings
-t or -t <product> Displays the product name, version, build information and 
installation date

CLI syntax

cinfo [-h install_dir]
      {[-b] |
      [-c {pc|all}] |
      [-d] |
      [-e [pc]] |
      [-g] |
      [-i] |
      [-o [pc]] |
      [-p {pc}] |
      [-r] |
      [-R] |
      [-s {pc|all}] |
      [-t [pc]] }

where:
-h install_dir
Identifies the installation directory if it is not the one in which the script is located.

Also use this option to take action on an IBM Tivoli Monitoring installation directory other than the one in the current system.

-b
Dumps an inventory of installed products with build information.
-c {pc}
Lists configuration prompts and configuratioin values for all components (by default) or for a specific component (identified by product code). If you use the product code, you can only enter one code.
Note: When you are running cinfo -c cq and are asked whether "you are using DB2, Oracle, or None for Warehouse? [1=DB2, 2=Oracle, 3=None]", JDBC=Oracle and None=Debby.
-d
Dumps an inventory of installed products.
-e [pc]
Displays the product name, version, build information and application support propagation status (the “SDA STATUS” column) for installed agents. Use the cinfo -e [pc] command with the product code of the particular agent or the cinfo -e command to list the information for all of the installed agents.
-g
Enables globalization.
-i
Shows an inventory of installed components. Lines starting with an architecture string indicate that the set of binaries for that component are installed. The following table specifies the strings at the beginning of the line(s) and their implication.
Table 1. String at beginning of lines and their implication
String at Start of Line Description
tms Application support for the Tivoli Enterprise Monitoring Server has been installed
tpa Application support for the Tivoli Performance Analyzer has been installed
tpd Application support for the Desktop Client has been installed
tps Application support for the Tivoli Enterprise Portal Server has been installed
tpw Application support for the Tivoli Enterprise Portal has been installed
-o [pc]
Lists configured instances for the product, if specified, or all of the products, if not specified.
-p {pc}
Shows associated platform codes for the product, if specified, or all of the products, if not specified.
-r
Shows the running processes.
-R
Shows the running processes, after updating a tracking database.

All started processes started and stopped by IBM Tivoli Monitoring commands are logged in a tracking database that does not automatically update itself if the process abnormally ends or is stopped without using an IBM Tivoli Monitoring command (for example, by using the UNIX kill command directly on the process). The -r option shows even these defunct processes in its report. In contrast, the -R option updates the tracking database before reporting the results. This results in a cleaner report, but permanently erases the history of processes normally kept in the tracking database.

The output of the -R option looks the same as the -r option, but any "process not running" messages are absent.

-s {pc|all}
Shows the configuration parameters and settings for either a single component (identified by using the product code) or for all installed components.
-t [pc]
Displays the product name, version, build information, and installation date for all of the products installed in the installation directory. See the IBM Tivoli Monitoring Installation and Setup Guide for information on arch abbreviations.

CLI example

The following example shows all installed products: 
   cinfo -i
The following is the output of this example: 
*********** Tue Mar 22 13:48:17 CET 2011 ******************
User: root Groups: root bin daemon sys adm disk wheel
Host name : NC045192     Installer Lvl:06.23.00.00
CandleHome: /opt/IBM/ITM
***********************************************************
...Product inventory

a4      Monitoring Agent for i5/OS
         tms     Version: 06.23.00.00

ax      IBM Tivoli Monitoring Shared Libraries
         li6263  Version: 06.23.00.00

gs      IBM GSKit Security Interface
         li6243  Version: 07.40.27.00

hd      Warehouse Proxy
         tms     Version: 06.23.00.00

(...)
The following example shows the running processes: 
   cinfo -r
The following is the output of this example: 
*********** Tue Mar 22 13:52:37 CET 2011 ******************
User: root Groups: root bin daemon sys adm disk wheel
Host name : NC045192     Installer Lvl:06.23.00.00
CandleHome: /opt/IBM/ITM
***********************************************************
Host      Prod  PID    Owner  Start  ID    ..Status
nc045192  ms    22072  root   13:52  TEMS  ...running
The following example shows the configuration settings for the Universal Agent: 
   cinfo -c um
The following is the output of this command: 
*********** Tue Mar 22 13:58:32 CET 2011 ******************
User: root Groups: root bin daemon sys adm disk wheel
Host name : NC045192     Installer Lvl:06.23.00.00
CandleHome: /opt/IBM/ITM
***********************************************************

Configuration    Setting
um  default      "Network Protocol 3 " = none
um  default      "Data Provider" = ASFS
um  default      "Secondary TEMS IP.PIPE Port Number" = 1918
um  default      "Secondary TEMS IP.SPIPE Port Number" = 3660
um  default      "Secondary TEMS Log Mode" = LOGMODE
um  default      "Secondary TEMS LU Name" = LUNAME
um  default      "Secondary TEMS Net Name" = CANDLE
um  default      "Secondary TEMS IP Port Number" = 1918
um  default      "IP.PIPE Port Number" = 1918
um  default      "IP.SPIPE Port Number" = 3660
um  default      "Log Mode" = LOGMODE
um  default      "LU Name" = LUNAME
um  default      "Net Name" = CANDLE
um  default      "IP Port Number" = 1918
um  li6263       "Network Protocol 3 " = none
um  li6263       "Will this agent connect to a TEMS? [1=YES, 2=NO]" = 1
um  li6263       "Data Provider" = ASFS
um  li6263       "Configure connection for a secondary TEMS? [1=YES, 2=NO]" = 2
um  li6263       "TEMS Host Name" = nc045192
um  li6263       "Secondary TEMS IP.PIPE Port Number" = 1918
um  li6263       "Secondary TEMS IP.SPIPE Port Number" = 3660
um  li6263       "Secondary TEMS Log Mode" = LOGMODE
um  li6263       "Secondary TEMS LU Name" = LUNAME
um  li6263       "Secondary TEMS Net Name" = CANDLE
um  li6263       "Secondary TEMS IP Port Number" = 1918
um  li6263       "IP.PIPE Port Number" = 1918
um  li6263       "IP.SPIPE Port Number" = 3660
um  li6263       "Log Mode" = LOGMODE
um  li6263       "LU Name" = LUNAME
um  li6263       "Net Name" = CANDLE
um  li6263       "IP Port Number" = 1918
um  li6263       "Enter Optional Primary Network Name or 0 for "none"" = none

Return values

An exit status of 0 indicates that the command ran successfully. An exit status greater than 0 indicates that there was a failure in the process.

Related commands

Return to Table 1.


Feedback