Add an ArcGIS Server site to ArcGIS Enterprise

The base ArcGIS Enterprise deployment includes a GIS Server that is configured as the portal's hosting server. You can enable additional functionality by adding the following ArcGIS Server sites to your Enterprise deployment on Microsoft Azure. When you add an ArcGIS Server site to your Enterprise deployment, the site is federated with the portal.

• ArcGIS GeoAnalytics Server

  Add an ArcGIS GeoAnalytics Server site to your Enterprise deployment to allow your portal users to run GeoAnalytics Tools.

  Your portal's hosting server must be configured with a spatiotemporal big data store for you to add a GeoAnalytics Server site to your ArcGIS Enterprise deployment. If you did not create a spatiotemporal big data store when you deployed ArcGIS Enterprise, add one before proceeding with the steps to add an ArcGIS Server site.

• ArcGIS GeoEvent Server

  Add a GeoEvent Server to enable real-time, event-based data streams to your portal and to archive streamed data.

  You must have an ArcGIS GeoEvent Server license to add a GeoEvent Server site to your ArcGIS Enterprise deployment.

  If you want to archive the real-time data streamed through GeoEvent Server, your portal's hosting server must be configured with a spatiotemporal big data store. If you did not create a spatiotemporal big data store when you deployed ArcGIS Enterprise, add one.

• ArcGIS Image Server

  Add an Image Server to your Enterprise deployment so that image services you publish to a federated server automatically create items in your portal. If you also want to allow your portal users to run raster analysis tools, you can configure this site as the portal's raster analysis server.

  Add a second ArcGIS Image Server site to your deployment if you want to configure an image hosting server to host the image layers generated when portal users run raster analysis tools.

  You must have an ArcGIS Image Server license to add an Image Server site to your ArcGIS Enterprise deployment.

• ArcGIS Mission Server

  An ArcGIS Mission Server site is a required component of ArcGIS Mission. If the portal to which you're adding the ArcGIS Mission Server site does not have a spatiotemporal big data store configured with it, add one to store the missions used with ArcGIS Mission.

  You must have an ArcGIS Mission Server license to add a Mission Server site to your ArcGIS Enterprise deployment.

• ArcGIS Notebook Server

  ArcGIS Notebook Server is a federated server that allows you to use Python to perform spatial analysis, create data science and machine learning workflows, manage GIS data, and automate administrative tasks for your ArcGIS Enterprise portal.

  To use ArcGIS Notebook Server, you must install and configure Docker on your ArcGIS Notebook Server instance on Azure.

• GIS Server

  You can federate additional GIS Server sites with your ArcGIS Enterprise deployment to run map and feature services you publish from ArcGIS Pro. When you publish these services to a federated server, they are automatically added as items in your portal.

  You must have an additional ArcGIS GIS Server license (beyond the one used for your hosting server) to add a GIS Server site to your ArcGIS Enterprise deployment.

Follow these steps to add an ArcGIS Server site to your ArcGIS Enterprise deployment:

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

   If you want to use the Microsoft Azure Government cloud and have an Azure Government subscription, check U.S. Government Cloud.

3. Choose an Azure Active Directory tenant, click next, choose the Azure subscription that contains the ArcGIS Enterprise deployment to which you want to add an ArcGIS Server site, and click next.
4. Ensure V2 Sites is selected and click Deploy a new site.
You can no longer add federated servers to V1 deployments.
5. Choose one of the ArcGIS Server roles depending on the functionality you need.
   • GeoEvent Server
   • GeoAnalytics Server
   • Image Server
   • Mission Server
   • Notebook Server
   • GIS Server
6. Click next to proceed to Image Options.
7. From the Deploy to Resource Group drop-down list, choose the resource group used by your ArcGIS Enterprise deployment.
8. Choose the image to use: an Esri image, an image in your subscription, or an image you create.
   • To use an Esri image or a custom image in your subscription, choose the image from the drop-down list.
   • To create an image from a source VHD file, follow these steps:
   1. Click the add + button under Image in this Azure Subscription.
   2. Type a name for the image and click Check Availability to be sure the name is unique.

      The image name can contain only letters, numbers, underscores (_), dots (.), and hyphens (-). The name must start with a letter or number and end with a letter, number, or underscore.

   3. Choose or create a resource group in which to store the image.
   4. Choose the region in which to create the image. Use the same region that contains the .vhd file.
   5. For Source Disk, click the button to browse to your .vhd file in your storage account. Choose the storage account that contains the file, choose the file, and click ok.

      The storage accounts available on the Select Image Disk dialog box are based on the region you chose in the previous step.

   6. Choose the type of image to create.

      HDD uses magnetic storage. SSD images use faster, solid state drives.

   7. For Size, choose the image size.

      The image size determines the minimum size of the operating system disk (C:\) of the virtual machine created from the image. You can increase the size of the provisioned disk for the virtual machine created from the image, but you cannot decrease the size below the image size. See the Microsoft Azure documentation for more information on Azure managed disks.

   8. Click create to create the image.
