Edit

Define and Configure an Application Request Routing Server Farm

  • Article

by IIS Team

Overview

This topic leads the reader through the steps to define and configure a server group for Application Request Routing (ARR) Version 1 on IIS 7.0 and above. The server farm is a logical group of application servers where HTTP requests are routed based on HTTP inspection rules and load balance algorithm.

Goal

To define and configure a server farm in Application Request Routing Version 1 on IIS as shown below:

Diagram of a server farm configuration involving an A R R 1 server group of two application servers.

Prerequisites

This walkthrough requires the following prerequisites:

  • IIS 7.0 or above on Windows 2008 (any SKU) or newer.
  • Microsoft Application Request Routing Version 1 and dependent modules.
  • Minimum of two application servers with working sites and applications.

Follow the steps outlined in this document to install Application Request Routing.

Step 1 – Create a server farm in Application Request Routing

To create and define a server farm using the UI:

  1. Launch IIS Manager.

  2. Application Request Routing is a server level feature. Select and expand the root of the server.

    Screenshot of an expanded A R R 1 root folder. in the I I S Manager.

  3. To create a server farm, right-click Server Farms, and then select Create Server Farm....

    Screenshot of right-clicking Server Farms to access Create Server Farm.

  4. Enter a name for the server farm. In the example below, myServerFarm is the name of the server farm. Click Next.

    Screenshot of the Create Server Farm dialog with a new online server farm named my Server Farm.

  5. The next step is to add servers to the server farm. On the Add Server page of the wizard, add as many application servers as needed. Click Finish to create the server farm with the entered application servers as the server farm members.

    Note

    Advanced options... allow you to configure the HTTP and HTTPS ports to non-standard (80 for HTTP and 443 for HTTPS) ports: Screenshot of viewing Advanced options in the Add Server dialog.

  6. You have successfully created a server group with application servers as its members.

To create and define a server farm using the command-line:

  1. Open a command prompt with administrator privileges.

  2. Navigate to %windir%\system32\inetsrv.

  3. To create the server farm named myServerFarm, enter:

    appcmd.exe set config  -section:webFarms /+"[name='myServerFarm']" /commit:apphost

  4. To add an application server named wonyoo-w2k8 to the server farm named myServerFarm, enter:

    appcmd.exe set config  -section:webFarms /+"[name='myServerFarm'].[address='wonyoo-w2k8']" /commit:apphost

    Repeat this command as many times as needed to add more servers to the server farm

  5. This step is only required when creating the server farm using appcmd. When creating the server farm using the UI, the URL rewrite rules are created automatically. With appcmd, the URL rewrite rules must be created manually. To route all incoming HTTP requests to the server farm named myServerFarm, enter:

    appcmd.exe set config  -section:system.webServer/rewrite/globalRules /+"[name='ARR_myServerFarm_loadbalance', patternSyntax='Wildcard',stopProcessing='True']" /commit:apphost

    appcmd.exe set config  -section:system.webServer/rewrite/globalRules /[name='ARR_myServerFarm_loadbalance',patternSyntax='Wildcard',stopProcessing='True'].match.url:"*"  /commit:apphost

    appcmd.exe set config  -section:system.webServer/rewrite/globalRules /[name='ARR_myServerFarm_loadbalance',patternSyntax='Wildcard',stopProcessing='True'].action.type:"Rewrite" /[name='ARR_myServerFarm_loadbalance',patternSyntax='Wildcard',stopProcessing='True'].action.url:"http://myServerFarm/{R:0}"  /commit:apphost

Step 2 – Configure server farm properties for Application Request Routing

After the server farm has been created and defined, additional properties can be set to manage the behavior of Application Request Routing. Only the subset of the settings is covered in this walkthrough.

To configure server farm properties using the UI:

  1. Select the server farm, myServerFarm. The following icons are shown:

    Screenshot of the default server farm icons that display after selecting a server farm.

  2. For this walkthrough, you will change the load balance algorithm that will be used for the server group, myServerFarm. Double-click Load Balance. Select Weighted round robin from the Load balance algorithm drop-down list, and then click Apply.

    Screenshot of the Load balance algorithm set to Weighted round robin and Load distribution set to Even distribution.

  3. ARR can be configured to send a GET request to a URL to determine the health of the servers. To configure this feature, double-click Health Test, and then type the URL that should be tested by ARR. Click Apply to save changes.

    Screenshot of the Health Test pane with the default options and no specified U R L in the U R L Test section.

  4. Explore other icons to familiarize yourself with ARR settings.

Summary

You have now successfully created and defined a server farm, myServerFarm. At this point, myServerFarm is configured to distribute the incoming requests evenly between the application servers that have been added as members of the server farm. For more advanced load balancing settings, refer to HTTP Load Balancing using Application Request Routing.