Installation notes for the Web ADF
The ArcGIS Server for the Java Platform ADF includes a set of Web controls and the Web Mapping Application. The Web Mapping Application demonstrates how to use the Web controls. The following information will explain how to configure ArcGIS Server for the Java Platform ADF.
Tip:These steps assume that the ArcGIS Server Object Manager is running and that you have created at least one MapServer Object.
The following is available:
- Web Mapping Application—Web application with basic map navigation capabilities
For more information on the Web Mapping Application, see ArcGIS Server help.
How to set your machine up to use the ADF
The following steps are required to use ArcGIS Server for the Java Platform ADF Web controls and Web Mapping Application:
- Verify Java 2 Platform Standard Edition (J2SE) SDK is installed. See the system requirements on the ESRI Support Site for supported J2SE SDK versions.
- Set the environment variables.
- Verify that you have a supported Web server and servlet engine/Application Server installed. See the system requirements on the ESRI Support Site for supported Web servers and servlet engines. Sun Java system (formerly Sun ONE) Application Server users should see the Additional steps for Sun Java system (formerly Sun ONE) Application Server users below. WebLogic Server users should see the Additional steps for BEA WebLogic Server users below.
- To build and deploy Web applications from the ArcGIS Server Java ADF Web Mapping Application, follow the directions for the supported Web server - servlet engine you are using.
Instructions for performing steps 2 and 3 above are provided below. Step 1 should have already been completed.
Once these steps have been completed, Another Neat Tool (ANT) is used to build and deploy applications using the Web Mapping Application. See the ArcGIS Server help for information.
How to set the environment variables
Add the following to your system Path environment variable:
PATH=$ARCGISHOME/java/tools/ant/bin
Tip:The environment variable $ARCGISHOME was created during the ArcGIS Server for the Java Platform setup. $ARCGISHOME is the ArcGIS Server for the Java Platform installation location.
- Set the JAVA_HOME environment variable to the installation location of J2SE SDK. For example:
JAVA_HOME=/opt/jdk1.6
For WebSphere Application Server, set the JAVA_HOME environment variable to the J2SE SDK installed with WebSphere Application Server.
For example:
JAVA_HOME=/disk1/WebSphere/AppServer/java
If you will be using the Apache Web server, append :$JAVA_HOME/bin to the system path variable.
Arcgisant (the tool you will use for building Web applications) uses the J2SE SDK to encrypt the GIS server password in the Web application. Once the Web application is deployed on a Web server, the Web server will decrypt the password at runtime.
Additional steps for BEA WebLogic Server users
If you are using BEA WebLogic Server, you will need to edit your commEnv.cmd file. The commEnv.cmd file is located in an installation location similar to <WebLogic installation directory>/bea/weblogic81/common/bin/commEnv.cmd. Open the commEnv.cmd file in a text editor and add the following line after the comments at the beginning of the file:
set AGS_HOME=<ArcGIS Server for the Java Platform Installation Directory>
For example:
set AGS_HOME=/disk1/arcgis/server10.0
Also, locate the WEBLOGIC_CLASSPATH variable setting and change it to the following:
set WEBLOGIC_CLASSPATH=$AGS_HOME/java/lib/arcobjects.jar;
$JAVA_HOME/lib/tools.jar;$WL_HOME/server/lib/weblogic_sp.jar;
$WL_HOME/server/lib/weblogic.jar;$WL_HOME/server/lib/ojdbc14.jar
$WL_HOME/server/lib/weblogic_sp.jar;$WL_HOME/server/lib/weblogic.jar;$WL_HOME/server/lib/ojdbc14.jar
The arcobjects.jar must be the first entry in the WebLogic classpath. Restart the WebLogic Server.
Additional steps for Sun Java system (formerly Sun ONE) Application Server users
If you are using Sun Java system (formerly Sun ONE) Application Server, you will need to edit your server.policy file. The server.policy file is located in an installation location similar to <Sun Java System Application Server installation directory>/Appserver7/domains/domain1/server1/config/server.policy for version 7.0 and <Sun Java System Application Server installation directory>/Appserver/domains/domain1/config/server.policy for version 8. Open the server.policy in a text editor and add the following lines to the end of the file:
grant {
permission java.util.logging.LoggingPermission "control", "";
permission java.lang.RuntimePermission "shutdownHooks";
permission java.lang.RuntimePermission "modifyThread";
permission java.lang.RuntimePermission "stopThread";
permission java.util.PropertyPermission "JINTEGRA_RELEASEALL_SHUTDOWN_HOOK", "write";
permission java.util.PropertyPermission "JINTEGRA_IUNKNOWN_VARIANT_OBJECTS", "write";
};
Additional steps for Tomcat users if a SecurityManager is in use
If you are using Tomcat with a SecurityManager, you will need to edit your catalina.policy file. The catalina.policy file is located at $CATALINA_HOME/conf/catalina.policy. Open the catalina.policy file in a text editor and add the following lines to the end of the file:
grant {
permission java.util.logging.LoggingPermission "control", "";
permission java.lang.RuntimePermission "shutdownHooks";
permission java.lang.RuntimePermission "modifyThread";
permission java.lang.RuntimePermission "stopThread";
permission java.util.PropertyPermission "JINTEGRA_RELEASEALL_SHUTDOWN_HOOK", "write";
permission java.util.PropertyPermission "JINTEGRA_IUNKNOWN_VARIANT_OBJECTS", "write";
permission java.net.SocketPermission "<hostname>:8080", "connect,resolve";
permission java.net.SocketPermission "<hostname>:135", "connect,resolve";
permission java.net.SocketPermission "<hostname>", "connect,resolve";
permission java.io.FilePermission "/opt/jdk1.6/jre/lib/rt.jar", "read";
}
where
<hostname> is the name of the machine Tomcat is running on.
Change the port numbers and path to the J2SE SDK as appropriate. Restart Tomcat with a SecurityManager as follows:
$CATALINA_HOME/bin/catalina.sh start -security