Debugging Hybrid Web Container Connection Issues

List of things to check if the Hybrid Web Container is not connecting to SAP Mobile Server.

Check the Hybrid Web Container connection settings configuration on the device

  • Verify that there is a valid SAP Mobile Server name in the configuration.

    If the SAP Mobile Server name has changed, you must uninstall and reinstall the Hybrid Web Container on the device.

  • Verify that the configuration has a port on which SAP Mobile Server is configured to listen for messages. The default port is 5001 but may be set differently by the administrator.
  • Verify that the port is listening. Check with the SAP Mobile Server administrator.
  • Verify that the user name is in the configuration. If not, enter the user name in the configuration.
  • When connecting to Relay Server, verify that the connection ID (CID) is appended to the URL suffix, for example, /rs/client/rs_client.dll/<CID>/tm.

Correct Persistent BlackBerry Connections Settings

Perform these steps if BlackBerry connection setting information persists on the setting screen, after re-installing Hybrid Web Container:
  1. From the BlackBerry home screen, enter the Hybrid Web Container.
  2. Select the Settings menu on the Messages screen, and go to the Settings screen.
  3. Select the Restart Client menu to start the client.
  4. Exit the Hybrid Web Container, and go back to the BlackBerry home screen.
  5. Select the Hybrid Web Container application icon on the home screen.
  6. Select Delete from the home screen menu.
  7. Follow the instructions to delete the application, and restart the BlackBerry device.
  8. After the device has restarted, re-install the Hybrid Web Container. The old setting information is removed.

Is the SAP Mobile Server name DNS resolvable?

Try the SAP Mobile Server name first. If that does not work, the DNS may not be resolvable, Try the IP address instead.

Is the SAP Mobile Server name reachable through the Internet Control Message Protocol (ICMP)?

If you cannot ping your SAP Mobile Server name, make sure that you are on the proper network and that your VPN is established and verified as working properly.

Are Hybrid Web Container ports to SAP Mobile Server going through the firewall?

Check to see whether the specific ports used by Hybrid Web Container to SAP Mobile Server are going through firewalls. In a Web browser, enter http://servername:port/tm (the default port is 5001) to verify the messaging server is listening on the specified port.

Can an HTTP connection be established?

If the Hybrid Web Container attempted to connect to the SAP Mobile Server and failed, verify that the HTTP connection is working by going to a website on your device's browser application.

Check settings in SAP Control Center

Check the moca log on the device

The moca log on the device is a good resource for debugging a Hybrid Web Container connection problem. If you have physical access to the device, connect it to your computer (PC or Mac), and use third party software to retrieve those log files. For example, you can browse the mobile device and extract the moca log file with:
  • iPhone – iPhoneExplorer
  • Windows Mobile – Windows Explorer
  • Android – Android AVD Manager

Check the Hybrid Web Container connection settings configuration on the device

Verify that another user has not previously registered with this device from the Application Connection tab of SAP Control Center.