Migration checklist

This checklist contains the steps that you need to perform when migrating an existing ArcGIS Server system to version 10.1. Before you upgrade to 10.1, you must first uninstall all ArcGIS products. Because simply installing 10.1 will not recognize your existing service configurations, you are strongly encouraged to prototype the migration on a development or test environment before uninstalling your existing server. The steps in this checklist help you to take inventory of your existing server so you can re-create its services and settings on your 10.1 server.

This checklist contains the core migration steps that everyone needs to perform. You may find that other migration adjustments need to be made to support your specific set of services or web applications. In most cases these other adjustments should be minor.

Check the operating system prerequisites

Determine if the operating system (OS) hosting your current installation of ArcGIS Server is 32 bit or 64 bit. Version 10.1 requires a 64-bit OS, and the installation will exit if the OS does not meet this requirement.

If your current OS is 32 bit, check if the hardware is compatible to support hosting a 64-bit OS. If it is not capable of hosting a 64-bit OS, do not proceed with uninstalling ArcGIS Server. You will need to acquire new hardware to support version 10.1.

Determine the ArcGIS products and versions currently installed

Open Windows Control Panel to the Programs and Features window. Note the ArcGIS products and versions currently installed.

Make backup copies of important configuration files

Before uninstalling your current ArcGIS Server, make copies of the following files and place them in a stable, secure location. Although you won't be able to directly use these files to restore your services, they preserve a reference of the settings you had. These backups are also useful if the migration is interrupted or postponed.

Create a list of client applications that use your server

Think about the various client applications that your staff and customers use to connect to the web services you host on ArcGIS Server. These can include, but are not limited to:

Depending on the types of connections they use and the server URL that you configure when you migrate, you may need to do some updating in these applications (described throughout the remainder of this topic). At the very least, you will probably want to inform the owners of these applications that you are migrating to 10.1.

Determine if you have any client applications that connect to ArcGIS Server using DCOM (ArcGIS Server Local) connections

ArcGIS Server versions prior to 10.1 supported both DCOM (ArcGIS Server Local) and HTTP (ArcGIS Server Internet) connections. Version 10.1 no longer supports DCOM connections, and existing applications that use the ArcGIS Server Local connection type will not be able to use services you publish with 10.1. You need to refactor these applications to use HTTP connections before upgrading to 10.1. If you used DCOM connections for the purpose of accessing ArcObjects, you need to remove your ArcObjects code or wrap it in a server object extension.

Determine the URL format used by your existing applications when connecting to ArcGIS Server

You need to determine the URL format used by your existing applications when connecting to ArcGIS Server. This will help you understand whether your apps need to be modified after the upgrade. Using the ArcGIS Web Adaptor, you can engineer your 10.1 site to match the URLs you used at previous versions, thereby saving yourself the effort of updating all your app code.

Applications that make HTTP connections to your server through REST or SOAP generally follow the syntax:

or

If ArcGIS Server is configured to use the default port of your web server (such as port 80), your URLs will likely not include the :<port>.

Take note of whether your services are being accessed through the default instance name of ‘arcgis’ or some other instance name.

Also determine if you have multiple instances installed on your system. To do this, navigate to <ArcGIS Server installation location>\DotNet and launch the AddInstance.exe tool. Select Modify an existing instance and click Next. The dialog box will list the instance names and the IIS Web Site (Port) locations on which they are hosted.

When you install 10.1, your site will use port 6080 and will have the site name arcgis in the URL. You can expose your site to external users through a different port and site name by installing the Web Adaptor. If you do not use the Web Adaptor, you will need to update your apps to use the new 10.1 server URL.

Make an inventory of your existing services

Create an inventory of all your existing services and the folder structure containing them. For example:

Note the properties of your services

Carefully record the properties of each service so that you can re-create the services after you upgrade to 10.1. You should note the following things in the Service Properties dialog box in ArcCatalog or the corresponding dialog boxes in Manager:

Make an inventory of your KML network links

Determine if your server is hosting any KML network links by logging in to Manager and clicking Services > KML Network Links. If you see KMZ files listed, note them. Also, navigate to the KML folder of your ArcGIS Server instance (for example C:\inetpub\wwwroot\ArcGIS\kml) and make backup copies of all the KMZ files therein.

