Skip to main content

cloudmigrate

This ArcGIS Data Store utility is used with the relational store.

If you deployed ArcGIS Enterprise in the Amazon Web Services (AWS) cloud with a relational store running locally with the ArcGIS Data Store installation, you can use this utility to migrate to a cloud relational store.

If you deployed ArcGIS Enterprise in the Amazon Web Services (AWS) or Microsoft Azure cloud with a relational store running locally with the ArcGIS Data Store installation, you can use this utility to migrate to a cloud relational store.

You must create the cloud database instance and update the configuration JSON file with the information specific to your instance before you migrate.

Important:

If you used ArcGIS Enterprise Cloud Builder for Microsoft Azure or ArcGIS Enterprise tools for Amazon Web Services to deploy ArcGIS Enterprise, migrating the relational store to a cloud store is an architectural change not supported by these tools at this time. Once migrated, you can no longer use these tools to manage or upgrade the deployment.

Syntax

cloudmigrate <ArcGIS Server host name> <ArcGIS Server administrator> <ArcGIS Server administrator password> [--store relational] [--cloudconfigFile <path to JSON configuration file>]

Option

Description

<ArcGIS Server host name>

This is the GIS Server site that is used as the ArcGIS Enterprise hosting server. Provide one of the following:

  • The fully qualified domain name of one of the machines in the hosting server site in the format gisserver.example.com

  • The URL of the hosting server site in the format https://gisserver.example.com:6443

    Note:

    Even if the GIS Server site uses a web adaptor or load balancer, you must provide the URL in the format shown above.

  • The IP address of one of the machines in the hosting server site

<ArcGIS Server administrator>

Provide the username for a built-in (not organization-specific) user who has administrator privileges in the hosting GIS Server site.

<ArcGIS Server administrator password>

Provide the password for the account used above.

--store

This option is not required; its value is always relational.

--cloudconfigFile

Specify the file containing information to connect to the existing cloud database-as-a-service instance to which you are migrating. Include the path to the file.

Template files are installed in <ArcGIS Data Store installation directory>/datastore /framework/template/sql/cloud/aws/.

Template files are installed in the ArcGIS Data Store installation directory in the following locations: \datastore\framework\template\sql\cloud\{aws|azure}\.

Example

In this example, the relational store is migrated to an instance of Amazon Aurora (PostgreSQL-compatible edition) that you create before running the migration. The name of one of the machines in the GIS Server site that will use the data store is gisserver.example.com:6443, the site administrator username and password are admin and Iph33l$ik, respectively.

./cloudmigrate.sh gisserver.example.com admin Iph33l$ik --store relational --cloudconfigFile /usr/myfiles/aws_aurora.json

In this example, the relational store is migrated to an instance of Amazon Aurora (PostgreSQL-compatible edition) that you create before running the migration. The name of one of the machines in the GIS Server site that will use the data store is gisserver.example.com:6443, the site administrator username and password are admin and Iph33l$ik, respectively.

./cloudmigrate.sh gisserver.example.com admin Iph33l$ik --store relational --cloudconfigFile /usr/myfiles/aws_aurora.json