Content-type: text/html
dxpresto - Graphically displays Prestoserve state and statistics.
/usr/bin/X11/dxpresto [-options] [hostname]
Specifies the color of the window's border (color displays
only). The default is black.
Specifies the color of the window's background (color displays
only). The default is white.
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).
This option is the same as the
-d
option.
Specifies the color of the text (color displays only). The
default is black.
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).
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.
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).
The dxpresto window contains the following information: 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. 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. 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. 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. 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. 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. Allows you to display or to not display graphs that demonstrate how the Prestoserve cache is being utilized. Allows you to display or to not display the Prestoserve cache statistics table. Allows you to exit from dxpresto. 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.
If you enable the Display Cache Utilization graphs, the following is displayed: 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. Shows a recent history of the average number of writes per second over the time intervals that are determined by the sample interval.
If you enable the Display Cache Statistics table, the following is displayed:
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.
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.
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.
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.
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
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
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. Specifies the resource. 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:
The dialog box containing all of the graphs
The graph displaying dirty buffers
The graph displaying clean buffers
The graph displaying inval buffers
The graph displaying active buffers
The graph displaying cache write history
The graph displaying cache hit history
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
X(1X), dxsession(1X), presto(7), portmap(8), presto(8), prestoctl_svc(8)
Guide to Prestoserve