server task server restart

Restarts a WebSEAL server using the ISAM server task framework.

This command requires authentication of administrator ID and password.

server task server_name server restart

Options

server_name

Name of the ISAM authorization server restart.

Authorization

Users and groups that require access to this command must have the s (administration) permission in the ACL that governs the /WebSEAL/host_name-instance_name object. For example, the sec_master administrative user has 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 successfully complete the command. The WebSEAL server returns an error message.

1

The command failed. When a command fails, the pdadmin command provides a description of the error and an error status code in hexadecimal format, for example, 0x14c012f2. See "Error messages" in the IBM Knowledge Center for a list of the ISAM error messages by decimal or hexadecimal codes.

The restart is successful only if the WebSEAL server was started using the pdweb_start script. The script must be running as a daemon on AIX®, Linux®, or Solaris, or as a service on Windows). The restart command does not work if the WebSEAL server is running in the foreground.

The result of the restart is not displayed on the administration console. We must examine the WebSEAL log files to confirm the server restart was successful.

Example

The following example restarts server03:

pdadmin> server task server03 server restart

Parent topic: pdadmin commands