|
System Administration | addtag(1m) |
| addtag - assign a domain name (tag)
to a domain |
SYNOPSIS
| addtag -d domain_id|domain_tag [-q] [-y|-n] new_tag |
|
addtag(1M) adds the specified domain tag name (new_tag) to a domain (domain_id|domain_tag). Only one name tag can be assigned to a domain, and it must be unique across all domains. addtag can also be used to change the domain_tag.
|
|
The following options are supported.
- -d domain_id
- ID of a domain. Valid domain_ids are 'A'...'R' and are case insensitive.
- -d domain_tag
- Name assigned to a domain using addtag(1M).
-
new_tag
- New tag name assigned to a domain. See Extended Description for a description of invalid domain names.
- -h
- Help. Displays usage descriptions. Note Use alone. Any option specified in addition to -h is ignored.
- -n
- Automatically answers "no" to all prompts. Prompts are displayed unless used with the -q option.
- -q
- Quiet. Suppresses all messages to stdout including prompts.
When used alone, -q defaults to the -n option for all prompts.
When used with either the -y or the -n option, -q suppresses all user prompts and automatically answers with either 'y' or 'n' based on the option chosen.
- -y
- Automatically answers "yes" to all prompts. Prompts are displayed unless used with the -q option.
|
|
The following operands are supported:
-
new_tag
- New tag name assigned to a domain. See Extended Description for a description of invalid domain names.
|
|
Domain Name Tag Restrictions
|
The following restrictions are required on a domain name tag:
- No single character names
- All domain name tags must be unique across all domains within a single chassis.
- Tags must adhere to the same restrictions as defined for Solaris software nodenames. Currently, the size restriction is set to 2 to 64 characters.
|
Group Privileges Required
|
You must have platform administrator privileges to run this command.
Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.
|
|
| Example 1. Assigning the Tag eng2 to Domain A With Prompts
|
|
sc0:sms-user:> addtag -d A eng2
|
If a tag for this domain exists you will be prompted.
|
Example 2. Assigning the Tag "eng2" to Domain A Using the y Option
|
|
sc0:sms-user:> addtag -d A -y eng2
|
Prompts are displayed and automatically answered 'yes.' This forces the domain tag to be set even if a tag already exists for this domain.
|
Example 3. Assigning the Tag eng2 to Domain A Using the n Option
|
|
sc0:sms-user:> addtag -d A -n eng2
|
Prompts are displayed and automatically answered 'no.' This sets the tag for this domain unless it has already been done.
|
Example 4. Assigning the Tag eng2 to Domain A Using the qy Options
|
|
sc0:sms-user:> addtag -d A -qy eng2
|
You are not prompted.
|
Example 5. Assigning the Tag eng2 to Domain A Using the qn Options
|
|
sc0:sms-user:> addtag -d A -qn eng2
|
The example assigns the tag eng2 to Domain A only if it has not already been set. You are not prompted.
|
Example 6. Assigning the Tag eng2 to Domain A Using the q Option
|
|
sc0:sms-user:> addtag -d A -q eng2
|
The example assigns the tag eng2 to Domain A if it is not already set. If it is set, the command will not change it. You are not prompted.
|
|
|
The following exit values are returned:
-
0
- Successful completion
- >0
- An error occurred.
|
|
See attributes(5) for descriptions of the following attributes:
Attribute Types | Attribute Values |
Availability | SUNWSMSop |
|
| |