Configuration File for Dialog-Free Installation of the Agents (SAP Library

Configuration File for Dialog-Free Installation of the Agents

Use

If you specify a configuration file, you can allow the installation of a CCMS agent to run unattended. The configuration file is always the same when installing the agent on more than one server. It therefore makes sense to install the agent using appropriate software distribution methods and to then configure it automatically.

Prerequisite

You must specify a file using the -f <filename> option for the installation of the CCMS agent. All installation information is then taken from the specified file. The installation is then performed dialog-free (see also Installation of the CCMS Agents).

Structure

The configuration file consists of the following three sections in which you can specify the connection to the central monitoring system:

CEN_CONFIG
CEN_ADMIN_USER
CEN_GATEWAY

Parameters in the File Sections

Section	Parameter	Description
CEN_CONFIG	CEN_SYSID	System ID of the central monitoring system

CEN_ADMIN_USER	CEN_ADMIN_R3NAME	System ID of the central monitoring system
	CEN_ADMIN_MSHOST	Host name of the message server in the central monitoring system
	CEN_ADMIN_ LOADBALANCING	Group logon [Y,N]
	CEN_ADMIN_GROUP	Name of the logon group (only if Group Logon = Y)
	CEN_ADMIN_ASHOST	Host name of an application server of the central monitoring system (only if Group Logon = N)
	CEN_ADMIN_SYSNR	Instance number of the above application server (only if Group Logon = N)
	CEN_ADMIN_CLIENT	Valid client in the central monitoring system
	CEN_ADMIN_USERID	Valid user in the central monitoring system
	CEN_ADMIN_PASSWORD	Associated password
	CEN_ADMIN_LANG	Language (such as de = German, en = English)
	CEN_ADMIN_TRACE	Is a trace set in the application server? [0,1]
	CEN_ADMIN_ROUTE	Host and port of the SAProuter in the format /H/<Router-Host>/S/<Router-Port>/H (optional, only required in rare cases)

CEN_GATEWAY	CEN_GATEWAY_HOST	Host name of the gateway with which the central monitoring system is to communicate (usually the gateway in the central monitoring system)
	CEN_GATEWAY_SYSNR	Instance number of the gateway
	CEN_GATEWAY_TRACE	Is a trace set in the gateway? [0,1]

Note

Enter the lines in the format <Parameter_name>=<Parameter_value>.

Use the CEN_ADMIN_USER to create an RFC destination in the central system. This user requires the authorization to execute transactions RZ20/21 (S_RZL_ADM with authorization field ACTVT and value 01) and to enter an RFC destination using transaction SM59 (S_ADMI_FCD with authorization field S_ADMI_FCD and value NADM). The CEN_ADMIN_PASSWORD is only used once to log on to the central system and is not stored.

You must end each section with a period (.). This line must be empty other than the period.

You can test the generate RFC connection of type "T" in transaction SM59.

The CCMS agent works as a registered RFC server. You specify the gateway that is used with the parameters in the section CEN_GATEWAY.

As the CCMS agent is implemented as an RFC server, a corresponding RFC destination is automatically generated in the central monitoring system. Thereafter, the central monitoring system automatically first attempts to read data from the monitored system through the RFC destination of the CCMS agent. If the agent is not active, the system reads the monitoring data from the monitored SAP instance using the standard RFC, as previously.

Example

Comment lines begin with the number sign (#).

CEN_CONFIG
    CEN_SYSID=CEN
.

# example: does not use logon load balancing
CEN_ADMIN_USER
    CEN_ADMIN_R3NAME=CEN
    CEN_ADMIN_MSHOST=cenhostx
    CEN_ADMIN_LOADBALANCING=N
    CEN_ADMIN_ASHOST=cenhost1
    CEN_ADMIN_SYSNR=01
    CEN_ADMIN_CLIENT=000
    CEN_ADMIN_USERID=user
    CEN_ADMIN_PASSWORD=passwd
    CEN_ADMIN_LANG=en
    CEN_ADMIN_TRACE=0
.

# for logon load balancing, use
# CEN_ADMIN_LOADBALANCING=Y
# CEN_ADMIN_GROUP=PUBLIC
# instead of CEN_ADMIN_ASHOST and CEN_ADMIN_SYSNR

CEN_GATEWAY
    CEN_GATEWAY_HOST=host1
    CEN_GATEWAY_SYSNR=01
    CEN_GATEWAY_TRACE=0
.