arcgis-workflow-manager cookbook #

This cookbook installs and configures ArcGIS Workflow Manager Server.

Supported ArcGIS Workflow Manager Server versions #

• 10.9.1
• 11.0
• 11.1
• 11.2
• 11.3
• 11.4
• 11.5

Supported ArcGIS software #

• ArcGIS Workflow Manager Server

Platforms #

• Microsoft Windows Server 2019 Standard and Datacenter
• Microsoft Windows Server 2022 Standard and Datacenter
• Ubuntu Server 20.04 LTS
• Ubuntu Server 22.04 LTS
• Ubuntu Server 24.04 LTS
• Red Hat Enterprise Linux Server 8
• Red Hat Enterprise Linux Server 9
• SUSE Linux Enterprise Server 15
• Oracle Linux 8
• Oracle Linux 9
• Rocky Linux 8
• Rocky Linux 9
• AlmaLinux 9

Dependencies #

The following cookbooks are required:

• arcgis-enterprise
• arcgis-repository

Attributes #

• node['arcgis']['workflow_manager_server']['setup_archive'] = Path to the ArcGIS Workflow Manager Server setup archive. Default value depends on the node['arcgis']['version'] attribute value.
• node['arcgis']['workflow_manager_server']['setup'] = The location of the ArcGIS Workflow Manager Server setup executable. Default location is %USERPROFILE%\Documents\ArcGIS11.5\WorkflowManagerServer\Setup.exe on Windows and /opt/arcgis/10.9/WorkflowManagerServer/Setup.sh on Linux.
• node['arcgis']['workflow_manager_server']['authorization_file'] = ArcGIS Workflow Manager Server authorization file path. Default value is set to the value of node['arcgis']['server']['authorization_file']
• node['arcgis']['workflow_manager_server']['authorization_file_version'] = ArcGIS Workflow Manager Server authorization file version. Default value is node['arcgis']['server']['authorization_file_version'].
• node['arcgis']['workflow_manager_server']['authorization_options'] = Additional ArcGIS Workflow Manager Server software authorization command line options. Default options are ''.
• node['arcgis']['workflow_manager_server']['ports'] = Ports used by ArcGIS Workflow Manager Server. Default ports are 9820,9830,9840,9880,13443,13820,13830,13840.
• node['arcgis']['workflow_manager_server']['patches] = File names of ArcGIS Workflow Manager Server patches to install. Default value is [].
• node['arcgis']['workflow_manager_server']['distributed_data_provider] = If set to true, distributed data provider module is enabled. Default value is false.

Recipes #

default #

Calls the arcgis-workflow-manager::server recipe.

federation #

Federates ArcGIS Workflow Manager Server with an ArcGIS Enterprise portal and enables the Workflow Manager Server function.

Attributes used by the recipe:

{
    "arcgis": {
        "portal": {
            "private_url": "https://portal.domain.com:7443/arcgis",
            "admin_username": "admin",
            "admin_password": "changeit",
            "root_cert": "",
            "root_cert_alias": ""
        },
        "server": {
            "web_context_url": "https://domain.com/server",
            "private_url": "https://domain.com:6443/arcgis",
            "admin_username": "admin",
            "admin_password": "changeit",
            "is_hosting": true
        }
    },
    "run_list": [
        "recipe[arcgis-workflow-manager::federation]"
    ]
}

install_server #

Installs ArcGIS Workflow Manager Server.

Attributes used by the recipe:

{
  "arcgis": {
    "version": "11.5",
    "run_as_user": "arcgis",
    "run_as_password": "<password>",
    "configure_windows_firewall": true,
    "repository": {
      "setups": "C:\\Software\\Setups"
    },
    "server": {
      "install_dir": "C:\\Program Files\\ArcGIS\\Server",
      "install_system_requirements": true
    },
    "workflow_manager_server": {
      "setup": "C:\\Software\\Setups\\ArcGIS11.5\\WorkflowManagerServer\\Setup.exe",
      "ports": "9830,9820,9840,9880,13443"      
    }
  },
  "run_list": [
    "recipe[arcgis-workflow-manager::install_server]"
  ]
}

install_patches #

Installs patches for ArcGIS Workflow Manager Server. The recipe installs patches from the patches folder specified by the arcgis.notebook_server.patches attribute. The patch names may contain a wildcard ‘*’. For example, “ArcGIS-1091-*.msp” specifies all .msp patches that start with “ArcGIS-1091-“.

Attributes used by the recipe:

{
  "arcgis" : {
    "repository" : {
      "patches" : "%USERPROFILE%\\Software\\Esri\\patches"
    },
    "workflow_manager_server": {
      "patches": ["patch1.msp", "patch2.msp"]
    }
  },
  "run_list": [
    "recipe[arcgis-workflow-manager::install_patches]"
  ]
}

server #

Installs and authorizes ArcGIS Workflow Manager Server.

Attributes used by the recipe:

{
  "arcgis": {
    "version": "11.5",
    "run_as_user": "arcgis",
    "run_as_password": "<password>",
    "configure_windows_firewall": true,
    "repository": {
      "setups": "C:\\Software\\Setups"
    },
    "server": {
      "install_dir": "C:\\Program Files\\ArcGIS\\Server",
      "install_system_requirements": true
    },
    "workflow_manager_server": {
      "setup": "C:\\Software\\Setups\\ArcGIS11.5\\WorkflowManagerServer\\Setup.exe",
      "authorization_file": "C:\\Software\\AuthorizationFiles\\11.5\\Workflow_Manager_Server.prvc",
      "authorization_file_version": "11.5",
      "ports": "9830,9820,9840,9880,13443"      
    }
  },
  "run_list": [
    "recipe[arcgis-workflow-manager::server]"
  ]
}

uninstall_server #

Uninstalls ArcGIS Workflow Manager Server.

{
  "arcgis": {
    "version": "11.5",
    "run_as_user": "arcgis",
    "server": {
      "install_dir": "C:\\Program Files\\ArcGIS\\Server"
    }
  },
  "run_list": [
    "recipe[arcgis-workflow-manager::uninstall_server]"
  ]
}