Installing an Agent on a Java Instance (Java Standalone 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 engine’s installation package. 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 Java 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 double-stack system (ABAP/Java) with the agent, proceed as described under Installing an Agent on a Java Instance (Double-Stack System).

●        If problems occur during the registration of the agent on a Microsoft Windows platform, proceed as described in SAP Note 817714.

Prerequisites

●      There is a communication user CSMREG in CEN.

●      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.      The access data for the two users required in CEN is determined from the start file and displayed in the corresponding fields. If necessary, you can change the name of the user or the client.

       8.      In the Password column, enter the passwords of the CEN Administration User and the CEN CSMREG User. 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?

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

   10.      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 CEN; you can see the corresponding monitoring data in the Alert Monitor in CEN.

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