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: /.../cellalias_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
registry 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: cellalias 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
cellalias 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 operations. The syntax is as follows: cellalias help [operation | -ver-
bose]
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
operation 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 command.
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)
