GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CFETOOLUPDATE (8)

NAME

cfetool update - Update the database with a new value

CONTENTS

SYNOPSIS

cfetool update name --value|-V value [--path|-p directory name] [--time|-t seconds] [--daily|-d] [--weekly|-w] [--yearly|-y] [--cfenvd|-c] [--histograms|-H] [--verbose|-v] [--help|-h]

DESCRIPTION

Takes a new value and uses it to update the database specified by name, located at the path specified by the -p argument, or the current working directory if the -p argument is ommitted. The value will be associated with the current time, unless the -t option is given. In order for cfetool to function properly, this command should be issued at least once during each interval specified by the --step option of cfetool create.

The -d, -w and -y options specify the databases to update. If all three options are omitted, only the weekly database will be updated.

OPTIONS

--value|-v value Specifies a new value to update the database with.
--path|-p directory name The directory in which the database specified by name can be found.
--time|-t The time the value was collected, in seconds since epoch (January 1st, 1970). If this argument is omitted, the current time will be used.
--daily|-d Update the daily averages database.
--weekly|-w Update the weekly averages database.
--yearly|-y Update the yearly averages database.
--cfenvd|-c Communicate with cfengine. If this option is specified, cfetool will define classes understandable by cfagent. For more information, refer to the documentation for cfenvd.
--histograms|-H Collect histogram information about the probability distribiution of fluctuations about the mean value over all times of day. Cfetool won’t write anything to this file for the first four weeks, as it has to have reliable mean values in order to accurately calculate it.
--verbose|-v Print details of the command’s execution to the standard output stream.
--help|-h Print a short help message and then exit.

OUTPUT

Before exiting, cfetool update will print one line to the standard output stream in the following format:

yrly=ynum,wkly=wnum,dly=dnum

ynum, wnum and dnum will be either the number 0 if the corresponding database was not updated, or a code indicating the state of the given statistic, as compared to an average of equivalent earlier times, as specified below:



 code    high|low|normal   meaning
 -------------------------------------------------------------
  -2     -                 no sigma variation
 -------------------------------------------------------------
  -4     low               within noise threshold, and within
  -5     normal              2 standard deviations from
  -6     high                expected value
 -------------------------------------------------------------
 -14     low               microanomaly: within noise
 -15     normal              threshold, but 2 or more standard
 -16     high                deviations from expected value
 -------------------------------------------------------------
 -24     low               normal; within 1 standard deviation
 -25     normal              from the expected value
 -26     high               
 -------------------------------------------------------------
 -34     low               dev1; more than 1 standard
 -35     normal              deviation from the expected
 -36     high                value
 ------------------------------------------------------------
 -44     low               dev2; more than 2 standard
 -45     normal              deviations from the expected
 -46     high                value
 -------------------------------------------------------------
 -54     low               anomaly; more than 3 standard
 -55     normal              deviations from the expected
 -56     high                value



Where low indicates that the current value is below both the expected value for the current time position, and the global average value. high indicates that the current value is above those values. normal indicates that the current value is within the range of expected values.

cfetool update also exits with a code corresponding to the above table. If more than one database is being updated, the most negative result from the updates is returned, and the individual results must be obtained from the standard output stream, as described above.

EXAMPLE



  % cfetool update temperature --path /my/path --value 14.5 --histograms
  yrly=0,wkly=-6,dly=0



Updates the weekly temperature database and histogram files located in /my/path/ with the value 14.5 using the current time as the update time. The output indicates that only a weekly database was updated, and the new value given was within cfetool’s noise threshold, and also within 2 standard deviations of the previous average stored in the database.

AUTHORS

The code and documentation were contributed by Stanford Linear Accelerator Center, a department of Stanford University. This documentation was written by
Elizabeth Cassell <e_a_c@mailsnare.net> and
Alf Wachsmann <alfw@slac.stanford.edu>

COPYRIGHT AND DISCLAIMER



 Copyright 2004 Alf Wachsmann <alfw@slac.stanford.edu> and
                Elizabeth Cassell <e_a_c@mailsnare.net>
 All rights reserved.



Search for    or go to Top of page |  Section 8 |  Main Index


perl v5.8.4 CFETOOLUPDATE (1) 2004-09-21

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.