Controlling CCMS Agents
Use
The following commands are available to you to control the CCMS agents directly from the operating system input prompt:
Command |
Meaning |
-R [-f <start
file>] |
Register the
agent |
-U [pf=<profile path>] |
Deregister the agent |
-DCCMS [pf=<profile path>] |
Starting the agent |
-stop [pf=<profile path>] |
Stop the agent |
-status [pf=<profile path>] |
Display the status of the agent |
-noservice |
Register and deregister without installing or uninstalling a service (Microsoft Windows only) |
-V |
Display the version of the agent |
You can display the list of available commands at any time by entering the name of the agent without commands and options at the operating system input prompt (such as sapccmsr).
Features
Deregistering CCMS Agents
To deregister an agent, enter the parameter –U. If you specified a profile path during registration, specify this path during deregistration too:
CCMS Agent |
Deregistration Command |
SAPCCMSR |
sapccmsr –U [pf=<profile path>] |
SAPCCMSR –j2ee |
sapccmsr –j2ee –U pf=<profile path> |
SAPCCM4X |
sapccm4x –U pf=<profile path> |
SAPCM3X |
sapcm3x –U [pf=<profile path>] |
The start file CSMCONF is deleted during the deregistration. The logon data for CEN is also requested during the deinstallation, to automatically delete the following entries for the agent in the system:
● Entry in the topology display of the monitoring architecture (you can start the topology display using transaction RZ21; in the Topology group box there, choose one of the radio buttons that display the CCMS agents registered with this system)
● RFC connections to the agent (Check using transaction SM59)
● Entry in the System Component Repository (SCR); you can display the SCR by choosing Technical Infrastructure → System Repository → Display in transaction RZ21.
In the case of a release status below SAP Web AS 6.20, these entries are not deleted. You should set the agent to Offline in the topology display to avoid problems in the system.
Starting and Stopping CCMS Agents
Always stop and restart a CCMS agent if you have made changes to its configuration file SAPCCMSR.INI, as this file is only read when the agent is started.
If you want to perform an upgrade for the relevant monitored system, stop the CCMS agents SAPCCM4X and SAPCCMSR –j2ee too. Start the agents again after the upgrade.
Follow the procedure below for your operating system platform:
● Under UNIX, you can stop the CCMS agent using the option -stop, therefore, for example, for agent SAPCCMSR, you would use the command sapccmsr –stop [pf=<profile path>]. To restart the agent later, use the option –DCCMS.
● Under Microsoft Windows, we recommend that you stop and restart the agent by stopping and restarting the service of the same name.
Register and deregister without installing or uninstalling a service (Microsoft Windows only)
Under Microsoft Windows, you can use the option –noservice in connection with the commands -R (register agent) and -U (deregister agent) to prevent the associated service being installed during registration, or uninstalled during deregistration.
This option is available to you as of Patch Collection 2005/5. It is especially useful if you need to register or deregister an agent using a user that does not have administrator authorization on the relevant host.
Displaying the Status of a CCMS Agent
The status of a CCMS agent displays its working directory and the configuration directory; if the agent is running, you receive additional information about the release of the central monitoring system in which the agent is registered. To do this, call the agent with the option –status (for example, with the SAPCCMSR agent):
>sapccmsr –status
INFO: CCMS agent
sapccmsr working directory is /usr/sap/tmp/sapccmsr
INFO: CCMS agent sapccmsr config file is
/usr/sap/tmp/sapccmsr/csmconf
INFO: Checking shared memory status of sapccmsr
******** CCMS agent running on this machine: ********
*
* sapccmsr
without profile
*
*
registered at central system BCE
*
* CCMS
version 20010925, 32 bit
* Process
Id 28807
*
relno
6200
*
patchno 45
*
intno
20020600
*****************************************************
EXITING with code 0
Displaying the Version of a CCMS Agent
Call the agent with the option –V (for example, with the SAPCCMSR agent):
>sapccmsr –v
CCMS version
20010925, 32 bit, multithreaded, Non-Unicode
compiled at Sep 17,2002
systemid 560 (PC with Windows
NT)
relno 6200
Patch text patch collection 2003/2, SAP
note 584136
patchno 344
intno 20023800
running on P57373 Windows NT 5.0 2195
Service Pack 2 Intel 80686
You can read the version from the release number (relno) and the patch number (patchno). The line running on also contains the operating system on which the agent is currently running. Patch text specifies the Patch Collection. For information about which collection contains which changes, see SAP Note 202591.
CCMS Agents start
page