Skip to end of metadata
Go to start of metadata
The diagnostics agent is a central component of the SAP Solution Manager system landscape. This page summarizes all relevant information on the agent and provides detail information on all relevant topics.

Installation

General Information

Following documents are most relevant for installing and working with the Diagnostics Agent:

  • Refer to SAP Note 1365123 for the Diagnostics Agent installation strategy. 

  • Refer to SAP Note 1833501 for information on Diagnostics Agent installer versions, and for an overview of SAP Notes related to Mass Deployment / Unattended Installation.

  • Refer to SAP Note 1858920 and the latest Installation and Setup Guide for:

    • Information on how to access the Product Availability Matrix (PAM) for the Diagnostics Agent
    • Differences that exist between the SWPM and 70SWPM installers
    • Instructions on how to download the Installation Media
    • Instructions on how to patch the Installation Media
    • Details on supported kernels
    • SMD Setup Script (smdsetup.bat/smdsetup.sh) documentation
    • More detailed installation instructions

Download Paths

Artifacts required for Diagnostics Agent installations can be downloaded as follows (for detailed instructions and alternative paths refer to latest Diagnostics Agent Installation and Setup Guides):

  • Go to http://service.sap.com/sltoolset  →  Software Logistics Toolset 1.0 
      • PAM →  "direct link"
      • Documentation  →  System Provisioning
          • Installation: Diagnostics Agent  →  <back_to_top_button_in_lower_right_corner>  →  "Installation and Setup Guide" for your "Operating System Platform"
      • "installer" (see big table with links)  →  row: System Provisioning  →  column: Download 
          • "download tool"  →  <your_platform>  →  SWPM10SP*.SAR (we recommend the SWPM10SP*.SAR installer)
      • "kernel" (see big table with links)  →  row: System Provisioning  →  column: Download
          • "download Kernel releases delivered for SL Toolset"  →  "Kernel for installation/SWPM"  →  "SAP KERNEL 7.21 EXT 64-BIT UC" (we recommend the 7.21 EXT SAP KERNEL)
              • "Installation"  →  <your_platform>  →  <your_download_object>

Recommended Reading

Which agent version should be used?

Please refer to the above mentioned Diagnostics Agent Installation Strategy SAP Note.

Where to install an agent?

Please refer to the above mentioned Diagnostics Agent Installation Strategy SAP Note.

Where to download the agent installation files?

Please refer to the General Information section above.

Connection Configuration

Refer to the installation procedures contained inside the Diagnostics Setup Guide.

Connection options

Before starting the installation make sure that you have identified which installation strategy you want to use. This means that you need to choose between the two following scenarios:

  • Direct Solution Manager Registration: In this scenario, the Diagnostics Agent establishes a direct connection to the Solution Manager system. Using this type of connection no SLD attachment is necessary especially since Solution Manager 7.1 SP05. Operational issues concerning Diagnostics Agents to Solution Manager connectivity can now be easily resolved via the “Non-authenticated Agents” list. (See Non Authenticated Diagnostics Agents).
    Prerequisite: Diagnostics Agent was connected to a Solution Manager 7.1 SP05 system at least once.
  • SLD Registration: In this scenario, the Diagnostics Agent registers itself into the production SLD assigned to the managed system on which the Diagnostics Agent will be installed. This scenario should be used especially if Solution Manager is not yet installed.

SLD Registration - Remotely Connect DIagnostics Agents  - Solution Manager 7.1

If you choose the "SLD Registration" strategy, the Diagnostics Agent should be visible using SOLMAN_SETUP transaction -> System preparation -> Step "Connect Agents". You must connect the relevant Diagnostics Agents to the current Solution Manager system in order to later be able to use them.

Agent reconnection may require waiting several minutes. It depends on settings which are set on the SMD Agent side. As soon as it detects that the association has been changed the SLD state is updated and the registration should proceed.

Direct Solution Manager Registration

If you want to perform the "Direct Solution Manager Registration" after the installation of the Diagnostics Agent, you will need to perform the smdsetup script action managingconf.

You can perform the direct connection to the solution manager in two ways, using the J2EE Message Server HTTP port (recommended). For more information about the smdsetup script refer to the Diagnostics Agent setup guide attached to the SAP Note for the most recent installer release (see SAP Note 1833501).

Example:

  • Connection by Message Server:

smdsetup managingconf hostname:"sapms://<fqn>" port:"<J2EE MsgServer HTTP Port>" [optional user:"<...>" pwd:"<...>"]

To run these script we will need to following information:

  1. Full qualified solution manager hostname.
  2. J2EE Message Server HTTP Port, like 81<SolMan Java SCS Instance>.
  3. Diagnostics Agent system user: For more information about these user check the User Administration Guide.
  4. Diagnostics Agent system user password.

Where to find the J2EE Message Server HTTP port.

  • J2EE Message Server HTTP: This port is usually 81XX (where xx is the SCS instance number: /usr/sap/<DASID>/SCS<xx>).

