ArcGIS Enterprise Cloud Builder CLI for AWS parameters
When you use ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services (AWS) to prepare and deploy ArcGIS Enterprise and ArcGIS Server sites, you provide information about the type of deployment you require by providing the location and name of the JSON file containing the settings you need.
Sample files
Several sample JSON files are included with the ArcGIS Enterprise Cloud Builder CLI for AWS file you download from My Esri. The JSON samples represent common deployments. There are separate files for preparatory steps—which you can use when you run the ArcGIS Enterprise Cloud Builder CLI for AWS utility with the PREP command—and files you can use to create the deployment when you run the ArcGIS Enterprise Cloud Builder CLI for AWS utility with the CREATE command.
The following two tables describe the sample files provided with the ArcGIS Enterprise Cloud Builder CLI for AWS utility:
|
Preparation sample file |
Description |
|---|---|
|
|
Creates an Amazon Virtual Private Cloud (VPC) in the AWS region you specify. |
|
|
Uploads ArcGIS Server licenses and a Portal for ArcGIS license file to an Amazon Simple Storage Service (S3) bucket managed by ArcGIS Enterprise Cloud Builder for Amazon Web Services. |
|
|
Uploads an SSL certificate to the Amazon S3 bucket managed by Cloud Builder and imports the SSL certificate to AWS Certificate Manager. |
|
|
Uploads ArcGIS Server licenses, a Portal for ArcGIS license, and an SSL certificate to the Amazon S3 bucket managed by Cloud Builder. It also imports the SSL certificate to AWS Certificate Manager. |
|
|
Creates a VPC and uploads ArcGIS Server licenses, a Portal for ArcGIS JSON file, and an SSL certificate to the Amazon S3 bucket managed by ArcGIS Enterprise Cloud Builder for AWS. It also imports the SSL certificate to AWS Certificate Manager. |
|
Creation sample file |
Description |
|---|---|
|
|
Deploys base ArcGIS Enterprise on a single machine. |
|
|
Deploys base ArcGIS Enterprise on a single machine plus a federated ArcGIS GeoEvent Server single-machine site. |
|
|
Deploys base ArcGIS Enterprise on a single machine, a federated ArcGIS Knowledge Server site configured as the portal's knowledge server, and an ArcGIS Data Store graph store registered with the hosting server. |
|
|
Deploys base ArcGIS Enterprise on two machines—a primary and a standby machine—and adds a spatiotemporal big data store. |
|
|
Deploys base ArcGIS Enterprise on a single machine plus a federated ArcGIS Image Server site configured as the portal's raster analysis server. |
|
|
Deploys base ArcGIS Enterprise on two machines plus a federated ArcGIS Image Server site configured as the portal's image hosting server. |
|
|
Deploys base ArcGIS Enterprise on two machines plus a federated ArcGIS Notebook Server. |
|
|
Deploys base ArcGIS Enterprise on a single machine plus a federated ArcGIS Mission Server site configured as the portal's mission server. |
|
|
Deploys base ArcGIS Enterprise on a single machine plus a federated ArcGIS Workflow Manager site configured as the portal's workflow manager server. |
|
|
Allows you to create a highly available base ArcGIS Enterprise deployment with all possible federated ArcGIS Server sites. |
|
|
Deploys a stand-alone ArcGIS GeoEvent Server site. |
|
|
Deploys a stand-alone ArcGIS GIS Server site. |
|
|
Deploys a stand-alone ArcGIS GIS Server site and registers a managed enterprise geodatabase in Amazon Relational Database Service (RDS) for SQL Server. |
|
|
Deploys a stand-alone ArcGIS GIS Server site and registers a managed enterprise geodatabase in Amazon RDS for PostgreSQL. |
You can copy and alter these files using a text editor or create your own JSON files. If you use the samples, replace sample settings with values specific to your deployment. You can also change which parameters are present in the sample files.
Parameters in the JSON file are grouped together under section (node) headings. These parameters and their groupings are described in the remainder of this page.
AWS credentials and region
ArcGIS Enterprise Cloud Builder CLI for AWS needs your AWS credential to connect to Amazon Web Services. Credentials can be the access key and secret key for your AWS account, or the AWS profile name for your account. These credentials are required whenever you run the ArcGIS Enterprise Cloud Builder CLI for AWS utility, and are grouped under the "AWSCredentials" section.
You also need to specify the AWS region in which to create the deployment. This region must be the same for all components of the deployment.
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The access key for your AWS account. |
Required if you do not specify the |
|
|
The secret key for your AWS account. |
Required if you do not specify the |
|
|
The profile name you configured for your AWS account. |
Required if you do not specify the |
|
|
The AWS region where all parts of your deployment will be created. |
Required. |
In this example, credentials for authorization are the access and secret keys for the AWS account. The Amazon Elastic Compute Cloud (EC2) instances will be launched in AWS region eu-west-2.
"AWSCredentials": {
"AWSAccessKey": "AKIAINKWSK6MI4YCPA123",
"AWSSecretKey": "ABCD1E2fghIJkLmNOPQzZuXHlWHOPhMqrTmPEpV",
"AWSRegion": "eu-west-2"
}
In this example, the credentials for authentication are the profile name configured for the AWS account. The EC2 instances will be launched in AWS region us-west-1.
"AWSCredentials": {
"AWSProfileName": "betavpc",
"AWSRegion": "us-west-1"
}
Parameters to use in files for deployment preparation
Before you create a deployment, you must create a VPC and S3 deployment bucket managed by ArcGIS Enterprise Cloud Builder for AWS and upload your SSL certificate and ArcGIS software licenses to the S3 bucket. Set parameters in a prep .json file to complete these steps.
Network stack
The "NetworkStack" section is an optional section of the prep file that allows you to create a VPC.
In this example, the utility will create a VPC in AWS zones eu-west-2b and eu-west-2a and assign it a name tag of MyEnterpriseVPC.
"NetworkStack": {
"StackName": "MyEnterpriseVPC",
"AZs": "eu-west-2b,eu-west-2a",
"CreateFlag": true
}
The following table describes each of the parameters you can use in the "NetworkStack" section:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
A unique name tag for your VPC to help you identify it. |
Optional; if not specified, a VPC is created with the name tag |
|
|
Specify two AWS availability zones for the VPC. The zones must be within the region you specified under the |
The |
|
|
Specifies whether to create a VPC ( |
The |
ArcGIS Enterprise files
The "ArcGISEnterpriseFiles" section contains information about the licensing and SSL files the utility needs to create your deployment.
ArcGIS Server license files can be .prvc or .ecp files. Portal for ArcGIS licenses are in .json files.
SSL files must be .pfx files.
The following is an example "ArcGISEnterpriseFiles" section with all possible parameters specified:
"ArcGISEnterpriseFiles": {
"PortalLicense": "C:\\Licenses\\portal.json",
"ServerLicense": "C:\\Licenses\\Server.prvc",
"NotebookServerLicense": "C:\\Licenses\\Notebook_Server.prvc",
"MissionServerLicense": "C:\\Licenses\\Mission_Server.prvc",
"ImageServerLicense": "C:\\Licenses\\Server_Image.prvc",
"RasterAnalyticsLicense": "C:\\Licenses\\Server_Image.prvc",
"ImageHostingLicense": "C:\\Licenses\\Server_Image.prvc",
"GeoEventLicense": "C:\\Licenses\\Server_GeoEvent.prvc",
"WorkflowManagerLicense": "C:\\Licenses\\Server_Workflow.prvc",
"KnowledgeServerLicense": "C:\\Licenses\\Server_Knowledge.prvc",
"SSLCertificateFile": "C:\\SSLCerts\\wildcard_webgistesting_net.pfx",
"SSLCertPassword": "abc123"
}
The following table contains descriptions of each parameter you can use in the "ArcGISEnterpriseFiles" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
Your Portal for ArcGIS license file ( Specify the physical path to the license file on local disk so the utility can upload it to the deployment S3 bucket managed by ArcGIS Enterprise Cloud Builder for AWS. |
Required if you deploy ArcGIS Enterprise. |
|
|
Your ArcGIS GIS Server license file. |
Required if you deploy ArcGIS Enterprise or a federated or stand-alone ArcGIS GIS Server site. |
|
|
Your ArcGIS Image Server license file. |
Required if you deploy a federated or stand-alone ArcGIS Image Server site. |
|
|
Your ArcGIS Notebook Server license file. |
Required if you deploy an ArcGIS Notebook Server site. |
|
|
Your ArcGIS Mission Server license file. |
Required if you deploy an ArcGIS Mission Server site. |
|
|
Your ArcGIS Image Server license file. |
Required if you deploy a federated ArcGIS Image Server. |
|
|
Your ArcGIS Image Server license file. |
Required if you deploy a federated ArcGIS Image Server. |
|
|
Your ArcGIS GeoEvent Server license file. |
Required if you deploy a federated or stand-alone ArcGIS GeoEvent Server. |
|
|
Your ArcGIS Knowledge Server license file. |
Required if you deploy a federated ArcGIS Knowledge Server. |
|
|
Your ArcGIS Workflow Manager license file. |
Required if you deploy an ArcGIS Workflow Manager site. |
|
|
The SSL certificate file issued to your site domain. Specify the physical path to the SSL certificate on local disk so the utility can upload it to the deployment S3 bucket managed by ArcGIS Enterprise Cloud Builder for AWS. |
Required to upload the SSL certificate. |
|
|
The password for the SSL certificate. |
Required to upload the SSL certificate. |
Parameters to use in files for deployment creation
To create a deployment, you must provide information about the software and hardware to include in the deployment. Parameters are grouped under the nodes described in the following sections.
Deployment details
At the top of the file, specify a name that will be used for each of the Amazon Elastic Compute Cloud instances (machines) in the deployment, the ArcGIS software version to deploy, and which operating system (either Microsoft Windows or Ubuntu Server) to use for the EC2 instances you deploy. All of these parameters are required except "AMIid".
"DeploymentDetails": {
"DeploymentName": "<name_to_append_to_machines_in_aws_deployment">,
"ArcGISVersion": "<11.1 | 11.3 | 11.4 | 11.5 | 12.0 | 12.1>",
"OperatingSystem": "<Windows | Ubuntu>",
"AMIid": "ami-xxxxxx"
}
The "DeploymentName" parameter must start with an alpha character, can contain only alphanumeric characters, and must be at least three characters in length.
The "OperatingSystem" parameter specifies the operating system to be used in ArcGIS deployments. For Windows it uses Microsoft Windows Server 2025 and for Ubuntu it uses Ubuntu Server 24.04 LTS.
The "AMIId" parameter is optional, but if you do specify it, it must be defined under the "DeploymentDetails" node. Specify the "AMIId" value in the following format: "ami-xxxxxx". If you don't know what AMI to use, don’t specify this parameter, and the ArcGIS Enterprise Cloud Builder CLI for AWS tool will use the latest AMI ID for Windows or Ubuntu based on the "OperatingSystem" parameter value.
Note:
You must specify a value for the "AMIId" parameter if you deploy in Amazon Web Services GovCloud with an Ubuntu operating system.
In this example, the names of all machines in the deployment will start with testservers. Because an AMI ID is not specified, the tool will use the latest Ubuntu AMI ID.
"DeploymentDetails": {
"DeploymentName": "testservers",
"ArcGISVersion": "12.1",
"OperatingSystem": "Ubuntu"
}
CloudFormation parameters
The parameters required by the Amazon Web Services CloudFormation templates are organized under the following nodes:
"Default"—Parameters set here apply to all parts of the deployment. Parameters set under default can be omitted from the other nodes."BaseEnterprise"—Parameters set in this section apply only to the base ArcGIS Enterprise deployment."NotebookServer"—Parameters set in this section apply only to a federated ArcGIS Notebook Server site."MissionServer"—Parameters set in this section apply only to a federated ArcGIS Mission Server site."RasterAnalytics"—Parameters set in this section apply only to federated or stand-alone ArcGIS Image Server sites."ImageHosting"—Parameters set in this section apply only to federated ArcGIS Image Server sites to be used as the portal's image hosting server."Server"—Parameters set in this section apply only to federated or stand-alone ArcGIS GIS Server sites."ImageServer"—Parameters set in this section apply only to federated or stand-alone ArcGIS Image Server sites."GeoEvent"—Parameters set in this section apply only to a federated or stand-alone ArcGIS GeoEvent Server site."WorkflowManager"—Parameters set in this section apply only to a federated ArcGIS Workflow Manager site."KnowledgeServer"—Parameters set in this section apply only to a federated ArcGIS Knowledge Server site."Spatiotemporal"—Parameters set in this section apply only to a spatiotemporal big data store component of an ArcGIS Enterprise deployment."Graph"—Parameters set in this section apply only to a graph store component of an ArcGIS Enterprise deployment."SQLEGDB"—Parameters set in this section apply only to an enterprise geodatabase in Amazon RDS for SQL Server."PostgresEGDB"—Parameters set in this section apply only to an enterprise geodatabase in Amazon RDS for PostgreSQL."AuroraEGDB"—Parameters set in this section apply only to an enterprise geodatabase in Amazon Aurora PostgreSQL.
Note:
You must include a node for every part of the deployment you want to create. For example, to create a base ArcGIS Enterprise deployment, a federated ArcGIS Image Server site, and a federated ArcGIS GIS Server site, you must have the "BaseEnterprise", "ImageServer", and "Server" nodes in your configuration file, and these nodes must contain at least one parameter. For example, even if you set the "Federate" and "ServerLicenseFileKeyName" parameters under the "Default" node, you must include at least one of these under the "Server" node; if you do not, the utility will not create a federated ArcGIS GIS Server site.
VPC settings must be defined under the "Default" node. You can use the "VPCId", "Subnet1", and "Subnet2" parameters to define a VPC, or, to reuse a VPC from an existing deployment created with this tool or an Esri CloudFormation template, you can specify the name of the deployment under the "NetworkStackName" parameter instead. The following are descriptions of these parameters:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
When you created the VPC, AWS assigned it an ID in the format vpc-xxxxxxxx. Provide the ID for the VPC here. If you use the ArcGIS Enterprise Cloud Builder CLI for AWS utility to prepare the deployment, this ID is listed in the output file created when you run the utility with the |
Required if you do not specify the |
|
|
The ID for one of the subnets in the VPC. If you use the ArcGIS Enterprise Cloud Builder CLI for AWS utility to prepare the deployment, this ID is listed in the output file created when you run the utility with the |
Required if you do not specify the |
|
|
The ID for the second subnet in the VPC. If you use the ArcGIS Enterprise Cloud Builder CLI for AWS utility to prepare the deployment, this ID is listed in the output file created when you run the utility with the |
Required if you do not specify the |
|
|
The name tag assigned to an existing VPC. |
Required if you do not specify the |
Other parameter values defined under the "Default" node are applicable to some or all of the other nodes in the JSON file. Esri recommends that you use the Default node to define parameters and values that are common across multiple nodes in the deployment. This shortens the configuration file and avoids repetition of parameters and values. For example, if you deploy a base ArcGIS Enterprise and federated ArcGIS GeoEvent Server, and use a wildcard SSL certificate, specify the "SSLCertificateFileKeyName" and "SSLCertificatePassword" parameters under the "Default" node because all the machines in the deployment will use the same certificate.
As shown in the following example, the "VPCId", "Subnet1", and "Subnet2" parameters are used to define the VPC. The root drive size ("InstanceDriveSize"), S3 bucket, administrator username and password, and the password for the software services ("arcgisUserPassword") apply to all parts of this deployment. Since all ArcGIS Server sites in the deployment will be federated with the portal, "Federate": true is also included under the "Default" node.
"CloudFormationParameters":{
"Default" :{
"VPCId": "vpc-b33fecd5",
"Subnet1": "subnet-7a709d1c",
"Subnet2": "subnet-26f0f76f",
"InstanceDriveSize": "300",
"KeyPairName": "StackTest_Mine",
"SiteadminUserName": "admin",
"SiteadminPassword": "changeit",
"arcgisUserPassword": "Change@1234",
"PostInstallationScript": "none",
"Federate": true
}
}
If you define parameter values in a specific deployment node, the value you specify in that node is used for that part of the deployment. For example, if you define the "InstanceType" parameter in both the "BaseEnterprise" and "Default" nodes, the "InstanceType" value defined in the "BaseEnterprise" node is used for the ArcGIS Enterprise base deployment machines, but the "InstanceType" value defined for the "Default" node is used for the ArcGIS GIS Server, ArcGIS Image Server, and ArcGIS GeoEvent Server sites you deploy using the same JSON file.
Parameters for base ArcGIS Enterprise
Parameter values you specify under the "BaseEnterprise" node apply only to ArcGIS Enterprise stacks created with the Esri CloudFormation templates that deploy ArcGIS Enterprise. You can use any of the following parameters for the base ArcGIS Enterprise portion of a deployment:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
Possible values are |
Required. This parameter must be specified under the |
|
|
The Amazon Elastic Compute Cloud key pair to allow remote access to the EC2 instances. |
Required if you did not specify this under the |
|
|
The allocation ID of the Elastic IP address of the VPC. |
Optional. Required if you deploy the base ArcGIS Enterprise on a single machine. (Set the You can specify this parameter under the |
|
|
Specify the domain name server (DNS) name of an existing Elastic Load Balancer (ELB). The ELB must be an application load balancer or classic load balancer. |
Conditional. Required only if you create a highly available ArcGIS Enterprise deployment (set the |
|
|
The Amazon Elastic Compute Cloud instance type to use for the ArcGIS Enterprise machine or machines. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The name of the Portal for ArcGIS authorization file object key. The |
Required if you did not specify this under the |
|
|
In the Portal for ArcGIS license file you receive from Esri, identifiers (IDs) are present for the types of users you are licensed to use in your organization. A subset of those are available for use for the initial administrator. The IDs present in the file can vary, but typical IDs include (but are not limited to) |
Optional, but if you do specify this parameter, specify it under the |
|
|
The name of the ArcGIS GIS Server license file for the hosting server. This file must be uploaded to the deployment S3 bucket managed by ArcGIS Enterprise Cloud Builder for AWS. |
Required if you did not specify this under the |
|
|
The username of the ArcGIS Server primary site administrator and Portal for ArcGIS initial administrator accounts. |
Required if you did not specify this under the |
|
|
The password for the site administrator account. |
Required if you did not specify this under the |
|
|
The password for the account used to run the ArcGIS Server, Portal for ArcGIS, and ArcGIS Data Store Windows services. The login name is always ArcGIS. |
Conditional. This parameter is required if you deploy on Windows machines (set the |
|
|
The type of storage location for the ArcGIS Server configuration store and Portal for ArcGIS content directory. To use an EC2 machine, set this parameter to |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud instance type to use for the file server. |
Optional. Applicable only if you create a highly available ArcGIS Enterprise deployment (set the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Optional. Applicable only if you create a highly available ArcGIS Enterprise deployment (set the |
|
|
The domain name for the deployment. Specify a fully qualified domain name for the Ensure the domain name ( |
Required if you did not specify this under the |
|
|
The web adaptor name for the portal. Access to the portal will be through a URL in the format |
Required, and you must specify this parameter under the |
|
|
The web adaptor name for the ArcGIS Server site. Access to the ArcGIS Server site will be through a URL in the format |
Required, and you must specify this parameter under the |
|
|
The SSL certificate file object key name. This must be a |
Required. This parameter must be specified under the |
|
|
The password for the SSL certificate. |
Required. This parameter must be specified under the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional, but if you do specify this parameter, it must be specified under the |
Parameters for ArcGIS Image Server, ArcGIS GIS Server, and ArcGIS Knowledge Server sites and the raster analysis and image hosting servers
Parameter values you specify under the "RasterAnalytics", "ImageHosting", "ImageServer", "Server", and "KnowledgeServer" nodes use the Esri CloudFormation templates that launch federated or stand-alone ArcGIS Server sites. Note that ArcGIS Knowledge Server sites must always be federated and that to use an ArcGIS Image Server site as a raster analysis server or as an image hosting server, the site must be federated.
ArcGIS Enterprise Cloud Builder CLI for AWS sets server roles when you federate the following types of sites:
ArcGIS Image Server—Configures as the raster analysis and image hosting servers
ArcGIS Knowledge Server—Configures as the Knowledge server.
The following table lists all the possible parameters you can set under the "RasterAnalytics", "ImageHosting", "ImageServer", "Server", and "KnowledgeServer" nodes:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon Elastic Compute Cloud key pair to allow remote access to the EC2 instances. |
Required if you did not specify this under the |
|
|
Specify the DNS name of an existing Elastic Load Balancer (ELB). The ELB must be an application load balancer or classic load balancer. |
Required, and you must specify this parameter under the specific server node— |
|
|
The Amazon Elastic Compute Cloud type to use for the ArcGIS GIS Server, ArcGIS Knowledge Server, or ArcGIS Image Server machines. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The number of EC2 instances in the site. The default number of instances is 2, the maximum is 10, and the minimum is 1. |
Required if you did not specify this under the |
|
|
The name of the ArcGIS GIS Server, ArcGIS Knowledge Server, or ArcGIS Image Server object key name. The |
Required if you did not specify this under the |
|
|
The username of the ArcGIS Server primary site administrator. |
Required if you did not specify this under the |
|
|
The password for the site administrator account. |
Required if you did not specify this under the |
|
|
The password for the account used to run the ArcGIS Server Windows service. The login name is always arcgis. |
Conditional. Applies if you deploy on Microsoft Windows instances (set the |
|
|
The type of storage location for the ArcGIS Server site configuration store. To use an EC2 machine, set this parameter to |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud instance type to use for the file server. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The domain name for the deployment. Specify a fully qualified domain name for the Ensure the domain name ( |
Required if you did not specify this under the |
|
|
The web adaptor name for the ArcGIS Server site. Access to the ArcGIS Server site will be through a URL in the format |
Required, and you must specify this parameter under the specific server node— |
|
|
The SSL certificate file object key name. This must be a |
Required, and you must specify this parameter under the specific server node— |
|
|
The password for the SSL certificate. |
Required, and you must specify this parameter under the specific server node— |
|
|
The bucket path in the format When used under the |
Required for the ArcGIS Image Server site you use as the portal's raster analysis or image hosting server. This parameter is optional if you create a stand-alone or federated ArcGIS Image Server or ArcGIS GIS Server site. Note:If the deployment includes |
|
|
Specifies whether the site will be federated with a base ArcGIS Enterprise deployment ( You must set If you don't specify this parameter in the deployment configuration file, the default value is |
Required. You must specify this parameter under the specific server node— |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you specify this parameter, you must specify it under the specific server node— |
Parameters for an ArcGIS GeoEvent Server site
Parameter values you specify under the "GeoEvent" node use the Esri ArcGIS GeoEvent Server CloudFormation template.
The following table lists all the possible parameters you can set under the "GeoEvent" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon Elastic Compute Cloud key pair to allow remote access to the EC2 instances. |
Required if you did not specify this under the |
|
|
The allocation ID of the Elastic IP address of the VPC. |
Required, and you must specify this parameter under the |
|
|
The Amazon Elastic Compute Cloud type to use for the ArcGIS GeoEvent Server machine. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The name of the ArcGIS GeoEvent Server object key name. The |
Required if you did not specify this under the |
|
|
The username of the ArcGIS GeoEvent Server primary site administrator. |
Required if you did not specify this under the |
|
|
The password for the site administrator account. |
Required if you did not specify this under the |
|
|
The password for the account used to run the ArcGIS GeoEvent Server Windows service. The login name is always arcgis. |
Conditional. Applies if you deploy on Microsoft Windows instances (set the |
|
|
The domain name for the deployment. Specify a fully qualified domain name for the Ensure the domain name ( |
Required if you did not specify this under the |
|
|
The web adaptor name for the ArcGIS GeoEvent Server site. Access to the ArcGIS GeoEvent Server site will be through a URL in the format |
Required. You must specify this parameter under the |
|
|
The SSL certificate file object key name. This must be a |
Required. You must specify this parameter under the |
|
|
The password for the SSL certificate. |
Required. You must specify this parameter under the |
|
|
Specifies whether the site will be federated with a base ArcGIS Enterprise deployment ( If you don't specify this parameter in the deployment configuration file, the default value is |
Required. You must specify this parameter under the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you specify this parameter, you must specify it under the |
Parameters for an ArcGIS Notebook Server site
Parameter values you specify under the "NotebookServer" node use the Esri CloudFormation templates that launch an ArcGIS Notebook Server site. Note that ArcGIS Notebook Server sites must always be federated, and you can create an ArcGIS Notebook Server site on the Ubuntu ArcGIS Notebook Server operating system only.
When you create a federated site, the ArcGIS Enterprise Cloud Builder CLI for AWS utility configures the site as your organization's Notebook Server; you do not need to configure this manually.
The following table lists all the possible parameters you can set under the "NotebookServer" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon Elastic Compute Cloud key pair to allow remote access to the EC2 instances. |
Required if you did not specify this under the |
|
|
Specify the DNS name of an existing Elastic Load Balancer (ELB). The ELB must be an application load balancer or classic load balancer. |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud type to use for the ArcGIS Notebook Server machines. |
Required if you did not specify this under the |
|
|
The size (in GB) of the root drive of the ArcGIS Notebook Server machines. The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The number of EC2 instances in the site. The default number of instances is 2, the maximum is 10, and the minimum is 1. |
Required if you did not specify this under the |
|
|
The name of the ArcGIS Notebook Server object key name. The |
Required if you did not specify this under the |
|
|
The ArcGIS Notebook Server license level. Available values are |
Required if you did not specify this under the |
|
|
The username of the ArcGIS Notebook Server primary site administrator. |
Required if you did not specify this under the |
|
|
The password for the site administrator account. |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud instance type to use for the file server. |
Required if you did not specify this under the |
|
|
The size (in GB) of the root drive of the ArcGIS Notebook Server file server machine. The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The domain name for the deployment. Specify a fully qualified domain name for the Ensure the domain name ( |
Required if you did not specify this under the |
|
|
The web adaptor name for the ArcGIS Notebook Server site. Access to the ArcGIS Notebook Server site will be through a URL in the format |
Optional. Required, and you must specify this parameter under the |
|
|
The SSL certificate file object key name. This must be a |
Required. You must specify this parameter under the |
|
|
The password for the SSL certificate. |
Required. You must specify this parameter under the |
|
|
Specifies whether the site will be federated with a base ArcGIS Enterprise deployment ( You must set If you don't specify this parameter in the deployment configuration file, the default value is |
Required. You must specify this parameter under the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you specify this parameter, you must specify it under the |
Parameters for an ArcGIS Mission Server site
Parameter values you specify under the "MissionServer" node use the Esri CloudFormation templates that launch an ArcGIS Mission Server site. Note that ArcGIS Mission Server sites must always be federated.
When you create a federated ArcGIS Mission Server site, the ArcGIS Enterprise Cloud Builder CLI for AWS utility configures the site as your organization's Server; you do not need to configure this manually.
The following table lists all the possible parameters you can set under the "MissionServer" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon Elastic Compute Cloud key pair to allow remote access to the EC2 instances. |
Required if you did not specify this under the |
|
|
Specify the DNS name of an existing Elastic Load Balancer (ELB). The ELB must be an application load balancer or classic load balancer. |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud type to use for the ArcGIS Mission Server machines. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The number of EC2 instances in the site. The default number of instances is 2, the maximum is 10, and the minimum is 1. |
Required if you did not specify this under the |
|
|
The name of the ArcGIS Mission Server object key. The |
Required if you did not specify this under the |
|
|
The username of the ArcGIS Mission Server primary site administrator. |
Required if you did not specify this under the |
|
|
The password for the site administrator account. |
Required if you did not specify this under the |
|
|
The password for the account used to run the ArcGIS Mission Server Windows service. The login name is always arcgis. |
Conditional. Applies if you deploy on Microsoft Windows instances (set the |
|
|
The Amazon Elastic Compute Cloud instance type to use for the file server. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The domain name for the deployment. Specify a fully qualified domain name for the Ensure the domain name ( |
Required if you did not specify this under the |
|
|
The web adaptor name for the ArcGIS Mission Server site. Access to the ArcGIS Mission Server site will be through a URL in the format |
Required, and you must specify this parameter under the |
|
|
The SSL certificate file object key name. This must be a |
Required if you did not specify this under the |
|
|
The password for the SSL certificate. |
Required if you did not specify this under the |
|
|
Specifies whether the site will be federated with a base ArcGIS Enterprise deployment ( You must set If you don't specify this parameter in the deployment configuration file, the default value is |
Required. You must specify this parameter under the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you use this parameter, you must specify it under the |
Parameters for an ArcGIS Workflow Manager site
Parameter values you specify under the "WorkflowManager" node use the Esri CloudFormation templates that launch an ArcGIS Workflow Manager site. Note that ArcGIS Workflow Manager sites must always be federated.
After you federate the ArcGIS Workflow Manager site with ArcGIS Enterprise, you must restart ArcGIS Workflow Manager on every EC2 instance. See Configure Workflow Manager with ArcGIS Enterprise for details.
The following table lists all the possible parameters you can set under the "WorkflowManager" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon Elastic Compute Cloud key pair to allow remote access to the EC2 instances. |
Required if you did not specify this under the |
|
|
Specify the DNS name of an existing Elastic Load Balancer (ELB). The ELB must be an application load balancer or classic load balancer. |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud type to use for the ArcGIS Workflow Manager machines. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The number of EC2 instances in the site. The default number of instances is 2, the maximum is 10, and the minimum is 1. |
Required if you did not specify this under the |
|
|
The name of the ArcGIS Workflow Manager object key. The |
Required if you did not specify this under the |
|
|
The username of the ArcGIS Workflow Manager primary site administrator. |
Required if you did not specify this under the |
|
|
The password for the site administrator account. |
Required if you did not specify this under the |
|
|
The password for the account used to run the ArcGIS Workflow Manager Windows service. The login name is always arcgis. |
Conditional. Applies if you deploy on Microsoft Windows instances (set the |
|
|
The Amazon Elastic Compute Cloud instance type to use for the file server. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 2048 GB. |
Required if you did not specify this under the |
|
|
The domain name for the deployment. Specify a fully qualified domain name for the Ensure the domain name ( |
Required if you did not specify this under the |
|
|
The web adaptor name for the ArcGIS Workflow Manager site. Access to the ArcGIS Workflow Manager site will be through a URL in the format |
Required, and you must specify this parameter under the |
|
|
The SSL certificate file object key name. This must be a |
Required if you did not specify this under the |
|
|
The password for the SSL certificate. |
Required if you did not specify this under the |
|
|
Specifies whether the site will be federated with a base ArcGIS Enterprise deployment ( You must set If you don't specify this parameter in the deployment configuration file, the default value is |
Required. You must specify this parameter under the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you use this parameter, you must specify it under the |
Parameters for spatiotemporal big data stores
Parameter values you specify under the "Spatiotemporal" node use the Esri CloudFormation template that launches an ArcGIS Data Store spatiotemporal big data store and registers it with the hosting server.
When you create a spatiotemporal big data store, the ArcGIS Enterprise Cloud Builder CLI for AWS utility registers the data store for you; you do not need to add the spatiotemporal big data store to the hosting server manually.
Note:
The ArcGIS Enterprise Cloud Builder CLI for AWS utility uses some of the attributes from the "BaseEnterprise" node when configuring a spatiotemporal big data store to identify what deployment to register the data store with. Therefore, the JSON configuration file you use when configuring a spatiotemporal big data store must include the "BaseEnterprise" node and information in the "Spatiotemporal" node.
The following table lists all the possible parameters you can set under the "Spatiotemporal" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon Elastic Compute Cloud key pair to allow remote access to the EC2 instances. |
Required if you did not specify this under the |
|
|
The number of Amazon Elastic Compute Cloud instances in the spatiotemporal big data store. Available values are |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud type to use for the spatiotemporal big data store machines. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 4096 GB. |
Required if you did not specify this under the |
|
|
The password for the account used to run the ArcGIS Data Store Windows service. The login name is always arcgis. |
Conditional. Applies if you deploy on Microsoft Windows instances (set the |
|
|
The type of storage used for spatiotemporal big data store backup files. Available values are If you specify If you specify |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud instance type to use for the file server. |
Conditional. This is required only if you set the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 4096 GB. |
Conditional. This is required only if you set the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you use this parameter, you must specify it under the |
Parameters for graph stores
Parameter values you specify under the "Graph" node use the Esri CloudFormation template that launches an ArcGIS Data Store graph store and registers it with the hosting server.
When you create a federated ArcGIS Knowledge Server, the ArcGIS Enterprise Cloud Builder CLI for AWS utility registers the graph store with the hosting server for you; you do not need to add the graph store to the hosting server manually.
Note:
The ArcGIS Enterprise Cloud Builder CLI for AWS utility uses some of the attributes from the "BaseEnterprise" node when configuring a graph store to identify what deployment to register the data store with. It also uses attributes from the "KnowledgeServer" node to ensure there is a federated ArcGIS Knowledge Server. Therefore, the JSON configuration file you use when configuring a federated ArcGIS Knowledge Server and a graph store must include the "BaseEnterprise" node, "KnowledgeServer" node, and "Graph" node.
The following table lists all the possible parameters you can set under the "Graph" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon Elastic Compute Cloud key pair to allow remote access to the EC2 instances. |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud type to use for the graph store machines. |
Required if you did not specify this under the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 4096 GB. |
Required if you did not specify this under the |
|
|
The password for the account used to run the ArcGIS Data Store Windows service. The login name is always arcgis. |
Conditional. Applies if you deploy on Microsoft Windows instances (set the |
|
|
The type of storage used for graph store backup files. Available values are If you specify If you specify |
Required if you did not specify this under the |
|
|
The Amazon Elastic Compute Cloud instance type to use for the file server. |
Conditional. This is required only if you set the |
|
|
The size (in GB) of the The default size is 500 GB, the minimum size is 200 GB, and the maximum size is 4096 GB. |
Conditional. This is required only if you set the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you use this parameter, you must specify it under the |
Parameters for enterprise geodatabases in Amazon RDS for SQL Server
The parameter values that you specify under the "SQLEGDB" node use the Esri CloudFormation template that creates an enterprise geodatabase in Amazon RDS for SQL Server and registers it with an ArcGIS Server site.
The "SQLEGDB" node and parameters are only applicable if you deploy on Microsoft Windows instances (set the "OperatingSystem" parameter under the "DeploymentDetails" section of the JSON configuration document to "Windows").
Note:
The ArcGIS Enterprise Cloud Builder CLI for AWS utility uses attributes from the "Server" or "ImageServer" node to identify the ArcGIS Server site to register the geodatabase with. Therefore, the JSON configuration file you use when configuring an enterprise geodatabase must include the "Server" node or "ImageServer" node for the site to which you want to add an enterprise geodatabase.
The following table lists the possible parameters you can set under the "SQLEGDB" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon RDS EC2 instance class for the database where the enterprise geodatabase will be created. |
Required if you did not specify this under the |
|
|
The allocated storage size of the Amazon RDS EC2 instance (in GB). The default is 500 GB, the minimum is 200 GB, and the maximum is 4096 GB. |
Required if you did not specify this under the |
|
|
The SQL Server database engine type. Available values are |
Required if you did not specify this under the |
|
|
The SQL Server database version. Available values are as follows:
The default value is |
Required if you did not specify this under the |
|
|
The database identifier name. The name must begin with a letter and contain only alphanumeric characters. The minimum number of characters is 3 and the maximum is 63. |
Required if you did not specify this under the |
|
|
The RDS master username. The name must begin with a letter and contain only alphanumeric characters. The minimum number of characters is 4 and the maximum is 16. |
Required if you did not specify this under the |
|
|
The password for the RDS master user. |
Required if you did not specify this under the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you use this parameter, you must specify it under the |
Parameters for enterprise geodatabases in Amazon RDS for PostgreSQL
The parameter values that you specify under the "PostgresEGDB" node use the Esri CloudFormation template that creates an enterprise geodatabase in Amazon RDS for PostgreSQL and registers it with an ArcGIS Server site.
Note:
The ArcGIS Enterprise Cloud Builder CLI for AWS utility uses attributes from the "Server" or "ImageServer" node to identify the ArcGIS Server site to register the geodatabase with. Therefore, the JSON configuration file you use when configuring an enterprise geodatabase must include the "Server" node or "ImageServer" node for the site to which you want to add an enterprise geodatabase.
The following table lists the possible parameters you can set under the "PostgresEGDB" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon RDS EC2 instance class for the database where the enterprise geodatabase will be created. |
Required if you did not specify this under the |
|
|
The allocated storage size of the Amazon RDS EC2 instance (in GB). The default is 500 GB, the minimum is 200 GB, and the maximum is 4096 GB. |
Required if you did not specify this under the |
|
|
The PostgreSQL database version. Available values are as follows:
The default value is |
Required if you did not specify this under the |
|
|
The database identifier name. The name must begin with a letter and contain only alphanumeric characters. The minimum number of characters is 3 and the maximum is 63. |
Required if you did not specify this under the |
|
|
The RDS master username. The name must begin with a letter and contain only alphanumeric characters. The minimum number of characters is 4 and the maximum is 16. |
Required if you did not specify this under the |
|
|
The password for the RDS master user. |
Required if you did not specify this under the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you use this parameter, you must specify it under the |
Parameters for enterprise geodatabases in Aurora PostgreSQL
The parameter values that you specify under the "AuroraEGDB" node use the Esri CloudFormation template that creates an enterprise geodatabase in Aurora PostgreSQL and registers it with an ArcGIS Server site.
Note:
The ArcGIS Enterprise Cloud Builder CLI for AWS utility uses attributes from the "Server" or "ImageServer" node to identify the ArcGIS Server site to register the geodatabase with. Therefore, the JSON configuration file you use when configuring an enterprise geodatabase must include the "Server" node or "ImageServer" node for the site to which you want to add an enterprise geodatabase.
The following table lists the possible parameters you can set under the "AuroraEGDB" node:
|
Parameter |
Description |
Required or optional |
|---|---|---|
|
|
The Amazon RDS EC2 instance class for the database where the enterprise geodatabase will be created. |
Required if you did not specify this under the |
|
|
The PostgreSQL database version. Available values are as follows:
The default value is |
Required if you did not specify this under the |
|
|
The database identifier name. The name must begin with a letter and contain only alphanumeric characters. The minimum number of characters is 3 and the maximum is 63. |
Required if you did not specify this under the |
|
|
The RDS master username. The name must begin with a letter and contain only alphanumeric characters. The minimum number of characters is 4 and the maximum is 16. |
Required if you did not specify this under the |
|
|
The password for the RDS master user. |
Required if you did not specify this under the |
|
|
To use your own CloudFormation template for this deployment instead of the templates provided by Esri, specify your template. Provide a valid HTTPS URL. |
Optional. If you specify this parameter, you must specify it under the |