dxpresto man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

dxpresto(8X)							  dxpresto(8X)

NAME
       dxpresto - Graphically displays Prestoserve state and statistics.

SYNOPSIS
       /usr/bin/X11/dxpresto [-flags] [hostname]

FLAGS
       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  flag  is
       not  specified, dxpresto uses the display screen specified by your DIS‐
       PLAY environment variable.  The display variable has the	 format	 host‐
       name: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 flag is the same as the -d flag.	Speci‐
       fies the color of the text  (color  displays  only).   The  default  is
       black.	Specifies the width, length, and location of the dxpresto win‐
       dow.  If the geometry flag is not specified, dxpresto uses default val‐
       ues.   The  geometry  flag 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 moni‐
       tor; 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  dae‐
 mon.	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 flag.

 The portmap daemon must be running if you want to use dxpresto .

       Because dxpresto is an X Window System application, your DISPLAY	 envi‐
       ronmental  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: 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
       flag,  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  sec‐
       onds  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 indi‐
       cates  that  the	 battery is disabled.  Prestoserve goes into the ERROR
       state when the backup battery power falls below a minimum amount.  Con‐
       tact the server administrator or the server hardware Field Service rep‐
       resentative 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	demon‐
       strate how the Prestoserve cache is being utilized.  Allows you to dis‐
       play 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 flag 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: 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.

	      Each point in the	 horizontal  axis  represents  a  sample  time
	      interval	as determined by the sample interval; the maximum num‐
	      ber 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 ver‐
	      tical line of dashes to distinguish the new  host's  information
	      from the previous host's information.  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 num‐
	      ber 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 sam‐
	      ple 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  cal‐
	      culation is:

		2 hits ---------- x 10 sec = 20 hits
		 sec

	      If you change hosts, the Hits per second graph displays a verti‐
	      cal 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 dis‐
       played: 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  dur‐
       ing  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  ta‐
       ble.   If  you  click on the Zero button and, at a later time, click on
       the Since last Zero button, the table displays the Prestoserve  statis‐
       tics  since  you clicked on the Zero button.  Shows information similar
       to the information that is displayed when you use the  presto  -p  com‐
       mand.   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 per‐
       centage, 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  cus‐
       tomize the appearance or characteristics of its displayed dxpresto win‐
       dow.  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.	 Spec‐
       ifies  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  con‐
       taining	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

EXAMPLES
       The following is an example of the suggested resource values:

       DXpresto*background:			darkslategray	DXpresto*fore‐
       ground:				  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*high‐
       light:		 gold3	DXpresto*hit_graph*background:		 black
       DXpresto*topShadowColor:			gold2	DXpresto*bottomShadow‐
       Color:		   gold4 DXpresto*armColor:			 gold3
       DXpresto*selectColor:						 gold3
       DXpresto*presto_on.selectColor:					 green
       DXpresto*presto_off.selectColor:					yellow
       DXpresto*presto_error.selectColor:      red

FILES
RELATED INFORMATION
       X(1X),	  dxsession(1X),     presto(7),	    portmap(8),	    presto(8),
       prestoctl_svc(8)

       Guide to Prestoserve

								  dxpresto(8X)
[top]

List of man pages available for Ultrix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net