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

cellalias_name
A single fully qualified alias name for the cell alias in the form:

/.../cellalias_name

operationThe 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:

   1.Creates a new principal to represent the cell alias in the registry. 

   2.Performs a registry verify  operation to ensure that all security replicas in the cell are up to date. 

   3.Creates the specified alias name in CDS using a cdsalias  operation. 

   4.Performs a directory synchronize  operation to ensure that all the CDS replicas are up to date. 

   5.Performs a hostdata  operation on each host in the cell for which you are creating the alias. 

   6.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.) 

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

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 cell_alias_name [force ]

Options

forceIgnores errors encountered during execution. 

The required cell_alias_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 | verbose ]

Options

verboseDisplays 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 required 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: account(8dce), cdsalias(8dce), dcecp(8dce), directory(8dce), hostdata(8dce), registry(8dce).