Configuring Sun Java System (formerly Sun ONE) 6.0 SP 5 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) 6.0 .

Verify that the following items are at \iPlanet\Servers\docs\servlet:

com directory
Esrimap_prop
ServletConnector_Res.properties
ServletConnector_Res_en_US.properties
WMSEsrimap_prop

If you can not verify the above:

On Windows NT, choose Start > Settings > Control Panel > Services; On Windows 2000, choose Start > Settings > Control Panel > Administrative Tools > Component Services, and click Services on the Tree tab; on Windows XP, choose Start > Control Panel > Performance and Maintenance > Administrative Tools > Component Services, and click Services on the Tree tab.
Stop Sun Java System (formerly Sun ONE) 6.0 Web server
Navigate to <ArcIMS Installation Directory>\ArcIMS\Connectors\Servlet, and copy the items to that location.
Go into the \iPlanet\Servers\docs\servlet\WEB-INF\classes directory and open Esrimap_prop.
Rename the AppServerMachine variable "APPSMACHINE" to the name or IP address of the machine where ArcIMS Application Server is installed. Change the AppServerClientPort if you are using a non-default client port.
Start Sun Java System (formerly Sun ONE) 6.0 Web server.

In your Web browser, type:

http://<localhost>:<serveradminport>

For example: http://esri:8888

Tips

You may need to include your domain: http://<localhost.domain.com>:<serveradminport>. For example: http://esri.esri.com:8888
If you don’t know your server’s administration port, open iPlanet\Servers\https-admserv\config\admin.conf in a text editor and read the port there.

Type your user name and password and click OK. The Sun Java System (formerly Sun ONE) 6.0 Web Server Administration Server screen displays.

Select your server from the dropdown list and click Manage. The Server On/Off screen displays. Make sure the server is on.

Click the Java tab along the top.

The Enable/Disable Java screen displays. Make sure the Enable Java Globally and Enable Java for class defaultclass options are checked. Click OK.

Click Class Manager in the upper right corner of the screen. The Manage Virtual Servers screen displays.

Click Content Mgmt in the navigation bar on the top. The Document Root Settings screen displays.

Click Document Preferences on the left sidebar. The Document Preferences screen displays.

Add the following first in the list under Index Filenames:

default.htm,default.html,index.htm,

Click OK. Click Apply in the upper right corner.

Click Apply Changes to restart your Web server.

Exit Sun Java System (formerly Sun ONE) 6.0 .

Creating virtual directories

After installing ArcIMS, you must create virtual directories for Output, Website and Manager. A virtual directory is a mapped location on the Web server to a physical path.

Note: During the ArcIMS installation, If you browsed to \iPlanet\Servers\docs to create directories for Output and Website (the Web Site Working Directories), you don’t need to create virtual directories for Output and Website. Exit Sun Java System (formerly Sun ONE) 6.0 and skip to Using the Diagnostics tool to test your ArcIMS installation.

Navigate to <Sun ONE 6.0 Installation Directory>\Servers\https-<localhost>.<domain>.com\config directory and open the obj.conf file in a text editor.

After the <Object name=default> tag add the following lines:

For Manager-

NameTrans fn=pfx2dir from="/Manager" dir="<ArcIMS Installation Directory>/ArcIMS/Manager"

For Output-

NameTrans fn=pfx2dir from="/Output" dir="<Website and Output Installation Directory>/Output"

For Website-

NameTrans fn=pfx2dir from="/Website" dir="<Website and Output Installation Directory>/Website"

Save and close the file

Stop and Start the Sun Java System (formerly Sun ONE) 6.0 Web server.

Using the Diagnostics tool to test your ArcIMS installation

Verify that 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) 6.0 SP 5 for Service Administrator for information on configuring ArcIMS Service Administrator.

See Configuring Sun Java System (formerly Sun ONE) 6.0 SP 5 for Metadata Explorer for information on configuring Metadata Explorer.

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