Configure Multi-Site Origin

The following steps will take you through the procedure of setting up an MSO. #. Create Cache Groups for the origin locations, and assign the appropriate parent-child relationship between the Mid-tier Cache Group(s) and origin Cache Groups. Each Mid-tier Cache Group can be assigned a primary and secondary origin parent Cache Group. When the Cache Group parent configuration is generated, origins in the primary Cache Groups will be listed first, followed by origins in the secondary Cache Group. Origin servers assigned to the Delivery Service that are assigned to neither the primary nor secondary Cache Groups will be listed last.

../../_images/002.png
  1. Create a profile to assign to each of the origins:

    ../../_images/014.png
  2. Create server entries for the origination vips:

    ../../_images/024.png
  3. Check the multi-site check box in the Delivery Servicescreen:

    ../../_images/mso-enable.png
  4. Assign the org servers to the Delivery Service that will have the multi site feature. Origin servers assigned to a Delivery Service with multi-site checked will be assigned to be the origin servers for this Delivery Service.

    ../../_images/034.png

    Note

    “Origin Server Base URL” uniqueness: In order to enable Mid-tier Cache Group to distinguish Delivery Services by different MSO algorithms while performing parent fail-over, it requires that OSBU for each MSO-enabled Delivery Service is unique. This means that the OSBU of an MSO-enabled Delivery Serviceshould be different from the OSBUs of any other Delivery Service, regardless of whether they are MSO-enabled or not. The exceptions to this rule are:

    • If there are multiple CDNs created on the same Traffic Ops, Delivery Services across different CDNs may have the same OSBU configured.
    • If several Delivery Services in the same CDN have the same MSO algorithm configured, they may share the same OSBU.
    • If delivery services are assigned with different Mid-tier Cache Groups respectively, they can share the same OSBU.
    • This OSBU must be valid - ATS will perform a DNS lookup on this FQDN even if IPs, not DNS, are used in the parent.config.
    • The OSBU entered as the “Origin Server Base URL” will be sent to the origins as a host header. All origins must be configured to respond to this host.
  5. Create a delivery service profile. This must be done to set the MSO algorithm. Also, as of ATS 6.x, multi-site options must be set as parameters within the parent.config. Header rewrite parameters will be ignored. See ATS parent.config for more details. These parameters are now handled by the creation of a Delivery Service profile.

    1. Create a profile of the type DS_PROFILE for the Delivery Service in question.

      ../../_images/ds_profile.png
    2. Click Show profile parameters to bring up the parameters screen for the profile. Create parameters for the following:

      Parameter Name Config File Name Value ATS parent.config value
      mso.algorithm parent.config true, false, strict, consistent_hash round_robin
      mso.parent_retry parent.config simple_retry, both, unavailable_server_retry parent_retry
      mso.unavailable_server_retry_responses parent.config list of server response codes, eg “500,502,503” defaults to the value in records.config when unused.
      mso.max_simple_retries parent.config Nubmer of retries made after a 4xx error defaults to the value in records.config when unused.
      mso.max_unavailable_server_retries parent.config Nubmer of retries made after a 5xx error defaults to the value in records.config when unused.
      ../../_images/ds_profile_parameters.png
    3. In the Delivery Service page, select the newly created DS_PROFILE and save the Delivery Service.

  6. Turn on parent_proxy_routing in the MID profile.

Note

Support for multisite configurations with single-layer CDNs is now available. If a Cache Groups defined parents are either blank or of the type ORG_LOC, that cache server’s parent.config will be generated as a top layer cache, even if it is an edge. In the past, parent.config generation was strictly determined by cache type. The new method examines the parent Cache Group definitions and generates the parent.config accordingly.