cdsadv(1m)cdsadv(1m)NAME
cdsadv - Starts the CDS client daemon
SYNOPSIS
cdsadv [-c] [-D] [-s] [-w route]
ARGUMENTS
Specifies cache size in kilobytes. Changing cache sizes causes previously cached information to be discarded, including information about
cached servers, so use of this option may necessitate defining a new cached server. NOTE : Alternatively this can be done by using the
tunable parameter cdsadv.cache_size provided in the /opt/dcelocal/etc/cds.conf file. This parameter takes a cache size in KiloBytes as
shown:
cdsadv.cache_size: 512 and sets the cdsadv cache size to 512 KiloBytes. cdsadv needs to be restarted for this value to be effective.
This is the recommended method to set cdsadv cache size. For debugging use only. Causes the cdsadv process not to fork. Causes the cdsadv
not to send or receive advertisements. This argument can be used for diagnostic work involving multiple servers on the same local area
network to limit access to those servers identified with the define cached server command. Routes serviceability messages.
DESCRIPTION
The cdsadv command starts the CDS client daemon.
Privilege Required
You must log in as superuser (root).
NOTES
This command is ordinarily executed by a DCE configuration or startup script. You should use this command interactively only when cdsadv
fails to start automatically after a reboot, or if you want to restart cdsadv after disabling it to perform a backup or to do diagnostic
work on the host system.
EXAMPLE
To restart cdsadv, follow these steps: Log in to the clerk system as superuser (root). Verify that the dced process is running. Enter the
following command to restart the cdsadv process:
# cdsadv
RELATED INFORMATION
Books: OSF DCE Administration Guide
cdsadv(1m)
Check Out this Related Man Page
host(1m)host(1m)NAME
host - A dcecp task object that manages host information in a DCE cell
SYNOPSIS
host catalog [cell_name] [-simplename]
host configure host_name -cell cellname -secmaster master_security_server_name -cds cds_server_name -password password {-client | -server}
[-remote] [-addlan additional_lan_name] [-dts {global | local | clerk | none}] [-timeserver time_server] [-lowuid low_uid] [-lowgid
low_gid] [-keyseed keyseed] [-riphost rip_hostname] [-tolsec tol_sec] [-nosync] [-protseq config_protseq] [-admin admin_principal]
host help [operation | -verbose]
host operations
host ping host_name
host show [host_name]
host start [host_name]
host stop [host_name] [-force]
host unconfigure [host_name] [-force] [-remmaster]
ARGUMENTS
The name of a single cell to operate on. The name must be a fully qualified cell name such as either of the following: /.../gumby1.com
/.: The name of a single host to operate on. Some host commands accept a fully qualified name (as in /.../cellname/hosts/hostname), while
others accepts a cell relative name (as in hosts/hostname) or a simple name (as in hostname). See the individual command descriptions in
OPERATIONS for details. The name of the host operation for which to display help information.
DESCRIPTION
The host task object represents DCE processes running on a machine in (or to be added to) a DCE cell. The host task object allows adminis-
trators to configure and start DCE on machines easily.
The host task object can configure and start the core DCE services on a server or a client machine. The services include the DCE daemon
(dced), the Cell Directory Service (CDS) daemons (cdsd and cdsadv), the Distributed Time Service (DTS) daemon (dtsd), the security service
daemon (secd), and the audit daemon (auditd). The argument to this command is the DCE name of a host to operate on. If an argument is
omitted, the command operates on the local host, if possible. The behavior of commands operating locally may differ from the behavior of
commands operating remotely, with more operations performed on the local host than may be possible remotely. See OPERATIONS for details.
OPERATIONS
host catalog
Returns a list of names of hosts in the cell. The syntax is as follows: host catalog [cell_name] [-simplename]
The catalog operation returns a list of names of hosts in the cell. By default, the names are fully qualified. Use the -simplename option
to return cell-relative names. The optional cell_name argument specifies a cell to operate in, and should be entered as a fully qualified
cell name (either /.: or /.../cell_name).
Privileges Required
You must have r (read) permission to the /.:/hosts directory in CDS.
Examples
The following example lists the full names of all the DCE hosts that have entries in the CDS /.:/hosts directory in the local cell: dcecp>
host catalog /.../my_cell.goodco.com/hosts/alpha /.../my_cell.goodco.com/hosts/beta /.../my_cell.goodco.com/hosts/gamma dcecp>
The following example lists the simple names of all the DCE hosts that have entries in the CDS /.:/hosts directory in the specified cell:
dcecp> host catalog /.../gumby1 -simplename hosts/blech hosts/jacobi hosts/oddball dcecp>
host configure
Configures a single machine named by the argument as a DCE server or as a client into an existing DCE cell. The syntax is as follows: host
configure host_name -cell cellname -secmaster master_security_server_name -cds cds_server_name -password password {-client | -server}
[-remote] [-addlan additional_lan_name] [-dts {global | local | clerk | none}] [-timeserver time_server] [-lowuid low_uid] [-lowgid
low_gid] [-keyseed keyseed] [-riphost rip_hostname] [-tolsec tol_sec] [-nosync] [-protseq config_protseq] [-admin admin_principal]
Options
Specifies the name of the cell in which the host is to be configured. The format is /.../cellname or simply cellname. Configures the host
as a DCE client machine. The machine will be configured to run dced (including the secval service), a DTS clerk (dtsd), cdsadv, and
auditd. Configures the host as a DCE server machine. The machine will be configured to run dced (including the secval service), a secu-
rity server (secd), a CDS server (cdsd and cdsadv), a DTS server (dtsd) and auditd. Specifies the hostname of the security master server
in the form hostname. Specifies the hostname of the CDS server in the form hostname. Specifies the password of the cell administrator.
Optionally specifies the principal name of the cell administrator. It defaults to cell_admin. Configures dced with remote administration
(-r) turned on. If not selected, remote administration is off. Configures an additional lan name on the local server. If not selected,
the default is NULL. Configure the DTS service as either global, local, clerk or none. The default is none. The hostname of the time
server with which to synchronize clocks, specified in the form hostname. The default is the host specified in the -secmaster option, mas-
ter_security_server_name. The starting point for new UIDs being created. The default is to automatically calculate the starting point.
The starting point for new GIDs being created. The default is to automatically calculate the starting point. The keyseed to use for the
initial security master. A relocatable IP hostname for hosts with Service Guard installed. The default is NULL if no Service Guard is
installed. The clock tolerance in seconds. The default is 120. Do not synchronize clocks with a server machine upon configuration of a
client host. The default is to synchronize clocks. Set the configuration protocol. The default is ncacn_ip_tcp.
The configure operation configures the local machine named by the host_name argument as a server or as a client into an existing DCE cell.
In the client case, the cell must already exist and must have security and naming services operating. When configuring a server, the host
should not be part of an existing cell. In all cases, DCE software must be installed on the target machine. The host_name argument is the
name of the local host machine without the cell name prepended, as in the following: hosts/hostname
hostname
This operation returns an empty string on success.
Privileges Required
You must have root authority.
Examples
The following example configures the machine hydra in the cell /.../my_cell.com as a client: dcecp> host configure hosts/hydra -client >
-cell my_cell.com -password fstzkl -secmaster scylla > -cds serpent dcecp>
The following example configures the machine mstr_node as both the master security server and initial CDS server in the new cell gumby1.
dcecp> host configure mstr_node -server -cell gumby1 > -cds mstr_node -secmaster mstr_node -password -dce- > -dts global -remote dcecp>
host help
Returns help information about the host task object and its operations. The syntax is as follows: host help [operation | -verbose]
Options Displays information about the host task object.
Used without an argument or option, the host help command returns brief information about each host operation. The optional operation
argument is the name of an operation about which you want detailed information. Alternatively, you can use the -verbose option for more
detailed information about the host task object itself.
Privileges Required
No special privileges are needed to use the host help command.
Examples
dcecp> host help catalog Returns a list of configured hosts in the cell. configure Configures a host into the cell
as a client or server. ping Determines if DCE is responding on the specified host. show Returns all DCE
processes configured on the specified host. start Starts DCE on the specified host. stop Stops DCE on the
specified host. unconfigure Removes the host from the name and security databases. help Prints a summary of com-
mand-line options. operations Returns a list of the valid operations for this command. dcecp>
host operations
Returns a list of the operations supported by the host task object. The syntax is as follows: host 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 host operations command.
Examples
dcecp> host operations catalog configure ping show start stop unconfigure help operations dcecp>
host ping
Tests whether DCE processes are accessible from the network. The syntax is as follows: host ping host_name
The ping operation tests whether DCE processes are accessible from the network. It contacts the endpoint mapper (either rpcd or dced,
whichever listens on port 135) on the specified host. The host_name argument is the fully qualified name of the host to ping, as in the
following: /.:/hosts/hostname The operation returns 1 if the host responds, 0 if it does not.
Privileges Required
No special privileges are needed to use the host ping command.
Examples
The following example pings host hydra: dcecp> host ping /.:/hosts/hydra 1 dcecp>
host show
Returns a list describing all processes that are configured to run on the specified host. The syntax is as follows: host show [host_name]
The show operation returns a list describing all processes that are configured to run on the specified host. The optional host_name argu-
ment is the cell-relative or simple name of the local DCE host, such as hosts/hostname or hostname. If not specified, the local host is
used. The information returned includes the status of DCE processes either running or configured on the specified host. The value running
is used to represent a DCE process that is configured and running. The value notrunning is used to represent a DCE process that is config-
ured but not running. The value notconfigured is used to represent a DCE process that is not configured.
The host show command uses the /etc/rc.config.d/dce file to determine which DCE processes are configured on the host.
Privileges Required
No special privileges are needed to use the host show command.
Examples
dcecp> host show hosts/oddball {dced running} {secval running} {auditd notconfigured} {secd running} {cdsadv running} {cdsd running} {gdad
notconfigured} {dtsd notrunning} {dts_null_provider notconfigured} {dts_ntp_provider notconfigured} {dts_spectracom_provider notconfigured}
{pwd_strengthd notconfigured} dcecp>
host start
Starts all DCE processes on the specified host. The syntax is as follows: host start [host_name]
The start operation starts all DCE processes on the specified host. This command uses the /sbin/init.d/dce file to determine which DCE
processes to start.
The host_name argument is the cell-relative or simple name of the local host, as in the following: hosts/hostname
hostname
This operation returns an empty string on success.
Privileges Required
You must have root authority.
Examples
The following example starts all configured DCE processes on host hydra: dcecp> host start hosts/hydra dcecp>
host stop
Stops all DCE processes on the specified host. The syntax is as follows: host stop [host_name] [-force]
Options
Specifies that any servers that fail to stop normally should be stopped using a stricter stopping mechanism.
The stop operation stops all DCE processes on the specified host. This command uses the /sbin/init.d/dce file to determine which DCE pro-
cesses to stop.
The host_name argument is the cell-relative or simple name of the local host, as in the following: hosts/hostname
hostname
This operation returns an empty string on success.
Privileges Required
You must have root authority.
Examples
The following example stops the running DCE processes on host hydra: dcecp> host stop hosts/hydra dcecp>
host unconfigure
Unconfigures the local host from a cell. The syntax is as follows: host unconfigure [host_name] [-force] [-remmaster]
Options
Specifies that any errors that occur during an unconfigure operation are to be ignored and the unconfigure operation should continue. Must
be used if the node being unconfigured is a security server.
The unconfigure operation unconfigures the local host from a cell. To unconfigure a node, the operation deletes the following: All
objects, directories and links from /.:/hosts/hostname including the directory itself. All principal names beginning with hosts/hostname.
The unconfigure operation takes the cell relative or simple name of the local host to unconfigure, as in the following: hosts/hostname
hostname This operation returns an empty string on success.
Privileges Required
You must have the appropriate permission to delete CDS objects and directories. You must also have the appropriate permission to delete
principals from the registry. Refer to the appropriate reference page on each object for more details.
Examples
The following example unconfigures host hydra from the cell: dcecp> host unconfigure hosts/hydra dcecp>
RELATED INFORMATION
Commands: dcecp(1m), dcecp_account(1m), dcecp_aud(1m), dcecp_directory(1m), dcecp_dts(1m), dcecp_principal(1m), dcecp_registry(1m).
host(1m)