Routing rules configuration

Use this topic to create the advanced configuration routing rules to ensure that work requests arrive at the proper generic server cluster. To view this console page, click Servers > Server Types > WebSphere proxy servers > proxy_server_name > Proxy Server Properties > Routing Rules > rule_name.

We can edit routing rules configurable field settings on the Configuration tab.

Name

The name field is required and is a user-defined field.

The name field cannot contain the following characters: # \ / , : ; " * ? < > | = + & % '

The name defined must be unique among routing rules and cannot begin with a period or a space. A space does not generate an error, but leading and trailing spaces are automatically deleted.

Enable this rule

We can create routing rules and then not enable them. This capability is useful when planning for the maintenance of nodes or emergencies.

By default, the rule is enabled.

Virtual host name

The virtual host name field is a selectable field that is preconfigured with the defined virtual hosts in the cell.

If we do not see the virtual host that you are looking for in the menu, click Environment > Virtual Hosts from the console and define the virtual host there.

URI group

The URI group field is populated with all the preconfigured URI groups in the cell.

If we do not see the URI group that you are looking for, click Environment > URI Groups and create one.

Route action

This option specifies to the proxy server how to route a request that matches the given criteria (virtual host and URI group) definedd. You have three options for this field.

Generic Server Cluster: If we want only the proxy server to seek a preconfigured generic server cluster, select that option and use the drop-down box to select the generic server cluster.

Failure Status Code: To reject the requests that match the specific criteria, you use the failure status code and provide an HTTP status code to use in the response to the sender.

Redirect URL: Use this option to send a redirect to the client. If we select this option, enter a fully qualified URL like http://abc.xyz.com. Usually, the URL is somewhere within the enterprise, sometimes right back to the proxy on a different port. We can use this option to ensure a request is routed through protocols like SSL.

Local route: Use this option to route requests to the root directory on the file system where static files are located.

Related tasks

Route requests from a plug-in to a proxy server