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_secu‐
rity_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 oth‐
ers 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 dae‐
mon (secd), and the audit daemon (auditd). The argument to this com‐
mand is the DCE name of a host to operate on. If an argument is omit‐
ted, 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 fol‐
lows: 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_secu‐
rity_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 con‐
figured to run dced (including the secval service), a security 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 host‐
name. 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 addi‐
tional 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, master_secu‐
rity_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 cal‐
culate 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 soft‐
ware 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 ser‐
pent dcecp>
The following example configures the machine mstr_node as both the mas‐
ter 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 infor‐
mation 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 command-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 unconfig‐
ure help operations dcecp>
host ping
Tests whether DCE processes are accessible from the network. The syn‐
tax 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, which‐
ever listens on port 135) on the specified host. The host_name argu‐
ment is the fully qualified name of the host to ping, as in the follow‐
ing: /.:/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 configured 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 notconfig‐
ured} {pwd_strengthd notconfigured} dcecp>
host start
Starts all DCE processes on the specified host. The syntax is as fol‐
lows: 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 pro‐
cesses 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 fol‐
lows: 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 processes
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_direc‐
tory(1m), dcecp_dts(1m), dcecp_principal(1m), dcecp_registry(1m).
host(1m)