Make sure that you address the Solution Manager Java SCS Message Server with the above mentioned port number. URL.  Enter in the following URL: http://<solmal_msg_server_host>:<j2ee_msg_server_http_port>/msgserver/text/logon
This shall display a P4 and/or P4S line, like here:



Having all necessary information, you have to perform the smdsetup script to connect the Diagnostics Agent to the Solution Manager system:

   1. Open a prompt command and navigate to the script folder inside of the agent path: usr/sap/<SID_AGT>/SMDAXX/script
   2. Run the smdsetup script as the following examples:

  • Connection by Message Server:

     - smdsetup managingconf hostname:"sapms://solman.full.qual.host.name" port:"81XX" user:"SMD_ADMIN" pwd:"XXXXXXXX"

  •  Afterwards, the command should finish successfully:

Then check at the “Agent Administration” if the agent is connected to the Solution manager. If the agent does not connect to the Solman system check the SMDSystem log for error. This log file can be found into the log folder at the agent path.

IMPORTANT: Note that SAP recommends to use the connection via the Solution Manager Java SCS Message Server. Trying out a direct connection via the P4 or P4S port, is only relevant in some very specific situations.

Frequently Asked Questions and Trouble Shooting

Please refer to the FAQ Diagnostics Agent.

 

 

  • No labels
  1. SAP Note 1878116 - P4 port not reachable

  2. See also the SCN blog "Agent Data in the SAP Solution Manager LMDB" by Wolf Hengevoss:

    http://scn.sap.com/community/it-management/alm/blog/2012/01/23/agent-data-in-the-sap-solution-manager-lmdb

    Best regards

    Steffi

  3. How to enable this P4 onto my solution manager/message server ?

    this SAP note 1878116 - P4 port not reachable tells nothing to me...

    Regards

  4. Hello Expert,

     

    I am facing an issue while registering agent with Solman in windows using below command.

       1) Open a prompt command and navigate to the script folder inside of the agent path: usr/sap/<SID_AGT>/SMDAXX/script
       2. Run the smdsetup script as the following examples:

    R:\>C:\usr\sap\DAA\SMDA98\script\smdsetup.bat managingconf hostname:"Solman_host" port:"50XX4" user:"SMD_agent" pwd:"XXXXXX"

    i have also tried below command also

    R:\>C:\usr\sap\DAA\SMDA98\script\smdsetup.bat managingconf hostname:"sapms://solman.full.qual.host.name" port:"81XX" user:"SMD_ADMIN" pwd:"XXXXXXXX"

     

    but getting an error that SMD server or port is not reachable.

     

    Please suggest.  

    1. Hi,

      I noticed that your example command has port "50XX4" but I think this is usually "5XX04".  If you used "50XX4" then it maybe worth trying "5XX04" instead.

      Steven.

      1. Hello ,

        I have tried 5xx04 , it was not working ... This error I am getting while installing agent ... My installation is not yet completed ..

        I tried to install agent with production Solution manager details and use prod solution manger port which was working fine .... 

        only getting an error while installing agent with pre-prod solution manager details...

         

         

        1.  

          Dear Viral,

          Note that the Diagnostics Agents shall in general always be connected via the Solution Manager Java SCS Message server and not the P4 or P4S port.
          I have updated this page to better highlight this and avoid ambiguities.

          Now, let me answer your question. In general the P4 port looks like: 5NN04. However the Java SCS Message Server HTTP port looks like: 81XX, where XX usually represents the Instance number. Remember also that the Java SCS Java has always a distinct instance number.

          Hope this answers your question.

          Best regards,

          Olivier

           

  5. Hello,

    do you have any guide or information on how to configure this but through a SAPRouter? It really seems that in the smdsetup sldconf or smdsetup managingconf commands you can't put the SAPRouter route (/H/..../S/...)

    So if I configure it like this:

    smdsetup sldconf hostname:"solution_manager_private_IP" port:"50000" user:"SLDDSUSER" pwd:"password"

    smdsetup managingconf hostname:"solution_manager_private_IP" port:50004” user:"SMD_ADMIN" pwd:"password"

    smdsetup addsaprouter route:"/H/SAPRouter_Public_IP/S/sapdp99/H/solution_manager_private_IP/S/3300"

    it doesn't work... any suggestions?

    thank you

    1. Hi Pablo,

      I see you have not received an answer so far. If you are still facing problems here, I suggest you report an incident on SV-SMG-DIA-SRV-AGT.

      Thanks,

      Pieter

  6. hello:

    I read your text

    "Diagnostics Agents update their business logic (coding) from the SAP Solution Manager system to which they are connected. All connected Diagnostics Agents that are running in the landscape, are centrally patched, when deploying an LM-SERVICE Java Software Component Archive (SCA) on the SAP Solution Manager system." 

    We have recently upgraded our Solman7.1 to SP11 and now all our diagnostic agents have a RED icon in the managed systems tab. How do we fix this? does this mean we have to upgrade every ST-PI on the managed system? the ST-PI on the central Solman7.1 shows 2008_1_700 SP10 and on the managed systems it is showing 2008_1_700 SP07

    please advise...

    thanx

    1. Hi Salim,

      I think your issue requires some investigation. Please report an incident on SV-SMG-DIA-SRV-AGT.

      Thanks,

      Pieter

  7. After patching to SP12 the diagnostic agents are not able to connect to solman. The error message is: Exception during getInitialContext operation. "Wrong security principle/credentials."
    I've checked the password and executed the script to update it but the issue is nto solved.
    Any ideas? 

    1. Hi Marian,

      Could you kindly precise your update/upgrade path ? Did you update from a Solution Manager lower than 7.1 SP10 ?
      Typically, such kind of user credential issues are related to the fact that with 7.1 SP10 and higher the standard user to connect the Diagnostics Agents is no longer SMD_ADMIN, but SMD_AGT.

      Therefore I propose to double check which user is maintained in SOLMAN_SETUP -> System Preparation -> Maintain Users (SMD_AGT). Make sure that this user is not locked. Also you can use the action "Update Password" to generate a new password is required. IMPORTANT: You will then get a notification pop-up. Make sure to confirm it, in order to execute as well any dependent setup activities.

      In any case, do not forget that you have the possibility to reconnect Agents centrally, having credential issues, using the Agent Administration UI, under the tab "Non-authenticate Agents".

      Best regards, Olivier

      1. Hi Olivier

        We updated from SP10 to SP12. 
        The change from SMD_ADMIN to SMD_AGT is familiar to me but the fact that all DAs  are not authenticated after a SPS update is quite disappointing.
        I've chcked again according to your proposal but the user is not locked and the password is valid (I've double checked it).
        The reconnect Option via Agent Adminitration UI does not work. I'm still investigating and trying to discover the culprit.

        Cheers
        Marian 



         

        1. Hi Marian,

          Thanks for these additional details. First of all note that this behavior is not expected and did not occur internally on the various validation and demo systems.

          Could you kindly open a ticket on SV-SMG-DIA-SRV-AGT, attaching the zip file generate with the Diagnostics Agent OS command "smdsetup supportlogs" on one of the impacted Managed systems hosts ?

          By the way, did you also apply the LM-SERVICE 7.1 SP12 Patch 1, like indicated in SAP note:  2020219 .

          Best regards, Olivier

          1. Hi Olivier

            THe LM-Service component has the SP12 Patch 1-> sap.com  LM-SERVICE  7.10 SP12 (1000.7.10.12.1.20140731094700)  SAP AG  SAP AG  20140819104722  
            I still want to invest some time and find a solution so no reason to hurry and create an incident.

            For the moment  the search continues.
            Many thanks for the hints! New ideas/approaches are always more than welcomed!
            Cheers
            Marian 

          2. Hi Olivier

            I think I found the reason why the authentication is not working anymore.
            After changing the "Authentication Policy for Agents" from Certificate to "Use Basic authentication" I was able to connect (only for testing purpose) one DA. When switching back to Certificate again there was an issued error message like:  "Wrong security principle/credentials; Failed to connect to SMD server - CN=SMD_ADMIN;  Connecting to SMD server ms://solmanfqdnhost:xxxx/P4 failed".
            The certificate authentication has SMD_AGT as assigned user.
            Could you please clarify the following things:

            • how can the CN=SMD_ADMIN be changed to SMD_AGT; I tried using the smdsetup script but somehow the change was not activated
            • in case the Authentication Method is changed back to Certificate what are the prerequisites? Is SSL connection compulsory? Previous to SP12 the Certificate Authentication was working without SSL.
            • can  "Basic authentication" still be used or in the near future only the Certificate Authentication should be used?


             Thank you 
            Marian 

            LE: found the following note 2013578 - SMDAgent cannot connect to the Solman using certificate based method - Solman 7.10 SP11 

             

            1. Hi Marian,

              Thanks for the feedback and the reference to that SAP KBA. 
              FYI, I will ask our Product Support colleagues to revise it as it could be misleading.

              Let me come back to your situation, as you finally didn't open a message. (smile)
              Do you confirm that at the time you updated to 7.1 SP12 you also worked through the prerequisites mentioned in the Solution Manager Release Information Note (2020219) ?
              Especially did you come to apply some NW patches ? Did you in that case also pay attention to the maintenance of the TrustedP4SPort property like mentioned ?
              It is correct that the error "Wrong security principle/credentials" could also occur, in case some NW J2EE patches (7.02 SP15) have been applied on the SolMan 7.1 SP12 system, but the TrustedP4SPort property is not maintained in NWA, although you are using the authentication via Certificates.

              Kindly precise your situation, before we check out additional points together.

              Best regards, Olivier