Esri / arcgis-powershell-dsc

This repository contains scripts, code and samples for automating the install and configuration of ArcGIS (Enterprise and Desktop) using Microsoft Windows PowerShell DSC (Desired State Configuration).
Apache License 2.0
113 stars 61 forks source link

Variable Documentation Improvement for FileShareLocalPath & ExternalFileSharePath + ServerRole #315

Closed runneals closed 3 years ago

runneals commented 3 years ago

Looking at the Variables page: https://github.com/Esri/arcgis-powershell-dsc/wiki/V3.-Variables-reference-page-for-JSON-configuration-files the FileShareLocalPath & ExternalFileSharePath under DataStoreItems > RasterStore need to be better defined. Do you need both?

Also is it possible to assign more than 1 ServerRole? Looking at our raster analytics, it was assigned both: GeneralPurposeServer,RasterAnalytics

cameronkroeker commented 3 years ago

Hi @runneals ,

If you'd like the DSC to create the RasterStore file share then specify both ConfigData.DataStoreItems.FileShareName and ConfigData.DataStoreItems.FileShareLocalPath otherwise if you have an existing file share then use ConfigData.DataStoreItems.ExternalFileSharePath.

You can only define one Config.ServerRole per json file. The Config.ServerRole does a couple of things. It helps the DSC determine which kind of Server is going to be installed/configured, for example: ArcGIS Server, ArcGIS Mission Server, ArcGIS Notebook Server, ArcGIS GeoEvent Server, etc. And it will also determine which Server Function gets set during federation.

If both GeneralPurposeServer, and RasterAnalytics are set as the Server Function for federation, then was this manually set or was it done by DSC?

If two json files were ran for the same Server. For example:

  1. https://github.com/Esri/arcgis-powershell-dsc/blob/master/SampleConfigs/v3/Gis%20Servers/GISServer-GeneralPurpose.json
  2. https://github.com/Esri/arcgis-powershell-dsc/blob/master/SampleConfigs/v3/Gis%20Servers/GISServer-RasterAnalytics-fileshare.json

or perhaps

  1. https://github.com/Esri/arcgis-powershell-dsc/blob/master/SampleConfigs/v3/Base%20Deployment/BaseDeployment-SingleMachine.json
  2. https://github.com/Esri/arcgis-powershell-dsc/blob/master/SampleConfigs/v3/Gis%20Servers/GISServer-RasterAnalytics-fileshare.json

In this scenario, my understanding is when the first json is ran DSC will set the Server Function to GeneralPurposeServer, then when the second json file is ran it will update the Server Function to RasterAnalytics.

Thanks, Cameron K.

cameronkroeker commented 3 years ago

The wiki has been updated.