Configuring Sun Java System (formerly Sun ONE) Application Server 7.0 for ArcIMS

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 (formerly Sun ONE) 7.0. Follow these steps to configure Sun Java System (formerly Sun ONE) Application Server 7.0 for ArcIMS:

1. Verify that the following items are located in <Sun Java System (formerly Sun ONE) 7.0 Installation Directory>\domains\domain1\server1\applications\j2ee-modules\arcimsservletconnector_1\WEB-INF\classes:

• com directory

• Esrimap_prop

• ServletConnector_Res.properties

• ServletConnector_Res_en_US.properties

• WMSEsrimap_prop

If you can not verify the above:

• On Windows NT, click Start > Settings > Control Panel > Services; on Windows 2000, click Start > Settings > Control Panel > Administrative Tools > Component Services and click Services on the Tree tab; on Windows XP, click Start > Control Panel > Performance and Maintenance > Administrative Tools > Component Services and click Services on the Tree tab.

• Verify that the services Sun App Server 7 (domain1:server1) and Sun App Server 7 Admin Server (domain1:admin-server) are started.

• Go to Start > Programs > Sun Microsystems > Sun Java System (formerly Sun ONE) Application Server 7 > Start Admin Console to open the administrator console for SunONE 7.0  or type http://localhost:4848 in a Web browser. Log in.

• In the left panel, navigate to App Server Instances > server1 > Applications > Web Apps  (click on the little bullet to expand applications).

• In the right panel, click Deploy, then browse to the file <ArcIMS Installation Directory>\ArcIMS\Connectors\Servlet\arcimsservletconnector.war  and click OK.

• Edit the Context Root to say “servlet”.

2. Go to Start > Programs > Sun Microsystems > Sun Java System (formerly Sun ONE) Application Server 7 > Start Admin Console to open the administrator console for SunONE 7.0  or type http://localhost:4848 in a Web browser. Log in.

3. In the left panel, navigate to App Server Instances > server1 > HTTP Server > Virtual Servers > server1.  Choose the “Doc Handling” tab and add “default.htm, default.html, index.htm” to the Index Filenames. Click OK to confirm.

4. Go to the “Doc Directories” tab in the right panel and add the ArcIMS Website document directory:

• URL prefix: “Website”

• Map to Directory: C:\ArcIMS\Website

Click OK to confirm.

5. Add the ArcIMS Output document directory:

• URL prefix: “Output”

• Map to Directory: C:\ArcIMS\Output

Click OK to confirm.

6. Add the ArcIMS Manager directory:

• URL prefix “Manager”

• Map to directory <ArcIMS installation location>\ArcIMS\Manager.

Click OK to confirm

7. Save and Close the Sun Java System (formerly Sun ONE) administrator console.

8. Navigate to <Sun Java System (formerly Sun ONE) 7.0 Installation Directory>\domains\domain1\server1\applications\j2ee-modules\arcimsservletconnector_1\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.

9. Navigate to <Sun Java System (formerly Sun ONE) 7.0 Installation Directory>\domain1\server1\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”:

grant codeBase “file:/Sun/AppServer7/domains/domain1/server1/applications/j2ee-modules/arcimsservletconnector_1/WEB-INF/classes/-“

{

    permission java.util.PropertyPermission “*”, “read,write”;

};

Save and close the file.

10. Restart Sun App Server 7.

Using the Diagnostics tool to test your ArcIMS installation

11. 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 display. Follow the instructions in the description to fix the problem and try the Diagnostics tool again.

See Configuring Sun Java System (formerly Sun ONE) Application Server 7.0 for Service Administrator for information on configuring ArcIMS Service Administrator.

See Configuring Sun Java System (formerly Sun ONE) Application Server 7.0 for Metadata Explorer for information on configuring ArcIMS Metadata Explorer.

See Step 5:Configure ArcIMS for the final step required to get ArcIMS running.