ArcGIS Spatial Data Server for Java checklist

The following is a list of requirements and tasks that you can use to help keep track of your ArcGIS Spatial Data Server for the Java platform set up. If you run into problems, refer to the checklist to be sure you have all the required software, files, and configurations.

Apache Tomcat is used for the web server as an example, but other web application servers are supported. See the ArcGIS Spatial Data Server System Requirements for more information.

Software requirements for publishing from ArcGIS for Desktop to ArcGIS Spatial Data Server for Java

The following software and files are required:

• ArcGIS for Desktop installed and licensed (at least Standard or Advanced)
• Database management system (DBMS) 32-bit client libraries installed on the ArcGIS for Desktop client machine
• ArcGIS Spatial Data Server for Java installed and authorized (an ArcGIS for Server Enterprise Standard or Advanced license is needed if you will be editing data.)

  Authorization keys, REST directories, and the arcgis.war file are created in c:\Program Files\ArcGIS\SDS<release>\java on Windows servers and /arcgis/SDS<release>/java in the user's home directory on Linux servers.

• DBMS installed and configured on a server
  • Users created in the DBMS with proper privileges to own and publish data
• Java Runtime Environment (JRE) installed on the server where ArcGIS Spatial Data Server is installed
• JDBC drivers placed on the server where ArcGIS Spatial Data Server is installed

  JDBC drivers usually are provided with your DBMS installation, or they can be downloaded from your DBMS vendor's website.

• Web application server installed on the server where ArcGIS Spatial Data Server is installed

  If using Apache Tomcat, you can download it from http://tomcat.apache.org/download-70.cgi. The following is an example of the tasks for installing Tomcat:

  • Run the installation as the Administrator user.
  • Create a JAVA_HOME variable.
  • Add your data sources to the Tomcat context.xml file.
  • Copy JDBC drivers to the Tomcat lib directory.

Deploying ArcGIS Spatial Data Server for Java

Once all the software is installed, you can deploy your spatial data server.

• If you are using Tomcat, copy or move the arcgis.war file from the ArcGIS Spatial Data Server installation directory to the Tomcat webapps directory.
• Start or restart Tomcat.

See Web application deployment for WebLogic or Web application deployment for WebSphere if using either of those web application servers.

Authorizing the deployed spatial data server

The deployed ArcGIS Spatial Data Server for Java must be authorized as well as the software itself.

On the server where ArcGIS Spatial Data Server for Java is installed:

• Start an Internet browser and navigate to http://localhost:<web app port>/arcgis/admin/authorizeSDS. Substitute your web application server port for <web app port>. The default port for Tomcat is 8080.
• Browse to the authorization keycode that was created when you authorized the ArcGIS Spatial Data Server for Java software.

  The keycodes file is created in \\Program Files\ESRI\License<release>\sysgen on Windows servers and /arcgis/SDS<release>/java/sysgen in the user's home directory on Linux servers.

If you do not have access to the Internet from your server, see Authorizing a deployed ArcGIS Spatial Data Server for Java without a web browser for instructions.

Publishing to the spatial data server

Once the data you want to publish has been loaded to the database and ArcGIS Spatial Data Server for Java is installed, deployed, and authorized, you can author a map and publish from ArcMap.

• In the Catalog tree, create a database connection to the database where your data is stored.

  Connect as a user with privileges to edit the data, if you want to be able to edit the data through a feature service.

  Be sure to save the user name and password.

  If publishing Oracle data, you must use Easy Connect syntax.

• Also in the Catalog tree, create an ArcGIS Server connection.

  Create a Publish GIS services connection, and be sure to choose Spatial Data Server for the server type.

• Add to the map the data you want to publish.
• Set desired layer properties for the data, such as feature symbology, scale ranges for data to display, and field aliases.
• Run the wizard to share the map as a service.

  File > Share > Service

• Analyze the service before publishing.

  At that time, you can define the data source mapping if ArcGIS for Desktop cannot determine a unique data source. When you define the data source, use the same user as was specified in your database connection.

  You must also fix any errors before publishing.

• Publish the service.

To see the published service, you can open a web browser and navigate to http://<hostname>:<web app port>/arcgis/rest/services. Choose the service and choose View In: ArcGIS.com Map.