mitchell852 closed pull request #1870: Remove old references to mso algorithm
URL: https://github.com/apache/incubator-trafficcontrol/pull/1870
This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:
As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):
diff --git
a/docs/source/admin/quick_howto/D22DCAA3-18CC-48F4-965B-5312993F9820.png
b/docs/source/admin/quick_howto/D22DCAA3-18CC-48F4-965B-5312993F9820.png
deleted file mode 100644
index 59d5b8e7e5..0000000000
Binary files
a/docs/source/admin/quick_howto/D22DCAA3-18CC-48F4-965B-5312993F9820.png and
/dev/null differ
diff --git a/docs/source/admin/quick_howto/mso-enable.png
b/docs/source/admin/quick_howto/mso-enable.png
index 9932de15f7..70207bafe1 100644
Binary files a/docs/source/admin/quick_howto/mso-enable.png and
b/docs/source/admin/quick_howto/mso-enable.png differ
diff --git a/docs/source/admin/quick_howto/mso-rank.png
b/docs/source/admin/quick_howto/mso-rank.png
deleted file mode 100644
index de80ac5c14..0000000000
Binary files a/docs/source/admin/quick_howto/mso-rank.png and /dev/null differ
diff --git a/docs/source/admin/quick_howto/multi_site.rst
b/docs/source/admin/quick_howto/multi_site.rst
index bd4807dcfb..270efc2487 100644
--- a/docs/source/admin/quick_howto/multi_site.rst
+++ b/docs/source/admin/quick_howto/multi_site.rst
@@ -57,45 +57,12 @@ Configure Multi Site Origin
4) This OFQDN must be valid - ATS will perform a DNS lookup on this
FQDN even if IPs, not DNS, are used in the parent.config.
5) The OFQDN 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.
-6) Select an option from the "Multi Site Origin Algorithm" drop-down list.
Four MSO algorithms are supported:
-
-+------------------+--------------------------------------------------------------------------------------------------------------------+
-| Option |
Description |
-+==================+====================================================================================================================+
-| Consistent hash | Origin server selection is based on the consistent hash
of requested URLs. |
-+------------------+--------------------------------------------------------------------------------------------------------------------+
-| Primary/back | Round robin selection does not occur. The first origin
server is selected unless it fails. |
-| | If the first fails, the second and other following origin
servers will be tried by order. |
-| | Order is defined by 2 factors - if the origin server's
cachegroup is configured as the |
-| | parent cachegroup for the mid, then this server will be
used as the primary. The same rules |
-| | apply for secondary parents, in order. Within the
cachegroups, the rank parameter will sort |
-| | order further. If no parents are defined at the mid, then
only rank is considered. |
-+------------------+--------------------------------------------------------------------------------------------------------------------+
-| Strict | MID caches serve requests strictly in turn. For example:
origin server 1 serves the first request, |
-| round-robin | origin server 2 serves the second request, and so on.
|
-+------------------+--------------------------------------------------------------------------------------------------------------------+
-| IP based | MID cache goes through the origin server list in a round
robin-based on the IP address of EDGE cache. |
-| round-robin |
|
-+------------------+--------------------------------------------------------------------------------------------------------------------+
-
-7) Optionally, there are two configuration options that can set the order of
the origins used if "Primary/backup" is selected for "Multi Site Origin
Algorithm". By creating location-based cachegroups and assigning the origin
servers accordingly and defining these cachegroups as parents for specific
mids, location-based primary/secondary selection can be made. If
primary/secondary selection should be the same for all mids, then a new
parameter ?rank? should be configured for each origin server profile. Origin
servers with lower values of rank have higher ranking in the origin server list
on MID caches, e.g. OS with rank of "2" precedes OS with the rank of "5". For
any OS, if rank value is not defined in its profile, its rank value will
default to ?1?. In the event that both location based cachegroups are used
alongside rank, sorting will be by cachegroup first and rank second. In this
way it is possible to have specific backup servers for use at specific
locations.
-
-.. image:: mso-rank.png
- :scale: 60%
- :align: center
-
-8) Assign the parent.config location parameter to the MID profile:
-
-.. image:: D22DCAA3-18CC-48F4-965B-5312993F9820.png
- :scale: 100%
- :align: center
-
-9) For ATS 5.x, configure the mid hdr_rewrite on the delivery service,
example: ::
+6) For ATS 5.x, configure the mid hdr_rewrite on the delivery service,
example: ::
cond %{REMAP_PSEUDO_HOOK} __RETURN__ set-config
proxy.config.http.parent_origin.dead_server_retry_enabled 1 __RETURN__
set-config proxy.config.http.parent_origin.simple_retry_enabled 1 __RETURN__
set-config proxy.config.http.parent_origin.simple_retry_response_codes
"400,404,412" __RETURN__ set-config
proxy.config.http.parent_origin.dead_server_retry_response_codes "502,503"
__RETURN__ set-config proxy.config.http.connect_attempts_timeout 2 __RETURN__
set-config proxy.config.http.connect_attempts_max_retries 2 __RETURN__
set-config proxy.config.http.connect_attempts_max_retries_dead_server 1
__RETURN__ set-config proxy.config.http.transaction_active_timeout_in 5 [L]
__RETURN__
-10) 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
<https://docs.trafficserver.apache.org/en/6.2.x/admin-guide/files/parent.config.en.html>`
for more details. These parameters are now handled by the creation of a
delivery service profile.
+7) 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
<https://docs.trafficserver.apache.org/en/6.2.x/admin-guide/files/parent.config.en.html>`
for more details. These parameters are now handled by the creation of a
delivery service profile.
a) Create a profile of the type DS_PROFILE for the delivery service in
question.
@@ -114,8 +81,17 @@ b) Click "Show profile parameters" to bring up the
parameters screen for the pro
| mso.parent_retry | parent.config | simple_retry,
both, | parent_retry |
| | |
unavailable_server_retry | |
+----------------------------------------+------------------+--------------------------+-------------------------+
-| mso.unavailable_server_retry_responses | parent.config | list of server
response | |
-| | | codes, eg
"500,502,503" | |
+| mso.unavailable_server_retry_responses | parent.config | list of server
response | defaults to the value |
+| | | codes, eg
"500,502,503" | in records.config |
+| | |
| when unused. |
++----------------------------------------+------------------+--------------------------+-------------------------+
+| mso.max_simple_retries | parent.config | Nubmer of
retries made | defaults to the value |
+| | | after a 4xx
error | in records.config |
+| | |
| when unused. |
++----------------------------------------+------------------+--------------------------+-------------------------+
+| mso.max_unavailable_server_retries | parent.config | Nubmer of
retries made | defaults to the value |
+| | | after a 5xx
error | in records.config |
+| | |
| when unused. |
+----------------------------------------+------------------+--------------------------+-------------------------+
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
With regards,
Apache Git Services
