Register an Enterprise Geodatabase with ArcGIS Server site - Esri/arcgis-powershell-dsc GitHub Wiki
This workflow guides you through the first time installation of an ArcGIS Server site with a registered Enterprise Geodatabase.
When the PowerShell DSC for ArcGIS module is finished, your machine will have the following components installed and configured:
- An ArcGIS Server, with a registered Enterprise Geodatabase, that is federated with an existing ArcGIS Enterprise portal
- SQL Server Client (Microsoft ODBC Driver 17 for SQL Server) installed on same node as ArcGIS Server
- SQL Server
Prerequisites
- Microsoft ODBC Driver 17 for SQL Server installation file (msodbcsql_17.4.1.1_x64.msi)
- Existing ArcGIS Enterprise 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 using Windows Management Framework 5.x for the best experience.
Log in to the machine(s) on which you'll be installing. You should have administrative authority on the machine.
Use one of the following options to prepare the files either through GitHub or using the PowerShell Gallery:
Option 1: Prepare your deployment using GitHub
- Clone this repository to your local machine.
- Add the "ArcGIS" modules folder to your
PsModulePath
, or copy the modules into the default PowerShell Modules folder (For example,C:\Program Files\WindowsPowerShell\Modules
). - Log in to My Esri. Download your ArcGIS Server software installation files and licenses to the machine.
Option 2: Prepare your deployment using the PowerShell Gallery
- Log in to my.esri.com. Download your ArcGIS Server software installation files and licenses to the machine.
- In a PowerShell cmdlet use the command
Install-Module arcgis
to install the ArcGIS module from the PowerShell Gallery. - Download the
SampleConfigs
files from the GitHub repository.
Edit the configuration file
- Open the GISServer-Database.json file from the SampleConfigs folder on your local machine.
- 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](/Esri/arcgis-powershell-dsc/wiki/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](/Esri/arcgis-powershell-dsc/wiki/Path-to-Configuration-json-File) [Install | InstallLicense | InstallLicenseConfigure | Uninstall | Upgrade] -Credential [Config RunAs - Optional] -MappedDriveOverrideFlag [$True | $False] -DebugSwitch