 |
Index for Section 8 |
|
 |
Alphabetical listing for D |
|
dxpresto(8X)
NAME
dxpresto - Graphically displays Prestoserve state and statistics.
SYNOPSIS
/usr/bin/X11/dxpresto [-options] [hostname]
OPTIONS
-bd color
Specifies the color of the window's border (color displays only). The
default is black.
-bg color
Specifies the color of the window's background (color displays only).
The default is white.
-d dispname
Specifies the display screen on which dxpresto displays its window. If
the display option is not specified, dxpresto uses the display screen
specified by your DISPLAY environment variable. The display variable
has the format hostname:number. Using two colons (::) instead of one
(:) indicates that DECnet is to be used for transport. The default is
:0. For more information, see X(1X).
-display dispname
This option is the same as the -d option.
-fg color
Specifies the color of the text (color displays only). The default is
black.
-geometry
Specifies the width, length, and location of the dxpresto window. If
the geometry option is not specified, dxpresto uses default values. The
geometry option has the format =[width][xlength][x][y]. For more
information about the screen coordinate system, see X(1X).
DESCRIPTION
The dxpresto command is an X Window System application that graphically
displays a machine's Prestoserve state and statistics. The dxpresto command
uses a Remote Procedure Call (RPC) protocol to communicate with the machine
being monitored. You use the dxpresto command to provide general
information about Prestoserve and to help manage Prestoserve. Also, you
can use the command to demonstrate the efficacy of the Prestoserve
software.
Use the hostname variable to specify the machine that you want to monitor;
the machine must be running the Prestoserve software. If hostname is not
specified, the local machine running the Prestoserve software is monitored.
If hostname is not specified and the local machine is not running the
Prestoserve software, the dxpresto window opens but it is not functional
until you enter the name of a host running the Prestoserve software in the
Host field.
Note
The machine that you want to monitor must be running the prestoctl_svc
daemon. Also, if you want to be able to enable or disable Prestoserve
on the machine, it must be running the prestoctl_svc daemon with the
-n option. The portmap daemon must be running if you want to use
dxpresto .
Because dxpresto is an X Window System application, your DISPLAY
environmental variable must be set to a machine that is an X Server. For
more information, see X(1X).
dxpresto Window
The dxpresto window contains the following information:
Host field
Shows the name of the host that you are monitoring. You type a host
name in the field and hit the Return key to monitor that host.
Presto State buttons
Show the Prestoserve state, either Enabled (UP), Disabled (DOWN), or
Error (ERROR). If the machine being monitored is running the
prestoctl_svc daemon with the -n option, you can change the machine's
Prestoserve state to either Enabled (UP) or Disabled (DOWN) by clicking
on the appropriate button. You cannot click on the Error button;
contact the server administrator or the server hardware Field Service
representative if the Error button is enabled.
Sample Interval slider
Displays the interval of time in seconds between Prestoserve queries
and allows you to change that interval. When you invoke the dxpresto
command, the default sample interval is 5; therefore Prestoserve
information is gathered every five seconds. For example, if you want
Prestoserve queried more often, move the slider to the left and click
on MB1 until 2 appears; Prestoserve is then queried every two seconds.
Time since last Enable field
Shows the time since Prestoserve was last enabled. The time is
displayed in hours, minutes, and seconds. The total number of seconds
is also shown.
Battery icons
Show the state of the Prestoserve backup battery system. An intact
battery icon with the word ok indicates that the battery has sufficient
power. An intact battery icon with the word low indicates that the
battery's power is low. A broken battery icon indicates that the
battery is disabled. Prestoserve goes into the ERROR state when the
backup battery power falls below a minimum amount. Contact the server
administrator or the server hardware Field Service representative if a
battery is low or disabled.
Size field
Displays the number of Kbytes of nonvolatile memory that the
Prestoserve cache is utilizing. Note that Prestoserve can utilize less
than the default maximum size of its Prestoserve cache if you changed
the cache size with the presto -s command.
Display Cache Utilization buttons
Allows you to display or to not display graphs that demonstrate how the
Prestoserve cache is being utilized.
Display Cache Statistics buttons
Allows you to display or to not display the Prestoserve cache
statistics table.
Exit button
Allows you to exit from dxpresto.
Message bar
Displays error messages and informational messages for both Prestoserve
and the dxpresto command. For example, if the prestoctl_svc daemon
with the -n option is not running on the machine you are monitoring, a
message is displayed indicating that changes to Prestoserve operation
are not allowed.
Some error messages, such as those indicating RPC communication
failure, are displayed on the terminal from which you invoked the
dxpresto command.
Cache Utilization Graphs
If you enable the Display Cache Utilization graphs, the following is
displayed:
Presto buffers status bar graph
Shows how the Prestoserve cache operations are distributed among the
four Prestoserve buffer states: dirty, clean, inval, and active. The
vertical axis shows the maximum number of objects or disk blocks that
the entire Prestoserve cache can contain. The sum of the four bars is
the total number of buffers used in the Prestoserve cache. Note that
the size of the Prestoserve cache can be changed by using the presto -s
command.
Writes per second trend line graph
Shows a recent history of the average number of writes per second over
the time intervals that are determined by the sample interval.
Each point in the horizontal axis represents a sample time interval as
determined by the sample interval; the maximum number of samples that
can be shown is 210. When you reach the maximum number of samples, the
graph shifts to the left so you can see at least the last 105 samples,
which is half the maximum number of samples. If you choose 5 as the
sample interval, Prestoserve is queried every five seconds; therefore
it takes 1050 (5 x 210) seconds to obtain the maximum of 210 samples.
The vertical axis shows the average number of writes performed per
second within the sample time interval as determined by the sample
interval.
For example, if you choose 2 as the sample interval, Prestoserve is
queried every two seconds, and each point in the graph shows the
average number of writes performed within the interval of two seconds.
If the graph shows that an average of 5 writes per second were
performed within two seconds, Prestoserve actually performed 10 writes
within those two seconds. The calculation is:
5 writes
---------- x 2 sec = 10 writes
sec
If you change hosts, the Writes per second graph displays a vertical
line of dashes to distinguish the new host's information from the
previous host's information.
Hits per second trend line graph
Shows a recent history of the average number of Prestoserve cache hits
per second over the time intervals that are determined by the sample
interval. The Prestoserve cache hits represent the total number of
clean and dirty read and write hits (blocks that match blocks already
in the cache).
Each point in the horizontal axis represents a sample time interval as
determined by the sample interval; the maximum number of samples that
can be shown is 210. When you reach the maximum number of samples, the
graph shifts to the left so you can see at least the last 105 samples,
which is half the maximum number of samples. If you choose 2 as the
sample interval, Prestoserve is queried every two seconds; therefore it
takes 420 (2 x 210) seconds to obtain the maximum of 210 samples.
The vertical axis shows the average number of hits performed per second
within the sample time interval as determined by the sample interval.
For example, if you choose 10 as the sample interval, Prestoserve is
queried every 10 seconds, and each point in the graph shows the average
number of hits performed within the interval of 10 seconds. If the
graph shows that an average of 2 hits per second were performed within
10 seconds, Prestoserve actually performed 20 writes within those 10
seconds. The calculation is:
2 hits
---------- x 10 sec = 20 hits
sec
If you change hosts, the Hits per second graph displays a vertical line
of dashes to distinguish the new host's information from the previous
host's information.
Cache Statistics Table
If you enable the Display Cache Statistics table, the following is
displayed:
Since last Enable button
Allows you to display Prestoserve statistics since Prestoserve was last
enabled. This is useful when you want to determine how Prestoserve
performs over a long period of time.
Since last Sample button
Allows you to display the Prestoserve statistics for each sample time
interval as determined by the Sample Interval slider. If no
Prestoserve activity occurs during the time interval, the numbers in
the statistics table are zero. For example, if the Sample Interval
slider is set to 5 and the Since last Sample button is enabled, the
statistics table shows the Prestoserve statistics for each interval of
five seconds.
Since last Zero button
Allows you to display Prestoserve statistics since you clicked on the
Zero button. This button allows you to determine how Prestoserve
performs over a specific period of time that you can set by using the
Zero button.
Zero button
Allows you to set a time reference for the Prestoserve statistics
table. If you click on the Zero button and, at a later time, click on
the Since last Zero button, the table displays the Prestoserve
statistics since you clicked on the Zero button.
Prestoserve statistics table
Shows information similar to the information that is displayed when you
use the presto -p command. For each Prestoserve cache read or write
operation, Prestoserve increments an appropriate counter. The table
shows:
·
The Write Cache Efficiency, which the ratio of write dirty hits to
the number of writes copied into the Prestoserve cache
·
The Count, which is the sum of the clean hits, dirty hits, and
allocations, and passes
·
The Hit rate percentage, which is the ratio of clean hits and dirty
hits to the total count
·
The Clean hits counter, which is the number of hits on the clean
buffers
·
The Dirty hits counter, which is the number of hits on the dirty
buffers (each dirty hit represents a physical disk write that was
avoided entirely)
·
The Allocations counter, which is the number of new buffers that had
to be allocated for disk block images
·
The passes counter, which is the number of I/O operations that
Prestoserve passed directly to the actual device driver
X DEFAULTS
The dxpresto application uses the values in the .Xdefaults file when you
logged in and uses the appropriate resource specification to customize the
appearance or characteristics of its displayed dxpresto window. The format
for a resource specification in the .Xdefaults file is:
name*resource: value
name
Specifies the application name or the name string that restricts the
resource assignment to that application or to a component of an
application. If this argument is not specified, the resource
assignment is globally available to all X applications.
resource
Specifies the resource.
value
Specifies the value that is to be assigned to the resource.
For more information, see X(1X).
Because each toolkit-based application can consist of a combination of
widgets (for example, push buttons and a scroll bar), you can form the name
string by adding widget class and name identifiers to the string. For
further information about adding class and name identifiers, see X(1X).
For dxpresto, the available name identifiers are:
graph_parent
The dialog box containing all of the graphs
dirty_graph
The graph displaying dirty buffers
clean_graph
The graph displaying clean buffers
inval_graph
The graph displaying inval buffers
active_graph
The graph displaying active buffers
write_graph
The graph displaying cache write history
hit_graph
The graph displaying cache hit history
EXAMPLES
The following is an example of the suggested resource values:
DXpresto*background: darkslategray
DXpresto*foreground: wheat1
DXpresto*borderColor: gold3
DXpresto*graph_parent*borderColor: firebrick
DXpresto*dirty_graph*highlight: gold3
DXpresto*dirty_graph*background: black
DXpresto*clean_graph*highlight: gold3
DXpresto*clean_graph*background: black
DXpresto*inval_graph*highlight: gold3
DXpresto*inval_graph*background: black
DXpresto*active_graph*highlight: gold3
DXpresto*active_graph*background: black
DXpresto*write_graph*highlight: gold3
DXpresto*write_graph*background: black
DXpresto*hit_graph*highlight: gold3
DXpresto*hit_graph*background: black
DXpresto*topShadowColor: gold2
DXpresto*bottomShadowColor: gold4
DXpresto*armColor: gold3
DXpresto*selectColor: gold3
DXpresto*presto_on.selectColor: green
DXpresto*presto_off.selectColor: yellow
DXpresto*presto_error.selectColor: red
FILES
/usr/lib/X11/uid/dxpresto.uid
/usr/lib/X11/app-defaults/DXpresto
~/.Xdefaults
SEE ALSO
X(1X), dxsession(1X), presto(7), portmap(8), presto(8), prestoctl_svc(8)
Guide to Prestoserve