cellalias(1m)cellalias(1m)NAME
cellalias - A dcecp task object that manages cell name aliases
SYNOPSIS
cellalias catalog
cellalias create cellalias_name [-force]
cellalias help [operation | -verbose]
cellalias operations
ARGUMENTS
A single fully qualified alias name for the cell in the form: /.../cel‐
lalias_name The name of the cellalias operation for which to display
help information.
DESCRIPTION
The cellalias task object allows you to create and display alternative
names for cells, known as cell aliases. You can create multiple aliases
for a single cell, but only one per cellalias command.
When you create an alias, cellalias does the following: Creates a new
principal to represent the cell alias in the registry. Performs a reg‐
istry verify operation to ensure that all security replicas in the cell
are up to date. Creates the specified alias name in CDS using a
cdsalias create operation. Performs a directory synchronize operation
to ensure that all the CDS replicas are up to date. Performs some
hostdata operations on each host in the cell for which you are creating
the alias. Updates all dced objects and the dcelocal/dce_cf.db and
dcelocal/etc/security/pe_site files to reflect the new alias name.
(This action can take a long time to complete in a cell with many
hosts.)
OPERATIONS
cellalias catalog
Returns a list of all cell alias names for the local cell. The syntax
is as follows: cellalias catalog
In the list of cell alias names, the cell's primary name (the name
assigned when the cell principal was created) is listed first. The
alias names are listed after the primary name.
Privilege Required
Requires r (read) permission on the root directory of the cell.
Examples
dcecp> cellalias catalog /.../gumby /.../pokey-alias dcecp>
cellalias create
Creates a new alias for the local cell. The syntax is as follows: cel‐
lalias create cellalias_name [-force]
Options Ignores errors encountered during execution.
The required cellalias_name is a single fully qualified name. You must
start dced in remote-update mode with the -r option before you use cel‐
lalias create. This operation returns an empty string on success.
Privilege Required
Requires a (auth_info) permission on the root directory of the cell.
Examples
dcecp> cellalias create /.../green.cell.rainbow.com dcecp>
cellalias help
Returns help information about the cellalias task object and its opera‐
tions. The syntax is as follows: cellalias help [operation | -verbose]
Options Displays information about the cellalias task object.
Used without an argument or option, the cellalias help command returns
brief information about each cellalias operation. The optional opera‐
tion argument is the name of an operation about which you want detailed
information. Alternatively, you can use the -verbose option to display
detailed information about the cellalias task object itself.
Privilege Required
No special privileges are needed to use the cellalias help command.
Examples
dcecp> cellalias help catalog Returns the cell alias names
currently in use. create Creates a new alias name for the
local cell. help Prints a summary of command-line
options. operations Returns a list of the valid operations
for this command. dcecp>
cellalias operations
Returns a list of the operations supported by the cellalias task
object. The syntax is as follows: cellalias operations
The list of available operations is in alphabetical order except for
help and operations, which are listed last.
Privileges Required
No special privileges are needed to use the cellalias operations com‐
mand.
Examples
dcecp> cellalias operations catalog create help operations dcecp>
RELATED INFORMATION
Commands: dcecp(1m), dcecp_account(1m), dcecp_cdsalias(1m),
dcecp_directory(1m), dcecp_hostdata(1m), dcecp_registry(1m).
cellalias(1m)