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.
- Open the file <IBM HTTP Installation Directory>/conf/httpd.conf in a text editor.
- 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> - 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
- Save and close the file.
- Configure the ArcIMS Servlet Connector:
Start IBM HTTP servers by navigating to <IBM HTTP Server Installation Directory>/bin. Type:
./adminctl start
./apachectl start
- Make sure IBM WebSphere Application server is running. If not, start the server by navigating to <WebSphere Installation Directory>/AppServer/bin. Type:
./startupServer.sh - Start the WebSphere Advanced Administrative Console by navigating to <WebSphere Installation Directory>/AppServer/bin. Type:
./adminclient.sh
- 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.
- On the tool bar, click on Wizards > Enterprise Application. This opens the Install Enterprise Application Wizard.
- Select Install stand-alone module (*.war, *.jar). For Path, Browse and navigate to <ArcIMS Installation Directory>/Middleware/servlet_connector/arcimsservletconnector.war.
- For Application Name, type: servlet
- For Context root for web module, type: /servlet
- Click Next and accept all the defaults until you reach the Completing the Application Installation Wizard page. Click Finish. This deploys the application.
- The ArcIMS Servlet Connector is installed under installedApps inside the IBM WebSphere installation directory.
- Open the Esrimap_prop file located at <WebSphere Installation Directory>/AppServer/installedApps/servlet.ear/arcimsservletconnector.war/WEB-INF/classes
- Change the value of appServerMachine to the name of your Application Server computer. For example:
AppServerMachine=<server name>.esri.com
- Save and close the file.
- 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.
- Close the WebSphere Administrative Console.
- 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.
- Select your Web server protocol, type your web server name including domain, and type your port number. The default is 80.
- 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.