Show TOC

Enabling SAP Host Agent Registration in SLDLocate this document in the navigation structure

To enable the automatic registration to SLD you have to configure the connectivity information using the command line tool sldreg.


  • You must be logged on as a user with the appropriate authorizations:

    Windows As a member of the local Administrators group.
    UNIX As a user with root authorizations.
    IBM i As a user profile with special authorities *SECADM and *ALLOBJ, for example as user profile QSECOFR.


  1. You are on the host that you want to register in the SLD.
  2. IBM i: Enter the command CALL PGM(QP2TERM) to start a PASE interactive terminal session .
  3. Change to the following directory as current directory ( DIR_GLOBAL Directory):
    Windows (language-dependent) %ProgramFiles%\SAP\hostctrl\exe
    UNIX, IBM i /usr/sap/hostctrl/exe
  4. Call the sldreg executable with the following command:
    Windows sldreg -configure slddest.cfg
    UNIX, IBM i ./sldreg -configure slddest.cfg

    You have to make sure that the SLD connection file is named slddest.cfg and that it is located in the DIR_GLOBAL directory of SAP Host Agent. Otherwise the registration does not work.


    UNIX, IBM i: To be able to access its libraries, the sldreg program requires the path /usr/sap/hostctrl/exe in the search path for libraries.

    • UNIX: For example, under Linux with a C shell, you can achieve this with the following command:

      setenv LD_LIBRARY_PATH /usr/sap/hostctrl/exe:$LD_LIBRARY_PATH

    • IBM i: From within QP2TERM, you can achieve this with the following command: export LIBPATH=/usr/sap/hostctrl/exe:$LIBPATH

  5. Enter the connection data for the SLD with which you want to register this host:
    • SLD user that has been assigned the role DataSupplierLD

    • Password of the above user

    • Host and HTTP port of the SLD

    • Protocol (HTTP or HTTPS)

  6. Confirm that you want to save this data in the encrypted file slddest.cfg.
  7. Restart SAP Host Agent by executing the following command:
    Windows saphostexec.exe -restart
    UNIX, IBM i ./saphostexec -restart

    The restart generates an XML file in the working directory of SAP Host Agent and transfers it to the SLD. This XML file contains all of the information about the host that the SLD requires.


You have registered the local host with an SLD.

Next Steps

You can check if the registration was performed successfully. To do this, call the start page of the SLD with the URL http:// <host>: <port>/sld, and choose Technical Systems. Choose AS Java In the Technical System Type drop-down list box. The host that you have just registered is displayed.