Upgrade an ArcGIS Mission Server site on AWS

How you upgrade depends on how and when you created the ArcGIS Mission Server site on Amazon Web Services (AWS).

• Any ArcGIS Mission Server site on AWS can be upgraded using a manual upgrade procedure. If you created the site before 10.8, you must use the manual procedure to upgrade.
• If you created the ArcGIS Mission Server site using a 10.8 or 10.8.1 Esri Amazon Web Services CloudFormation template, you can upgrade using Chef scripts.
• If you created the ArcGIS Mission Server site using a 10.9, 10.9.1, 11.0, 11.1, 11.2, or 11.3 Esri CloudFormation template, you can use the corresponding 11.4 CloudFormation template to upgrade it.
• If you created the ArcGIS Mission Server site using 10.9, 10.9.1, 11.0, 11.1, 11.2, or 11.3 ArcGIS Enterprise Cloud Builder for Amazon Web Services, you can use 11.4 ArcGIS Enterprise Cloud Builder for AWS to upgrade it.

Before you upgrade

Regardless of the upgrade method you use, review the following information before you upgrade your deployment:

• You must obtain a new license file to upgrade to 11.4.
• Make a backup of the ArcGIS Mission Server site before upgrading.
• You must upgrade the ArcGIS Enterprise portal with which ArcGIS Mission Server is federated before upgrading the ArcGIS Mission Server site.

Upgrade using manual upgrade procedures

The manual upgrade procedure for an ArcGIS Mission Server site on AWS is similar to upgrading one on-premises. Therefore, follow instructions in the ArcGIS Mission Server installation guide to upgrade the site. Read the instructions specific to the operating system on your EC2 instances:

• Installation guide for ArcGIS Mission Server on Linux
• Installation guide for ArcGIS Mission Server on Windows

Upgrade using Chef scripts

If you created the ArcGIS Mission Server site using a 10.8 or 10.8.1 Esri Amazon Web Services CloudFormation template, you can upgrade using Chef scripts.

Upgrade steps are different for deployments on Microsoft Windows and Ubuntu. Follow the instructions applicable to the operating system of your deployment.

Upgrade a site on Windows

Follow the steps in the next two sections to use Chef to upgrade an ArcGIS Mission Server site and its ArcGIS Web Adaptor on Windows Amazon EC2 instances.

Upgrade ArcGIS Mission Server

First, upgrade ArcGIS Mission Server on the EC2 instance in the site.

1. Make a remote desktop connection to the EC2 instance in the ArcGIS Mission Server site.
2. Download and install a supported Chef or Cinc client.

   See the ArcGIS Cookbook compatibility matrix for supported versions.

3. Download the 11.4 versions of the following installation files from your account in My Esri and upload them to the C:\Software\Archives folder on the EC2 instance.

   • ArcGIS_Mission_Server_Windows_114_192950.exe
   • ArcGIS_Web_Adaptor_for_Microsoft_IIS_114_192944.exe

4. Obtain an ArcGIS Mission Server 11.4 authorization file and place it in a local folder on the EC2 instance or a file share that you can access from the EC2 instance.
5. Download the ArcGIS Cookbook version 5.0.0 (arcgis-5.0.0-cookbooks.zip) to the EC2 instance, unzip the file, and place the contents of the unzipped file in the C:\chef folder.
6. Delete the following folders:

   • C:\chef\nodes
   • C:\Users\Administrator\.chef\local-mode-cache

