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

Sun Enterprise 10000 SSP 3.5 Reference Manual

domain_link(1M)

NAME

domain_link- link domains to form, or expand, an InterDomain Network (IDN)

SYNOPSIS

domain_link

domain_name_a

domain_name_b

DESCRIPTION

The domain_link command links Dynamic System Domains, referred to as domains in this document, only on the Sun Enterprise 10000 server. You can use the domain_link to create, or expand, an IDN within the same server. The system boards that host memory in the domains must contain at least one processor. If one of the specified domains is already a member of an IDN, the domain_link command adds the other specified domain to that IDN. If both domains are members of different IDNs, the domain_link command combines those IDNs into a single, larger IDN. If neither domain is part of an IDN, the domain_link creates a new IDN with both domains as members.

You can specify only two domain names when you use the domain_link(1M) command. If you want to create a multidomain IDN, you must first link two domains, then you can link the other domains to the IDN by specifying the name of one of the domains in the IDN with the name of the new domain.

Each IDN has one master domain, which maintains the Shared Memory Region (SMR), as described in the Sun Enterprise 10000 InterDomain Networks User Guide. The master domain is dynamically chosen by the IDN subsystem.

Note -

If the domains are up and running, you must set the idn-smr-size variable at the OBP prompt and reboot the domain before you attempt to link the domain to an IDN.

If one domain goes down, the others can continue to communicate over the IDN. Although all of the domains within an IDN are logically connected in a point-to-point configuration, the IDN feature also supports broadcasting at the network interface level. For more information about arbstops and IDNs, see the Sun Enterprise 10000 InterDomain Networks User Guide.

OPTIONS

The following options are supported.

domain_name_a: Represents the name of the first domain that you want to link. The domain could be a member of an existing IDN, or it could be a domain that is not already linked to an IDN.
domain_name_b: Represents the name of the second domain that you want to link. The domain could be a member of an existing IDN, or it could be a domain that is not already linked to an IDN.

EXIT STATUS

The following exit values are returned:

0: Domain link successful.
nonzero: Domain link unsuccessful.

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.