dxpresto(8X) dxpresto(8X)
Name
dxpresto - graphically display Prestoserve state and statistics
Syntax
/usr/etc/dxpresto [options] [hostname]
Description
The command is an X Window System application that graphically displays a machine's Prestoserve state and statistics. The command uses a
Remote Procedure Call (RPC) protocol to communicate with the machine being monitored. You use the 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 host-
name is not specified, the window opens but it is not functional until you enter the name of a host running the Prestoserve software in the
Host field. The machine that you want to monitor must be running the daemon. Also, if you want to be able to enable or disable
Prestoserve on the machine, it must be running the daemon with the option.
Because 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
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 displays its window. If the display option is not specified, uses the display
screen specified by your DISPLAY environment variable. The display option 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 infor-
mation, see
-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 window. If the geometry option is not specified, uses default values.
The geometry option has the format =[width][xlength][x][y]. For more information about the screen coordinate system,
see
dxpresto Window
The 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
daemon with the 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 between Prestoserve queries and allows you to change that interval. When you invoke the 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 sec-
onds is also shown.
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 command.
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 indi-
cates 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.
Display Cache Utilization buttons
Allow you to display or to not display graphs that demonstrate how the Prestoserve cache is being utilized.
Display Cache Statistics buttons
Allow you to display or to not display the Prestoserve cache statistics table.
Exit button
Allows you to exit from
Message bar
Displays error messages and informational messages for both Prestoserve and the command. For example, if the daemon with the option
is not running on the machine you are monitoring, then 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
command.
Cache Utilization Graphs
If you enable the Display Cache Utilization graphs, the following is displayed:
Presto buffers 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 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 inter-
val.
Each point in the horizontal axis represents a sample time interval as determined by the sample interval; the maximum number of sam-
ples 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 sam-
ple 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 sam-
ples 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:
Prestoserve statistics table
Shows information similar to the information that is displayed when you use the command. For each Prestoserve cache read or write
operation, Prestoserve increments an appropriate counter. The table shows:
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 passes counter, which is the number of I/O operations that Prestoserve passed directly to the actual device driver
The count, which is the sum of the three previous counters
The hit rate percentage, which is the ratio of clean hits and dirty hits to the total count
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.
X Defaults
The 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 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
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 identi-
fiers, see
For 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
If you want to change the foreground and background colors of the window and to customize the window's graphs, you can add the following
entries to your .Xdefaults file:
DXpresto*background: darkslategray
DXpresto*foreground: wheat
DXpresto*borderColor: gold
DXpresto*highlight: yellow
DXpresto*graph_parent*borderColor: firebrick
DXpresto*dirty_graph*highlight: gold
DXpresto*dirty_graph*background: black
DXpresto*clean_graph*highlight: gold
DXpresto*clean_graph*background: black
DXpresto*inval_graph*highlight: gold
DXpresto*inval_graph*background: black
DXpresto*active_graph*highlight: gold
DXpresto*active_graph*background: black
DXpresto*write_graph*highlight: gold
DXpresto*write_graph*background: black
DXpresto*hit_graph*highlight: gold
DXpresto*hit_graph*background: black
Files
See Also
presto(4), presto(8), prestoctl_svc(8), X(1X), dxsession(1X)
Guide to Prestoserve
dxpresto(8X)