domain_remove(1M)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | NOTES | SEE ALSO

NAME

domain_remove- remove an existing domain

SYNOPSIS

domain_remove -d  domain_name

DESCRIPTION

domain_remove dismantles the specified domain, reconfiguring its system boards to a physically present and not in use state on the Sun Enterprise 10000 system. You should not remove a domain until it has been shutdown, and you cannot remove a domain that is a member of an IDN. See the Caution in the ERRORS section, below.

domain_remove displays the following message, giving you the option of saving certain information:

The following subdirectories contain domain-specific information, such as messages files, configuration files, and hpost dump files. You may choose to keep these directories if you still need this information. This domain may be recreated with or without this information being saved.

domain_remove then asks whether you want to keep the specific subdirectories. After you respond, it does as you ask, then proceeds.

After domain_remove completes, the boards are available for a subsequent domain_create(1M) or DR Attach.

You can execute domain_remove from the command line, or you can do so via Hostview. To use Hostview to remove a board, select a board in the domain you wish to remove and choose Configuration -> Domain -> Remove. You cannot remove a domain when it is running the operating system.

If interrupted during its configuration-verification phase, domain_remove aborts. After this phase, once it has begun the reconfiguration, it cannot be interrupted.

RETURN VALUES

Upon successful completion, domain_remove returns a zero value; otherwise, it returns a nonzero value.

ERRORS

The specified domain is running the operating system.

Domain 'domain_name' is up, must be shutdown before removing. Continue anyway (y/n)?

CAUTION: If you tell domain_remove to continue removing a domain that is running the operating system, it will do so, crashing the domain and potentially causing loss of data.

The specified domain is a member of an IDN. It must be unlinked from the IDN before it can be removed.

domain_remove: Domain (domain_name) is linked to an IDN. Domain must be unlinked before it can be removed. See domain_unlink(1M).

NOTES

Each execution of the domain_remove command can remove only one domain.

Upon successful removal of the configuration, the corresponding obp_helper(1M) and netcon_server(1M) daemons are also terminated.

SEE ALSO

domain_create(1M), domain_history(1M), domain_unlink(1M), domain_rename(1M), domain_status(1M), domain_switch(1M), netcon_server(1M)

SSP 3.5  Last Revised 1 Aug 1999

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | NOTES | SEE ALSO