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
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:
(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
The output should list the user ID db2inst1.
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.