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  -  CMOGSTORED (1)

NAME

cmogstored - manual page for cmogstored 1.5.0

CONTENTS

Synopsis
Description
Environment
Signals
Upgrading
Copyright

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

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


cmogstored 1.5.0 CMOGSTORED (1) November 2015

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