server task virtualhost throttle

The server task virtualhost throttle command places the server located at this virtual host junction in a throttled operational state.

Requires authentication (administrator ID and password) to use.

server task instance-webseald-host virtualhost throttle [-i server_uuid] vhost_label

The server task virtualhost throttle command places the server located at this virtual host junction in a throttled operational state. Only requests from users who have created a session with WebSEAL prior to the invocation of this command continue to have their requests processed by the specified server. If a server is not specified, all servers that are located at this virtual host junction are placed in a throttled operational state..

Options

Authorization

Users and groups that require access to this command must be given the c (control) permission in the ACL that governs the /WebSEAL/host_name-instance_name/@vhost_label object. For example, the sec_master administrative user has permission by default.

Return codes

Examples

In the following example, the virtual host junction with the label support-vhost-https, configured on the WebSEAL server abc.ibm.com, supports the virtual host support.ibm.com, located on the back-end junctioned server int3.ibm.com. There is a requirement to place the int3.ibm.com server in a throttled operational state. To determine the UUID of this junctioned server, run the server task virtualhost show command:

Output is similar to:

Virtual Host label: support-vhost-https
Type: SSL
...
Virtual hostname: support.ibm.com
Alias: ibm.com
Alias: support
Virtual Host junction protocol partner: support-vhost-http
Server 1:
ID: bacecc66-13ce-11d8-8f0a-09267ea5aa77
Server State: running
Operational State: Online
Hostname: int3.ibm.com
Port: 443
Server DN: 
Query_contents URL: /cgi-bin/query_contents
Query-contents: unknown
Case insensitive URLs: no
Allow Windows-style URLs: yes
Current requests: 0
Total requests: 1

Place this server in a throttled operational state using the following command:

See also

server task throttle
server task offline
server task online
server task virtualhost offline
server task virtualhost online

Parent topic: Command reference