7/31/2019 Installing and Registering CCMS Agents

1/3

Installing and Registering CCMS Agents

UseThe CCMS agents extend the monitoring architecture by providing an alternative connection route from the central

monitoring system to any other servers. In doing so, they enable you to:

Include SAP components without ABAP interfaces Include non-SAP components Optimize performance when reading and writing monitoring data Establish a connection route irrespective of the possible error status of the monitored SAP instance

Prerequisites When installing a CCMS agent under Microsoft Windows NT or Microsoft Windows 2000, you require

administrator rights on the relevant host.

Install SAPCCM4X and SAPCM3X using the useradm(UNIX) orSAPService(MicrosoftWindows) of the monitored system to ensure that the agent can access the shared memory.

If multiple SAP systems with a release status of SAP Basis 3.X are running on one host, note the followingpoints:

Install only one SAPCM3X agent on each host. The agent only monitors one instance, if you specify a profile; therefore do not specify a profile (withpf=) when starting the agent.

Install the agent using the root user so that it can read the shared memory segments of all systems. In the case of agents SAPCCM4X and SAPCCMSR with Option j2ee, you require a separate agent for each

instance.

Process Flow

This section describes the installation and registration of CCMS agents in general terms, with all settingoptions. In most cases, however, you will only want to register SAP NetWeaver components with a

CEN using CCMS agents. These standard procedures are described in Installing CCMS Agents for SAP

NetWeaver Components.

1. Download the desired CCMS agent from the Software Catalogof the SAP Service Marketplace (seeDownloading the CCMS Agents).

2. Copy the CCMS agent that you want to install to the following directory, depending on the platform:CCMS Agent Microsoft Windows UNIX

SAPCCMSR

SAPCM3X

\\\saploc\prfclog /usr/sap/ccms/bin

SAPCCMSRj2ee

SAPCCM4X\\\usr\sap\\SYS\exe\run

/usr/sap//SYS/exe/run

The saploc directory can also have another name; the important thing is that it is released as a share

with the name saploc. By default, it is the directory\usr\sap. If the directory does not

exist, create it yourself during the installation.

3. If you want to monitor log files with the CCMS agent, create one or more log file templates (see Structure of theLog File Templates of the Log File Agent).

4. If you want to configure the monitoring of operating system data individually, create a SAPOSCOL filter file,with which you can explicitly activate and deactivate parts of the operating system monitoring (see Monitoring

7/31/2019 Installing and Registering CCMS Agents

2/3

Operating System Data with CCMS Agents).

5. You specify a profile file during the registration of a CCMS agent withpf=. This ismandatory for agent SAPCCM4X, and the profile file must be that of the monitored instance. You must also

specify a profile file for agent SAPCCMSR with the j2eeOption. This profile file must also be the profile for the

monitored instance. Both profile files are stored under:

:\usr\sap\\SYS\profile\__(Microsoft Windows)

/usr/sap//SYS/profile/__(UNIX)

For agents SAPCM3X and SAPCCMSR without the option j2ee, on the other hand, the specification of a

profile file is optional, and usually not necessary. For information about which profile parameters you can set ina profile file of this type, see Profile File of the CCMS Agents.

6. Create the configuration file SAPCCMSR.INI before installing a CCMS agent if you are using at least one of thefollowing functions:

Your own settings formonitoring log files Configuring the Monitoring of Operating System Data Alert Logging of CCMS Agents Your own settings fordisplaying file contents in the Alert Monitor Using additional shared libraries

You can also create the configuration files from points 3 to 6 after registering the CCMS agent.

However, you must then ensure that the agent takes these files into account. To do this, restart the

agent (see Controlling CCMS Agents).

7. Register the CCMS agent; by doing this, you inform the central monitoring system about the agent. Werecommend that you have the central monitoring system create the data required for this (see Automatically

Creating the CSMCONF Start File). You can perform the registration in two ways:

Registration with the agent registration tool; use this tool to register the SAPCCMSR agent with exactlyone CEN. For the corresponding procedure, see Installing CCMS Agents for SAP NetWeaver

Components.

Registration in dialog (see Registering the CCMS Agents in Dialog) Dialog-free registration using a start file (see Dialog-Free Registration of the CCMS Agents)

For information about the special features of the registration ofSAPCCMSR with Option j2ee are

discussed in Registering SAPCCMS with the -j2ee Option.

8. Under Microsoft Windows, the agent has been entered as a service and started. The agent is automaticallyrestarted at every restart. If you have installed the CCMS agent under UNIX, the agent has not yet been

started. Restart it using the appropriate command:

Agent Start Command

SAPCCMSR sapccmsr DCCMS [pf=]

SAPCCMSR j2ee sapccmsr j2ee DCCMS pf=

SAPCCM4X sapccm4x DCCMS pf=

SAPCM3X sapcm3x DCCMS [pf=]

On a UNIX platform, you must also ensure yourself that the CCMS agent is automatically started after a restart

of the server (for example, by entering the start command in INITTAB).

9. This point applies only if you are installing agent SAPCCM4X: If the monitored system of the agent is alreadyknown to the monitoring architecture of the central monitoring system before the registration, all of the required

RFC connections already exist. Otherwise, you must enter the monitored system in the central monitoring

system as a remote system (see Monitoring Multiple Systems).

10. The data transferred by the CCMS agent is now available in the central monitoring system. If you require more

7/31/2019 Installing and Registering CCMS Agents

3/3

convenient access to this data, you can create monitors for the CCMS agents in the central monitoring

system.

CCMS Agents start page