This workflow guides you through the first-time installation of an ArcGIS Image Server site on a single machine, for the purposes of raster analytics.

ArcGIS Image Server includes distributed raster analysis and distributed image processing. ArcGIS Image Server distributed analytics can work with a single large raster dataset, such as world elevation, or a high resolution satellite image. It can also be applied to massive collections of imagery. Raster analysis provides scalable distributed processing for large image and raster collections, including your existing GIS and imagery data. With the ArcGIS Enterprise portal, you can use built-in raster analysis tools to process and create new persisted layers, which can be made available as image and feature web layers.

When the PowerShell DSC for ArcGIS module is finished, your machine will have the ArcGIS Server software installed, configured and licensed as a raster analytics Image Server, and federated with the ArcGIS Enterprise portal you specify. You need to have a network file share that will host the directories for this server.

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 Server. You should have PowerShell DSC, 7-Zip, and administrative authority on each machine.

Caution: The PowerShell DSC for ArcGIS module uses 7-Zip; if the tool is not already installed on the machine, the module will attempt to download and install it. This may be blocked by your firewall, so it's best to have the tool already installed on the machine before you begin.

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 Server software installation file and license to the machine.

Option 2: Prepare your deployment using the PowerShell Gallery

1. Log in to my.esri.com. Download your ArcGIS Server software installation file and license.
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 GISServer-RasterAnalytics-fileshare.json file from the SampleConfigs folder of the arcgis-powershell-dsc repository 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 Configure-ArcGIS cmdlet and provide the path to the configuration file as an input parameter. Mode and Credential are optional arguments.

 Configure-ArcGIS -ConfigurationParametersFile [Path to Configuration json File](/Esri/arcgis-powershell-dsc/wiki/Path-to-Configuration-json-File) -Mode [Install | InstallLicense | InstallLicenseConfigure | Uninstall | Upgrade] -Credential [Config RunAs - Optional]

or

Configure-ArcGIS [Path to Configuration json File](/Esri/arcgis-powershell-dsc/wiki/Path-to-Configuration-json-File) [Install | InstallLicense | InstallLicenseConfigure | Uninstall | Upgrade] -Credential [Config RunAs - Optional]