Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

cfetoolcreate(8) [debian man page]

CFETOOLCREATE(8)					User Contributed Perl Documentation					  CFETOOLCREATE(8)

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 accu-
	   rately 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)

Check Out this Related Man Page

CFETOOLIMPORT(8)					User Contributed Perl Documentation					  CFETOOLIMPORT(8)

NAME

       cfetoolimport - import the contents of a database from XML format

SYNOPSIS

       cfetool import name --file|-f filename [--path|-p directory name] [--daily|-d] [--weekly|-w] [--yearly|-y] [--verbose|-v] [--help|-h]

DESCRIPTION

       Creates a new database from it's XML representation, in the format created by rrdtool dump.

       The -d, -w, and -y options specify which databases to create and look for in the dump, and may be combined. If they are all omitted, the
       default is to only import the weekly database.

OPTIONS

       --file|-f filename
	   Specifies the XML file to restore.

       --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.

       --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.

       --verbose|-v
	   Print details of the command's execution to the standard output stream.

       --help|-h
	   Print a short help message and then exit.

EXAMPLE

	 % cfetool import temperature_copy --path /my/path --file ./temperature.xml

       Create a new weekly database, "temperature_copy", in the "/my/path" directory, and import it's contents from the file "temperature.xml" in
       the current working directory.

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-21							  CFETOOLIMPORT(8)
Man Page