Start of Content Area

Procedure documentation Configuring Parameter Reporting  Locate the document in its SAP Library structure

Use

To configure the CCMS monitoring functions for TREX, you have to configure the parameter reporting first. Configuring the parameter reporting is a prerequisite for configuring the monitoring of availability (heartbeat/GRMG), log files, and processes.

To configure the parameter reporting, you must register the CCMS agent, SAPCCMSR, with the central monitoring system (CEN). During the registration process, you enter details of the CEN and the users through which communication between the agent and CEN is processed.

Note

For more details about the CCMS agents and registration, see CCMS Agents and Installing/Registering the CCMS Agents for Experts.

You configure the parameter reporting for TREX for two different scenarios:

●      Configure parameter reporting for an initial TREX installation

●      Configure parameter reporting for update of an existing TREX installation

Configuring Parameter Reporting for an Initial TREX Installation

If you have installed TREX for the first time you have to work through the following configuration steps to configure parameter reporting for an initial TREX installation:

...

       1.      You run scripts to set the correct environment variables:

                            a.      Log on to the TREX host with the <sapsid>adm user.

                            b.      Go to the directory <TREX_DIR>.

                            c.      Set the environment variables required by TREX by executing the following scripts in a command prompt:

UNIX

■       Bourne shell sh, Bourne-again shell bash, Korn shell ksh

.TREXSettings.sh

■       C Shell csh:

source TREXSettings.csh

Windows

TREXSettings.bat

       2.      Register the CCMS agent with the central monitoring system (CEN):

sapccmsr pf=<full_path_to_instance_profile> -j2ee –R

During the registration of the CCMS agent, the following user data is queried:

○       Client

○       User name

○       Logon language

○       Host name of the message server in the central monitoring system

○       Indicator as to whether load-balancing is to be used for logon

○       Logon group name for logging on (if load-balancing is activated)

○       Host name of the application server for logging on (if load-balancing is deactivated)

○       System number of the application server for logging on (if load-balancing is deactivated)

○       Host and port of the SAProuter in the form /H/<router host>/S/<router port>/H (optional, only necessary in exceptional cases)

○       Indicator for a trace (0 = no, 1 = yes)

○       User password; the password is used once only to log on as described above and is not saved

○       Gateway connection data (normally the message server for the central monitoring system), that the CCMS agent uses to communicate with the RFC server

○       Gateway host name

○       Gateway system number

       3.      Choose the name of the system group.

When the name of the system group is queried, you assign the TREX system for the SAP system ID <SAPSID> as the monitored system to the TREX_Systems system group in the central monitoring system:  

[optional] monitored system <SAPSID> belongs to system group: TREX_Systems

If there is a default value for an entry, this is presented in square brackets. If you want to apply this value, choose ENTER.

Note

For more information about the user data queried, see Registering the CCMS Agents in Dialog.

       4.      Only Windows: Choose the starttype of service.

                            a.      When the starttype of service is queried, chose the value manual.  This query only appears on Windows.

                            b.      Disable the Startup Type of the service of the CCMS agent in the Windows Administrative Tool Services:

Start à Settings à Control Panel à Adminstrative tools à Service

Choose the service of the CCMS agent with the name SAPCCMSR.<instance-number> and single-click the secondary (right) mouse button à Properties  à General à Startup Type: Disable.

       5.      Change the TREX start profile START_TRX<instance_number>_<host>.

You can find the TREX start profile in the global file system for your TREX installation <TREX_GLOBAL>.

○       Only UNIX

Change the following sections of the TREX start profile :

Before the change:

SETENV_<nr> = LD_LIBRARY_PATH=$(DIR_LIBRARY):%(LD_LIBRARY_PATH)

SETENV_<nr> = SHLIB_PATH=$(DIR_LIBRARY):%(SHLIB_PATH)

SETENV_<nr> = LIBPATH=$(DIR_LIBRARY):%(LIBPATH)

After the change:

SETENV_<nr> = LD_LIBRARY_PATH=$(DIR_EXECUTABLE):%(LD_LIBRARY_PATH)

SETENV_<nr> = SHLIB_PATH=$(DIR_ EXECUTABLE):%(SHLIB_PATH)

SETENV_<nr>= LIBPATH=$(DIR_ EXECUTABLE):%(LIBPATH)

○       Windows and UNIX

Insert the following entry in the TREX start profile:

■       Windows:

#----------------------------------------------------------

# Start CCMS Agent

#----------------------------------------------------------

_CCMS = $(DIR_EXECUTABLE)\sapccmsr$(FT_EXE)

Start_Program_<number> = local $(_CCMS) pf=$(_PF) -j2ee
-DCCMS

This graphic is explained in the accompanying text

You can use a text editor or the SAP Management console, a snap-in in the Microsoft Management Console: Windows (MMC), to change the start profile.

■       UNIX:

#---------------------------------------------------------

# Start CCMS Agent

#----------------------------------------------------------

TREX/NameServer/Port=3$(SAPSYSTEM)01

_CCMS = $(DIR_EXECUTABLE)/sapccmsr$(FT_EXE)

Start_Program_<number> = local $(_CCMS) pf=$(_PF) -j2ee –DCCMS -nodaemon

This graphic is explained in the accompanying text

Choose the next free number for the value <number> in Start_Program_<number>.

This graphic is explained in the accompanying text