Note the details of your security configuration

ArcGIS Server for the Microsoft .NET Framework

Determine if security is enabled for your server by opening Manager and navigating to Security > Settings.

Migrate users and roles

If security for GIS services is enabled, note the location of the security store (the location is visible on the same page) and follow the instructions for the specific store type below to migrate your users and roles:

  • SQL Server: To use the 10.0 SQL Server store in 10.1; see Using a 10.0 .NET SQL Server security store in 10.1.
  • Windows local users and groups: If you are using local windows groups to assign permissions to a web service or folder, use the Security > Users and Security > Roles pages to make an inventory of users and roles. You will use this inventory to re-create users and roles in 10.1.
  • Windows domain users and groups: If you are using windows domain groups to assign permissions to a web service or folder, you can continue to use the same domain in 10.1. To do this you must install ArcGIS 10.1 for Server on a machine that is part of the same domain.

Note permissions for folders and services

If security for GIS services is enabled, use Manager to determine which roles are allowed to access each folder and service. To do this, click Services > Manage Services > Manage Folders and click the Permissions link. Record the list of allowed roles so that you can apply these permissions on your 10.1 server. Repeat this process with each service by clicking the Permissions (lock) icon next to the service.

ArcGIS Server for the Java Platform

Determine if security is enabled for your server by opening Manager and navigating to Security > Settings.

Migrate users and roles

If security for GIS services is enabled, click the Security Store tab to determine the type of security store being used and follow the instructions for the specific store type below to migrate your users and roles:

  • Internal Data Store or External Database Store: If the Security store used is the Internal Data Store or External Database, use the Security > Users and Security > Roles pages to make an inventory of users and roles. You will use this inventory to re-create users and roles in 10.1.
  • LDAP Store: If the Security store used is an LDAP server, note down the LDAP connection properties. You will use these properties to use the same LDAP server as the 10.1 security store.
  • Active Directory: If the Security store is Active Directory, determine the domain that hosts the Active Directory. When installing ArcGIS 10.1 for Server, you will need to install on a machine that is part of the same domain. This will enable the server to use the Active Directory server for that domain as the security store.

Note permissions for folders and services

Determine which roles are allowed to access each folder and service. To do this, click Services > Manage Services and click the Permissions (lock) icon next to the folder name. Record the list of allowed roles so that you can apply these permissions on your 10.1 server. Repeat this process for each service within the root folder by clicking the Permissions (lock) icon next to the service. Repeat this process for each subfolder within the root folder.

Unregister server object extension libraries

Before you uninstall ArcGIS Server, unregister any server object extension libraries that you have deployed on your server object container (SOC) machines. You don't have to unregister the extension with ArcGIS Server; you should just unregister the library (for example, the DLL in the case of a .NET extension).

Server object extensions do not automatically migrate from 10.0 to 10.1. They need to be rebuilt and redeployed after you have installed 10.1.

Verify 10.1 authorization and licensing information

Before uninstalling ArcGIS Server, verify that you have the necessary authorization codes or provisioning files to authorize the server once you upgrade to 10.1.

Uninstall ArcGIS Server and other ArcGIS products

Uninstall all pre-10.1 ArcGIS products from your server. If you had the SOM and SOC components distributed among multiple machines, uninstall those components from all machines.

Once you uninstall, make a backup of any files left behind in the installation location (\ArcGIS\Server10.0) and the instance root location (probably C:\inetpub\wwwroot\ArcGIS).

Install ArcGIS 10.1 for Server and create a site

Install ArcGIS 10.1 for Server and create a site. You can install the server on multiple machines and join them together into the same site if desired. See the installation guide and also Creating a new site.

You will also need to install ArcGIS 10.1 for Desktop on at least one machine on your network. ArcMap and ArcCatalog will recognize any previous GIS server connections that you had in the Catalog tree. You should delete the connection to your old server and establish a new connection to your 10.1 server. See About connecting to ArcGIS Server in ArcGIS for Desktop.

Register your data with the server

