Show TOC

Procedure documentationActivating the Remote OS Script

 

To allow the system to execute your custom scripts, in the SAP Solution Manager agent administration, specify the file path under which you have stored the custom scripts. Adapt the agent applications configuration file, and in this way activate the remote OS script.

Prerequisites

You have the required authorizations.

Procedure

  1. In the SAP Solution Manager Administration work center, choose Landscape.

  2. Select the system.

  3. Choose Agent Framework.

  4. On the Status tab page, choose Agent Admin.

  5. Choose the Application Configuration tab page.

  6. In the Agent Applications navigation tree, expand the com.sap.smd.agent.application.remoteos agent application.

  7. Under Application Resources select commands.xml.

  8. To save the commands.xml configuration file to your local computer, do the following:

    • If the configuration file was not yet adapted, under Resource Information, choose Download.

    • If the configuration file was customized, under Resource Customization, in the Scope field, select Global (to update all managed systems) or Agent (to select the agent associated to the system for which you want to use this new functiony and data provider), and choose Download.

  9. In the commands.xml file, go to the end of the OS section (the first section).

  10. Append a command group according to the following schema. The example code applies to Microsoft Windows.

    Syntax Syntax

    1. <CmdGroup name="Custom scripts" cv_ppms_id="*">
    2.   <Cmd key="os.run" name="Script" desc="Execute scrips from a standard directory">
      
    3.     <OsCmd ostype="Windows" exec="" path="c:/usr/sap" param="true" runtime="600"/>
    4.   </Cmd>
      </CmdGroup>
    End of the code.

    Adapt the following parameter values according to your use case: .

    • key: Ensure the value is os.run.

    • ostype: In case of MS Windows systems, enter Windows, in case of UNIX type systems, for example Linux, enter UNIX.

    • path: Specify the folder in which you have created the custom_scripts folder on the managed system. In our example, the system finds the scripts in folder c:/usr/sap/custom_scripts/.

      Use slashes, not backslashes, for both MS Windows and UNIX type systems.

    • param: Ensure the value is true. To exclude scripts located in the custom_scripts folder, set the parameter to false.

  11. Save your entries.

  12. To upload the customized commands.xml file, do the following:

    1. Go back to the Application Configuration tab page.

    2. Specify the scope.

    3. To select the customized commands.xml, choose Browse.

    4. Choose Upload.

You have activated your OS command (script). It can now be used by the Remote OS Script data provider.