server task remove

Removes the specified installed WebSEAL server or server instance from a WebSEAL junction point.

Requires authentication (administrator ID and password) to use this command.

Syntax

server task instance_name-webseald-host_name remove –i server_uuid junction_point

Options

–i server_uuid

Specifies the UUID of the server to be removed from the junction point. See the server task show command for details about obtaining the UUID.

instance_name-webseald-host_name

Specifies the full server name of the installed WebSEAL server instance. You must specify this full server name in the exact format as displayed in the output of the server list command.

The instance_name specifies the configured name of the WebSEAL server instance. The webseald designation indicates that the WebSEAL service performs the command task. The host_name is the name of the physical computer where the WebSEAL server is installed.

For example, the configured name of a single WebSEAL server instance is default. The host computer name where the WebSEAL server is installed is abc.ibm.com. Then, the full WebSEAL server name is default-webseald-abc.ibm.com.

If an additional WebSEAL server instance is configured and named web2, the full WebSEAL server name is web2-webseald-abc.ibm.com.

junction_point

Specifies the name of the directory in the WebSEAL protected object space where the document space of the server is mounted.

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/junction_point object. For example, the sec_master administrative user is given this permission by default.

Return codes

0: The command completed successfully. For WebSEAL server task commands, the return code is 0 when the command is sent to the WebSEAL server without errors. However, even after the command was successfully sent, the WebSEAL server might not be able to successfully complete the command. The WebSEAL server returns an error message.
1: The command failed. See "Error messages" in the IBM Knowledge Center. This reference provides a list of the Security Access Manager error messages by decimal or hexadecimal codes.

Note: For more information about how to remove a server from a WebSEAL junction, see the Administering topics in the IBM Knowledge Center.

This command is available only when WebSEAL is installed.

Example

The following example removes the backappl junctioned server from the /pubs junction point. To determine the UUID of the server to be removed, run the server task show command:

pdadmin> server task default-webseald-cruz show /pubs

Output is like:

Junction point: /pubs
...
Server 1:
ID: 6fc3187a-ea1c-11d7-8f4e-09267e38aa77
Server State: running
...
Hostname: backapp1.cruz.ibm.com
...

Remove the server from the junction:

pdadmin> server task default-webseald-cruz remove \
-i 6fc3187a-ea1c-11d7-8f4e-09267e38aa77 /pubs