Specify the address of the network router for Mobile Access

In some cases, you need to edit the Mobile Access Runtime software configuration file in order to specify the address of the network router that manages traffic on your network.

Before you begin this task, you must have already installed Mobile Access Runtime on your IWS project server. The file that you need to edit is included with that software. For more information, see Install the Mobile Access Runtime software. You should also be familiar with XML and how to edit an XML-formatted configuration file.

If the project server is located on a private network behind a network router that uses network address translation (NAT) to manage traffic between the private network and the Internet, you need to do two things.

First, you need to configure the router to forward connections from the Internet to the project server. This is typically done by opening a port on the router and then mapping that port to the correct server on the network. If you cannot do this yourself, please contact your network administrator. When it is done, however, note the public IP address of the router and the number of the port that was mapped.

Second, you need to configure Mobile Access Runtime so that it knows the address of the router. It uses this information to set up the Mobile Access web interface in the browser on the client, after the user logs on. Without this information, the client cannot maintain its connection to the server.

To specify the address of the network router:

  1. Find the Mobile Access Runtime software configuration file (Web.config) on your project server. Assuming that both Microsoft IIS and Mobile Access Runtime have been installed in their default locations, the configuration file should be located at C:inetpubwwwrootMAWeb.config
  2. Open the configuration file with a text editor (e.g., Notepad).
  3. In the configuration file, find the node named appSettings. For example, in the default version of Web.config that is installed with the Mobile Access Runtime software:
        <appSettings>      <add key="MinMaxMessage" value="Value out of range Min:{0} Max:{1}"/>      <add key="InvalidFloatingPointValue" value="Invalid floating point value"/>      <add key="DataServerIPAddress" value="127.0.0.1"/>      <add key="TCPPort" value="1234"/>      <!--<add key="RouterIP" value="200.128.128.0"/>      <add key="RouterPort" value="3040"/>-->    </appSettings>  
  4. Uncomment the keys named RouterIP and RouterPort. In other words, delete the brackets (<!– –>) around the keys that mark them as comments. For example:
        <appSettings>      <add key="MinMaxMessage" value="Value out of range Min:{0} Max:{1}"/>      <add key="InvalidFloatingPointValue" value="Invalid floating point value"/>      <add key="DataServerIPAddress" value="127.0.0.1"/>      <add key="TCPPort" value="1234"/>      <add key="RouterIP" value="200.128.128.0"/>      <add key="RouterPort" value="3040"/>    </appSettings>  
  5. Replace the key values: for RouterIP, type the public IP address of the network router, and for RouterPort, type the number of the port that was mapped to the project server. For example:
        <appSettings>      <add key="MinMaxMessage" value="Value out of range Min:{0} Max:{1}"/>      <add key="InvalidFloatingPointValue" value="Invalid floating point value"/>      <add key="DataServerIPAddress" value="127.0.0.1"/>      <add key="TCPPort" value="1234"/>      <add key="RouterIP" value="66.94.230.43"/>      <add key="RouterPort" value="3506"/>    </appSettings>  
  6. Save and close the configuration file.

Remember that the user will also need the IP address and port number in order to log on. For more information, see Log on to the Mobile Access web interface.

Specify the address of the network router