9. If you have an ArcGIS Server workgroup edition license, are deploying a test or demonstration site, or only want one machine in your ArcGIS Server site, check Single machine deployment. Only one Azure machine will be used for your site. If you have an enterprise edition ArcGIS Server license and want to distribute processing and connection loads across multiple machines, uncheck Single machine deployment.
10. To avoid duplication of Azure resource names in resource groups, Cloud Builder allows you to prefix resources with a specified string by checking Prefix Azure Resource Manager (ARM) Resource names with and providing up to three alphanumeric characters. Cloud Builder automatically populates this value with a random two-character string. If you want to change this, type a prefix to add to Azure resource names such as load balancers and availability sets.

    Prefixes must start with an alphabetic character.

    Adding a prefix avoids duplication of resource names and allows you to categorize resources according to your requirements for managing in the Azure portal or billing.

    For disaster recovery configurations, create multiple resource groups with the same prefix.

11. Click next to proceed to Federation Options.
12. Choose With Existing Deployment and choose your ArcGIS Enterprise deployment from the drop-down list.
13. Type the user name and password for the login you specified for the site administrator when you created your ArcGIS Enterprise deployment.
14. If you are adding an ArcGIS GeoAnalytics Server site, leave GeoAnalytics Server checked.

    Your hosting server must have a spatiotemporal big data store configured with it. If it does not, you must add one before you can proceed.

15. If you want to register a big data file share for your ArcGIS GeoAnalytics Server site, click the Register a Cloud Data Store from Azure Blob Storage button . You need to do one of the following:
    • Prepare your data by formatting a parent folder and subfolders in an existing Azure Blob storage container, place your data files in the folders, and choose the existing Azure Blob storage container on the Select Blob Container dialog box.
    • Create a new storage account and container. After you launch the ArcGIS GeoAnalytics Server site, you must place your files in the folders for the cloud store that Cloud Builder creates, and connect to the site from ArcGIS Server Manager and update the big data file share manifest to recognize the files.
16. If you are adding an ArcGIS Image Server site, you can add it to support raster analysis tools in your portal (Raster Analysis Server) or you can add it to act as an image hosting server (Image Hosting Server). Each ArcGIS Image Server site can fill only one role. Check the box next to the role you want it to fill and specify a storage location.
    1. Click the browse button.
    2. Choose the storage account used for your ArcGIS Enterprise deployment from the drop-down list.
    3. If you have an existing Blob storage container you want to use, choose that container from the list.
    4. If you want to create a new Blob container in this storage account, click the Create a container button, type a unique name for the storage container, and click Check Availability to confirm the name is unique. Once you have a unique name, click create to create the container.
    5. Click ok to close the Select Image Disk dialog box.
17. Click next to proceed to Machine Options.
18. Type a user name and password for Machine Administrator.

    This is the Windows login you will use to administer the virtual machines in your site. The same login and password are used for all machines in your site.

    The user name must contain three or more characters and contain no spaces, and it cannot be admin or administrator. The password must meet Windows Server complexity requirements.

19. Use the default virtual machine type and size or click the Configure Virtual Machine button to specify machine and disk configurations for a virtual machine that Cloud Builder will create for your ArcGIS Server site on Azure.
20. Choose the time zone you want your virtual machines to use.
21. If you have an existing Windows Domain in your Azure environment to which you want to add your machine (or machines), click Domain Join Options.
    1. On the Domain Join Options dialog box, check the Join Existing Windows Domain check box.
    2. Provide the name of the Active Directory domain.
    3. Provide the user name and password for the domain administrator.
    4. Click apply.
22. If you want Microsoft Azure to apply updates to the operating systems on your virtual machines, check the box next to Enable automatic operating system updates.
23. If the ArcGIS Server site you are federating with your Enterprise deployment is not a GIS Server, proceed to step 27. If you are federating a GIS Server site, click next to proceed to the Database Options page.
24. If you're adding a GIS Server site, you can add a registered database to the site. You can upload data to this enterprise geodatabase on Azure to use with ArcGIS Pro and ArcGIS Server sites on Azure.
    • If you do not want a registered database, choose None from the Database Type drop-down menu and proceed to step 27.
    • To add a registered database, choose the type of database or database service you want to use from the drop-down menu and proceed to the next step.
25. If you choose a database service, choose or create a database server and database and provide a user name and password for the database administrator and for a user that has permissions to create data in the database. If these resources don't yet exist, Cloud Builder will create them.
26. If you choose Microsoft SQL Server, follow these substeps to create and register a database:
    1. Type a name for the virtual machine that will host the Microsoft SQL Server database.
    2. Click Machine Options and choose a SQL Server version from the Image drop-down menu.
    3. Use the default machine type and size, or click the Configure Virtual Machine button to specify the disk types, machine type, and disk sizes for the virtual machine.
    4. Click apply to save your machine settings.
    5. Type a name for the database. The name must meet SQL Server requirements.
    6. Type a user name and password for the database administrator. This user name and password will also be used for the machine administrator.
    7. Type a user name and password for a database user who will have permissions to create tables in the database.