You have only to specify the parameter TREX/NameServer/Port=3$(SAPSYSTEM)01 for the TREX 7.0.08 and TREX 7.0.24 versions. The file <TREX_DIR>/exe/doc/TREXVersion.html indicates the current TREX version.

       6.      Only UNIX:

Change TREX instance profile <SAPSID>_TRX<instance_number>_<host>.

You can find the TREX instance profile in the global file system for your TREX installation <TREX_GLOBAL>.

Insert the entry TREX/NameServer/Port=3$(SAPSYSTEM)01 at the end of the file the TREX instance profile <SAPSID>_TRX<instance_number>_<host>.

This graphic is explained in the accompanying text

You have only to specify the parameter TREX/NameServer/Port=3$(SAPSYSTEM)01 for the TREX versions TREX 7.0.08 and TREX 7.0.24. The file <TREX_DIR>/exe/doc/TREXVersion.html indicates the current TREX version.

       7.      Restart the TREX instance for the new settings in the TREX start profile and instance profile to take effect.

○       On Windows, you use the SAP Management console, a snap-in of the Microsoft Management Console: Windows (MMC), to start and stop SAP systems and TREX instances.

○       On UNIX, you use the shell scripts startsap and stopsap to start and stop SAP systems and TREX instances.

Configuring Parameter Reporting for an Update of an Existing TREX Installation

If you have already installed TREX and CCMS monitoring had been enabled, you may have to work through the following additional configuration steps to configure parameter reporting for the updated TREX installation:

...

       1.      Stop the CCMS agent by entering the following in a command prompt:

sapccmsr pf=<full_path_to_instance_profile> -j2ee -standalone –stop

You can find the CCMS agent in the directory <TREX_DIR>/exe.

<full_path_to_instance_profile> is the complete file path for the instance profile of the monitored TREX instance, including the name of the instance profile <SAPSID>_TRX<instance_number>_<host> itself.

Example:

<drive>:\usr\sap\<SAPSID>\SYS\profile\
<SAPSID>_TRX<instance_number>_<host>

You can find the exact value for <full_path_to_instance_profile> in the global file system for your TREX installation, <TREX_GLOBAL>.

       2.      Only Windows:

Stop the service of the CCMS agent and disable the Startup Type in the Windows Administrative Tool Services:

Start à Settings à Control Panel à Adminstrative tools à Service

Choose the service of the CCMS agent  and single-click the secondary (right) mouse button à Properties  à General à Startup Type: Disable.

       3.      Check the TREX start profile START_TRX<instance_number>_<host>.

You can find the TREX start profile in the global file system for your TREX installation <TREX_GLOBAL>.

Check if the following entries are set correctly in the TREX start profile. If necessary, correct the entries as described:

○       Windows

#----------------------------------------------------------

# Start CCMS Agent

#----------------------------------------------------------

_CCMS = $(DIR_EXECUTABLE)\sapccmsr$(FT_EXE)

Start_Program_<number> = local $(_CCMS) pf=$(_PF) -j2ee
-DCCMS

This graphic is explained in the accompanying text

You can use a text editor or the SAP Management console, a snap-in in the Microsoft Management Console: Windows (MCC), to change the start profile.

○       UNIX

#---------------------------------------------------------

# Start CCMS Agent

#----------------------------------------------------------

TREX/NameServer/Port=3$(SAPSYSTEM)01

_CCMS = $(DIR_EXECUTABLE)/sapccmsr$(FT_EXE)

Start_Program_<number> = local $(_CCMS) pf=$(_PF) -j2ee –DCCMS
-nodaemon

This graphic is explained in the accompanying text

Choose the next free number for the value <number> in Start_Program_<number>.

This graphic is explained in the accompanying text

You only have to specify the parameter TREX/NameServer/Port=3$(SAPSYSTEM)01 for the TREX 7.0.08 and TREX 7.0.24 versions. The file <TREX_DIR>/exe/doc/TREXVersion.html indicates the current TREX version.

       4.      Only UNIX:

Check the TREX instance profile,<SAPSID>_TRX<instance_number>_<host>.

You can find the TREX instance profile in the global file system for your TREX installation <TREX_GLOBAL>. Insert the entry TREX/NameServer/Port=3$(SAPSYSTEM)01 at the end of the file for the TREX instance profile if it is not there.

This graphic is explained in the accompanying text

You only have to specify the parameter TREX/NameServer/Port=3$(SAPSYSTEM)01 for the TREX versions TREX 7.0.08 and TREX 7.0.24. The file <TREX_DIR>/exe/doc/TREXVersion.html indicates the current TREX version.

       5.      If you have made any changes you have to the restart the TREX instance for the new settings in the TREX start profile and instance profile to take effect:

○       On Windows, you use the SAP Management console, a snap-in of the Microsoft Management Console: Windows (MMC), to start and stop SAP systems and TREX instances.

○       On UNIX, you use the shell scripts startsap and stopsap to start and stop SAP systems and TREX instances.

Result

To check whether or not SAPSOCOL and your TREX system are active, proceed as follows:

...

...

       1.      Launch transaction RZ20 in the CCMS system.

The screen containing the CCMS Monitor Sets appears.

       2.      Expand the node SAP CCMS Monitors for Optional Components.

       3.      Double-click the entry TREX.

       4.      A node tree containing the following entries appears:

○       TREX Server Heartbeat (all Releases)

○       TREX (Release <= 6.40)

○       TREX (Release >= 7.0)

       5.      Choose a TREX release.

Information about the Operating System, Host Name, CPU, and so on for your TREX system appears.

 

End of Content Area