The templates listed on this page use CloudFormation to create an ArcGIS Enterprise 10.6.1 deployment or ArcGIS Server 10.6.1 roles on Amazon Web Services (AWS).
10.6 | 10.5.1 | 10.5 | 10.4.1 | 10.4 | 10.3.1 |
---|
The CloudFormation templates below create either one base Enterprise deployment or one ArcGIS Server role deployment. An optimized ArcGIS Enterprise deployment often requires several ArcGIS Server and ArcGIS Data Store machines, the ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services an intuitive tool for automating cloud deployments of ArcGIS Enterprise to create these deployments.
ArcGIS Enterprise needs to run in a VPC environment. Most Amazon Web Services accounts have a default AWS VPC created. Use this default VPC, create another VPC manually, or use the template described in this section to create a VPC.
ArcGIS Server requires the hostname to be valid. On the machine where ArcGIS Server is running, you need to make sure you can ping the hostname. To check that, run the following:
>hostname
This returns the hostname.
>ping "<the output of the hostname above>"
If the hostname is accessible, this command returns the valid ip address.
When you manually create a VPC, the following properties need to be ensure your hostname is accessible:
domain-name=ec2.internal; domain-name-servers=AmazonProvided
You can also use this template to create a VPC environment for your ArcGIS Enterprise deployment.
Template Name | Description | View | Launch |
---|---|---|---|
Create an Amazon VPC | Create an Amazon VPC with two subnets that ArcGIS Enterprise can be deployed in. ReadMe | View | Launch Stack |
A base ArcGIS Enterprise deployment includes Portal for ArcGIS, a GIS Server to be used as the portal's hosting server, and a relational and a tile cache data store created through ArcGIS Data Store and registered with the portal's hosting server.
These templates create a base ArcGIS Enterprise deployment You also have the option to include a spatiotemporal big data store with your base deployment when you use the following templates.
Template Name | Description | Platform | View | Launch |
---|---|---|---|---|
Single-machine deployment | Create a base ArcGIS Enterprise deployment on a single machine. This is the minimal all-in-one configuration, where all the components are installed on a single instance. ReadMe | Windows 2016 | View | Launch Stack |
Ubuntu LTS 16.04 | View | Launch Stack | ||
Highly available deployment | Create a highly available deployment with two machines. Both machines contain all ArcGIS Enterprise components. The second machine acts as a standby ArcGIS Enterprise machine, which minimizes downtime in scenarios when one machine is unavailable. ReadMe | Windows 2016 | View | Launch Stack |
Ubuntu LTS 16.04 | View | Launch Stack | ||
ELB for highly available base ArcGIS Enterprise deployment. The highly available base ArcGIS Enterprise CloudFormation template allows you to use an existing ELB. This option makes it easier to keep your existing domain_name mapping. The existing ELB has certain requirements, for example, the VPC, SSL cert, etc. It is recommended to create the ELB using this template. |
View | Launch Stack | ||
Disaster recovery deployment in a different region | Build an identical ArcGIS Enterprise deployment in a different region and periodically synchronize content from the active deployment to a deployment in a different region. If the active deployment goes offline, you can switch your clients to use the second deployment. ReadMe | Windows&Ubuntu |
In addition to the base ArcGIS Enterprise deployment, you can add functionality and capacity with additional ArcGIS Server sites.
Template Name | Description | Platform | View | Launch |
---|---|---|---|---|
ArcGIS GIS Server | This template creates a general purpose GIS Server site, GeoAnalytics Server site, or Image Server Sites that you can set as Raster analytics Server or Image Hosting Server for the portal in your base ArcGIS Enterprise deployment. You just need to use different Server license files to deploy different ArcGIS Server roles. ReadMe | Windows 2016 | View | Launch Stack |
Ubuntu 16.04 LTS | View | Launch Stack | ||
ELB for ArcGIS GIS Server deployment. The ArcGIS GIS Server CloudFormation template allows you to use an existing ELB. This option makes it easier to keep your existing domain_name mapping. The existing ELB has certain requirements, for example, the VPC, SSL cert, etc. It is recommended to create the ELB using this template. |
View | Launch Stack | ||
ArcGIS GeoEvent Server | This template creates a single-machine ArcGIS GeoEvent Server site that can be scaled up to a multi-machine deployment that you can federate with the portal in a base ArcGIS Enterprise deployment. To archive stream service data, you must have a spatiotemporal big data store, which must run on separate instances from the other components. ReadMe | Windows 2016 | View | Launch Stack |
Ubuntu LTS 16.04 | View | Launch Stack | ||
ELB for ArcGIS GeoEvent Server deployment. The ArcGIS GIS Server CloudFormation template allows you to use an existing ELB. This option makes it easier to keep your existing domain_name mapping. The existing ELB has certain requirements, for example, the VPC, SSL cert, etc. It is recommended to create the ELB using this template. |
View | Launch Stack | ||
Stand-alone ArcGIS Server sites | Create an autoscaling group of stand-alone ArcGIS Server sites behind an Elastic Load Balancer. You can create a GIS Server site, Image Server site, or GeoEvent Server site. ReadMe | Windows&Ubuntu | View | Launch Stack |
The CloudFormation stacks for highly available base enterprise deployments, ArcGIS GIS Server deployments, and ArcGIS GeoEvent Server deployments will create Lambda functions to help stop and start all the EC2 instances in your deployment stack. It's recommended to use these Lamdba functions to stop and start all the EC2 instances and to scale auto-scaling groups up or down rather than perform those tasks manually.
These Lambda functions have the name starting with "<CloudFormation Stack Name>-StartStackFunction" or "<CloudFormation Stack Name>-StopStackFunction". You can invoke the function using the sample event data provided in the AWS Management Console following these steps:
You can create a ClouldFormation stack using AWS Command Line Interface, AWS Tools for Windows PowerShell, and AWS SDKs for different languages. See Tools for Amazon Web Services for more information. Sample Python and PowerShell scripts are provided to create ArcGIS Enterprise and ArcGIS Server CloudFormation stacks.
C:\Python27\
folder or <ArcGIS Server Installation Directory>/arcgis/server/tools
folder on
Linux.
cf_parameters_win_allinone_webgisstack.json
,
defines the parameters required to deploy all base ArcGIS Enterprise components on one Windows instance on AWS. Modify the parameters accordingly. Run the file by typing:
>>
python cloudformation_stack_creation.py <Your AWS Access key> <Your AWS Secret Access Key> cf_parameters_win_allinone_webgisstack.json
step 0: make a backup of the existing system.Use the webgisdr utility. This tool helps make a backup of all the components of your deployment – Portal for ArcGIS, any federated ArcGIS Server sites, and ArcGIS Data Store – into one single backup file.
chef-solo -j c:\chef\node.json
sudo cfn-init -v -c secondpass -s <StackName> -r AllInOneEC2Instance --region <AWS::Region>
sudo chef-solo -j /tmp/node.json
chef-solo -j c:\chef\node.json
chef-solo -j c:\chef\node.json
sudo cfn-init -v -c secondpass -s <StackName> -r SecondaryServerEC2Instance --region <AWS::Region>
sudo chef-solo -j /tmp/node.json
sudo cfn-init -v -c secondpass -s <StackName> -r PrimaryServerEC2Instance --region <AWS::Region>
sudo chef-solo -j /tmp/node.json
If you have Spatial Temporal DataStore deployed with your base ArcGIS Enterprise Deployment, upgrade the spatial temporal datastore after you upgrade the base ArcGIS Enterprise deployment.
chef-solo -j c:\chef\node.json
chef-solo -j c:\chef\node.json
Template Name | Description | Platform | View | Launch |
---|---|---|---|---|
Upgrade Spatial Temporal DataStore AutoScaling Group | Upgrade the Spatial Temporal DataStore AutoScaling Group created by ArcGIS base Enterprise deployment CloudFormation stack at 10.6 to 10.6.1. | Windows 2016 | View | Launch Stack |
sudo cfn-init -v -c secondpass -s <StackName> -r LaunchConfig --region <AWS::Region>
sudo chef-solo -j /tmp/node.json
Template Name | Description | Platform | View | Launch |
---|---|---|---|---|
Upgrade Spatial Temporal DataStore AutoScaling Group | Upgrade the Spatial Temporal DataStore AutoScaling Group created by ArcGIS base Enterprise deployment CloudFormation stack at 10.6 to 10.6.1. | Ubuntu LTS 16.04 | View | Launch Stack |
chef-solo -j c:\chef\node.json
Template Name | Description | Platform | View | Launch |
---|---|---|---|---|
Upgrade ArcGIS GIS Server AutoScaling Group | Upgrade the AutoScaling Group created by ArcGIS GIS Server deployment CloudFormation stack at 10.6 to 10.6.1. | Windows 2016 | View | Launch Stack |
sudo cfn-init -v -c secondpass -s <StackName> -r PrimaryServerEC2Instance --region <AWS::Region>
sudo chef-solo -j /tmp/node.json
Template Name | Description | Platform | View | Launch |
---|---|---|---|---|
Upgrade ArcGIS GIS Server AutoScaling Group | Upgrade the AutoScaling Group created by ArcGIS GIS Server deployment CloudFormation stack at 10.6 to 10.6.1. | Ubuntu LTS 16.04 | View | Launch Stack |
To upgrade from 10.5.1 and before to 10.6.1, it is recommended to move all the instances in auto-scaling group out and then run manual upgrade steps just like on-premises following upgrade document.
See Troubleshoot AWS CloudFormation stack creation in the ArcGIS Enterprise on Amazon Web Services help for information on how to identify and correct issues you may encounter when launching a CloudFormation stack using the Esri sample templates.