Help Center/ SAP Cloud/ Best Practices/ SAP Monitoring Best Practices/ Installing the Monitoring Agent/ SAP S/4HANA (Single-Node Deployment Without High Availability Required)
Updated on 2024-08-15 GMT+08:00

SAP S/4HANA (Single-Node Deployment Without High Availability Required)

In the SAP S/4HANA (single-node deployment without high availability required) scenario, you need to install the SAP monitoring agent on the node where both ASCS and PAS instances are deployed.

Prerequisites

Ensure that Application Operations Management (AOM) ICAgent has been installed.

  • AOM ICAgent is used to collect host OS metrics, such as CPU, memory, and disk. If it has not been installed, install it by referring to Installing an ICAgent.

Ensure that the AOM FullAccess permission has been assigned to the agency created for the host.

  • AOM FullAccess is used for the authentication of AOM metric reporting API. The following describes the procedure to configure the permission.
  1. Log in to the management console.
  2. In the navigation pane on the left, click and choose Identity Access Management under Management & Governance.
  3. Click Agencies in the left pane, and then click Create Agency in the upper right corner. The Create Agency page is displayed.
  4. Set agency parameters.

    • Agency Name: AOMFullAccess (this name is only for reference)
    • Agency Type: Select Cloud service.
    • Cloud Service: Select Elastic Cloud Server (ECS) and Bare Metal Server (BMS).
    • Validity Period: Retain the default setting.
    • Click Next to configure the permission:
      1. Select Region-specific projects for Scope.
      2. Select the region where the cloud server is located.
      3. Enter AOM FullAccess in the search box and select it in the search result.
      4. Click OK.

  5. Configure the agency created in the previous step for the ECS.

    1. In the left navigation pane, click and choose Computing > Elastic Cloud Server.
    2. Select the ECS for which you want to configure the agency and click its name to switch to the basic information page.
    3. Click the edit button next to Agency in the Management Information area, select the agency created in 4, and save the modification.

Procedure

Preparations

  1. Obtain SAP NW RFC SDK.

    To obtain SAP NW RFC SDK, log in at https://support.sap.com/en/my-support/software-downloads.html, access downloads of Support Packages & Patches, search for SAP NW RFC SDK 7.50, and download it.

  2. Log in to the cloud server as user root.
  3. Upload the obtained SAP NW RFC SDK installation package to the /usr/sap directory.
  4. Run the following commands to decompress the SAP NW RFC SDK package to the /usr/sap directory:

    unzip nwrfc750P_7-70002752.zip

    mv nwrfcsdk /usr/sap/

Installing the Monitoring Agent

  1. Run the following commands to obtain the installation script to install the monitoring agent.

    The download paths of the script vary depending on regions. For details about how to obtain the path, see Table 1. The following commands show the download path in AP-Bangkok.

    cd /tmp

    wget https://obs-sap-ap-southeast-2.obs.ap-southeast-2.myhuaweicloud.com/sapmon/install.sh&& sh install.sh --nwrfcsdk-path /usr/sap/nwrfcsdk

    /usr/sap/nwrfcsdk is the decompression path in 4.

  2. Modify the configuration.

    1. Run the following command to encrypt the password:

      /usr/local/sapmon/bin/ktool -e

    2. Enter the password.
    3. Run the following command to enter the edit mode of the configuration file. Modify the file according to Table 2, save the file, and exit.

      vim /usr/local/sapmon/config/sapmon.ini

      Modify the parameters based on the actual situation. Change the password to the return code obtained in 2.a.

      Table 2 Configuration parameters

      Parameter Type

      Name

      Description

      Example Value

      DEFAULT

      log_level

      Log level

      INFO

      log_file

      Log file name. The log file path is /var/log/huawei/sapmon/.

      sap_metrics.log

      hostname

      OS hostname

      s4hana-1709

      application.netweaver

      enable

      Whether to obtain the application metrics. The value can be true or false.

      NOTE:

      In the SAP S/4HANA (single-node deployment with HA required) scenario, set this parameter to true for the active node and to false for the standby node.

      true

      ha_mode

      Whether to deploy the application in high availability mode. If yes, set this parameter to true. If no, set this parameter to false.

      true

      sid

      Application SID

      S4H

      instance_number

      PAS instance ID

      10

      client

      SAP system ID

      000

      username

      Application username

      ddic

      password

      Application password. Enter the encrypted password.

      -

      If you need to monitor multiple applications, copy and paste parameters under application.netweaver, and change application.netweaver to application.netweaver.<sid>.

      sid indicates the application system ID.

    4. Run the following command to restart the monitoring agent.

      systemctl restart sapmon

(Optional) Uninstalling the Monitoring Agent

  1. Run the following command to uninstall the monitoring agent.

    rpm -e sapmon