Installing an Agent on a Java Instance (Double-Stack System) 

Use

The monitoring data for the J2EE Engine is transferred to central monitoring system (CEN) using the CCMS agent SAPCCMSR. The agent is part of the installation package of the Engine; you only need to register the agent for the relevant Engine with CEN and to start the agent.

This procedure describes the registration of a CCMS agent that is to monitor a J2EE Engine that is part of a double-stack system of ABAP and java instance.

In the case of a double-stack system, the agent must be registered with two systems: primarily with the local ABAP system, and secondarily with CEN. Although the agent must run on every instance of the monitored Java system, the distribution is performed automatically through the registration in the Visual Administrator, meaning that you only have to register and start the agent once for each system with CEN.

●        Note that this description applies only for monitored J2EE Engines as of SAP NetWeaver 04. For J2EE Engines with a release status of SAP Web AS 6.20, proceed as described under Installing an Agent on a SAP Web AS 6.20 Java Instance/Other Hosts.

●        If you want to monitor a J2EE Engine of a standalone Java system with the agent, proceed as described under Installing an Agent on a Java Instance (Java Standalone System).

Prerequisites

●      There is a CSMREG communications user in CEN and in the local ABAP system.

●      You have created the CSMCONF start file for CCMS agents in CEN.

The way in which you can fulfill the prerequisites is described in Installing CCMS Agents for SAP NetWeaver Components.

Procedure

...

       1.      Log on to the host of J2EE Engine of the system as <SID>adm.

       2.      Copy the CSMCONF start file to the following directory:

Microsoft Windows:    [drive]:\usr\sap\ccms\<SysID>_<Inst. No.>\sapccmsr

UNIX:                /usr/sap/ccms/<SysID>_<Inst. No.>/sapccmsr

You can save the start file to any directory that you can access from your local host. In this case, you need to specify during the registration of the agent where you saved the file. To do this, select the Change …button in the Monitoring service of the Visual Administrator (see below), and specify the path of the start file. The file is then automatically copied to the above directory.

       3.      On the host of the J2EE Engine, switch to the following directory:

Microsoft Windows:    <J2EE Home directory>\JC<Inst. No.>\j2ee\admin\

UNIX:           <J2EE Home directory>/JC<Inst. No.>/j2ee/admin/

If you installed the J2EE Engine together with an ABAP Engine, the character combination in the name of the JC<Inst. No.> directory in the above path may vary.

       4.      Start the Visual Administrator by calling the start script go (UNIX) or go.bat (Microsoft Windows), and log on with your user as the J2EE Engine administrator.

       5.      In the navigation bar, choose Cluster → <SysID> → Dispatcher → Services → Monitoring, and choose the CCMS Agent Configuration tab page.

       6.      If you want to monitor multiple systems with the same system ID, select the Long SID indicator, and enter in this input field an identifier for the system that is unique in your monitored system landscape. This “long system ID” must fulfill the following conditions:

○       The first three characters must be the system ID.

○       The name can be a maximum of eight characters long.

○       The name must not contain an underscore (_).

       7.      Since you want to register the agent with two systems, you require access data for two users for each of these systems, one of which is an administration user, and the other being the communication user CMSREG.

       8.      Specify the access data of these users for the local ABAP system by making all entries for the Local Administration User and Local CSMREG User rows. If necessary, you can overwrite the predefined values.

       9.      Specify the access data of these users for CEN by making all entries for the CEN Administration User and CEN CSMREG User rows. If necessary, you can overwrite the predefined values. The CEN Administration User is the user with administration authorizations with which you created the CSMCONF start file.

If necessary, you can use the Information button to answer the following questions:

●        Is the instance profile of the instance to be monitored valid?

●        Is the CMSCONF start file to be used valid?

●        What is the version of the CCMS agent SAPCCMSR?

   10.      Choose the Register button. The registration log is displayed; errors are highlighted in red.

   11.      Under UNIX, the agent is automatically started by the startsap script when you start the J2EE Engine. Under Microsoft Windows, you need to start the associated service (which was created during the installation of the J2EE Engine) yourself.

To do this, on the Microsoft Windows host on which the agent is running, choose Start → Settings → Control Panel → Administrative Tools → Services, and choose the service SAPCCMSR.<Instance No.> by double-clicking it. Set the Start Type to Automatic, and choose Start.

Result

All Java instances of the system are now registered with the local ABAP system and with CEN; you can see the corresponding monitoring data in the Alert Monitor of both systems.

The Customizing destination has also been automatically created for all Java instances, so that you can also change the threshold values for the monitoring data from the Alert Monitor (see Creating a Customizing Destination for SAPCCMSR -j2ee).

  CCMS Agents start page