iis-lb

This cookbook configures IIS as a simple web load-balancer by creating an IIS Server Farm. It also allows you to add servers to the farm by passing a node['iis-lb']['members'] hash.

DISCLAIMER

This cookbook helps demonstrate the wrapper-cookbook pattern, attribute precedence and search in Chef Essentials training for Windows. This cookbook does NOT describe the definitive pattern for configuring IIS as a web load-balancer. Use at your own risk.

Platforms

This cookbook was tested on:

• Windows Server 2012 R2

Usage

default

Add recipe[iis-lb::default] to your Windows Server's run_list to install the necessary components and create an IIS Server Farm myServerFarm. This will also add two servers to the Server Farm, based on the node['iis-lb']['members'] hash. One should override this hash to add their own servers to the farm, such as in this example wrapper recipe:

node.default['iis-lb']['members'] = [
  {
    'address' => 'localhost',
    'weight' => 100,
    'port' => 4000,
    'ssl_port' => 4000
  },
  {
    'address' => '127.0.0.1',
    'weight' => 100,
    'port' => 4001,
    'ssl_port' => 4001
  }]

include_recipe 'iis-lib::default'

_arr

The recipe[iis-lb::_arr] will install Application Request Router (ARR) 3.0 using Microsoft Web Platform Installer (webpi).

Resources

iis_lb_farm

Creates an IIS Server Farm, sets its load-balancing algorithm and creates the necessary URL rewrite rules.

Actions

default = :create

• :create - creates the server farm, load balancing algorithm and the URL rewrite rules.
• :remove - removes the server farm with all its servers and URL rewrite rules.

Attribute Parameters

• farm_name - the name of the Server Farm.
• algorithm - sets the Server Farm's Load Balancing algorithm. Default is WeightedRoundRobin, Valid Values are: 'WeightedRoundRobin', 'LeastRequests', 'LeastResponseTime', 'WeightedTotalTraffic', 'RequestHash'

Example

# creates a Server Farm called SuperDuperFarm with lb algorithm LeastRequests
iis_lb_farm 'SuperDuperFarm' do
  action :create
  algorithm 'LeastRequests'
end

# removes a Server Farm called SuperDuperFarm
iis_lb_farm 'SuperDuperFarm' do
  action :remove
end

iis_lb_server

Adds a server to a Server Farm.

Actions

default = :add

• :add - adds a server to a server farm. If the specified farm does not exist, it will be created automagically. If the farm is not specified then servers get added to a new myServerFarm.
• :remove - removes a server from a server farm. If the farm is not specified, the server is removed from myServerFarm.

Attribute Parameters

• server_address - name attribute. Specifies IP or FQDN of a server to add to the farm.
• farm - The name of the IIS Server Farm to add the server to. Default is myServerFarm
• weight - Relative weight for Weighted Round Robin load distribution. Default is 100
• port - HTTP port that the server is listening on. Default is 80
• ssl_port - HTTPS port that the server is listening on. Default is 443

Example

# adds server webserver.superdomain.internal, with http/https ports of 8080/4443, to SuperDuperFarm
iis_lb_server 'webserver.superdomain.internal' do
  port 8080
  ssl_port 4443
  farm 'SuperDuperFarm'
  action :add
end

# removes the Server Farm called SuperDuperFarm
iis_lb_server 'webserver.superdomain.internal' do
  farm 'SuperDuperFarm'
  action :remove
end

Dependencies

This cookbook depends on the following Community Cookbooks:

• webpi
• iis