Provided by: mongodb-server_2.4.9-1ubuntu2_amd64 bug

NAME

       mongos - MongoDB Shard Utility

SYNOPSIS

       mongos  for  "MongoDB  Shard,"  is a routing service for MongoDB shard configurations that
       processes queries from the application layer, and determines the location of this data  in
       the  sharded  cluster, in order to complete these operations.  From the perspective of the
       application, a mongos instance behaves identically to any other MongoDB instance.

       Note   Changed in version 2.1.

              Some aggregation operations using the aggregate  will  cause  mongos  instances  to
              require  more  CPU  resources  than in previous versions. This modified performance
              profile may dictate alternate architecture decisions if  you  use  the  aggregation
              framework extensively in a sharded environment.

       See also

              /sharding and /core/sharded-clusters.

OPTIONS

       mongos

       --help, -h
              Returns a basic help and usage text.

       --version
              Returns the version of the mongod daemon.

       --config <filename>, -f <filename>
              Specifies a configuration file, that you can use to specify runtime-configurations.
              While the options  are  equivalent  and  accessible  via  the  other  command  line
              arguments, the configuration file is the preferred method for runtime configuration
              of mongod. See the "/reference/configuration-options" document for more information
              about these options.

              Not all configuration options for mongod make sense in the context of mongos.

       --verbose, -v
              Increases  the  amount  of internal reporting returned on standard output or in the
              log file specified by --logpath. Use the -v form to control the level of  verbosity
              by including the option multiple times, (e.g. -vvvvv.)

       --quiet
              Runs  the  mongos  instance  in  a  quiet mode that attempts to limit the amount of
              output.

       --port <port>
              Specifies a TCP port for the mongos to listen for client  connections.  By  default
              mongos listens for connections on port 27017.

              UNIX-like systems require root access to access ports with numbers lower than 1024.

       --bind_ip <ip address>
              The  IP address that the mongos process will bind to and listen for connections. By
              default mongos listens for connections on the localhost (i.e.  127.0.0.1  address.)
              You may attach mongos to any interface; however, if you attach mongos to a publicly
              accessible  interface  you  must  implement  proper  authentication   or   firewall
              restrictions to protect the integrity of your database.

       --maxConns <number>
              Specifies  the  maximum number of simultaneous connections that mongos will accept.
              This setting will have no effect if the value of this setting is higher  than  your
              operating system's configured maximum connection tracking threshold.

              This  is  particularly useful for mongos if you have a client that creates a number
              of collections but allows them to timeout rather than close the  collections.  When
              you  set  maxConns,  ensure  the  value  is  slightly  higher  than the size of the
              connection pool or the total number of connections to prevent erroneous  connection
              spikes from propagating to the members of a shard cluster.

       Note   You cannot set maxConns to a value higher than 20000.

       --objcheck
              Forces the mongos to validate all requests from clients upon receipt to ensure that
              invalid objects are never inserted into the database. This option has a performance
              impact, and is not enabled by default.

       --logpath <path>
              Specify a path for the log file that will hold all diagnostic logging information.

              Unless  specified,  mongos  will output all log information to the standard output.
              Additionally, unless you also specify --logappend, the logfile will be  overwritten
              when the process restarts.

       --logappend
              Specify  to  ensure  that  mongos appends additional logging data to the end of the
              logfile rather than overwriting the content of the log when the process restarts.

       --syslog
              New in version 2.1.0.

              Sends all logging output to the host's syslog system rather than to standard output
              or a log file as with --logpath.

       Warning
              You cannot use --syslog with --logpath.

       --pidfilepath <path>
              Specify  a  file  location  to  hold the "PID" or process ID of the mongos process.
              Useful for tracking the mongos  process  in  combination  with  the  mongos  --fork
              option.

              Without a specified --pidfilepath option, mongos creates no PID file.

       --keyFile <file>
              Specify  the path to a key file to store authentication information. This option is
              only useful for the connection between  mongos  instances  and  components  of  the
              sharded cluster.

       See also

              sharding-security

       --nounixsocket
              Disables  listening  on  the UNIX socket. Without this option mongos creates a UNIX
              socket.

       --unixSocketPrefix <path>
              Specifies a path for the UNIX socket. Unless specified, mongos creates a socket  in
              the /tmp path.

       --fork Enables  a  daemon mode for mongod which forces the process to the background. This
              is the normal mode of operation, in production  and  production-like  environments,
              but may not be desirable for testing.

       --configdb <config1>,<config2><:port>,<config3>
              Set  this option to specify a configuration database (i.e. config database) for the
              sharded cluster. You must specify either 1 configuration server or 3  configuration
              servers, in a comma separated list.

       Note   mongos instances read from the first config server in the list provided. All mongos
              instances must specify the hosts to the --configdb setting in the same order.

              If your configuration databases reside in more that  one  data  center,  order  the
              hosts in the --configdb argument so that the config database that is closest to the
              majority of your mongos instances is first servers in the list.

       Warning
              Never remove a config server from the --configdb  parameter,  even  if  the  config
              server or servers are not available, or offline.

       --test This  option is for internal testing use only, and runs unit tests without starting
              a mongos instance.

       --upgrade
              This option updates the meta data format used by the config database.

       --chunkSize <value>
              The value of the --chunkSize determines the size of each chunk,  in  megabytes,  of
              data  distributed  around  the  sharded cluster. The default value is 64 megabytes,
              which is the ideal size for chunks in most deployments: larger chunk size can  lead
              to uneven data distribution, smaller chunk size often leads to inefficient movement
              of chunks between nodes. However, in some circumstances it may be necessary to  set
              a different chunk size.

              This  option  only  sets the chunk size when initializing the cluster for the first
              time. If you modify the run-time option later, the new value will have  no  effect.
              See  the "sharding-balancing-modify-chunk-size" procedure if you need to change the
              chunk size on an existing sharded cluster.

       --ipv6 Enables IPv6 support to allow clients to connect to  mongos  using  IPv6  networks.
              MongoDB disables IPv6 support by default in mongod and all utilities.

       --jsonp
              Permits  JSONP  access via an HTTP interface. Consider the security implications of
              allowing this activity before enabling this option.

       --noscripting
              Disables the scripting engine.

       --nohttpinterface
              New in version 2.1.2.

              Disables the HTTP interface.

       --localThreshold
              New in version 2.2.

              --localThreshold affects the logic that mongos  uses  when  selecting  replica  set
              members   to   pass   read   operations   to  from  clients.  Specify  a  value  to
              --localThreshold in milliseconds. The default value is 15, which corresponds to the
              default value in all of the client drivers.

              When  mongos receives a request that permits reads to secondary members, the mongos
              will:

                 • find the member of the set with the lowest ping time.

                 • construct a list of replica set members that is  within  a  ping  time  of  15
                   milliseconds of the nearest suitable member of the set.

                   If you specify a value for --localThreshold, mongos will construct the list of
                   replica members that are within the latency allowed by this value.

                 • The mongos will select a member to read from at random from this list.

              The ping time used for a set member compared by the --localThreshold setting  is  a
              moving  average  of  recent ping times, calculated, at most, every 10 seconds. As a
              result, some queries may  reach  members  above  the  threshold  until  the  mongos
              recalculates the average.

              See  the  replica-set-read-preference-behavior-member-selection section of the read
              preference documentation for more information.

       --noAutoSplit
              New in version 2.0.7.

              --noAutoSplit prevents mongos from automatically inserting  metadata  splits  in  a
              sharded  collection.  If set on all mongos, this will prevent MongoDB from creating
              new chunks as the data in a collection grows.

              Because any mongos in a cluster can create a split, to totally disable splitting in
              a cluster you must set --noAutoSplit on all mongos.

       Warning
              With  --noAutoSplit enabled, the data in your sharded cluster may become imbalanced
              over time. Enable with caution.

   SSL Options
       See

              /administration/ssl for full documentation of MongoDB's support.

       --authenticationDatabase <dbname>
              New in version 2.4.

              Specifies the database that holds the user's (e.g --username) credentials.

              By default, mongos assumes that the database specified to the --db  argument  holds
              the user's credentials, unless you specify --authenticationDatabase.

              See  userSource,  /reference/privilege-documents and /reference/user-privileges for
              more information about delegated authentication in MongoDB.

       --authenticationMechanism <name>
              New in version 2.4.

              Specifies the authentication mechanism. By default, the authentication mechanism is
              MONGODB-CR,  which  is  the MongoDB challenge/response authentication mechanism. In
              the MongoDB Subscriber Edition, mongos also includes support for GSSAPI  to  handle
              Kerberos authentication.

              See   /tutorial/control-access-to-mongodb-with-kerberos-authentication   for   more
              information about Kerberos authentication.

AUTHOR

       MongoDB Documentation Project

COPYRIGHT

       2011-2013, 10gen, Inc.