esri-iis Cookbook #

This cookbook enables IIS, installs features required by ArcGIS Web Adaptor (IIS), configures HTTPS, and starts IIS.

Platforms #

• Windows 7
• Windows 8 (8.1)
  • 8.1 requires .Net Framework 3.5 (See ms_dotnet cookbook README)
• Windows 10
  • requires .Net Framework 3.5 (See ms_dotnet cookbook README)
• Windows Server 2008 (R2)
• Windows Server 2012 (R2)
• Windows Server 2016
• Windows Server 2019
• Windows Server 2022

Dependencies #

The following cookbooks are required:

• openssl
• windows

Attributes #

• node['arcgis']['iis']['domain_name'] = Domain name used for generating a self-signed SSL certificate. By default, <node FQDN> is used.
• node['arcgis']['iis']['keystore_file'] = Path to PKSC12 keystore file (.pfx) with server SSL certificate for IIS. Default value is nil.
• node['arcgis']['iis']['keystore_password'] = Password for keystore file with server SSL certificate for IIS. Default value is nil.
• node['arcgis']['iis']['web_site'] = IIS web site to configure. Default value is Default Web Site.
• node['arcgis']['iis']['replace_https_binding'] = If false, the current HTTPS binding is not changed if it is already configured. Default value is false.
• node['arcgis']['iis']['features'] = An array of Windows features to be installed with IIS. Default value depends on Windows version.

Recipes #

esri-iis::default #

Enables IIS features required by ArcGIS Web Adaptor (IIS) and configures HTTPS binding.

esri-iis::install #

Enables IIS features required by ArcGIS Web Adaptor (IIS).

Usage #

Include esri-iis in your node’s run_list:

{
  "arcgis": {
    "iis": {
      "domain_name": "domain.com",
      "keystore_file" : "C:\\domain_com.pfx",
      "keystore_password": "test",
      "web_site": "Default Web Site",
      "replace_https_binding": false
    }
  },
  "run_list": [
    "recipe[esri-iis]"
  ]
}