NAME

       cfetoolcreate - Set up a new Database

SYNOPSIS

       cfetool  create name [--path⎪-p directory name] [--step⎪-s step] [--daily⎪-d] [--weekly⎪-w] [--yearly⎪-y]
       [--cfenvd⎪-c] [--histograms⎪-H] [--verbose⎪-v] [--file⎪-f filename] [--help⎪-h]

DESCRIPTION

       Creates a new database and, optionally, histogram file in a new directory with the name given. If the  -p
       option  is  specified,  it  will  be created as a subdirectory of the path given. Otherwise, it will be a
       subdirectory of the current working directory.

       The -d, -w, and -y options specify the period over which the data will  span,  and  may  be  combined  to
       create multiple databases. If they are all omitted, the default is weekly.

OPTIONS

       --path⎪-p
           The  directory  in  which  to  create  the new database folder. If this argument is not provided, the
           current working directory will be used.

       --step⎪-s
           The interval, in minutes, with which the database will be updated.  If this argument is not provided,
           cfetool assumes a default of 5 minutes.

       --daily⎪-d
           Create a database for recording daily patterns.

       --weekly⎪-w
           Create a database for recording weekly patterns.

       --yearly⎪-y
           Create a database for recording yearly patterns.

       --cfenvd⎪-c
           Communicate with cfengine. If this option is specified, cfetool will set  classes  understandable  by
           cfagent. For more information, see the cfenvd documentation.

       --histograms⎪-H
           Create  a  histogram  file,  to store 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.

       --file⎪-f
           Specifies  a  file  which  contains  measurements  to  feed into the database in batch mode. Used for
           testing purposes. Each line in the file should be in either of these formats:

           month/day/year hour:min:sec value

           or

           epoch value

       --help⎪-h
           Prints a short help message and then exits.

EXAMPLE

         % cfetool create temperature --path /my/path --histograms --step 10

       Creates an empty database and histogram file in /my/path/temperature/, ready to  store  values  over  ten
       minute intervals spanning a one-week period.

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.

perl v5.8.4                                        2004-09-22                                   CFETOOLCREATE(8)