server task virtualhost throttle

Places the server that is 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 that is at this virtual host junction in a throttled operational state. Users can create a session with WebSEAL before the invocation of this command. Only requests from such users continue to be processed by the specified server. If a server is not specified, all servers that are 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 is given this permission by default.

Return codes

This command is available only when WebSEAL is installed.

Example

In the following example, the virtual host junction:

The virtual host support.ibm.com is on the 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:

pdadmin> server task default-webseald-abc.ibm.com \
virtualhost show support-vhost-https 
Output is like:
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:

pdadmin> server task default-webseald-cruz virtualhost throttle \
-i bacecc66-13ce-11d8-8f0a-09267ea5aa77 support-vhost-https

See also

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

Parent topic: pdadmin commands