'Connect to Message Server Failed' Error

Symptom

Sometimes, when you try to launch SAP GUI from Process Runner, an error similar to the following is displayed.

Connect to message server failed

Cause

This problem occurs because the path of the SAPUILandscape.xml file in the SAP system and Process Runner is not the same or due to the changes made in the System Connection Parameters setting.

Solution

To resolve this issue, check the following:

  • Path of SAPUILandscape.xml file
  • SAP system properties

To check the path of SAPUILandscape.xml file

  1. Open SAP Logon and perform the following steps:
    1. Select the hamburger menu icon available at the upper-left corner and select Options. The SAP GUI Options – SAP Logon window is displayed.
    2. Expand SAP Logon Options, and select Local Configuration Files. The path of SAPUILandscape.xml file is displayed in the Loaded Local Files section.
  2. Open Process Runner and perform the following steps:
    1. On the Home tab, select SAP Shortcuts. The Magnitude Connector for SAP window is displayed.
    2. Select the Advanced tab. The path of SAPUILandscape.xml file is displayed under the Local Config File section.

      3. Ensure that the path of SAPUILandscape.xml file in the SAP Logon and in Process Runner are the same.

  3. Run the Process file.

To check SAP system properties, perform the following steps:

  1. Open SAP Logon, and perform the following:
    1. Select the SAP system in which you are facing the issue, and select Edit from the More drop-down list menu. The System Entry Properties window is displayed.
    2. On the Connection tab, select Group/Server Selection from the Connection Type dropdown list menu. If the Message Server has been changed in the SAP system properties, a message is displayed to indicate that the message server has been changed.
    3. Select OK. The Instance Number for the selected SAP system is updated.
  2. Open Process Runner, and perform the following:
    1. On the Home tab, select SAP Shortcuts. The Magnitude Connector for SAP window is displayed.
    2. On the Server/Group tab, select the SAP system and select Properties. The Properties<NameOfSAPSystem> window is displayed.
    3. On the Logon Values tab, select Auto Switch check box and change the logon method type. If Method 1 is selected, change it to Method 2 and if Method 2 is selected, change it to Method 1.
    4. Select OK.
  3. Run the Process file.

For further assistance, please create a support case on Salesforce.