Migration to ArcGIS Server 10

This topic provides an overview of things to consider when moving from ArcGIS Server 9.3 or 9.3.1 to ArcGIS Server 10. To learn about additions to the product, see What's new in ArcGIS Server 10.

If you are migrating to 10 from ArcGIS Server 9.2 or previous, consider reading the following topics:

The GIS server and services on Windows

On the Windows platform, the services you created in ArcGIS Server 9.3 (or 9.3.1) and their respective caches will transfer to ArcGIS Server 10 without your intervention. You may notice that the ArcGIS Server install creates a folder called Server10.0 under which all the files are placed. If you install ArcGIS Server 10 in the same parent folder where you had previously installed ArcGIS Server 9.3 (or 9.3.1), the install finds your server and service configuration files (which were intentionally left behind by the uninstall) and migrates them to the appropriate location under the Server10.0 install folder.

However, before migrating to ArcGIS Server 10, you should manually back up your configuration (.cfg) files and take note of their instance names and URLs. The ArcGIS Server 10 installation requires that you use the same instance and port number since any existing applications will be referencing these service URLs.

Migrating to Server Object Extensions

At ArcGIS Server 10, you can now expose your Server Object Extensions (SOEs) through REST (applicable to SOEs for map services only). Your customized GIS services created by SOEs can be displayed in the ArcGIS Services Directory and used through the ArcGIS Web APIs.

To take advantage of these enhancements, you can migrate your custom applications developed with fine-grained ArcObjects to use custom GIS services based on SOEs. For more information, see the ArcObjects SDK Server Object Extensions (SOEs) topic in the ArcGIS Resource Center.

Migrating secured deployments

ArcGIS Server does not attempt to migrate services or security settings from secured deployments. This is because ArcGIS Server 10 cannot discern enough information about a previous installation's security configuration to guarantee a complete migration of security settings. Rather than leave the migrated environment unsecured, ArcGIS Server does not attempt to migrate the services and settings.

On Windows, if the ArcGIS Server 10 installation detects (by reading the left-behind Server.dat file) that security was enabled on your previous deployment, none of your configuration files are automatically migrated. Your ArcGIS 10 deployment is instead left in a clean state wherein you can log into Manager, re-configure security, then explicitly enable security on your services.

To reconfigure security at ArcGIS 10, you need to do the following things in this order:

  1. Use Manager to define your user and role store.
  2. Re-create your services and folders, or copy your service configuration (.cfg) files from 9.3.1 into the ArcGIS Server 10 configuration directory. Typically, this is located at <ArcGIS Server 10 install directory>\server\user\cfg.
  3. Use Manager to set permissions on your newly created services and folders, or copy your security configuration files (.sec) from 9.3.1 into the ArcGIS Server 10 configuration directory. Typically, this is located at <ArcGIS Server 10 install directory>\server\user\cfg.
  4. Use Manager to enable security on your GIS server.

Installing the Data Interoperability Extension

The Data Interoperability Extension is no longer a part of the core ArcGIS Desktop or ArcGIS Server setups at 10. You must install the extension separately. If you do not install the extension, you may encounter problems publishing maps to ArcGIS Server that contain Interoperability Connections. Similarly, you will not be able to run models containing Data Interoperability tools or publish any toolboxes containing those models.

The Data Interoperability Extension is an excellent way to include data formats not native to ArcGIS (such as WFS) in your services and applications.

Moving to compact map caches

ArcGIS Server 10 introduces an optional compact cache format that requires less space and fewer files to store map caches. You can use a new tool, Convert Map Server Cache Storage Format, to migrate your existing caches to the compact format.

Migrating Web applications

This section describes how migrating to ArcGIS Server 10 will affect your existing Web applications.

Migrating Web applications built with ArcGIS Web APIs

The ArcGIS Server 10 installation requires that you use the same instance and port number defined in your ArcGIS Server 9.3/9.3.1 installation, since any existing Web API applications will be referencing these service URLs. To ensure your Web API applications will work with ArcGIS Server 10 services, you should manually back up your (.cfg) files and take note of their instance names and URLs before migrating to ArcGIS Server 10.

Once you migrate to using ArcGIS Server 10 services, you can update your Web API applications to take advantage of new functionality available at ArcGIS Server 10, such as editing, service area, closest facility, time-aware layers, geometry service unions, and generalization.

For more information about updating your ArcGIS Web API applications to work with the 2.0 release, visit the links below:

Migrating to version 2.0 of the ArcGIS API for JavaScript

Migrating to version 2.0 of the ArcGIS API for Flex

What's new in version 2.0 of the ArcGIS API for Silverlight/WPF

Migrating Web applications built with ArcGIS Server Manager

At ArcGIS Server 10, some technology and performance enhancements have been made to ArcGIS Server Manager. As a result of these enhancements, you will need to migrate your Web applications built with Manager in ArcGIS Server 9.3 (or 9.3.1) to ArcGIS Server 10.

The steps below will guide you through migrating your Web applications in ArcGIS Server Manger. Initially, you'll be prompted to confirm a basic migration of your Web application to 10, which will allow your Web application to work in 10. In the next step, you'll be prompted to confirm upgrading to 10, which will enhance your Web application to take advantage of new features in 10, such as zooming to an X,Y location and zooming to a specified scale. For full details on the new features available in Web applications built with Manager, see What's new in ArcGIS Server 10.

