After installing ArcIMS, you must configure your Web server for ArcIMS. If your Web server is not operational, contact your system administrator before you proceed. See www.sun.com/software for information on problems with Sun Java System Application Server 9. Follow these steps to configure Sun Java System Application Server 9 for ArcIMS:
Verify that the following items are located in <Sun Java System Application Server 9 Installation Directory>\SDK\domains\domain1\server1\applications\j2ee-modules\servlet\WEB-INF\classes:
com directory
Esrimap_prop
ServletConnector_Res.properties
ServletConnector_Res_en_US.properties
If you can not verify the above:
Start the Sun Java System Application Server if it is not started already by going to Start > Programs > Sun Microsystems > Application Server PE 9> Start Default Server.
Go to Start > Programs > Sun Microsystems > Application Server PE 9> Admin Console to open the administrator console for Sun Java System Application Server 9 or type http://localhost:4848 in a Web browser. Log in.
In the left panel, navigate to Application Server> Applications > Web Applications (click on the little bullet to expand applications).
In the right panel, click Deploy, select Specify a package file to upload to the Application Server, then browse to the file <ArcIMS Installation Directory>\ArcIMS\Connectors\Servlet\arcimsservletconnector.war and click Next.
Edit the Application Name to say “servlet”.
Edit the Context Root to say “/servlet”.
Click OK.
On the Website folder (ie. C:\arcims\website), create a WEB-INF folder and create web.xml and sun-web.xml text files within this folder. In a text editor such as Notepad, edit these files.
Edit web.xml and paste the following:
<web-app>
<display-name>website</display-name>
</web-app>
Edit sun-web.xml and paste the following:
<?xml version="1.0" encoding="UTF-8"?>
<sun-web-app>
<context-root>/website</context-root>
</sun-web-app>
On the Output folder (ie. C:\arcims\output), create a WEB-INF folder and create web.xml and sun-web.xml text files within this folder. In a text editor such as Notepad, edit these files.
Edit web.xml and paste the following:
<web-app>
<display-name>output</display-name>
</web-app>
Edit sun-web.xml and paste the following:
<?xml version="1.0" encoding="UTF-8"?>
<sun-web-app>
<context-root>/output</context-root>
</sun-web-app>
Go to Start > Programs > Sun Microsystems > Application Server PE > Admin Console to open the administrator console for Sun Java System Application Server 9 or type http://localhost:4848 in a Web browser. Log in.
In the left panel, navigate to Application Server> Applications > Web Applications (click on the little bullet to expand applications).
In the right panel, click Deploy, select Specify a package file or a directory path that must be accessible from the server, then enter website path (ie. C:\arcims\website) and click Next.
Edit the Application Name to say “website”.
Edit the Context Root to say “/website”.
Click OK.
In the right panel, click Deploy, select Specify a package file or a directory path that must be accessible from the server, then enter output path (ie. C:\arcims\output) and click Next.
Edit the Application Name to say “output”.
Edit the Context Root to say “/output”.
Click OK.
Navigate to <Sun Java System Application Server 9 Installation Directory>\SDK\domains\domain1\applications\j2ee-modules\servlet\WEB-INF\classes. In a text editor (such as Notepad), open the Esrimap_prop file and edit “APPSMACHINE” to reflect the name of the ArcIMS host. Save and close the file.
Navigate to <Sun Java System Application Server 9 Installation Directory>\SDK\domains\domain1\config and in a text editor (such as Notepad) open the server.policy file. Copy and add the following text immediately above the line that begins “\\ Following grant block is only required by connectors”:
// Permissions for the ArcIMS Servlet Connector
grant codeBase "file:/<Sun Java System Application Server 9 Installation Directory>/SDK/domains/domain1/applications/j2ee-modules/servlet/WEB-INF/classes/-" {
permission java.util.PropertyPermission "*", "read,write";
};
Save and close the file.
Navigate to <Sun Java System Application Server 9 Installation Directory>\SDK\domains\domain1\config and in a text editor (such as Notepad) open the default-web.xml file. Copy and add the following text within the <welcome-file-list> block.
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
Save and close the file.
Navigate to <Sun Java System Application Server 9 Installation Directory>\SDK\domains\domain1\applications\j2ee-modules\servlet\WEB-INF and in a text editor (such as Notepad) open the web.xml file. Copy and add the following text above the </welcome-file-list> line.
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
Save and close the file.
Restart Sun Java System Application Server 9.
Verify your ArcIMS installation was successful.
a. Choose Start > Programs > ArcGIS > ArcIMS > Diagnostics. The ArcIMS Diagnostics tool displays.
b. Select your Web server protocol, type your Web server name including domain, and type your port number. The default is 80.
c. Click 1 to test the ArcIMS Servlet Connector and 2 to test the ArcIMS Application Server.
If these tests are successful, your ArcIMS Application Server and ArcIMS Servlet Connector are 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 are displayed. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.
See Configuring Sun Java System Application Server 9 for Service Administrator for information on configuring ArcIMS Service Administrator.
See Step 5:Configure ArcIMS for the final step required to get ArcIMS running.