A new aspect of server management at 10.1 is the concept of the data store. The data store is a list of locations known by the server to contain data and have the necessary permissions applied. You should grant the ArcGIS Server account permissions to the data used by your former services. Then register the databases and data folders with ArcGIS Server using the steps in Registering your data with ArcGIS Server using ArcGIS for Desktop.

To duplicate the workflow you had in previous releases, you will most likely register your folders and databases such that the publisher and server use the same path or connection information. In other words, the publisher and the server are accessing the data out of a common folder, visible to both. However, more sophisticated workflows are available at 10.1 allowing for automatic correction of paths as files are transferred between the publisher's machine and the server at publish time.

Finally, you should also register your existing server cache directories with ArcGIS Server, or move your caches into the server cache directory that was created at the same time the site was created.

Publish services and configure properties

Now you can begin publishing your services and configuring them with the same properties they had before you uninstalled. The 10.1 publishing experience takes place in ArcGIS for Desktop. Follow the instructions in How to publish a service to familiarize yourself with the 10.1 publishing workflow. If you are publishing map services, you must open the source .mxd file in ArcMap; you cannot directly publish .msd files at 10.1.

As you work through the publishing process, you can use the Service Editor dialog box to set the properties that you recorded from your former services. Most of the properties work the same way. Notable exceptions are the minimum and maximum number of instances properties, which at 10.1 refer to the minimum and maximum number of instances per GIS server machine; not per the site as a whole.

Map and globe caches created in previous versions should work with 10.1 provided the tiles reside in a registered service cache directory and the GIS server folder and service names match the name of the directory containing the tiles. The directory should be named in the format <folder name>_<service name>, meaning if you have a folder California with service Fresno, the folder containing the tiles should be named California_Fresno.

You will see some services already running with 10.1 for publishing (PublishingTools) and caching (CachingTools). If you plan to do a lot of caching and you want to dedicate more server power toward caching jobs, you should increase the maximum number of instances of the CachingTools service that are allowed to run. In previous releases you added more instances of the map or globe service being cached, but at 10.1 you add more instances of CachingTools.

Rebuild and redeploy server object extensions

If you were using server object extensions with your previous deployment, now is the time to rebuild them and deploy them to ArcGIS Server. A rebuild is required to create the .SOE file used in 10.1. Deployment in 10.1 is a much simpler process than in previous releases and is typically performed using Manager. See Migrating a .NET server object extension to 10.1 and Migrating a Java server object extension to 10.1.

Once you've redeployed your server object extensions, you need to enable them on any services that use them and set the extension properties, if any.

Install the Web Adaptor

The Web Adaptor helps you integrate your ArcGIS Server site with your existing enterprise web server. Install the Web Adaptor if you want to modify the port and URL used to access your server. In most cases you can get the URL to be the same as it was in previous releases, saving you the trouble of updating your web apps. There are various other benefits to the Web Adaptor that are listed in About the ArcGIS Web Adaptor.

If your ArcGIS Server instance used the default name of arcgis and you want to maintain this in 10.1 using the Web Adaptor, then you need to do some preparatory work before you run the Web Adaptor setup. Using your web server software, remove the virtual directory named arcgis. Then delete the folder on disk that was holding the files for the ArcGIS Server instance, for example C:\Inetpub\wwwroot\arcgis. (You may want to create a backup before you do this.) Finally, install the Web Adaptor and run the Web Adaptor configuration page.

If you do not install the Web Adaptor, you need to update the URLs used in your client applications to point at your 10.1 server URL. For REST services, this URL is http://<server>:6080/arcgis/rest/services.

Define your security store

At this point you can begin reconstructing the security settings on your services. You can either connect ArcGIS Server to your previous user and role store, or you can re-create your user and role store using the built-in store that comes with 10.1. Once you have defined your user and role store, you can reassign the permissions that you recorded for each folder and service.

Republish KML network links

If you noted any KML network links available on your former server, you can republish those with 10.1. See Uploading an existing KML network link to ArcGIS Server.

Migrate and test your web applications

You can now test all of your web applications and update the URLs used by them if necessary.

12/18/2014