Configuring the XML Gateway

Owned by Luna
Last updated: Aug 30, 2012Version comment
1 min read

The Insight XML Gateway is installed by default. Once the XML Gateway has been installed, it needs to be configured.

Configuring the XML Gateway with a Username and a Connection to a User Manager

The Insight XML Gateway acts like the Insight Java Client. It is configured with a User Manager Address, a Username, a Password, and License-File Directory. By default, these are the only required configuration properties.

  1. Locate the XML Gateway configuration file (web.xml). The web.xml file is located in the WEB-INF directory of the XML Gateway installation directory.
  2. Open the web.xml file in your preferred text editor.
  3. Change the User Manager Address.
    1. Locate the following lines in the web.xml file:

<param-name>UserServerAddress</param-name>
<param-value>localhost</param-value>

    1. Change "localhost" to match the address of your Insight User Manager.
  1. Change the username and password.
  2. Locate the following lines in the web.xml file.

<init-param>
<param-name>username</param-name>
<param-value>test</param-value>
<description>Username for User Managerauthentication.</description>
</init-param>
<init-param>
<param-name>password</param-name>
<param-value>test</param-value>
<description>Password for User Managerauthentication.</description>
</init-param>

  1. Set the username parameter to match a valid username on your User Manager.
  2. Set the password parameter to match the valid password for the username used above.
  3. If you have upgraded from a previous version of the XML Gateway, change the ResponseSystemID parameter to http://www.lunaimaging.com/support/dtd/insightXMLGateway/v6.3/insightresponse.dtd.


  1. Restart Tomcat.
  2. Run the XML Gateway Tester (for more information on the XML Gateway Tester, please see (Testing the XML Gateway on page ).


Configuring the Simple Search Example Servlet

Insight ships with an example servlet on the Installation CD to help you get started with the XML Gateway. For more information on the simple search example servlet, please see the "utilities" directory on the Installation CD.