unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 host(1m)		  Open Software Foundation		    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
      cell_name 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

		/.:


      host_name The name of a single host to operate on.  Some host commands
		accept a fully qualified name (as in



 Hewlett-Packard Company	    - 1 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




		/.../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.

      operation 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
      administrators 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>&gt&gt> host catalog
      /.../my_cell.goodco.com/hosts/alpha
      /.../my_cell.goodco.com/hosts/beta



 Hewlett-Packard Company	    - 2 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




      /.../my_cell.goodco.com/hosts/gamma
      dcecp>&gt&gt>


      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>&gt&gt> host catalog /.../gumby1 -simplename
      hosts/blech
      hosts/jacobi
      hosts/oddball
      dcecp>&gt&gt>


    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

      -cell cellname
		Specifies the name of the cell in which the host is to be
		configured.  The format is /.../cellname or simply cellname.

      -client	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.

      -server	Configures the host as a DCE server machine.  The machine
		will be configured to run dced (including the secval
		service), a security server (secd), a CDS server (cdsd and



 Hewlett-Packard Company	    - 3 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




		cdsadv), a DTS server (dtsd) and auditd.

      -secmaster master_security_server_name
		Specifies the hostname of the security master server in the
		form hostname.

      -cds cds_server_name
		Specifies the hostname of the CDS server in the form
		hostname.

      -password password
		Specifies the password of the cell administrator.

      -admin admin_principal
		Optionally specifies the principal name of the cell
		administrator.	It defaults to cell_admin.

      -remote	Configures dced with remote administration (-r) turned on.
		If not selected, remote administration is off.

      -addlan additional_lan_name
		Configures an additional lan name on the local server.	If
		not selected, the default is NULL.

      -dts {global | local | clerk | none}
		Configure the DTS service as either global, local, clerk or
		none.  The default is none.

      -timeserver time_server
		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_security_server_name.

      -lowuid low_uid
		The starting point for new UIDs being created.	The default
		is to automatically calculate the starting point.

      -lowgid low_gid
		The starting point for new GIDs being created.	The default
		is to automatically calculate the starting point.

      -keyseed keyseed
		The keyseed to use for the initial security master.

      -riphost rip_hostname
		A relocatable IP hostname for hosts with Service Guard
		installed.  The default is NULL if no Service Guard is
		installed.





 Hewlett-Packard Company	    - 4 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




      -tolsec tol_sec
		The clock tolerance in seconds.	 The default is 120.

      -nosync	Do not synchronize clocks with a server machine upon
		configuration of a client host.	 The default is to
		synchronize clocks.

      -protseq config_protseq
		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>&gt&gt> host configure hosts/hydra -client \
      >&gt&gt> -cell my_cell.com -password fstzkl -secmaster scylla \
      >&gt&gt> -cds serpent
      dcecp>&gt&gt>


      The following example configures the machine mstr_node as both the
      master security server and initial CDS server in the new cell gumby1.

      dcecp>&gt&gt> host configure mstr_node -server -cell gumby1 \
      >&gt&gt> -cds mstr_node -secmaster mstr_node -password -dce- \
      >&gt&gt> -dts global -remote
      dcecp>&gt&gt>




 Hewlett-Packard Company	    - 5 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




    host help
      Returns help information about the host task object and its
      operations.  The syntax is as follows:

      host help [operation | -verbose]


      Options


      -verbose	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 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





 Hewlett-Packard Company	    - 6 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




      No special privileges are needed to use the host operations command.

      Examples

      cecp> 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>&gt&gt> host ping /.:/hosts/hydra
      1
      dcecp>&gt&gt>


    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
      argument 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



 Hewlett-Packard Company	    - 7 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




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






 Hewlett-Packard Company	    - 8 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




      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>&gt&gt> host start hosts/hydra
      dcecp>&gt&gt>


    host stop
      Stops all DCE processes on the specified host. The syntax is as
      follows:

      host stop [host_name] [-force]


      Options

      -force	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>&gt&gt> host stop hosts/hydra



 Hewlett-Packard Company	    - 9 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




      dcecp>&gt&gt>


    host unconfigure
      Unconfigures the local host from a cell.	The syntax is as follows:

      host unconfigure [host_name] [-force] [-remmaster]


      Options

      -force	Specifies that any errors that occur during an unconfigure
		operation are to be ignored and the unconfigure operation
		should continue.

      -remmaster
		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>&gt&gt> host unconfigure hosts/hydra



 Hewlett-Packard Company	   - 10 -	      OSF DCE 1.1/HP DCE 1.8






 host(1m)		  Open Software Foundation		    host(1m)




      dcecp>&gt&gt>


 RELATED INFORMATION
      Commands: dcecp(1m), dcecp_account(1m), dcecp_aud(1m),
      dcecp_directory(1m), dcecp_dts(1m), dcecp_principal(1m),
      dcecp_registry(1m).















































 Hewlett-Packard Company	   - 11 -	      OSF DCE 1.1/HP DCE 1.8