Setting up redundant origin servers

Sometimes you want to set up two different origin servers, one as a primary and one as a backup in case the primary becomes unavailable. You can do this via the web interface or using custom VCL.

Using the web interface

Set up redundant origins via the web interface using these steps.

1. Log in to the Fastly web interface.
2. From the Home page, select the appropriate service. You can use the search box to search by ID, name, or domain.
3. Click Edit configuration and then select the option to clone the active version.
4. Click Origins.

5. In the Health Checks area, define a health check and assign it to the primary origin server.

6. In the Hosts area, find your secondary origin server and click Attach a condition.

   

7. Click Create a new request condition.

   

8. Fill out the Create a new request condition fields as follows:

   • In the Name field, enter the name of your request condition (for example, Primary Unhealthy).
   • In the Apply if field, enter !req.backend.healthy.

9. Click Save and apply to. The Hosts area now displays the condition that must be met (Primary Unhealthy) in order for your secondary origin server to begin being used.

   

   Once you've added the condition to your secondary origin server, the VCL generated by Fastly will reflect the new condition.

10. Preview the VCL, and confirm the following snippets appear in vcl_recv:

    # default conditions
    set req.backend = F_primary;

    1
    2
    3
    4
    5

    # Request Condition: primary unhealthy Prio: 10
    if (!req.backend.healthy) {
      set req.backend = F_secondary;
    }
    #end condition

Using custom VCL

Set up redundant origins with custom VCL using these steps.

1. In the Fastly web interface, define a health check and assign it to the primary origin server.

2. Copy the boilerplate VCL from our guide on mixing Fastly VCL with custom VCL, and paste it into a new file.

3. Replace the vcl_recv sub with:

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11

   sub vcl_recv {
   #FASTLY recv
     set req.backend = F_<primary_origin>;
     if (!req.backend.healthy) {
       set req.backend = F_<secondary_origin>;
     }
     if (req.method != "HEAD" && req.method != "GET" && req.method != "FASTLYPURGE") {
       return(pass);
     }
     return(lookup);
   }

   To find the exact backend names, view the generated VCL.

4. Upload your VCL file.