The mission-server.json file you will use to upgrade is included in the cookbook you downloaded and extracted in step 5. It is located in C:\chef\templates\arcgis-mission\11.4\windows\.
7. Change directories to the chef subfolder to which you extracted the cookbook, open the mission-server.json file in a text editor, and modify the following parameters:

   • Set the password for the Windows account used to run the ArcGIS Mission Server service.

     "arcgis" : {
         "run_as_password": "<password>",

   • Specify the location where you placed the ArcGIS Mission Server authorization file.

     "arcgis" : {
         "mission-server": {
             "authorization_file": "<drive>\\<folder>",

   • Set the username and password for the ArcGIS Mission Server site administrator.

     "arcgis" : {
         "mission-server": {
     	       "admin_username": "<username>",
             "admin_password": "<password>",

   • Set the root server directory location. The default location is C:\arcgismissionserver\directories, but you may have used a different drive or path.

     "arcgis" : {
         "mission-server": {
         "directories_root": "<drive>\\<folder>",

   • Set the connection string for the location of the ArcGIS Mission Server configuration directory. This was set when you created the ArcGIS Mission Server site. To find the string, sign in to the ArcGIS Mission Server administrator directory for the ArcGIS Mission Server site as the site administrator and go to system > configStore.

     "arcgis" : {
         "mission-server": {
         "config_store_connection_string": "<drive>\\<folder>",

   • Set the web socket context URL. This was set when you created the ArcGIS Mission Server site. To copy the URL, sign in to the ArcGIS Mission Server administrator directory for the ArcGIS Mission Server site as the site administrator and go to system > properties > REST. It is in the format wss://<fully qualified machine name>/<ArcGIS Mission Server web adaptor name>.

     "arcgis" : {
         "mission-server": {
         "system_properties": {
             "WebSocketContextURL": "<URL>"

   • Add a hostname node and leave it blank.

     "arcgis" : {
         "mission-server": {
         "hostname": ""

8. Save and close the mission-server.json file.
9. Open a command line window as an administrator, change the directory to C:\chef, and run the following command: chef-client -z -j c:\chef\templates\arcgis-mission\11.4\windows\mission-server.json.

Now upgrade ArcGIS Web Adaptor.

Upgrade ArcGIS Web Adaptor

Use the mission-server-webadaptor.json file, which is also included with the cookbook you downloaded in step 5 in the previous section, to upgrade ArcGIS Web Adaptor.

1. Open the mission-server-webadaptor.json file in a text editor and modify the following parameters:

   • Set the password for the Windows account used to run the ArcGIS Mission Server service.

     "arcgis" : {
         "run_as_password": "<password>",

   • Set the username and password for the ArcGIS Mission Server site administrator.

     "arcgis" : {
         "mission-server": {
     	       "admin_username": "<username>",
             "admin_password": "<password>",

   • Set the location of the PKSC12 keystore file (.pfx) with SSL certificate for IIS.

     "arcgis" : {
         "iis": {
         "keystore_file": "<drive>\\<folder>\\<file name>.pfx",

   • Set the password for keystore file with SSL certificate for IIS.

     "arcgis" : {
         "iis": {
         "keystore_password": "<password>"

2. Open a command line window as an administrator, change directory to C:\chef, and run the following command: chef-client -z -j c:\chef\templates\arcgis-mission\11.4\windows\mission-server-webadaptor.json.

Upgrade a site on Ubuntu

Follow these steps in the next two sections to use Chef to upgrade an ArcGIS Mission Server site and its ArcGIS Web Adaptor on Ubuntu Amazon EC2 instances.

Upgrade ArcGIS Mission Server

First, upgrade ArcGIS Mission Server on the EC2 instance in the site.

1. As the ubuntu user, make a secure shell protocol (SSH) connection to the EC2 instance in the ArcGIS Mission Server site.
2. Use one of the following commands to download and install a supported Chef or Cinc client.

   See the ArcGIS Cookbook compatibility matrix for supported versions. Replace the version number text in the following statements with the client version you install, for example 18.30.

   • Chef client: sudo curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v <version_number>
   • Cinc client: sudo curl -L https://omnitruck.cinc.sh/install.sh | sudo bash -s -- -v <version_number>
3. Download the 11.4 versions of the following installation files from your account in My Esri and upload them to the /opt/software/archives directory on the EC2 instance.

   • ArcGIS_Mission_Server_Linux_114_192991.tar.gz
   • ArcGIS_Web_Adaptor_Java_Linux_114_192983.tar.gz

4. Obtain an ArcGIS Mission Server 11.4 authorization file and place it in a local folder on the EC2 instance or a file share that you can access from the EC2 instance.
5. Download the ArcGIS Cookbook version 5.0.0 (arcgis-5.0.0-cookbooks.tar.gz) to the EC2 instance, untar and unzip the file, and place the files contents in the /opt/chef directory.
The mission-server.json file you will use to upgrade is included in the cookbook you downloaded and extracted in the previous step.
6. Change directories to /opt/chef/templates/arcgis-mission/11.4/linux, open the mission-server.json file in a text editor, and modify the following parameters:

   • Set the installation directory to /home.

     "arcgis" : {
         "mission_server": {
             "install_dir": "/home"

   • Specify the location where you placed the ArcGIS Mission Server authorization file.

     "arcgis" : {
         "mission_server": {
             "authorization_file": "/<folder>/<subfolder>",

   • Set the username and password for the ArcGIS Mission Server site administrator.

     "arcgis" : {
         "mission_server": {
     	       "admin_username": "<username>",
             "admin_password": "<password>",

   • Set the root server directory location to /gisdata/arcgismissionserver.

     "arcgis" : {
         "mission_server": {
         "directories_root": "/gisdata/arcgismissionserver",

   • Set the connection string for the location of the ArcGIS Mission Server configuration directory to /gisdata/arcgismissionserver/config-store.

     "arcgis" : {
         "mission_server": {
         "config_store_connection_string": "/gisdata/arcgismissionserver/config-store",

   • Set the log directory to /home/arcgis/mission/usr/logs/.

     "arcgis" : {
         "mission_server": {
         "log_dir": "/home/arcgis/mission/usr/logs/",

   • Set the web socket context URL. This was set when you created the ArcGIS Mission Server site. To copy the URL, sign in to the ArcGIS Mission Server administrator directory for the ArcGIS Mission Server site as the site administrator and go to system > properties > REST. It is in the format wss://<fully qualified machine name>/<ArcGIS Mission Server web adaptor name>.

     "arcgis" : {
         "mission_server": {
         "system_properties": {
             "WebSocketContextURL": "<URL>"

   • Add a hostname node and leave it blank.

     "arcgis" : {
         "mission_server": {
         "hostname": ""

7. Save and close the mission-server.json file.
8. As the ubuntu user, run the following command: sudo chef-client -z -j /opt/chef/templates/arcgis-mission/11.4/linux/mission-server.json.

Now upgrade ArcGIS Web Adaptor.

Upgrade ArcGIS Web Adaptor

Use the mission-server-webadaptor.json file, which is also included with the cookbook you downloaded in step 5 in the previous section, to upgrade ArcGIS Web Adaptor.

1. Open the mission-server-webadaptor.json file in a text editor and modify the following parameters:

   • Set the location of the PKSC12 keystore file (.pfx) with SSL certificate for Apache Tomcat.

     "arcgis" : {
         "tomcat": {
         "keystore_file": "/<folder>/<subfolder>/<file name>.pfx",

   • Set the password for keystore file with SSL certificate for Tomcat.

     "arcgis" : {
         "tomcat": {
         "keystore_password": "<password>"

   • Set the username and password for the ArcGIS Mission Server site administrator:

     "arcgis" : {
         "mission_server": {
     	       "admin_username": "<username>",
             "admin_password": "<password>",

2. Save and close the mission-server-webadaptor.json file.
3. As the ubuntu user, change the directory to /opt/chef, and run the following command: chef-client -z -j /opt/chef/templates/arcgis-mission/11.4/linux/mission-server-webadaptor.json.

Upgrade using a CloudFormation template

If you used a 10.9, 10.9.1, 11.0, 11.1, 11.2, or 11.3 deployment CloudFormation template provided by Esri to create an ArcGIS Mission Server site, you can use the corresponding 11.4 upgrade template to upgrade it.

The following table lists corresponding deployment and upgrade templates and provides links to instructions for using the upgrade templates.

10.9, 10.9.1, 11.0, 11.1, 11.2, or 11.3 deployment template	11.4 upgrade template	Instructions to use upgrade template
arcgis-mission-server-singlemachine.template.json	arcgis-mission-server-singlemachine-upgrade.template.json	Upgrade a single machine ArcGIS Mission Server site using CloudFormation
arcgis-mission-server-ha.template.json	arcgis-mission-server-ha-upgrade.template.json	Upgrade a multiple machine ArcGIS Mission Server site using CloudFormation