
<!-- "@(#)config_files	1.13 97/09/09 Sun Microsystems, Inc." >

<title>Administering Configuration Files</title>
<h1>Administering Configuration Files</h1>

The   Cluster  Console uses     two  databases: <tt>clusters</tt>  and
<tt>serialports</tt>.  These   two  files should   be created   and/or
modified on the  administration   workstation.These databases  can  be
<tt>/etc</tt> files  or  NIS/NIS+ databases.  For more  information on
NIS/NIS+ maps refer to the NIS/NIS+ System Administration Guide or the
online AnswerBook.

<br>
<br>
<hr>
<b>Clusters Database</b><p>

The <tt>clusters</tt> database maps a cluster name to the list of
hostnames that make up the cluster. Each line in this database
specifies a cluster.  The format is: <p>

<blockquote>
<i>clustername hostname-1 hostname-2 [...] hostname-n</i>
</blockquote>

Sample <tt>clusters</tt> database entries are:

<blockquote>
<pre>
planets  mercury venus
wine     zinfandel merlot chardonnay riesling
</pre>
</blockquote>

The <tt>clusters</tt> database is used by all three 
    <a href="cconsole/session_types">session types</a>
of the Cluster Console (<tt>cconsole</tt>, <tt>ctelnet</tt>, and
<tt>crlogin</tt>) to map cluster names to host names on the
    <a href="cconsole/command_line_options">command line</a>
and in the
    <a href="cconsole/select_hosts_dialog">Select Hosts dialog</a>.<p>

To create the <tt>/etc/clusters</tt> file:
<ul>

Become  root (superuser) and  create a file named <tt>clusters</tt> in
<tt>/etc</tt>.<p>

Enter   the  necessary information, delimited   by  whitespaces.   For
example,  to create a  cluster  named <tt>wine</tt>  that consists  of
nodes <tt>zinfandel</tt>,    <tt>merlot</tt>,  <tt>chardonnay</tt> and
<tt>riesling</tt>, enter:<p>

<tt>wine  zinfandel merlot chardonnay riesling</tt><p>
</ul>

This  file requires updating only  if Hostname(s)  change or nodes are
added or removed.

<br>
<br>
<hr>
<b>Serialports Database</b><p>

The <tt>serialports</tt> database maps a host name to the
    <a href="cconsole/tc">terminal concentrator</a>
and the terminal concentrator serial port to which the console
is connected.  Each line in this database specifies the serial port of a
host. The format is:

<blockquote>
<i>hostname terminal_concentrator serial_port</i>
</blockquote>

Sample <tt>serialports</tt> database entries (except for E10000 nodes)are:

<blockquote>
<pre>
mercury   planets-tc 5002
venus     planets-tc 5003
</pre>
</blockquote>

The <tt>serialports</tt> database is used by the <tt>cconsole</tt>
    <a href="cconsole/session_types">session type</a>
of this program to determine which terminal concentrator and serial port
to connect to for hosts or clusters specified on the
    <a href="cconsole/command_line_options">command line</a>
or in the
    <a href="cconsole/select_hosts_dialog">Select Hosts dialog</a>.
<p>

In the above example, node mercury is connected to planets-tc port 2
while node venus is connected to planets-tc port 3.  (Port 1 is
generally used for administration of the terminal concentrator
itself).

To create the <tt>/etc/serialports</tt> file:
<ul>

Become  root (superuser) and  create a file named <tt>serialports</tt> in
<tt>/etc</tt>.<p>

For  each  host   enter <i>hostname  terminal_concentrator serial_port
</i>in the file.The following is an example for a 4 node cluster.

<tt><pre>
zinfandel   wines-tc   5002
merlot      wines-tc   5003
chardonnay  wines-tc   5004
riesling    wines-tc   5005
</tt></pre><p>
</ul>

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. Following is the  generic format for the entry.<p>
<blockquote>
<i>hostname        SSPname  23</i>
</blockquote>
Sample <tt>serialports</tt> database entries for E10000 nodes are:

<blockquote>
<pre>
cashews         nuts-ssp-1  23
pecans          nuts-ssp-2  23
</pre>
</blockquote>

This  file requires updating only  if 
<ul>
<li> Hostname(s) change.
<li> Terminal Concentrator's name changes.
<li> Port number of host on the terminal concentrator changes.
<li> Hosts are added/removed to/from the terminal concentrator.
</ul>







