Create a base ArcGIS Enterprise deployment on one machine

This workflow guides you through the first-time installation of a base ArcGIS Enterprise deployment on a single machine. When the PowerShell DSC for ArcGIS module is finished, your machine will have the following components installed and configured:

• One ArcGIS Server instance configured as your hosting server
• An ArcGIS Enterprise portal, powered by the Portal for ArcGIS software
• One ArcGIS Data Store configured to handle relational 2D data
• Two ArcGIS Web Adaptors, one each for the server and the portal

Prepare your deployment

Before you run the command to the module in PowerShell DSC, you’ll need to obtain the necessary files and resources and add them to your local machine.

Note: We recommend you use WMF 5.x for the best experience.

Log in to the machine on which you'll be installing ArcGIS Enterprise. You should have administrative authority on the machine.

You can prepare the files either through GitHub or using the PowerShell Gallery:

Option 1: Prepare your deployment using GitHub

1. Clone this repository to your local machine.
2. Add the "ArcGIS" modules folder to your PsModulePath, or copy the modules into the default PowerShell Modules folder (e.g. C:\Program Files\WindowsPowerShell\Modules).
3. Log in to My Esri. Download your ArcGIS Enterprise software installation files and licenses to the machine.

Option 2: Prepare your deployment using the PowerShell Gallery

1. Log in to my.esri.com. Download your ArcGIS Enterprise software installation files and licenses.
2. Install the ArcGIS module using the command Install-Module arcgis.
3. Download the SampleConfigs files from the GitHub repository.

Edit the configuration file

1. Open the BaseDeployment-SingleMachine.json file from the SampleConfigs folder on your local machine.
2. Replace the placeholder variables in brackets with your deployment properties and parameters. Refer to the Variables reference page for a full list.

Install your deployment

In PowerShell DSC, run the Invoke-ArcGISConfiguration cmdlet and provide the path to the configuration file as an input parameter. Mode, Credential, DebugSwitch and MappedDriveOverrideFlag are optional arguments.

Invoke-ArcGISConfiguration -ConfigurationParametersFile [[Path to Configuration JSON File]] -Mode [Install | InstallLicense | InstallLicenseConfigure | Uninstall | Upgrade] -Credential [Config RunAs - Optional] -MappedDriveOverrideFlag [$True | $False] -DebugSwitch

or

Invoke-ArcGISConfiguration [[Path to Configuration json File]] [Install | InstallLicense | InstallLicenseConfigure | Uninstall | Upgrade] -Credential [Config RunAs - Optional] -MappedDriveOverrideFlag [$True | $False] -DebugSwitch