Troubleshooting the CIM server

 

Use this information if the CIM server does not start or if the CIM server starts, but does not run as expected.

The CIM server does not start

Do the following steps if the CIM server does not start:

If this is the first time the CIMOM server is being started after install of Pegasus V2.5, it takes a while for the server to start. During that time, the repository is being upgraded and the user data from the previous repository is being migrated.

Ensure that the CIM server is configured correctly.

See Setting the required configuration parameters to configure your CIM server.

Verify whether you need to change your Kerberos configuration or change the CIM server to use basic authentication.

If you receive the following message, there is an error with your authentication. You need to fix your authentication or use another form of authentication, such as basic authentication.
CPDDF82: (Message appears in CIM server, QYCMCIMOM, joblog)
PGS02000: The CIM server authentication handler for Kerberos failed to initialize properly.  The CIM server is not started.

You should not use basic authentication unless you have a highly secure environment, where passing clear text passwords is not an issue. To use the cimconfig command to change your CIM configuration settings, QSHELL (Option 30) must be installed.

To change the authorization to basic, type the following command at a command line.
qsh cd / QIBM/UserData/OS400/CIM cimconfig -shttpAuthType=Basic -p

Ensure that the correct options are installed on your system.

If you receive the CPDDF80 with reason code 07 indicating the required option 39 is not installed, install Option 39 (ICU).

The CIM server does not behave as expected

If you are having trouble with the CIM server, see the following instructions:

Check to see if the CIM server is running by typing WRKJOB QYCMCIMOM at a command line.

If there is not an active job, start the CIM server by typing STRTCPSVR *CIMOM at a command line.

Check to see if the CIMOM repository is corrupted.

Verify whether the repository directory and configuration files exist in the QIBM/UserData/OS400/CIM directory of the integrated file system. If any of these files are missing, restore all the repository directories and files from your backup. You must use a backup of those files from the Pegasus V2.5 backup, not from a V5R3 system that did not have the Pegasus V2.5 PTFs installed.

If a backup to restore from does not exist, follow the instructions in Restoring corrupted files.

Verify if you are attempting to process a request when the provider is not registered or enabled.

To verify if you are attempting to process a request when the provider is not registered or enabled, do the following steps:

  1. Type cimprovider -l -s to list the name and status of the registered provider modules.

  2. Type cimprovider -l-m module name to see the individual providers in that module.

Check the job log file.

To check the job log file, do the following steps:

  1. Type WRKACTJOB at a command line.

  2. Look in the QSYSWRK subsystem to find the QYCMCIMOM job.

  3. Select 5 (work with), then 10 (Display job log, if active, on job queue, or pending).

  4. If the QYCMCIMOM job is not running, type WRKJOB QYCMCIMOM.

  5. Select the most recent job by typing 1 (Select) next to it.

  6. If status is OUTQ, type 4 (Work with spooled files), and then type 5 (Display) next to the QPJOBLOG file.

Message CPDDF82 appears in the CIM Server job log

Message CPDDF82 may appear in the CIM Server (QYCMCIMOM) job log during server startup:

CPDDF82: 
  The Common Information Model Object Manager (CIMOM) server 
  logged an error or warning message.  The message text is:  SSL Exception:    
  PGS12425: WARNING: THE SSL FUNCTION IS NOT SUPPORTED AT THIS TIME. SSL HAS   
  BEEN DISABLED.  TO REMOVE THIS MESSAGE, SET THE ENABLEHTTPSCONNECTION AND    
  ENABLESSLEXPORTCLIENTVERIFICATION PROPERTIES TO FALSE.  USE THE CIMCONFIG    
  COMMAND TO SET THESE PROPERTIES

Although SSL is configured by default, it is not yet supported. Therefore you might see this message in the job log. To remove message CPDDF82 from the CIM Server joblog (QYCMCIMOM) do the following command:

Qshell Interpreter (5722-SS1 Option 30) must be installed on your system to do this command.

qsh cd /QIBM/UserData/OS400/CIM   
cimconfig -s enableHttpsConnection=false -p   
cimconfig -s enableSSLExportClientVerification=false -p 

 

Parent topic:

Common Information Model