Suspending and Resuming a Domain

The following topics are addressed here:

• To Suspend a Domain

• To Resume a Domain

To Suspend a Domain

Use the suspend-domain subcommand in remote mode to suspend a specified domain.

Suspending a domain causes the domain administration server (DAS) to enter a state where it will not accept any asadmin, Administration Console, or REST API command that might alter the configuration or content of the domain. However, because the DAS is still running, commands that do not change the configuration or content of the domain are accepted and performed. For example, asadmin list and get commands are available, and the Administration Console is available with view-only access.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. Suspend the domain by using the suspend-domain(1) subcommand:

   asadmin> suspend-domain --timeout seconds --message display-message

   --timeout

   Specifies a time in seconds to wait for certain running operations to complete before suspending the domain. If any such running operation does not complete in this time, the suspend-domain subcommand fails. The default time is 30 seconds.

   --message

   An optional message that is displayed to administrators who try to perform operations that would be blocked because the domain is suspended. If this option is not used, administrators are only informed that the domain has been suspended and when it was suspended.

Example 3-14 Suspending the Default Domain

This example suspends the default domain, domain1, using the default timeout of 30 seconds and providing an informative message about the suspension.

asadmin> suspend-domain --message "Manual backup in progress"
The domain was successfully suspended on Sun, 15 Jan 2011 08:30:22 PST.
Command suspend-domain executed successfully.

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help suspend-domain at the command line.

To Resume a Domain

Use the resume-domain subcommand in remote mode to resume a specified domain.

Resuming a domain that is suspended causes the domain administration server (DAS) to return to a fully operational state where it will accept and perform all asadmin, Administration Console, and REST API commands.

• Resume the domain by using the resume-domain(1) subcommand.

Example 3-15 Resuming the Default Domain

This example resumes the default domain, domain1.

asadmin> resume-domain
The domain is resumed. (Sun, 15 Jan 2011 08:32:17 PST)
Command resume-domain executed successfully.

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help resume-domain at the command line.