Web ADF installation instructions

Resource Center» Configuration
ADF

ArcGIS Server 10 for Java platform ADF contains a set of Web controls and web drawing applications. The Web drawing application demonstrates how to use Web controls. The following information describes how to configure ArcGIS Server 10 for Java platform ADF.

The prerequisite for these steps is that the ArcGIS Server Object Manager (SOM) is running and you have created at least one mapserver object.

The following programs are available:

Web plotting application-web application with basic map navigation

For more information about the web graphics application, see ArcGIS Server help.

How to set up a computer to use the ADF

To use the Web Control and web drawing application of ArcGIS Server 10 for Java platform ADF, perform the following steps:

1. Check whether the j2se SDK has been installed. For supported j2se SDK versions, see system requirements.

2. Set environment variables.

3. Check whether the supported Web servers and Servlet Engine/application servers have been installed. For supported Web servers and servlet engines, see system requirements. Sun Java System (formerly known as Sun ONE) Application
   Server users should refer to the following sun
   The additional steps required by the Java System (formerly known as Sun ONE) Application Server user. WebLogic Server users should refer to bea below
   The additional steps that WebLogic Server users need to perform.
4. To build and deploy Web applications using the ArcGIS Server for Java platform ADF web drawing application, follow the instructions on the use of the supported Web server/servlet engine.

The following describes how to perform steps 2 and 3. Complete Step 1 first.

After completing these steps, you can use another neat tool (ANT) to build and deploy applications in web graphics applications. For more information, see ArcGIS Server help.

How to Set Environment Variables

Add the following content to the System Path Environment Variable:

PATH=%AGSSERVERJAVA%\java\tools\ant\bin

• The environment variable % agsserverjava % has been created during the installation of ArcGIS Server 10 for Java platform; % agsserverjava % indicates the installation location of ArcGIS Server for Java platform.

• Set the java_home environment variable to the installation location of j2se SDK. For example:

  JAVA_HOME=C:\j2sdk1.4.2_06

For WebSphere Application Server, you can set the java_home environment variable to the j2se SDK location installed with WebSphere Application Server.

For example:

JAVA_HOME=C:\Program Files\WebSphere\AppServer\java

If you want to use an Apache web server, add

;%JAVA_HOME%\bin

To the system PATH variable.

Arcgisant (a web application building tool) encrypts the password of the GIS server in the Web application using the j2se SDK. After a web application is deployed on the Web server, the web server decrypts the password at runtime.

Additional steps for BEA WebLogic Server users

If you are using BEA WebLogic Server, You need to edit the commenv. CMD file. The installation location of the commenv. CMD file is similar to the <WebLogic installation directory> \ Bea \ weblogic81 \ common \ bin \ commenv. cmd. Open the commenv. CMD file in the text editor and add the following lines after the comments at the beginning of the file:

set AGS_HOME=<ArcGIS Server for the Java Platform ADF Installation Directory>\ArcGIS

For example:

set AGS_HOME=C:\Program Files\ArcGIS\Server10.0

In addition, find the weblogic_classpath variable settings and make the following changes:

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

The ArcObjects. jar file must be the first entry in the Weblogic class path. Restart WebLogic Server.

Additional steps required by Sun Java System (Sun ONE) Application Server

If you are using Sun Java System (Sun ONE) application server, you need to edit the server. Policy file. Server. the installation location of the policy file is similar to: <Sun Java System (Sun ONE) Application Server installation directory>/appserver7/domains/domain1/server1/config/server. policy (version 7) or <Sun Java System (formerly called Sun ONE) Application
Server installation directory>/appserver/domains/domain1/config/server. Policy (version 8 ). Open the server. Policy file in the text editor and add the following lines at 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"; };

The following are additional steps for Tomcat users using securitymanager:

If you use Tomcat through securitymanager, You need to edit the Catalina. Policy file. The Catalina. Policy file is located at % catalina_home % \ conf \ Catalina. Policy. Open the Catalina. Policy file in the text editor and add the following lines at 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 "
Where
<Hostname> indicates the name of the computer on which Tomcat is running.

Change the port number and j2se SDK path according to the actual situation. Restart Tomcat using securitymanager as follows:
%CATALINA_HOME%\bin\catalina start -security