CautionCaution:

The look and feel of your Web applications built with Manager in ArcGIS Server 9.3 (or 9.3.1) will change after migrating to ArcGIS Server 10. Before proceeding, you should manually back up your Web applications.

CautionCaution:

If your Web applications were customized outside of Manager, migrating to ArcGIS Server 10 may overwrite your customizations. Proceed to the "Migrating custom Web ADF applications" section in the ArcGIS Web ADF Developer Help topic How to migrate the Web ADF to 10 for more information.

Steps:

  1. Install ArcGIS Server 10
  2. Once installation is finished, open ArcGIS Server Manager and click the Applications module. You'll be prompted to migrate all of your Web applications.
  3. Click OK to migrate your Web applications. When finished, you can optionally view a migration report for all migrated Web applications. Click OK to exit the dialogue.
  4. Select one of your Web applications and click the Edit button. A dialogue box will display. Click Yes to upgrade the Web application. Repeat this step until all of your Web applications have been upgraded.

Migrating custom ArcGIS Server Web ADF applications

A Web Application Migration Utility has been included with the ArcGIS Server Web ADF to help you automatically migrate your custom applications built with the ArcGIS Server 9.3 (or 9.3.1) Web ADF. The utility updates all assembly references to 10, removes all references to ArcWeb Services and the Find Place task, and performs other back-end changes to help your application take advantage of the ArcGIS Server 10 Web ADF. The migration utility is available with the other ArcGIS Server shortcuts on the Windows Start menu.

For more information about migrating custom Web ADF applications or for instructions on how to manually update your Web application built with the ArcGIS Server Web ADF, please consult the topic How to migrate the Web ADF to 10 in the ArcGIS Web ADF Developer Help.

NoteNote:

The Applications Manager and Web ADF section of the What's new in ArcGIS Server 10 topic lists changes and improvements to the ArcGIS 10 Web ADF that may affect the behavior of your existing Web applications.

Common migration questions

In what order should I upgrade different ArcGIS components? If ArcGIS Desktop or ArcSDE are on the same machine as ArcGIS Server, does that affect the order?

If ArcGIS Desktop, ArcSDE, and ArcGIS Server are all installed on the same machine, everything must be migrated in one event.

If ArcGIS Desktop, ArcSDE, and ArcGIS Server are spread out among multiple machines, you can upgrade different ArcGIS components in stages. For example, you could follow the steps below:

  1. Upgrade a few ArcGIS Desktop clients. After confirming the upgrade process is sound, upgrade all ArcGIS Desktop clients.
  2. Upgrade ArcGIS Server
  3. Upgrade ArcSDE

Newer ArcGIS Desktop and ArcGIS Server clients can understand older ArcSDE versions, but an older ArcGIS Desktop or ArcGIS Server client cannot understand newer ArcSDE versions. For more information, please consult the product compatibility matrix for clients and servers of ArcSDE technology in ArcGIS Server.

Should I upgrade my operating system at the same time I upgrade ArcGIS Server?

If you are comfortable with your current operating system, such as Windows Server 2003 or 2008, and have no motivating factor to move to a newer version, there is no need to upgrade your operating system.

However, if you are unsure whether or not your current operating system is supported in ArcGIS Server 10, please review the ArcGIS Server 10 system requirements page for more information.

Is there anything additional I can do to ensure my ArcGIS Server upgrade will go smoothly?

If at all possible, prototype your ArcGIS Server upgrade by creating a mirrored image of your production machine. This will help you understand how to migrate your Web applications, services, SOAP/REST endpoints, and ArcSDE database before performing the upgrade in your production environment.

Can I publish map services in ArcGIS Server 9.3/9.3.1 with maps authored in ArcGIS Desktop 10?

You can publish ArcGIS 10 maps in ArcGIS Server 9.3 (or 9.3.1), but you have to save the maps back to the format of the version from which you want to publish. Map documents authored in ArcGIS 10 can be saved to the format of a previous version. For example, you could:

  1. Author a map document (.mxd) in ArcMap 10
  2. Save the map document to match the version of ArcGIS Server you are using, such as 9.3.1
  3. Publish the map document as a map service in ArcGIS Server 9.3.1

Map service definition (.msd) based services created in ArcGIS Desktop 10 do not support backwards compatibility with previous versions of ArcGIS. If you or your organization requires MSD-based services, consider upgrading to a version of ArcGIS Server that matches your installed version of ArcGIS Desktop.

For more information on how to save a map document to a previous version of ArcGIS, please consult the Saving a map topic in the ArcGIS Desktop help.

Can I create ArcGIS Server 10 services with resources authored in ArcGIS Desktop 9.3/9.3.1?

ArcGIS Server 10 is compatible with all map documents, geoprocessing models, and GIS resources authored in ArcGIS Desktop 9.3/9.3.1.

Can I administer ArcGIS Server 10 services from ArcGIS Desktop 9.3/9.3.1?

ArcGIS Desktop 9.3/9.3.1 cannot be used to administer ArcGIS Server 10 services. Alternatively, the ArcGIS Server 10 Manager application can be used to administer GIS services created in ArcGIS Desktop 9.3/9.3.1. If you or your organization require an administrative connection to administer GIS services, consider upgrading ArcGIS Desktop to match your installed version of ArcGIS Server.


11/18/2013