How to configure SMP 3.0 to use proxy to access external resource

[Ali_Chalhoub]

Purpose

This article explains all the steps needed to configure SAP Mobile Platform 3.0 to use a proxy server to access external resource.

Overview

This article will walk you through the steps needed to enable proxy in SAP Mobile Platform 3.0 in order to access an external webservices, oData or any other resources, using system proxy if SAP Mobile Platform 3.0 requires a proxy to access the internet.

Environment

• SAP Mobile Platform 3.0 (SMP)

Problem

If the SMP 3.0 server is configured in an environment where there is no direct access to the internet and a proxy is required, by default, you need to configure SMP 3.0 manually in order to configure proxy. Consider the following situation:

1. The environment is configured to access the internet using a proxy server
2. Assume you need to access an oData external service which requires an internet access and in that case, the Use System Proxy is checked as shown below:
   
3. By default, that will not work, you need to reconfigure SMP server to use your proxy

Solution

To fix this issue follow the following steps:

1. Open the props.ini configuration file located in the following default installation <SMP-HOME-PATH>\MobilePlatform3\Server in a text editor
2. Look for the following parameters,
   1. -Dhttp.proxyHost=
   2. -Dhttp.proxyPort=
3. Add your proxy as shown below and save your file
   
4. So if for example your proxy is called "myProxy" and the port is "8080", then that would look like this:
   1. -Dhttp.proxyHost=myProxy
   2. -Dhttp.proxyPort=8080
5. If the secure https proxy is the same server, then the configuration would look like this:
   1. -Dhttp.proxyHost=myProxy
   2. -Dhttp.proxyPort=8080
   3. -Dhttps.proxyHost=myProxy
   4. -Dhttps.proxyPort=8080
6. Once you are done, save your changes

Note, any changes to the props.ini requries either stopping and starting the SMP server via the desktop shortcut, or if it is running as a service, the service should stop and the service configruation needs to be regenerated in order to make SMP 3.0 uses the new proxy configuration, If SMP 3.0 is not running as a service and it is running through the desktop shortcut, manually, then all we need to do is stop the server using the shortcut and restart the server using the shortcut.

Regenerating the SMP Mobile Service

To regenerate the service in order to make SMP use the new configuration from the props.ini file follow the following steps:

1. Stop SMP 3.0 service if it is running as a service
2. Open a command prompt as an Administrator
3. Navigate to the following location <SMP-HOME-PATH>\MobilePlatform3\Server\bin
4. Execute this svcutil -uninstall
5. Execute this svcutil -generate
6. Execute this svcutil -install
7. Restart the SMP Mobile Service
8. SMP 3.0 should be able to access the external resource using the proxy configuration

Note

If the proxy requires user id and password, please refer to this KBA, 1969316.

Summary

This article explained how to enable and configure SMP 3.0 proxy using the props.ini file and how to regenerate the service for SMP 3.0