DragonFly On-Line Manual Pages

CMOGSTORED(1)                    User Commands                   CMOGSTORED(1)

NAME
       cmogstored - manual page for cmogstored 1.5.0

SYNOPSIS
       cmogstored [OPTION...]

DESCRIPTION
       cmogstored -- alternative mogstored implementation for MogileFS

       --config=<file>
              Set config file (no default, unlike mogstored)

       -d, --daemonize
              Daemonize

       --docroot=<path>
              Docroot above device mount points.  Defaults to /var/mogdata

       --httplisten=<ip:port> IP/Port HTTP server listens on

       --maxconns=<number>
              Number of simultaneous clients to serve. Default 10000

       --mgmtlisten=<ip:port> IP/Port management/sidechannel listens on

       --pidfile=<path>
              path to PID file

       -?, --help
              give this help list

       --usage
              give a short usage message

       -V, --version
              print program version

ENVIRONMENT
       MOG_IOSTAT_CMD - command-line for invoking iostat(1).  This is used by
       the sidechannel to report disk utilization to trackers.  Default:
       "iostat -dx 1 30"

       LISTEN_FDS, LISTEN_PID - may be used for systemd-style socket
       activation regardless of whether systemd is on the system.  See
       sd_listen_fds(3) for more information.  Since cmogstored supports two
       protocols on different sockets, the command line or config file must
       still specify which addresses to listen on.  This feature is available
       in cmogstored 1.5.0 and later.

       CMOGSTORED_FD - a comma-delimited list of integer file descriptors.
       This is used internally for SIGUSR2 upgrades, but may be specified at
       startup (e.g. via env(1)) as it is not tied to LISTEN_PID like
       LISTEN_FDS is.  Unlike LISTEN_FDS, CMOGSTORED_FD does not rely on
       inherited file descriptors being contiguous.

       See MALLOC TUNING for environment variables which may affect memory
       usage.

SIGNALS
       SIGQUIT - gracefully shutdown the server SIGUSR2 - upgrade executable
       on the fly

UPGRADING
       Upgrading cmogstored on-the-fly is possible since version 1.2.0.  The
       procedure is close to the one used by nginx users: send SIGUSR2
       followed by SIGQUIT to the old process.  Use of SIGWINCH and SIGHUP are
       currently not supported (but may be in the future).  Procedures for the
       nginx upgrade are documented here:
       http://wiki.nginx.org/CommandLine#Upgrading_To_a_New_Binary_On_The_Fly

MALLOC TUNING
       malloc(3) implementations tuned for multithreading speed (and not
       memory usage) may cause large amounts of metadata overhead in
       infrequently-used arenas.  While cmogstored may use many threads for
       filesystem I/O, cmogstored is designed to not be dependent on malloc(3)
       performance nor scalability.

       On GNU/Linux systems with glibc, we recommend setting MALLOC_ARENA_TEST
       and MALLOC_ARENA_MAX to low numbers to limit the number arenas.
       Setting the value of each to 1 or 2 should be enough, even.

REPORTING BUGS
       Only bug reports in plain-text email will be read.  Please email to
       either the public cmogstored mailing list <cmogstored-
       public@bogomips.org> or the public MogileFS mailing list
       <mogile@googlegroups.com>.

       Report bugs to cmogstored-public@bogomips.org.

COPYRIGHT
       Copyright (C) 2012-2015 all contributors <cmogstored-
       public@bogomips.org> License: GNU GPL version 3 or later
       <https://www.gnu.org/licenses/gpl.html>.  This is free software: you
       are free to change and redistribute it.  There is NO WARRANTY, to the
       extent permitted by law.

SEE ALSO
       cmogstored website: http://bogomips.org/cmogstored/README You can learn
       more about MogileFS: http://mogilefs.org/

       cmogstored source code is available via git:

            git clone git://bogomips.org/cmogstored.git

cmogstored 1.5.0                 November 2015                   CMOGSTORED(1)