InstallMapserviceTool - merkator-software/GaiaBuilder-manual GitHub Wiki

Run the InstallMapserviceTool from the command line using Propy.bat from the ArcGIS Pro or ArcGIS Server installation directory:

"C:\miniconda3\envs\gaiabuilder\python.exe" InstallMapservice_lite.py -f <serviceDefinition> -s <server> -m true/false -q true/false -c true/false -h true/false -d true/false -i true/false -a true/false -r true/false -z true/false -j <BuildNumber> -g <Revision>

Command line parameters

The following parameters are used as input to the script:

  • -f / serviceDefinition= Required, json file containing the Mapservice configuration
  • -s / server= Required, server configuration to use from json and global ini file
  • -u / user= Optional, Portal build in username with publisher rights. Use the USER Environment variable to pass the username from the build server to GaiaBuilder
  • -p / password= Optional, Portal build in user password. Use the PASSWORD Environment variable to pass the username from the build server to GaiaBuilder
  • -r / replaceDatasources= Optional default true, true/false, should the database connections or FGDB connections be updated to match the server database connection
  • -m / mapximport= Optional, default false, true imports the mapx file specified in the json under mapx into an empty ArcGIS Pro project
  • -q / mapxrestore= Optional, default false, true restores the json file specified in the json under mapxjson to a Mapx file. Use -q true with -m true and -r false
  • -c / createSDFile= Optional default true, true/false, should a .SD service definition file be created
  • -h / stopService= Optional default true, true/false, should the service be stopped
  • -d / deleteService= Optional default false, true/false, should the service be deleted. Deleting the service will also remove the relatedItems from ArcGIS Enterprise
  • -i / installService= Optional default true, true/false, should the .SD service definition be published to the server, requires -c option or existing .SD file in the PUB directory
  • -a / configureService= Optional default true, true/false, should mapservice be configured with the settings from the json file
  • -z / startService= Optional default true, true/false, should the service be started
  • -t Optional default false, true/false, create or update the tile cache
  • -j / buildnumber= Optional default empty, the build number from the buildserver
  • -g / revision= Optional default empty, the git revision number if a git repository is used

Environment variables

  • USER : the Portal Build-in User username
  • PASSWORD : the Portal Build-in User password TARGET_USER : the Portal or ArcGIS Online Build-in User username of the target environment, used when the system preparing the Service Definition file is different from the system hosting the service created from the SD TARGET_PASSWORD : the Portal or ArcGIS Online Build-in User username of the target environment
  • API_KEY : API Key on ArcGIS Enterprise 11.5 or ArcGIS Online. This is an alternative to user/password sign in and no build-in user credentials have to be used
  • TARGET_API_KEY : API Key on ArcGIS Enterprise 11.5 or ArcGIS Online. This is an alternative to TARGET user/password sign in and no build-in user credentials have to be used on the target environment
⚠️ **GitHub.com Fallback** ⚠️