PreviousNext

cell ping

Performs quick checks to test whether a cell is running. The syntax is as follows:

cell ping [cell_name] [-clients] [-replicas]

Options

-clients
This option causes the command to ping every machine in the cell. It does this by looping through /.:/hosts and doing a host ping on each host name. In case of failure, it generates an error and returns a list of hosts that could not be contacted. On success, it returns DCE clients available.

-replicas
This option causes the command to ping the master security server, each security replica in the cell, all the CDS servers in the cell, and all the DTS servers in the cell. In case of failure it generates an error and returns a list of servers that could not be contacted. On success, it returns DCE servers available.

Description
The cell ping operation performs a quick check to test whether a cell is running.

If called with no option,it pings (using server ping) the master security server, the CDS server that currently holds the write copy of the cell root directory (/.:), and all the DTS servers in the cell. In case of failure it generates an error and returns a list of servers that could not be contacted. On success, it returns DCE services available.

The -replicas option causes the command to ping each security replica and CDS server as well as those mentioned above. In case of failure it generates an error and returns a list of servers that could not be contacted. On success, it returns DCE servers available.

The -clients option causes the command to ping every machine in the cell. It does this by looping though /.:/hosts and doing a host ping on the hostname. In case of failure, it generates an error and returns a list of hosts that could not be contacted. On success, it returns DCE clients available.

Privileges Required
You must have r (read) permission to the following directories: /.:/hosts, /.:/hosts/hostname, and /.:/subsys/dce/sec.

Examples
The following example tells whether the core services master servers are available:

dcecp> cell ping /.../blue.cell.osf.org
DCE services available
dcecp>

The following example tells whether the core services and their replicas are available:

dcecp> cell ping -replicas
DCE servers available
dcecp>

The following example tests the presence of all DCE hosts in a cell.

dcecp> cell ping -clients

DCE clients available
dcecp>