DB2 Performance Expert for Multiplatforms V2.2, 2nd Edition

Chapter 3. Configuration and verification 59

3.1.3 Configuring the CIM server

In the configuration examples later in this chapter, we configure an instance for

collecting operating system information using a CIM sever on AIX. Before we can

start configuring the instance and start monitoring, we need to collect some CIM

server related values and prepare the monitored instance to run a CM server.

The following steps are prerequisites for configuring a CIM server:

 Start the CIM server and determine the port number used by the CIM server.

 Add a user ID to the CIM server.

 Add a CIM user authorization.

The following section describes the steps for a CIM server running on AIX. For

details on how to configure CIM servers, please see Chapter 4, “Configuring

Performance Expert Server on Windows systems” and Chapter 9 “Configuring

Performance Expert Server on UNIX and Linux systems”, in IBM DB2

Performance Expert for Multiplatforms IBM DB2 Performance Expert for

Workgroups Installation and Configuration, SC18-9191.

Tip: For ease of administration, consider establishing a naming convention for

your PE environment before you begin configuration. Consider the naming of

objects, such as the monitored DB2 instance alias, DB2 instance node name,

and performance database name, which are included in the PE Server

configuration, and also the monitored DB2 instance alias and DB2 connection

alias, which are included in the PE Client configuration. For example, you may

wish to consider the following options:

 Include characters in each performance database name to help

administrators and users to easily identify them as such, such as PWH

(performance warehouse), PE, PERF, and so on. You may choose to also

identify the monitored instance and the server on which it runs, within the

eight-character limit. For example, we use the value WSDB2PWH for the

Windows example value in the worksheet for the name of the performance

database of instance DB2 on server Wisla.

 You cannot change the monitored instance alias at the server after

configuration, but you may change it in the PE Client when it is configured.

If you want to keep it the same in all locations, you may choose to use a

naming convention for it that reflects the monitored instance name and the

server on which it is located, and possibly the name of the server on which

the PE Server is installed. Or you might choose to identify DB2 instances

used for production, development, testing, or other purposes by beginning

the monitored instance alias with a certain letter (p, d, t, and so on).

 If your environment is small, you may choose to use shorter or simpler

object names.

60 DB2 Performance Expert for Multiplatforms V2.2

Starting the CIM server

Follow the steps below to start the CIM server:

1. Log in as root at the system that owns the monitored instance.

2. Change to the /opt/freeware/cimom/pegasus/bin directory.

3. Enter the command:

cimserver

(To stop the CIM server, enter cimserver -s.)

When the CIM server starts, you will get an output similar to Figure 3-1. The

output lists the port number used by the CIM server. Record the port number in

the worksheet; you will need it when you configure the instance for monitoring.

The default port number is 5988.

Figure 3-1 Starting the CIM server on AIX

Adding a user ID to the CIM server

You must add a user ID to the CIM server. Use the user ID prepared in the

worksheet during configuration of the Performance Expert Server. This is to

authorize the user to access the CIM server. Note that CIM users must be valid

users at the local system. Run the following command:

cimuser -a -u db2inst1

You are asked to enter the password:

Please enter your password:

Please re-enter your password:

User added successfully.

Note that there is no default authorization permissions set for a newly added

user. Verify that the user was successfully added by entering the following

command:

cimuser -l

The output should list the user ID db2inst1.

# cimserver

PGS10020: Logs directory = /opt/freeware/cimom/pegasus/logs

CIM Server 2.3.2

--- CMPI Provider Manager activated

PGS10025: The CIM server is listening on HTTP port 5,988.

Started.

#