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

Sun Enterprise 10000 SSP 3.5 Reference Manual

domain_rename(1M)

NAME

domain_rename- rename an existing domain

SYNOPSIS

domain_rename

-d

domain_name

-n

new_domain_name

-o

new_os_version

DESCRIPTION

domain_rename changes the name or version of a domain, or both. If you specify the -n option, domain_rename changes the name from the domain name specified by the -d option to the domain name specified by the -n option. If you specify the -o option, domain_rename changes the version number of the SunOS operating system for the domain.

You can execute domain_rename from the command line or from Hostview. Your attempt fails if the target domain already is running the operating system.

When renaming a domain you must reconfigure the Internet address and other configuration information on the Sun Enterprise 10000 system domain and also on the SSP to enable the system to recognize the domain's new name. Otherwise, the domain cannot be reached and controlled by the SSP.

If interrupted during its configuration-verification phase, domain_rename aborts. You cannot interrupt it after it has completed this phase and begun the reconfiguration.

OPTIONS

The following options are supported:

-d domain_name: Name of the domain to be changed.
-n domain_name: New name for the domain specified in -d domain_name.
-o new_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.

RETURN VALUES

Upon successful completion, domain_rename returns a zero value (otherwise, it returns a nonzero value). You now can bring up the domain through the bringup(1M) command.

ERRORS

domain_name does not exist.

domain_rename cannot find the specified domain name.

new_domain_name already exists.

The name you are trying to assign the domain is already in use.

NOTES

After renaming a domain via this command you must set the SUNW_HOSTNAME environment variable as follows to ensure proper operation of the SSP command set:

setenv SUNW_HOSTNAME new_domain_name