Configuration files and parameters

The GPM4CIM parameters are supplied with the platform specific configuration files /etc/gpm/gpm4[A|X|Z|W].cfg. This allows you to run one separate GPM4CIM instance per platform, which is required if you want to monitor AIX®, Linux and Windows systems in a mixed environment.

Of course, you can also start multiple instances of GPM4CIM for the same platform. In this case, provide a dedicated copy of the configuration file per instance, for example, gpm4a1.cfg and gpm4a2.cfg and use these names in the GPM4CIM procedures (Figure 1).

Figure 1. GPM4CIM configuration file example for AIX

/*********************************************************************/
/*                                                                   */
/* Name:        gpm4A.cfg                                            */
/*                                                                   */
/* Description: Configuration for the RMF Distributed Data Server    */
/*              USS/CIM (GPM4CIM)                                    */
/*                                                                   */
/*********************************************************************/
CACHESLOTS(3)                   /* Number of timestamps in CACHE     */
DEBUG_LEVEL(0)                  /* No informational messages         */
SERVERHOST(*)                   /* Don't bind to specific IP-Address */
TIMEOUT(0)                      /* No timeout                        */
MAXSESSIONS_HTTP(20)            /* MaxNo of concurrent HTTP requests */
HTTP_PORT(8805)                 /* Port number for HTTP requests     */
HTTP_ALLOW(*)                   /* Mask for hosts that are allowed   */
HTTP_NOAUTH()                   /* No server can access without auth.*/
/*********************************************************************/
/* Declaration of Host Connections with CIM Instrumentation          */
/* ========================================================          */
/* - INTERVAL is the monitoring interval length,                     */
/*   value is given in seconds.                                      */
/*   Example:  INTERVAL(900)                                         */
/*   Default:  INTERVAL(300)                                         */
/*                                                                   */
/*   - AIX_Complex is the name for the root resource.                */
/*   Example: AIX_COMPLEX(SAPPLEX)                                   */
/*                                                                   */
/*   - AIX_IMAGE is the host name or IP-address of a                 */
/*   CIM connection including the port number.                       */
/*   Example: AIX_IMAGE(SAP1.US.IBM.COM:5988)                        */
/*                                                                   */
/*********************************************************************/
INTERVAL(300)                   /* Data monitoring interval (seconds)*/
RECORD(YES)                     /* Collect SMF record type 104 data  */
AIX_COMPLEX(P6PLEX)             /* User defined name of CIM complex  */
                                /* AIX images following here         */
AIX_IMAGE(P6RMF1.DE.ABC.COM:5988)
AIX_IMAGE(P6RMF2.DE.ABC.COM:5988)
AIX_IMAGE(P6RMF3.DE.ABC.COM:5988)

The parameters CACHESLOTS through HTTP_NOAUTH are common parameters for both procedures, GPM4CIM and GPMSERVE, as described in DDS options.

The following parameters are specific for GPM4CIM only:

AIX_COMPLEX | LNX_COMPLEX | LNZ_COMPLEX | WIN_COMPLEX

Name for the root resource of the GPM4CIM instance. You can use your own name. This name appears as resource name for the resource type AIX_SYSTEM_COMPLEX for AIX, XLINUX_SYSTEM_COMPLEX for Linux on System x®, ZLINUX_SYSTEM_COMPLEX for Linux on System z®, or WINDOWS_SYSTEM_COMPLEX for Windows on System x.

AIX_IMAGE | LNX_IMAGE | LNZ_IMAGE | WIN_IMAGE

Host name or IP address of an image running the specified operating system, including the port number. Due to different resource models, all images within the same complex must run the same operating system.

INTERVAL

Length of the monitoring interval in seconds. Specify a value between 60 and 3600 seconds. The default is 300 seconds.

The interval parameter determines the frequency, with which RMF™ retrieves data from the monitored endpoints. It does not necessarily match the data collection interval of the CIM providers on this systems:

For endpoints running the AIX operating system, GPM4CIM tries to synchronize the CIM provider interval with the GPM4CIM specified interval. This function requires AIX version 6.2.
For endpoints running the Linux or Windows operating system, it is the administrator's responsibility to synchronize the interval start time and the interval length of the CIM providers with the GPM4CIM specified interval.

RECORD(YES|NO)

Specifies whether or not measurement data is collected in SMF record type 104 as defined by the settings in the active SMFPRMxx parmlib member. The default is RECORD(NO). Therefore, if you want to collect SMF records with GPM4CIM, you need to specify RECORD(YES).