Esri
Provision a base ArcGIS Enterprise deployment on one EC2 instance
This template provisions an ArcGIS Enterprise deployment that includes Portal for ArcGIS, a GIS Server site (set as the portal's hosting server), ArcGIS Data Store (which will create a relational and tile cache data store), and ArcGIS Web Adaptor on one EC2 instance. You can optionally direct the template to create a spatiotemporal big data store on additional EC2 instances. The template creates an architecture as shown in the graphic below.
To deploy this template, follow these steps:
- Create an S3 bucket in your AWS account. This bucket is called DeploymentBucket in the template parameters.
- Upload your Portal for ArcGIS license file and ArcGIS GIS Server license file to the DeploymentBucket.
- Obtain the domain for your ArcGIS Enterprise deployment and an SSL certificate file issued to your domain name.
- Upload the SSL certificate file to the DeploymentBucket.
- Allocate an Elastic IP address for VPC in the AWS region where you want to create your stack.
- Map the domain name to the Elastic IP address in DNS.
- Launch stack from the template.
Click Launch Stack for this template. Several parameters can be set when launching the stack using the template, such as the following:- BDSInstances: AWS instance for the spatiotemporal big data store. Pick 0 or 1 to create AWS instance for spatiotemporal big data store or not. The CloudFormation stack will create an Auto Scaling group for these instances. You can modify the number of instances in this Auto Scaling group in the AWS Management Console after the stack is created. For example:
- Pick 0 if you do not want spatiotemporal big data store when creating base ArcGIS Enterprise stack.
- If you subsequently want a spatiotemporal big data store, go to the AWS Management console, find the Auto Scaling group that has your CloudFormation stack name and change the Desired, Min, Max, parameter values to 1.
- Pick 1 if you want spatiotemporal big data store.
- If you want more than 1 instance, always make sure or change the Desired, Min and Max number to 1 first. Wait until the spatiotemporal big data store is registered to your base ArcGIS Enterprise deployment's hosting Server successfully. Then you can change the Desired, Min and Max number to the number you want, such as 3.
- BDSInstanceType: The EC2 instance type you want your spatiotemporal big data store to run on.
- DeploymentBucket: The S3 bucket you created. It has your Esri authorization files and SSL certificate file uploaded to it.
- DriveSizeRoot: The size of the root drive. It's the C: drive on Windows and the root drive on Ubuntu Linux.
- InstanceType: The EC2 instance type for the base ArcGIS Enterprise machine. This machine will be configured with the AWS Auto Recovery. If the instance crashes, AWS can restore it to the stage before it crashed in the same Availability Zone. Only certain instance types are allowed.
- KeyName: The KeyPair to allow you remote access to the instance.
- PortalLicenseFile: The authorization file for Portal for ArcGIS you obtained from Esri. It must be in the S3 deployment bucket.
- PostInstallationScript: ZIP archive file with custom post installation script. This zip file must be uploaded to DeploymentBucket. If there's a deploy.bat or deploy.sh at the root level inside this zip file, deploy.bat will be executed as administrator on Windows as the last step to configure the machine. On ubuntu, deploy.sh will be executed as superuser.
- RunAsUserPassword : This is the password for the account used to run the ArcGIS Server service. (Windows only)
- ServerLicenseFile: The authorization file for ArcGIS GIS Server you obtained from Esri. It must be in the S3 deployment bucket.
- SiteAdmin: The user name for the Portal for ArcGIS initial administrator account and ArcGIS Server primary site administrator.
- SiteAdminPassword: The password for the SiteAdmin.
- SiteDomain: The domain name for your ArcGIS Enterprise deployment. This domain must be mapped to the Elastic IP address you specified.
- SiteEIPAllocationID: The allocation ID of the Elastic IP address for this deployment. Allocation IDs are in the format: eipalloc-xxxxxxxxx. Your SiteDomain needs to be mapped to this IP address.
- SSLCertificateFile: The SSL Certificate issued to your SiteDomain, for example, WebGIS_esri_com.pfx. It must be in the S3 deployment bucket.
- SSLCertPassword: The password to your SSL certificate.
- StoreType:
- FileSystem: Portal for ArcGIS content store and ArcGIS Server config-store will be on the file system in the same machine.
- CloudStore: Portal for ArcGIS content store will be in an AWS S3 bucket created by the stack. ArcGIS Server config-store will be in AWS DynamoDB and a S3 bucket created by this stack.
- BDSInstances: AWS instance for the spatiotemporal big data store. Pick 0 or 1 to create AWS instance for spatiotemporal big data store or not. The CloudFormation stack will create an Auto Scaling group for these instances. You can modify the number of instances in this Auto Scaling group in the AWS Management Console after the stack is created. For example:
Troubleshooting
See Troubleshoot AWS CloudFormation stack creation in the ArcGIS Enterprise on Amazon Web Services help if you run into problems.
Steps to complete the deployment
The Portal for ArcGIS initial administrator needs to customize the portal for your organization's use. See the topics in the Portal for ArcGIS administrator guide for information on configuring the portal web site, adding members, securing the portal, and other administrative tasks.