Manage machines in an ArcGIS deployment on Microsoft Azure

You can manage sizes and states for machines in existing ArcGIS Enterprise deployments or ArcGIS Server sites you created through ArcGIS Enterprise Cloud Builder for Microsoft Azure. You can also change the state of the Azure Application Gateway used with the deployment and upload a script to run on all the machines in the deployment.

You manage the following for the deployment:

• Stop, start, or delete a machine.
• Change machine settings.
• Stop or restart the Azure Application Gateway.
• Run a Microsoft PowerShell script on all machines.

Stop, start, or delete a machine

You can stop, restart, or delete a machine.

One reason to stop a machine is to save on Azure charges when the machine is not in use. Restart the machine when it is needed again.

Caution:

Do not delete a machine unless you do not need it any longer. You cannot recover a deleted machine.

Follow these steps to change settings for machines in the deployment, including their state and disk settings:

1. Start ArcGIS Enterprise Cloud Builder for Microsoft Azure.
2. Sign in to Microsoft Azure.

   If the ArcGIS Enterprise deployment or ArcGIS Server site is in the Microsoft Azure Government cloud, check U.S. Government Cloud.

3. Choose the subscription that contains the deployment to manage and click Next.

   If your account only has access to one subscription, you will not see this page.

4. Click the Manage Machines in the site button .
   • To manage a stand-alone ArcGIS Server site or base ArcGIS Enterprise deployment, click the Manage Machines in the site button next to the deployment name.
   • To manage a federated server, click the down arrow next to the deployment name to see the list of federated servers. Click the Manage Machines in the site button next to the name of the federated server.

   The Configure Machines page appears.

5. For each machine, choose the appropriate option from the Desired State drop-down menu.
   • Stop
   • Retart
   • Delete
6. Provide the site administrator username and password to authenticate the changes and click Next.
7. Specify a storage account in which to store temporary objects necessary to complete this change, and click Next.

   You can use an existing storage account in any region, or create one. Cloud Builder deletes these temporary deployment objects after the deployment change completes.

8. Confirm the site administrator username and click Finish to save changes to the deployment.

   Caution:

   Deleting a machine cannot be undone.

Change the state of the Azure Application Gateway

If you stop the virtual machines to save costs when they are not in use, you can also stop the Azure Application Gateway when the deployment is not in use to save on those fees. Restart the Azure Application Gateway when the deployment is needed again.

Follow these steps to stop or restart the Azure Application Gateway used by the deployment:

1. Start ArcGIS Enterprise Cloud Builder for Microsoft Azure.
2. Sign in to Microsoft Azure.

   If the ArcGIS Enterprise deployment or ArcGIS Server site is in the Microsoft Azure Government cloud, check U.S. Government Cloud.

3. Choose the subscription that contains the deployment to manage and click Next.

   If your account only has access to one subscription, you will not see this page.

4. Click the Manage Machines in the site button .
   • To manage a stand-alone ArcGIS Server site or base ArcGIS Enterprise deployment, click the Manage Machines in the site button next to the deployment name.
   • To manage a federated server, click the down arrow next to the deployment name to see the list of federated servers. Click the Manage Machines in the site button next to the name of the federated server.

   The Configure Machines page appears.

5. To change the state of the Azure Application Gateway, choose Stop or Restart from the Desired State drop-down list.
6. Provide the site administrator username and password to authenticate the changes and click Next.
7. Specify a storage account in which to store temporary objects necessary to complete this change, and click Next.

   You can use an existing storage account in any region, or create one. Cloud Builder deletes these temporary deployment objects after the deployment change completes.

8. Confirm the site administrator username and click Finish to save changes to the deployment.

Change machine settings

You can change the following for machines in the deployment:

• Machine type—You can choose from available Microsoft Azure machine types in the region of your deployment. Change types if you require more cores or memory on the machine.

  Note:

  For ArcGIS Server machines, you can only use the number of cores for which you are licensed.

  For all machines types, do not request cores in excess of what your Azure subscription allows.

