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

Sun Enterprise 10000 SSP 3.5 Reference Manual

domain_create(1M)

NAME

domain_create- create new domain or recreate old one

SYNOPSIS

domain_create

-d

domain_name

domain_create

-d

domain_name

-b

sysboard_list

-o

os_version

-p

platform_name

-t

platform_type

DESCRIPTION

You can use the domain_create command to create a domain, or to recreate a domain that once existed but was subsequently removed through domain_remove(1M). The domain_history(1M) command displays a list of domains removed by domain_remove(1M).

When creating a new domain, you must specify the -d, -b, -o and -p options. domain_create creates the new domain and assigns it the name specified by -d.

To recreate a domain with its original configuration, you must specify only the -d option. domain_create recreates the domain according to its original specifications. If it cannot find information about a previously existing domain of that name, domain_create returns an error.

Note -

If optional parameters are not used on the command line, the command uses the original specification for the domain from the domain_history file. If a value cannot be found in the domain_history file, an error is returned.

You can execute domain_create from the command line, or by selecting Configuration -> Domain -> Create from within Hostview (see hostview(1M)).

No historical information is maintained regarding IDN membership for a previously existing domain. When you create a domain, it does not belong to an IDN.

CONDITIONS

Execute domain_create only when all of the following are true:

The composition of system boards specified for the domain have, at minimum, a network interface, SCSI interface, and sufficient memory to support an autonomous system.
The domain name is defined in the /etc/hosts file of the host.
The system boards are all present and none are in use.

OPTIONS

The following options are supported:

-d domain_name: Either recreate the removed domain named domain_name, or create a new domain and assign it the name domain_name.
-b sysboard_list: Include the specified system boards in the new domain. The system boards are listed by board number and are separated by a space.
-o os_version: The version of the SunOS operating system - for example, 5.5.1, 5.6, 5.7, or 5.8 - to be running on the domain.
-p platform_name: The name of the Sun Enterprise 10000 system whose boards are to be used for the new domain.
-t platform_type: The type of system from which the domain originates. The default is the platform type of the machine from which the domain originates. The platform type for the Sun Enterprise 10000 system is Ultra-Enterprise-10000.

EXAMPLES

Example 1 Creating a Domain

The following command creates a domain named junior, which is configured with three boards numbered 0, 2 and 9, and that runs version 5.5.1 of the operating system. junior's boards came from the machine whose platform name is dad.

domain_create -d junior -b 0,2,9 -o 5.5.1 -p dad

RETURN VALUES

Upon successful completion domain_create returns a zero value and reconfigures the SSP to see the new domain; otherwise, it returns a nonzero value.

NOTES

The domain_create command can create only one domain at a time.

After creating a domain from the command line (this step is not necessary when doing so from Hostview), set the SUNW_HOSTNAME environment variable to ensure proper operation of the SSP command set. You can set the variable by using the domain_switch(1M) command.

You can then bring up the domain by using the bringup(1M) command.

Note that a new operating system patch may involve a new version of a host-dependent SSP binary. If so, the patch README file will have the operating system version number you should use to create the domain that will run the new operating system patch.