Skip To Content

ArcGIS Enterprise Cloud Builder for Amazon Web Services

An ArcGIS Enterprise deployment optimized for your needs may require several machines or a machine with a large amount of memory or disk space. Deploying ArcGIS Enterprise on Amazon Web Services (AWS) provides flexibility and scalability, allowing you to use the machines you require. To simplify the creation of ArcGIS Enterprise deployments on AWS, use ArcGIS Enterprise Cloud Builder for Amazon Web Services.

ArcGIS Enterprise Cloud Builder for Amazon Web Services includes a graphical user interface application and the ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services utility, which allows you to automate cloud deployments of ArcGIS Enterprise. To use either of these applications, confirm you meet the prerequisites, and download the ArcGIS Enterprise Cloud Builder for Amazon Web Services file from My Esri.

Both the app and command line interface use Esri AWS CloudFormation templates to deploy software stacks.

Note:

When you use ArcGIS Enterprise Cloud Builder for Amazon Web Services to create an ArcGIS Enterprise deployment, Cloud Builder creates a separate Amazon Elastic Compute Cloud (EC2) instance to use as a file server for the hosting server directories and one for each federated server machine.

If you want to use the same EC2 file server for the directories of the hosting server and the federated server machines, use the AWS CloudFormation template provided by Esri to create a shared file server. Then use CloudFormation templates provided by Esri to create the ArcGIS Enterprise deployment, and provide the shared file server EC2 instance information.

ArcGIS Enterprise Cloud Builder for Amazon Web Services app

Use the ArcGIS Enterprise Cloud Builder for Amazon Web Services app if you want an interactive experience for provisioning resources and deploying ArcGIS Enterprise on AWS. Decide what ArcGIS components you need before deploying, as the ArcGIS Enterprise Cloud Builder for Amazon Web Services app does not currently include functionality to add components to an existing deployment.

After you install Cloud Builder, you can open the app from the Start menu on your computer.

Set preferences (optional)

You can set a default AWS region for your deployment and a default size for the root drives of the Amazon EC2 instances in the deployment. As you move through the app, the region and drive size options will be prepopulated with the preference values you set.

To set these preferences, open the app, sign in to your AWS account, and click the Preferences link at the bottom of the Deployments page of the app.

Manage deployments

Deployments you create using ArcGIS Enterprise Cloud Builder for Amazon Web Services appear in a list of existing deployments when you open the app. From this list, you can do the following:

Deployments you create using other methods do not appear in this list.

ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services

The ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services utility is an intuitive tool for automating cloud deployments of ArcGIS Enterprise.

To create an ArcGIS Enterprise deployment on Amazon Web Services (AWS) using ArcGIS Enterprise Cloud Builder CLI for AWS, you use two JSON files, your Microsoft Windows computer's command prompt, and the AWS Management Console in your browser. The two JSON files—one to prepare for installation and another to deploy—can be modified from the sample files available in the Configuration folder in the Cloud Builder installation location. Always keep the configuration file in the Cloud Builder installation location.

Use a text editor, such as Notepad++, to edit the JSON files. Once you alter the JSON files, open a Command Prompt console, change directories to the folder where you extracted Cloud Builder, and run the Cloudbuilder.exe command. Specify the correct JSON file and the required command to prepare (PREP) or create (CREATE) a deployment.

  • Cloudbuilder.exe PREP -j <prepfilename.json>
  • Cloudbuilder.exe CREATE -j <createfilename.json>

The other commands do not require JSON files. They are as follows:

  • Cloudbuilder.exe LIST --aws-access-key <access key> --aws-secret-access-key <secret access key> or Cloudbuilder.exe LIST --aws-profile-name <aws profile name>
  • Cloudbuilder.exe STOP -d <deployment name> --aws-access-key <access key> --aws-secret-access-key <secret access key> or Cloudbuilder.exe STOP -d <deployment name> --aws-profile-name <aws profile name>
  • Cloudbuilder.exe START -d <deployment name> --aws-access-key <access key> --aws-secret-access-key <secret access key> or Cloudbuilder.exe START -d <deployment name> --aws-profile-name <aws profile name>
  • Cloudbuilder.exe DELETE -d <deployment name> --aws-access-key <access key> --aws-secret-access-key <secret access key> or Cloudbuilder.exe DELETE -d <deployment name> --aws-profile-name <aws profile name>
  • Cloudbuilder.exe {-v | --version}
  • Cloudbuilder.exe {-h | --help}

The PREP command automates several tasks that you are required to complete before creating a deployment. It creates a network stack and Amazon Simple Storage Service (S3) bucket for your deployment, uploads all necessary authorization files and the SSL certificate to the bucket, and imports your SSL certificate to AWS Certificate Manager. The PREP command is only necessary the first time you create a specific ArcGIS Enterprise deployment, if you have not already done these steps manually.

The CREATE command creates an ArcGIS Enterprise deployment and can create and federate one additional machine for each ArcGIS Server licensing role you specify. Once you have run the command to create your initial deployment, you can run it later with an updated file to add more sites to the deployment. A file server instance is created for the portal, and one file server instance is created for each ArcGIS Server site in the deployment.

The LIST command returns a list of all deployments in your account that you created using the ArcGIS Enterprise Cloud Builder for AWS app or command line interface. The list contains five columns: Deployment Name, AWS Region, ArcGIS Version, Deployment Status, and Deployment State.

The STOP command stops all Amazon EC2 instances associated with the deployment you specify. You can only use this command to stop deployments created using the ArcGIS Enterprise Cloud Builder for AWS app or command line interface.

The START command starts all Amazon EC2 instances associated with the deployment you specify. You can only use this command to start deployments created using the ArcGIS Enterprise Cloud Builder for AWS app or command line interface.

The DELETE command deletes your deployment and associated AWS resources. It can only delete a deployment created using the ArcGIS Enterprise Cloud Builder CLI for AWS or ArcGIS Enterprise Cloud Builder for AWS app.

The version or -v option returns the current version of ArcGIS Enterprise Cloud Builder CLI for AWS.

The help or -h option displays syntax and examples for ArcGIS Enterprise Cloud Builder CLI for AWS commands.

To get started using ArcGIS Enterprise Cloud Builder CLI for AWS to create a deployment, see Prepare deployment resources using the ArcGIS Enterprise Cloud Builder CLI for AWS PREP command.