clusters(4) [opensolaris man page]

clusters(4)						     Sun Cluster File Formats						       clusters(4)

NAME

       clusters - cluster names database

SYNOPSIS

       /etc/clusters

DESCRIPTION

       The  clusters  file contains information regarding the known clusters in the local naming domain.  For each cluster a single line should be
       present with the following information:

	 clustername	     whitespace-delimited list of hosts

       Expansion is recursive if a name on the right hand side is tagged with the expansion marker: ``*''.

       Items are separated by any number of blanks and/or TAB characters.  A `#' indicates the beginning of a comment. Characters up to the end of
       the line are not interpreted by routines which search the file.

       Cluster names may contain any printable character other than an upper case character, a field delimiter, NEWLINE, or comment character. The
       maximum length of a cluster name is 32 characters.

       This information is used by Sun Cluster system administration tools, like cconsole(1M) to specify a group  of  nodes  to  administer.   The
       names used in this database must be host names, as used in the hosts database.

       The database is available from either NIS or NIS+ maps or a local file.	Lookup order can be specified in the /etc/nsswitch.conf file.  The
       default order is nis files.

EXAMPLES

       Example 1 A Sample /etc/clusters File

       Here is a typical  /etc/clusters file:

	 bothclusters	     *planets *wine
	 planets	     mercury venus
	 wine		     zinfandel merlot chardonnay riesling

       Here is a typical  /etc/nsswitch.conf entry:

	 clusters: nis files

FILES

       /etc/clusters

       /etc/nsswitch.conf

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWsczu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Uncommitted		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       cconsole(1M), chosts(1M), serialports(4), nsswitch.conf(4), attributes(5)

Sun Cluster 3.2 						    26 Jun 2006 						       clusters(4)

serialports(4)						     Sun Cluster File Formats						    serialports(4)

NAME

       serialports - name to serial port database

SYNOPSIS

       /etc/serialports
       serialports NIS or NIS+ maps

DESCRIPTION

       The serialports database maps a name to a server name and TCP port number that represents the serial port connected to the specified termi-
       nal server host. The database is typically used to map host names to their consoles, but may also be used to provide  access  to  printers,
       modems, and the like. The mapping is used when the service is being provided by a network based terminal concentrator. For each name a sin-
       gle line should be present with the following information:

	 host-name concentrator-hostname tcp-port-number

       Items are separated by any number of blanks or TAB characters. A pound sign (#)indicates the beginning of a comment. Characters between the
       pound sign and the end of the line are not interpreted by routines that search the file.

       This  information is used by the cconsole or cssh command to establish connection to a group of consoles of a cluster of network hosts. The
       names that are used in this database must be host names, as used in the /etc/inet/hosts database.

       To support Secure Shell connections to node consoles through the cssh command, specify in the /etc/serialports file the name  of  the  con-
       sole-access  device and the Secure Shell port number for each node. If you use the default Secure Shell configuration on the console-access
       device, specify port number 22.

       For E10000 nodes, the entries are different. This is because E10000 uses netcon for console purposes, which operates  over  a  network  and
       executes on the SSP. The following is the generic format for the entry.

	 hostname SSPname 23

       The  database  is  available  from  either  the NIS or NIS+ maps or a local file. Lookup order is specified by the serialports entry in the
       /etc/nsswitch.conf file, if present. If no search order is specified, the default order is nis files.

EXAMPLES

       Example 1 A Sample /etc/serialports File

       The following is an example /etc/serialports file:

	 # Network host to port database

	 #  NFS server cluster
	 mercury	planets-tc     5001
	 venus		planets-tc     5002

	 # E10000 server cluster
	 cashews	 nuts-ssp-1 23
	 pecans 	 nuts-ssp-2 23

       Example 2 A Sample /etc/nsswitch.conf File Entry

       The following is a typical /etc/nsswitch.conf entry:

	 serialports: nis files

FILES

       /etc/serialports

       /etc/nsswitch.conf

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscdev 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Uncommitted		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       cconsole(1M), chosts(1M), cports(1M), cssh(1M), clusters(4), nsswitch.conf(4), attributes(5)

Sun Cluster 3.2 						    8 Sep 2007							    serialports(4)