domain_unlink(1M) (Sun Enterprise 10000 SSP 3.5 Reference Manual)

Sun Enterprise 10000 SSP 3.5 Reference Manual

domain_unlink(1M)

NAME

domain_unlink- unlink domain(s) from an InterDomain Network (IDN)

SYNOPSIS

domain_unlink

-f

-F

domain_name

DESCRIPTION

The domain_unlink command disconnects one or more domains from an IDN. (A single instance of this command cannot remove domains that are linked to different IDNs.) Domains that remain in the IDN continue to communicate over that network in the normal fashion. Before you unlink a domain, you should verify that the associated network interface is not in use.

OPTIONS

The following options are supported:

-f: Represents the soft force option. With this option, domain_unlink attempts to unlink all of the specified domains in the normal manner; however, if a time-out condition occurs because a domain is completely non-responsive, domain_unlink uses the -F option to remove the link, forcing the domain to be unlinked.
-F: Represents the hard force option. With this option, domain_unlink unlinks the specified domain from all of the other domains in the IDN and does so without synchronizing the disconnects. You should use this option when the specified domain is completely nonresponsive or when it has been isolated from the IDN as part of AWOL recovery.
domain_name: Represents the name of the domain that you want to unlink. All of the specified domains must be members of an IDN. You can unlink more than one domain at a time; however, if you specify N-1 domains in the IDN, where N equals the total number of domains in the IDN, the domain_unlink command unlinks all of the domains in the IDN, effectively dismantling the IDN.

WARNINGS

The force option should be used only as a recovery mechanism when a domain is known to be in an unknown state (AWOL). It should not be used under normal conditions. It could result in an arbstop if the hardware is reprogrammed while the IDN is active. Note that if multiple domains within an IDN are hung, you need to unlink all of the hung domains in a single operation.

ENVIRONMENT VARIABLES

Before you attempt to create an IDN or to link a domain to an existing IDN, ensure that the SUNW_HOSTNAME shell environment variable is set to the name of a domain that supports the IDN feature. For this variable, the platform name does not work with IDN commands.

EXIT STATUS

Upon successful completion, domain_unlink returns a zero exit value. Otherwise, it returns a nonzero value, which indicates the domain unlink was not successful.