355 lines
14 KiB
Plaintext
355 lines
14 KiB
Plaintext
<SGIDOC LANG=C><MANUAL>
|
|
|
|
<SECTION2 HELPID = "dummy">
|
|
</SECTION2>
|
|
|
|
<SECTION2 HELPID = "overview">
|
|
<TITLE><XREFTARGET ID="AI0010">oview Overview</TITLE>
|
|
|
|
<PARAGRAPH>
|
|
The <ITALICS>oview</ITALICS> displays a dynamic 3D representation of the
|
|
topology and activity of an Origin system. It is a 3D Open Inventor graphical
|
|
tool for Performance Co-Pilot (PCP).
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
<ITALICS>oview</ITALICS> can display performance information about CPUs,
|
|
nodes and CrayLink routers in Origin systems. The system topology is
|
|
described in the <XREF IDREF="AI0700" TYPE="TITLE">Origin Topology</XREF>
|
|
section of this guide.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
By default, <ITALICS>oview</ITALICS> operates in `live' mode, fetching
|
|
the topology and the metrics from the local host in real-time.
|
|
<ITALICS>oview</ITALICS> may fetch the metrics from any host which is
|
|
running the PCP collector software, or from a PCP archive.
|
|
When fetching metrics from an archive, <ITALICS>oview</ITALICS> operates
|
|
in `archive' mode where the user can interactively control the current
|
|
replay rate and time using a VCR paradigm.
|
|
This is particularly useful for retrospective comparisons and for
|
|
post-mortem analysis of performance problems where a remote system is
|
|
not accessible or a performance analyst is not available on-site.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
Other PCP tools may be launched from <ITALICS>oview</ITALICS> so that specific
|
|
areas of interest from the performance perspective can be explored in more
|
|
detail (see the <XREF IDREF="AI0300" TYPE="TITLE">Launch Menu</XREF>).
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
The <ITALICS>oview</ITALICS> window is shown in Figure 1. It is comprised
|
|
of a menu bar, time and scale controls, metric and time values, and an
|
|
`examiner' Inventor viewer which displays the 3D scene described in the
|
|
<XREF IDREF="AI0700" TYPE="TITLE">Origin Topology</XREF> section.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH><FIGURE>
|
|
<PARAGRAPH> </PARAGRAPH>
|
|
<GRAPHIC FILE="startup.gif" POSITION="INLINE" scale="FALSE">
|
|
<CAPTION><PREFIX>Figure 1</PREFIX>An <ITALICS>oview</ITALICS> window when invoked on an
|
|
eight router Origin system.</CAPTION>
|
|
</FIGURE></PARAGRAPH>
|
|
<PARAGRAPH>
|
|
The Menu Bar options are described in the following sections:
|
|
</PARAGRAPH>
|
|
<PARAGRAPH></PARAGRAPH>
|
|
<BULLETLIST>
|
|
<BULLET><PARAGRAPH>
|
|
File - <XREF IDREF="AI0100" TYPE="TITLE">The File Menu</XREF>
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>
|
|
Options - <XREF IDREF="AI0200" TYPE="TITLE">The Options Menu</XREF>
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>
|
|
Launch - <XREF IDREF="AI0300" TYPE="TITLE">The Launch Menu</XREF>
|
|
</PARAGRAPH></BULLET></BULLETLIST>
|
|
<PARAGRAPH>
|
|
The components of the display that are specific to <ITALICS>oview</ITALICS>
|
|
are described in the following sections:
|
|
</PARAGRAPH>
|
|
<PARAGRAPH></PARAGRAPH>
|
|
<BULLETLIST>
|
|
<BULLET><PARAGRAPH>
|
|
Time Control - <XREF IDREF="AI0400" TYPE="TITLE">The Time Controls</XREF>
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>
|
|
Scale Control - <XREF IDREF="AI0500" TYPE="TITLE">The Scale Controls</XREF>
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>
|
|
Metric Selection - <XREF IDREF="AI0600" TYPE="TITLE">Metric Selection</XREF>
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>
|
|
Topology - <XREF IDREF="AI0700" TYPE="TITLE">Origin Topology</XREF>
|
|
</PARAGRAPH></BULLET>
|
|
</BULLETLIST>
|
|
|
|
<PARAGRAPH>
|
|
The `?' button on the right-hand edge of the window may be used to display
|
|
generic help on how to use the Inventor viewer.
|
|
</PARAGRAPH>
|
|
|
|
<PARAGRAPH>
|
|
The terminology used for the various text boxes and buttons below the
|
|
Menu Bar is explained in Figure 2.
|
|
<PARAGRAPH><FIGURE>
|
|
<PARAGRAPH> </PARAGRAPH>
|
|
<GRAPHIC FILE="toptext.gif" POSITION="INLINE" scale="FALSE">
|
|
<CAPTION><PREFIX>Figure 2</PREFIX>Names for text boxes and buttons in the
|
|
<ITALICS>oview</ITALICS> window.</CAPTION>
|
|
</FIGURE></PARAGRAPH>
|
|
</PARAGRAPH>
|
|
</SECTION2>
|
|
|
|
<SECTION2 HELPID = "fileMenu">
|
|
<TITLE><XREFTARGET ID="AI0100">The File Menu</TITLE>
|
|
|
|
<PARAGRAPH>
|
|
The File Menu allows you to save or print the 3D scene, or to quit.
|
|
</PARAGRAPH>
|
|
<BULLETLIST>
|
|
<BULLET><PARAGRAPH>Save - A file selection dialog will prompt for the output
|
|
file name. The generated file will contain the Open Inventor ASCII
|
|
description of the current view which can then be read by
|
|
<ITALICS>ivview</ITALICS> and some Web browsers.
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>Print - A dialog will prompt you for the printer and size
|
|
of the output image. Pressing the print button will send the current scene
|
|
to the selected printer.
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>Quit - <ITALICS>oview</ITALICS> will terminate immediately.
|
|
</PARAGRAPH></BULLET>
|
|
</BULLETLIST>
|
|
</SECTION2>
|
|
|
|
<SECTION2 HELPID = "optionsMenu">
|
|
<TITLE><XREFTARGET ID="AI0200">The Options Menu</TITLE>
|
|
<PARAGRAPH>
|
|
The Options Menu is used to gain access to the time controls and to control
|
|
the level of detail shown. The time controls drive the 3D scene, and are
|
|
described in <XREF IDREF="AI0400" TYPE="TITLE">The Time Controls</XREF>
|
|
section. Some `level of detail' menu items may be insensitive at times
|
|
depending on what is currently shown in the scene.
|
|
<BULLETLIST>
|
|
<BULLET><PARAGRAPH>Show Time Control - The <XREF IDREF="AI0400"
|
|
TYPE="TITLE">Time Control dialog</XREF> is displayed
|
|
or brought to the front if hidden by other windows.
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>New Time Control - A new <XREF IDREF="AI0400"
|
|
TYPE="TITLE">Time Control dialog</XREF> is created and displayed.
|
|
This is useful when the current time controls are shared with other
|
|
PCP tools and a separate time control dialog is required for this
|
|
<ITALICS>oview</ITALICS> instance.
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>Show All Nodes - All nodes that are currently not
|
|
shown will be displayed. Any hidden CPUs will remain hidden. If all
|
|
nodes are already shown then this menu item will be insensitive.
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>Hide All Nodes - All nodes that are currently shown
|
|
will be hidden. This will also hide all CPUs. If all nodes are already
|
|
hidden then this menu item will be insensitive.
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>Show All CPUs - All CPUs that are currently not shown
|
|
will be displayed. This will also display all the nodes. If all CPUs
|
|
are already shown then this menu item will be insensitive.
|
|
</PARAGRAPH></BULLET>
|
|
<BULLET><PARAGRAPH>Hide All CPUs - All CPUs that are currently shown
|
|
will be hidden. If all CPUs are already hidden, then this menu item
|
|
will be insensitive.
|
|
</PARAGRAPH></BULLET>
|
|
</BULLETLIST>
|
|
<PARAGRAPH>
|
|
The text of the last two menu items may change, depending on the
|
|
current <XREF IDREF="AI0600" TYPE="TITLE">Metric Selection</XREF>.
|
|
</PARAGRAPH>
|
|
<BULLETLIST>
|
|
<BULLET><PARAGRAPH>Show/Hide Node(s) - Show (hide) the selected node,
|
|
or the nodes connected to the selected router. These options may only
|
|
be invoked when a router or a node has been selected with the left
|
|
mouse button.
|
|
</PARAGRAPH>
|
|
</BULLET>
|
|
<BULLET><PARAGRAPH>Show/Hide CPUs - Show (hide) the selected CPU, or
|
|
the CPUs attached to the selected node or router. These options may
|
|
only be invoked when a CPU, node or router has been selected with the
|
|
left mouse button.
|
|
</PARAGRAPH></BULLET>
|
|
</BULLETLIST>
|
|
</SECTION2>
|
|
|
|
<SECTION2 HELPID = "launchMenu">
|
|
<TITLE><XREFTARGET ID="AI0300">The Launch Menu</TITLE>
|
|
<PARAGRAPH>
|
|
The Launch menu is used to launch other PCP tools (see the
|
|
<ITALICS>PCPIntro(1)</ITALICS> manual page). The configuration of the
|
|
launched tools will vary depending on the current selections (if any) in
|
|
the <ITALICS>oview</ITALICS> scene.
|
|
The menu is created dynamically using configuration files described in
|
|
the <ITALICS>pmlaunch(5)</ITALICS> manual page.
|
|
</PARAGRAPH>
|
|
</SECTION2>
|
|
|
|
|
|
<SECTION2 HELPID = "vcrButton">
|
|
<TITLE><XREFTARGET ID="AI0400">The Time Controls</TITLE>
|
|
<PARAGRAPH>
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
The <ITALICS>time state button</ITALICS> (see Figure 3) is located in
|
|
the top left-hand corner of the <ITALICS>oview</ITALICS> window.
|
|
This button indicates the direction of play, and whether the metrics
|
|
are live or from an archive.
|
|
Clicking the left mouse button on the time state button will display the
|
|
Time Control dialog if it is not already visible.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH><FIGURE>
|
|
<PARAGRAPH> </PARAGRAPH>
|
|
<GRAPHIC FILE="vcr.gif" POSITION="INLINE" scale="FALSE">
|
|
<CAPTION><PREFIX>Figure 3</PREFIX>A <ITALICS>time state</ITALICS> button indicating that
|
|
<ITALICS>oview</ITALICS> is in `archive' mode and moving forward.</CAPTION>
|
|
</FIGURE></PARAGRAPH>
|
|
<PARAGRAPH>
|
|
The <ITALICS>time text box</ITALICS> displays the current time that
|
|
<ITALICS>oview</ITALICS> is visualizing, either from the live or archive
|
|
sources. The same time position shown in the Time Control dialog.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
Detailed help on the Time Control dialog can be obtained by pressing the
|
|
Help button in the Time Control dialog.
|
|
</PARAGRAPH>
|
|
</SECTION2>
|
|
|
|
<SECTION2 HELPID = "scaleWheel">
|
|
<TITLE><XREFTARGET ID="AI0500">The Scale Controls</TITLE>
|
|
<PARAGRAPH>
|
|
The <ITALICS>scale thumbwheel</ITALICS> and the
|
|
<ITALICS>scale text box</ITALICS> (located above the Inventor viewer)
|
|
allow the user to apply a multiplier to all values
|
|
represented in the scene. Spinning the wheel to the right or increasing
|
|
the text value for the scale will increase the length, height or color
|
|
of every modulated object in the scene. Spinning the wheel to the left
|
|
or lowering the text value will decrease the length, height or color
|
|
of every modulated object. The button between the thumbwheel and the
|
|
text box will reset the scale back to the original state. In addition,
|
|
the metric text for a selected object will indicate the value after
|
|
scaling as a percentage of the range. If the value (above the scale
|
|
controls) of a metric after scaling exceeds the defined range for an
|
|
object, the object will turn white.
|
|
</PARAGRAPH>
|
|
</SECTION2>
|
|
|
|
<SECTION2 HELPID = "metricSel">
|
|
<TITLE><XREFTARGET ID="AI0600">Metric Selection</TITLE>
|
|
<PARAGRAPH>
|
|
Users can select objects in the 3D scene.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
Make sure the pointer cursor is active (select the pointer button
|
|
on the right-hand edge of the window, or press escape). Move the
|
|
pointer over different objects in the scene. Metric information and
|
|
values for the object currently under the pointer will be displayed
|
|
in the <ITALICS>metric information text box</ITALICS>
|
|
(located beneath the Menu Bar).
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
Click (with the left mouse button) on an object to select it.
|
|
The selected object will have a red wire-frame drawn around it.
|
|
When an object has been selected in this way, the metric information
|
|
for this object is always displayed in the text box irrespective of
|
|
where the mouse pointer is. (See the selected router in Figure 4).
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
The text box is updated whenever the scene is updated with the latest
|
|
value for the metric of current interest. This description includes
|
|
the source, name and instances of the metric, the current value and
|
|
units, and the value as a percentage of the expected maximum value.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
Clicking the left mouse button on another object will change the
|
|
selection as only one object may be selected at a time. Selecting the
|
|
background will deselect any selected objects.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH><FIGURE>
|
|
<PARAGRAPH> </PARAGRAPH>
|
|
<GRAPHIC FILE="select.gif" POSITION="INLINE" scale="FALSE">
|
|
<CAPTION><PREFIX>Figure 4</PREFIX>Router in Module 1 Slot 1 has been selected.</CAPTION>
|
|
</FIGURE></PARAGRAPH><PARAGRAPH>
|
|
An object selected in this way will affect the <XREF IDREF="AI0200"
|
|
TYPE="TITLE">Options Menu</XREF> items and the behavior of the launched tools
|
|
from the <XREF IDREF="AI0300" TYPE="TITLE">Launch Menu</XREF>.
|
|
</SECTION2>
|
|
|
|
<SECTION2 HELPID = "topology">
|
|
<TITLE><XREFTARGET ID="AI0700">Origin Topology</TITLE>
|
|
<PARAGRAPH>
|
|
<ITALICS>oview</ITALICS> accurately represents the topology of an
|
|
Origin system by modulating objects which represent the routers,
|
|
nodes, CPUs and CrayLinks. This is illustrated in Figure 5. Note
|
|
that the colors may vary with differing application resources.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH><FIGURE>
|
|
<PARAGRAPH> </PARAGRAPH>
|
|
<GRAPHIC FILE="topology.gif" POSITION="INLINE" scale="FALSE">
|
|
<CAPTION><PREFIX>Figure 5</PREFIX>The topology of a four router Origin system when
|
|
visualized by <ITALICS>oview</ITALICS>.</CAPTION> </FIGURE>
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
The CrayLink tubes between routers and nodes show the
|
|
<ITALICS>receive</ITALICS> utilization of the associated node or
|
|
router port using colored bands which grow toward the mid-point of the
|
|
link as the utilization increases. <ITALICS>Receive by-pass</ITALICS>
|
|
and <ITALICS>receive queued</ITALICS> utilization of the link are
|
|
shown as stacked bands in violet and yellow respectively. The routers
|
|
change color according to the <ITALICS>average</ITALICS> receive
|
|
utilization of all connected links on the router.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
Nodes are represented by short cylinders. CPUs use a stack of three
|
|
colored blocks to show the <ITALICS>user, system</ITALICS> and
|
|
<ITALICS>wait</ITALICS> utilization of each CPU. The grey part of a
|
|
CPU, if visible, represents unused CPU capacity.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
If a metric exceeds the expected maximum value, the modulated object
|
|
will change color to white. If a metric is unavailable, the object
|
|
will change to a dark grey.
|
|
</PARAGRAPH>
|
|
<PARAGRAPH>
|
|
To avoid cluttering the scene in larger configurations, the initial
|
|
scene will show routers but may not show the nodes and/or CPUs,
|
|
depending on the number of routers present in the system hardware
|
|
inventory. Small systems (of up to four routers) will start with
|
|
nodes and CPUs displayed. Systems of five to eight routers will have
|
|
the CPUs initially hidden, but show the nodes. A system with more
|
|
than eight CrayLink routers will begin showing neither nodes nor CPUs.
|
|
CPUs cannot be shown without their associated nodes. Nodes and CPUs
|
|
may be interactively displayed and removed from the scene using the
|
|
<XREF IDREF="AI0200" TYPE="TITLE">Options Menu</XREF>.
|
|
</PARAGRAPH>
|
|
</SECTION2>
|
|
|
|
<SECTION2 HELPID = "keys">
|
|
<TITLE><XREFTARGET ID="AI0800">Keys and Short Cuts</TITLE>
|
|
<PARAGRAPH>
|
|
Most menu options have a keyboard and a mnemonic shortcut:
|
|
</PARAGRAPH>
|
|
<BULLETLIST>
|
|
<BULLET><PARAGRAPH><BOLD>Record</BOLD> - <ITALICS>Ctrl</ITALICS>-R or
|
|
<ITALICS>Alt</ITALICS>-F R</PARAGRAPH>
|
|
</BULLET>
|
|
<BULLET><PARAGRAPH><BOLD>Save</BOLD> - <ITALICS>Ctrl</ITALICS>-S or
|
|
<ITALICS>Alt</ITALICS>-F S</PARAGRAPH>
|
|
</BULLET>
|
|
<BULLET><PARAGRAPH><BOLD>Print</BOLD> - <ITALICS>Ctrl</ITALICS>-P or
|
|
<ITALICS>Alt</ITALICS>-F P</PARAGRAPH>
|
|
</BULLET>
|
|
<BULLET><PARAGRAPH><BOLD>Quit</BOLD> - <ITALICS>Ctrl</ITALICS>-Q or
|
|
<ITALICS>Alt</ITALICS>-F Q</PARAGRAPH>
|
|
</BULLET>
|
|
<BULLET><PARAGRAPH><BOLD>Show Time Control</BOLD> - <ITALICS>Ctrl</ITALICS>-T or
|
|
<ITALICS>Alt</ITALICS>-O T</PARAGRAPH>
|
|
</BULLET>
|
|
<BULLET><PARAGRAPH><BOLD>New Time Control</BOLD> - <ITALICS>Ctrl</ITALICS>-N or
|
|
<ITALICS>Alt</ITALICS>-O N</PARAGRAPH>
|
|
</BULLET>
|
|
</BULLETLIST>
|
|
</SECTION2>
|
|
|
|
</MANUAL><SGIDOC>
|