ADC

Redirect client requests to an alternate URL

October 8, 2023

Contributed by:

C S

You can redirect requests to an alternate URL by using an HTTP 302 redirect if a load balancing virtual server of type HTTP or HTTPS goes DOWN or is disabled. The alternate URL can provide information about the status of the server. The configured redirect URL is specified in the location header of the HTTP response. The exact URL specified in the response depends on the following configuration options:

If the configured redirect URL contains only the domain name, such as http://www.sample1.example.com, the redirect URL specified in the HTTP response appends the Uniform Resource Identifier (URI). It is specified in the HTTP request to the configured domain name. For example, if the request contains the GET http://www.sample2.example.com/images/site_nav.gif header, then the location header in the redirect response specifies the location: http://www.sample1.example.com/images/site_nav.gif header.

Note

The domain names in the request and response can differ. In this topic, the two domains are referred to as sample1.example.com and sample2.example.com to explain the concept.
If the configured redirect URL contains a complete path, then the redirect response specifies the complete configured URL, irrespective of the URI in the request. For example, the following are such URLs:
- Requested URL - http://www.redirect.com/en/index.html
- Redirect URL - http://www.redirect.com/en/site_down.html

The following table lists the preceding configuration options:

Configured Redirect URL	URL in HTTP Request	Header in HTTP Response
http://www.sample1.example.com	http://www.sample2.example.com/en/index.html	http://www.sample1.example.com/en/index.html
http://www.sample1.example.com/en/error.html	http://www.sample2.example.com/en/index.html	http://www.sample1.example.com/en/error.html

Note

When configuring a redirect URL, the http://example.com URL is not the same as the http://example.com/ URL, because the latter contains the complete path to the Webroot path, /.

If a load balancing virtual server is configured with both a backup virtual server and a redirect URL, the backup virtual server takes precedence over the redirect URL. A redirect is used only when both the primary and backup virtual servers are DOWN.

To configure a virtual server to redirect the client request to a URL by using the CLI

Create a load balancing virtual server.

set lb vserver -redirect url
Verify that the redirect URL option is working as expected. Disable the virtual server.

disable vserver <vserver_name>
Access the website URL from a web browser to verify that the request is redirected as expected. You might have to clear the web browser cache and make a new connection before accessing the website.
Enable virtual server.

enable vserver <vserver_name>

To configure a virtual server to redirect the client request to a URL by using the GUI

Navigate to Traffic Management > Load Balancing > Virtual Servers.
In the details pane, to add a new virtual server, click Add.
To edit an existing virtual server, select the virtual server from the list and click Edit.
On the Advanced Settings tab, click Protection. In the Redirect URL field, type the redirect URL (for example, http://www.newdomain.com/mysite/maintenance).
Click OK.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Redirect client requests to an alternate URL

October 8, 2023

Contributed by:

C S

October 8, 2023

Contributed by:

C S

Redirect client requests to an alternate URL

To configure a virtual server to redirect the client request to a URL by using the CLI

To configure a virtual server to redirect the client request to a URL by using the GUI

In this article