27. Click next to proceed to the License and Credentials page.
28. Browse to the location of your ArcGIS GIS Server, ArcGIS GeoAnalytics Server, ArcGIS GeoEvent Server, ArcGIS Image Server, ArcGIS Mission Server, or ArcGIS Notebook Server license file.
29. Provide a context name for the ArcGIS Server site's URL. The context is the identifier in the URL that routes you to the correct site.

    For example, in the following URL, mygisserver is the context: https://mydeployment.domain.com/mygisserver.

30. Type a user name and password for Site Administrator. This is the ArcGIS Server primary site administrator account.
31. Type a user name and password for ArcGIS Service Account, which is the Windows login under which the ArcGIS Server service will run.

    If you added your machines to an existing Windows Domain in your Azure environment and created a domain account to use for this purpose, you can specify that domain account information for the user name and password, and check the box next to Is a Domain Account.

32. Click next to proceed to Deployment Options.
33. Choose or create a storage account for your deployment. To create a storage account, follow these steps.
    1. Type a name for the storage account. Names must be unique. Click Check Availability to confirm the storage account name is unique.
    2. Choose the Azure region where your storage will reside.
    3. Choose an existing resource group for the storage account or create one.
    4. Choose the type of redundancy for your storage account: Geo-Redundant, Locally Redundant, or Read-Access Geo-Redundant.

       See Azure Storage redundancy in Microsoft Azure documentation for a description of each option.

    5. Specify the kind of Azure storage account to use: Storage (a legacy account type), StorageV2 (a basic account type), or BlobStorage (only supports Azure Blob storage).
    6. Once the storage account is created, click close.
34. To use Azure Monitor logs, check Enable Monitoring using Azure Monitor Logs and choose or create a log workspace.
35. Check the Transfer server logs to Azure Monitor Logs check box to enable ArcGIS Server to harvest logs at a specified location on the ArcGIS Server machines.

    Note:

    To allow Azure Monitor Logs to gather ArcGIS Server logs (services.log and server.log files), you must define a custom logs data source on the Log Analytics page in the Microsoft Azure portal. The ArcGIS Server log files are stored in the C:\ArcGIS\serverlogs directory on the ArcGIS Server machines.

36. If you want ArcGIS Server site directories to be stored using an Azure Cloud Storage service, check Use Azure Cloud Storage for the configuration store.
37. If you check Use Azure Cloud Storage for the configuration and content store?, choose which storage option to use.
    • Choose Azure Files (SMB) to store your ArcGIS Server configuration store and directories in Azure Files.

      This is the only option available for ArcGIS Mission Server sites at this time.

      For ArcGIS Notebook Server, directories are stored on the Notebook Server machine.

    • Choose Azure Blobs and Tables to store the ArcGIS Server configuration store in Azure Blob Storage. Directories will be stored on the ArcGIS Server machines.
38. Specify an Azure storage account that is in the same region you used for your ArcGIS Enterprise deployment. You can use the same storage account used for your ArcGIS Enterprise deployment or create a new storage account. To create a storage account in the region group for this site, follow these steps:
    1. Click the add button (+).
    2. Type a name for the storage account. Names must be unique. Click Check Availability to confirm the storage account name is unique.
    3. Choose the type of redundancy for your storage account: Geo-Redundant, Locally Redundant, or Read-Access Geo-Redundant.

       See Azure Storage redundancy in the Microsoft Azure documentation for a description of each redundancy option.

    4. Click create. When the storage account is created, click close to return to Deployment Options.
39. Click next to view a summary of your settings.
40. Review the settings in the Summary pane. If anything needs to be changed, click back to go to the page where you need to change the information.

    Tip:

    Click Save Summary to save your site configuration information to a text file so you can refer to it for information such as user names or machine names.

41. Click Generate Cost Estimate to calculate the approximate cost of the Azure infrastructure you will use in your deployment. When you finish generating the estimate, click close.

    This estimate does not include data storage costs.

42. Click Save Automation Artifacts to export an archive file (.zip file) containing information and files you can use in automation scripts to re-create this deployment.
    1. Browse to a location on the local disk where the archive file will be created and type a name for the file.
    2. Choose the type of automation format you will use.
    3. Click generate to create the file.
43. When all settings are correct and you have saved the files you need, click finish to create your ArcGIS Server site.
44. If you federated an ArcGIS Notebook Server, you must complete the following steps:
    1. Make a Remote Desktop connection to the ArcGIS Notebook Server machine on Azure.
    2. Install and configure Docker on your ArcGIS Notebook Server machine.
    3. Copy the ArcGIS Docker images to the ArcGIS Notebook Server machine and run the postinstallation utility.
45. If you federated an ArcGIS GeoEvent Server site, open Global Settings in ArcGIS GeoEvent Manager and set the REST Receiver Base URL to the external fully qualified domain name for the site (https://<fqdn>/).