• Operating system disk type—If you initially deployed with a magnetic disk drive (HDD) and want to improve performance, you can switch to a solid-state drive (SSD). If you deployed with an SSD but you are only using the deployment in a development environment, you can switch to HDD to cut costs.
• Operating system disk size—If you need more storage on the operating system disk, you can increase the size.
• Add a data disk—To add more storage space, add a data disk.

Follow these steps to change states or disk settings for machines in the deployment:

1. Start ArcGIS Enterprise Cloud Builder for Microsoft Azure.
2. Sign in to Microsoft Azure.

   If the ArcGIS Enterprise deployment or ArcGIS Server site is in the Microsoft Azure Government cloud, check U.S. Government Cloud.

3. Choose the subscription that contains the deployment to manage and click Next.

   If your account only has access to one subscription, you will not see this page.

4. Click the Manage Machines in the site button .
   • To manage a stand-alone ArcGIS Server site or base ArcGIS Enterprise deployment, click the Manage Machines in the site button next to the deployment name.
   • To manage a federated server, click the down arrow next to the deployment name to see the list of federated servers. Click the Manage Machines in the site button next to the name of the federated server.

   The Configure Machines page appears.

5. For each machine, click the Configure Virtual Machine button and specify new settings for the machine type or disk settings.
6. Click Apply when setting changes are complete.
7. Provide the site administrator username and password to authenticate the changes and click Next.
8. Specify a storage account in which to store temporary objects necessary to complete this change, and click Next.

   You can use an existing storage account in any region, or create one. Cloud Builder deletes these temporary deployment objects after the deployment change completes.

9. Confirm the site administrator username and click Finish to save changes to the deployment.

Run a script on all machines in the deployment

If you write a Microsoft PowerShell script to manage a deployment, you can upload it and run it.

Example uses for scripts include the following:

• To patch software
• To upload files or data
• To install or upgrade software not deployed or upgraded using Cloud Builder.

  Note:

  If you install software that is not supported by Cloud Builder, you must script the upgrade of that software going forward.

Follow these steps to upload a script that will run on all machines in the deployment:

1. Start ArcGIS Enterprise Cloud Builder for Microsoft Azure.
2. Sign in to Microsoft Azure.

   If the ArcGIS Enterprise deployment or ArcGIS Server site is in the Microsoft Azure Government cloud, check U.S. Government Cloud.

3. Choose the subscription that contains the deployment to manage and click Next.

   If your account only has access to one subscription, you will not see this page.

4. Click the Manage machines in the site button .
   • To run a script on the machines in a stand-alone ArcGIS Server site or base ArcGIS Enterprise deployment, click the Manage machines in the site button next to the deployment name.
   • To run a script on the machines in a federated server, click the down arrow next to the deployment name to see the list of federated servers. Click the Manage machines in the site button next to the name of the federated server.

   The Configure Machines page appears.

5. Provide the Microsoft PowerShell script and related information as described below.
   1. Script file path—Provide the location and name of the script file. You can paste the path into the text box, or click the options button to browse to the file's location.
   2. Timeout (in minutes)—Define the amount of time, in minutes, to allow the script to run. If the script does not complete in the time specified, Cloud Builder will end the process to prevent a hung script. The minimum timeout is five minutes; the maximum is 300 minutes.
   3. Script parameters—If the script requires parameters to run, provide those here. Syntax for the parameters is -<parameter> <value>.
   4. Run script as ArcGIS service account—By default, the script will run using the ArcGIS service account. You must provide credentials for that account. It is recommended that you use this account because it does not have elevated privileges. If you uncheck this option, the script runs using the local system account on each machine.

      Tip:

      You specified the ArcGIS service account on the Licenses and Credentials page when you created the deployment or added a federated server.

6. Provide the site administrator username and password to authenticate the changes and click Next.
7. Specify a storage account in which to store temporary objects necessary to complete this change, and click Next.

   You can use an existing storage account in any region, or create one. Cloud Builder deletes these temporary deployment objects after the deployment change completes.

8. Confirm the site administrator username and click Finish to upload and run the script on all machines in the deployment.