server task server restart
The server task server restart command restarts a WebSEAL server by using the Verify Identity Access server task framework.
Requires authentication (administrator ID and password) to use this command.
Syntax
server task server_name server restart
Options
- server_name
- Specifies the name of the WebSEAL server to be restarted.
Authorization
Users and groups that require
access to this command must be given the s (administration)
permission in the ACL that governs the /WebSEAL/host_name-instance_name object.
For example, the sec_master administrative
user has permission by default.
Return codes
- 0
- The command that completed successfully. For WebSEAL server
task commands, the return code is
0when the command is sent to the WebSEAL server without errors.Note: Even if the command is successfully sent, the WebSEAL server might not be able to successfully complete the command and can return 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 which provides a list of the Verify Identity Access error messages by decimal or hexadecimal codes.
Note: The restart is only successful
if the WebSEAL server starts by using the pdweb_start script
(that is, if it is running as a daemon on UNIX™, or as a service on Windows™). The restart command does not work
if the WebSEAL server runs in foreground.
The restart is only
successful if the WebSEAL server starts by using the pdweb_start script
(that is, if it is running as a daemon on UNIX, or as a service on Windows). The restart command does not work
if the WebSEAL server runs in foreground. The result of the restart is not displayed on the administration console. You must examine the WebSEAL log files to confirm that the server restart was successful.
Examples
The following example restarts
server03: pdadmin> server task server03 server restart