
<!-- "@(#)fp_picture_area	1.15 95/05/08 Sun Microsystems, Inc." >

<title>Graphical Picture Area</title>
<h1>Graphical Picture Area</h1>

The graphical picture in the
    <a href="clustmon/front_panel">Front Panel</a>
contains a representative diagram of your SPARCcluster PDB system
configuration.  The diagram shows the two types of components that make
up the cluster: <b>nodes</b> and <b>disk arrays</b>.  <p>

Additionally, each component may have numerous subcomponents, of which
there are two types:  <b>hardware components</b> and <b>software
components</b>. <p>




<hr>
<b>Node Components</b><p>

<img src="clustmon/fp_node.gif">
<br>
A node is a box that represents a SPARCserver 1000 or a SPARCcenter
2000 (the node name, for example, bulldogs, is displayed immediately above the box), in which the following <b>hardware subcomponents</b> are represented: <p>

<ul>
<li> Boot disks <i>(Not implemented yet)</i>
<li> CD-ROM drive <i>(Not implemented yet)</i>
<li> All CPU's
<li> Memory
<li> Public nets
<li> Private nets
<li> SOC ports
</ul>

Additionally, the following <b>software subcomponents</b> are
represented in the same area: <p>
<ul>
<li> SPARCcluster PDB framework software
<li> <a href="pdb/cvm">Cluster Volume Manager</a>
<li> Oracle Parallel Server
</ul>

See below for a discussion on the appearance of hardware and software
subcomponents. <p>

Additionally, the overall node state will be set according to the state
of the PDB and CVM software subcomponents.  The possible overall node
states are:

<ul>
<li> <b>Working</b> - Node is fully functional and serving database clients.
     Specifically, the node is a member of the cluster and CVM is up.
<li> <b>Minor Failure</b> - Node is a member of the cluster.  However, it
     is either serving database clients in a degraded state or not serving
     database clients at all due to a "minor" failure or operator intervention.
<li> <b>Major Failure</b> - Node is not a member of the cluster and not
     serving database clients due to a "major" failure or operator
     intervention.
</ul>

The
    <a href="clustmon/item_props_dialog">Item Properties dialog</a>
also displays the current overall state of a node. 

<p>




<hr>
<b>Disk Array Components</b><p>

<img src="clustmon/fp_pluto.gif">
<br>

A disk array is a smaller box representing a SPARCstorage Array 100
(the last four digits of the World Wide Name of the disk array are displayed immediately below it).  <p>



<hr>
<b>Hardware Subcomponents</b><p>

Hardware subcomponents appear as square boxes that are accompanied by
either a textual or graphical label.  The graphical symbols are:

<ul>
<li> Ethernet port - <img src="clustmon/sc_ethernet.gif"> 
<li> Fibre channel port - <img src="clustmon/sc_oc.gif">
<li> Other - <img src="clustmon/sc_other.gif">
</ul>

The possible states for hardware subcomponents are:

<ul>
<li> <b>Working, Online, Selected</b> - Subcomponent is functional and online.
     In addition, subcomponent is one of a redundant pair that has been
     selected for use by the cluster.  <i>(This currently is only used
     by the
	<a href="pdb/private_net">private interconnect wires</a>)</i> 
<li> <b>Working, Online</b> - Subcomponent is functional and online.
<li> <b>Working, Offline</b> - Subcomponent is functional but currently
     offline.
<li> <b>Broken, Offline</b> - Subcomponent is non-functional and offline.
<li> <b>In Transition</b> - Subcomponent is currently changing or in between
      states.
<li> <b>Unknown</b> - Subcomponent state is not currently known.  This
     generally is due to a Solaris driver not providing information.
</ul>

Cluster Monitor displays each hardware subcomponent's state by filling
in the square box with the corresponding state color, as defined by the
Cluster Monitor Properties sheet <i>(not yet implemented)</i>.  Additionally,
state (and other details) can be found in the
    <a href="clustmon/item_props_dialog">Item Properties dialog</a>.
<p>




<hr>
<b>Software Subcomponents</b><p>

Software subcomponents appear as rectangular boxes that are accompanied
by a textual label.  These only appear in node components.  Currently,
three software subcomponents are implemented, and each has its own
states.  The software subcomponents (and their possible states) are:

<ul>
<li> <b>pdb</b> (SPARCcluster PDB framework software)
     <ul>
     <li> <b>Is A Cluster Member</b> - Node is a participating member in the 
	  cluster.
     <li> <b>In Transition</b> - Node is currently changing membership state
	  (between joining and leaving the cluster).
     <li> <b>Not A Cluster Member</b> - Node is not a participating member in
	   the cluster.
     <li> <b>Stopped</b> - PDB framework software has been stopped on the node.
     <li> <b>Aborted</b> - PDB framework software has aborted on the node.
     </ul>
     <p>
<li> <b>cvm</b> (Cluster Volume Manager)
     <ul>
     <li> <b>Up</b> - CVM is up and running.
     <li> <b>In Recovery</b> - CVM is currently resyncing the volumes.
     <li> <b>Down</b> - CVM is currently down.
     </ul>
     <p>
<li> <b>ora</b> (Oracle Parallel Server)
     <ul>
     <li> <b>Up</b> - OPS is up and running.
     <li> <b>Down</b> - OPS is currently down.
     </ul>
</ul>

Cluster Monitor displays each software subcomponent's state in the form
of a progress indicator: a corresponding percentage of the rectangular
box will be filled in with a corresponding state color.  State percentages
and colors are defined in the Cluster Monitor Properties sheet <i>(not
yet implemented)</i>.  Additionally, state (and other details) can be
found in the
    <a href="clustmon/item_props_dialog">Item Properties dialog</a>.
<p>
