Configuring Parameter Reporting

Use

To configure the CCMS monitoring functions for TREX, you have to configure parameter reporting first. Configuring 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.

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:

You run scripts to set the correct environment variables:
1. Log on to the TREX host with the <sapsid>admuser.
2. Go to the <TREX_DIR> directory.
3. 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
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
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
If there is a default value for an entry, this is presented in square brackets. If you want to apply this value, choose ENTER.
Only Windows: Choose the starttype of service.
1. When the starttype of service is queried, chose the value manual. This query only appears on Windows.
2. Disable the Startup Type of the service of the CCMS agent in the Windows Administrative Tool Services:
  Start → Settings → Control Panel → Administrative Tools →Services.
  
  Choose the service of the CCMS agent with the nameSAPCCMSR.<instance-number> and single-click the secondary (right) mouse button → Properties → General → Startup Type: Disable.
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
    Note
    You can use a text editor or the SAP Management Console, a snap-in in the Microsoft Management Console (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
      
      Note
      Choose the next free number for the value <number> in Start_Program_<number>.
      
      Note
      
      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.
Only on 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>.

Note
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.
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 (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 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:

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>.

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

Start → Settings → Control Panel → Administrative Tools →Services.

Choose the service of the CCMS agent and single-click the secondary (right) mouse button → Properties → General → Startup Type: Disable.
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

Note

You can use a text editor or the SAP Management Console, a snap-in in the Microsoft Management Console (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

Note

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

Note

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.

Only on 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.

Note
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.
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 (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 SAPSOCOLand your TREX system are active, proceed as follows:

Call transaction RZ20 in the CCMS system.
The screen containing the CCMS Monitor Sets appears.
Expand the SAP CCMS Monitors for Optional Componentsnode.
Double-click the TREXentry.
A node tree containing the following entries appears:
- TREX Server Heartbeat (all Releases)
- TREX (Release <= 6.40)
- TREX (Release >= 7.0)
Choose a TREX release.
Information about the operating system, host name, CPU, and so on of your TREX system appears.