NAME
   growthforecast.pl - Lightning Fast Graphing/Visualization

SYNOPSIS
     % growthforecast.pl --data-dir=/path/to/dir

DESCRIPTION
   GrowthForecast is graphing/visualization web tool built on RRDtool

INSTALL
   Install dependencies
       To install growthforecast, these libraries are needed.

       *   glib

       *   xml2

       *   pango

       *   cairo

         (CentOS) $ sudo yum groupinstall "Development Tools"
                  $ sudo yum install pkgconfig glib2-devel gettext libxml2-devel pango-devel cairo-devel

         (Ubuntu) $ sudo apt-get build-dep rrdtool

   Install GrowthForecast
         $ cpanm GrowthForecast

       It's recommended to using perlbrew

OPTIONS
   --data-dir
       A directory to store rrddata and metadata

   --port
       TCP port listen on. Default is 5125

   --host
       IP address to listen on

   --socket
       File path to UNIX domain socket to bind. If enabled unix domain
       socket, GrowthForecast does not bind any TCP port

   --front-proxy
       IP addresses or CIDR of reverse proxy

   --allow-from
       IP addresses or CIDR to allow access from. Default is empty (allow
       access from any remote ip address)

   --disable-1min-metrics
       don't generate 1min rrddata and graph Default is "1" (enabled)

   --disable-subtract
       Disable gmode `subtract`. Default is "1" (enabled)

   --enable-float-number
       Store numbers of graph data as float rather than integer. Default is
       "0" (disabled)

   --with-mysql
       DB connection setting to store metadata. format like
       dbi:mysql:[dbname];hostname=[hostnaem] Default is no mysql setting.
       GrowthForecast save metadata to SQLite

   --web-max-workers
       Number of web server processes. Default is 4

   --rrdcached
       rrdcached address. format is like either of

          unix:</path/to/unix.sock>
          /<path/to/unix.sock>
          <hostname-or-ip>
          [<hostname-or-ip>]:<port>
          <hostname-or-ipv4>:<port>

       See the manual of rrdcached for more details. Default does not use
       rrdcached.

   --mount
       Provide GrowthForecast with specify url path. Default is empty (
       provide GrowthForecast on root path )

   --time-zone
       Set the system time zone for GrowthForecast. Default is system
       timezone.

   -v --version
       Display version

   -h --help
       Display help

MYSQL Setting
   GrowthForecast uses SQLite as metadata by default. And also supports
   MySQL

   GrowthForecast needs these MySQL privileges.

   *   CREATE

   *   ALTER

   *   DELETE

   *   INSERT

   *   UPDATE

   *   SELECT

   Sample GRANT statement

     mysql> GRANT statement sample> GRANT  CREATE, ALTER, DELETE, INSERT, UPDATE, SELECT \\
              ON growthforecast.* TO 'www'\@'localhost' IDENTIFIED BY foobar;

   Give USERNAME and PASSWORD to GrowthForecast by environment value

     $ MYSQL_USER=www MYSQL_PASSWORD=foobar growthforecast.pl \\
         --data-dir /home/user/growthforecast \\
         -with-mysql dbi:mysql:growthforecast;hostname=localhost

   AUTHOR Masahiro Nagano <kazeburo {at} gmail.com>

   LICENSE This library is free software; you can redistribute it and/or
   modify it under the same terms as Perl itself.