English

How To: Configure WebSphere 4.0.3 for IBM HTTP Server on HP-UX

Summary

After installing ArcIMS, you must configure your Web server for ArcIMS. If your Web server and servlet engine are not operational, contact your system administrator before you proceed. See IBM Websphere support for information on problems with WebSphere.

Procedure

After installing ArcIMS, you must create virtual directories for output and website. A virtual directory is a mapped location on the web server to a physical path. You must also register the ArcIMS Servlet Connector with WebSphere 4.0.3.

  1. Open the file <IBM HTTP Installation Directory>/conf/httpd.conf in a text editor.
  2. In the Alias section, add the following for web site and server output:

    Alias /output "<Path to output directory>/output"
    <Directory "<Path to output directory>/output">
    Options Indexes MultiViews
    AllowOverride None
    Order allow,deny
    Allow from all
    </Directory>

    Alias /website "<Path to website directory>/website"
    <Directory "<Path to website directory>/website">
    Options Indexes MultiViews
    AllowOverride None
    Order allow,deny
    Allow from all
    </Directory>
  3. For the web pages designed in ArcIMS to start automatically, make sure your DirectoryIndex line includes default.htm. For example:
    DirectoryIndex index.html default.htm

  4. Save and close the file.
  5. Configure the ArcIMS Servlet Connector:

    Start IBM HTTP servers by navigating to <IBM HTTP Server Installation Directory>/bin. Type:
    ./adminctl start
    ./apachectl start
  6. Make sure IBM WebSphere Application server is running. If not, start the server by navigating to <WebSphere Installation Directory>/AppServer/bin. Type:
    ./startupServer.sh
  7. Start the WebSphere Advanced Administrative Console by navigating to <WebSphere Installation Directory>/AppServer/bin. Type:
    ./adminclient.sh

  8. On the left sidebar, expand the WebSphere Administrative Domain, Nodes, computer name and Application Servers to make sure that the 'Default Server' is running. If not, right-click on it and click Start.
  9. On the tool bar, click on Wizards > Enterprise Application. This opens the Install Enterprise Application Wizard.

  10. Select Install stand-alone module (*.war, *.jar). For Path, Browse and navigate to <ArcIMS Installation Directory>/Middleware/servlet_connector/arcimsservletconnector.war.

  11. For Application Name, type: servlet
  12. For Context root for web module, type: /servlet
  13. Click Next and accept all the defaults until you reach the Completing the Application Installation Wizard page. Click Finish. This deploys the application.

  14. The ArcIMS Servlet Connector is installed under installedApps inside the IBM WebSphere installation directory.

  15. Open the Esrimap_prop file located at <WebSphere Installation Directory>/AppServer/installedApps/servlet.ear/arcimsservletconnector.war/WEB-INF/classes
  16. Change the value of appServerMachine to the name of your Application Server computer. For example:
    AppServerMachine=<server name>.esri.com

  17. Save and close the file.

  18. In WebSphere Advanced Administrative Console, right click on "Default Server" under Nodes, your computer name, Application Servers. Click on Stop. Restart it by clicking Start.

  19. Close the WebSphere Administrative Console.
  20. Use the Diagnostics tool to test your ArcIMS installation:

    Open <ArcIMS Installation Directory>/Xenv/ArcIMS_Diagnostics/ArcIMS_Diagnostics.html in Netscape. The ArcIMS Diagnostics tool displays.
  21. Select your Web server protocol, type your web server name including domain, and type your port number. The default is 80.

  22. Click 1 to test the ArcIMS Servlet Connector.

    If this test is successful, your ArcIMS Servlet Connector is configured correctly.
    If you receive an error message, select the error number in the dropdown list and click View. The error number and a description display. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.

Related Information