You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by me...@apache.org on 2015/07/08 20:48:55 UTC

mesos git commit: Updated configuration.md with new flags for 0.23.0.

Repository: mesos
Updated Branches:
  refs/heads/master efe36d64f -> fe0246c6d


Updated configuration.md with new flags for 0.23.0.

Review: https://reviews.apache.org/r/36294


Project: http://git-wip-us.apache.org/repos/asf/mesos/repo
Commit: http://git-wip-us.apache.org/repos/asf/mesos/commit/fe0246c6
Tree: http://git-wip-us.apache.org/repos/asf/mesos/tree/fe0246c6
Diff: http://git-wip-us.apache.org/repos/asf/mesos/diff/fe0246c6

Branch: refs/heads/master
Commit: fe0246c6d5842109c324323cf26c6751e754b239
Parents: efe36d6
Author: Adam B <ad...@mesosphere.io>
Authored: Wed Jul 8 11:45:43 2015 -0700
Committer: Adam B <ad...@mesosphere.io>
Committed: Wed Jul 8 11:48:34 2015 -0700

----------------------------------------------------------------------
 docs/configuration.md | 136 ++++++++++++++++++++++++++++++++++++---------
 src/logging/flags.cpp |   2 +-
 2 files changed, 110 insertions(+), 28 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/mesos/blob/fe0246c6/docs/configuration.md
----------------------------------------------------------------------
diff --git a/docs/configuration.md b/docs/configuration.md
index 9a8505d..feee559 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -14,7 +14,7 @@ Configuration values are searched for first in the environment, then on the comm
 
 **Important Options**
 
-If you have special compilation requirements, please refer to `./configure --help` when configuring Mesos. Additionally, the documentation lists only a subset of the options. A definitive source for which flags your version of Mesos supports can be found by running the binary with the flag `--help`, for example `mesos-master --help`.
+If you have special compilation requirements, please refer to `./configure --help` when configuring Mesos. Additionally, this documentation lists only a recent snapshot of the options in Mesos. A definitive source for which flags your version of Mesos supports can be found by running the binary with the flag `--help`, for example `mesos-master --help`.
 
 ## Master and Slave Options
 
@@ -33,11 +33,12 @@ If you have special compilation requirements, please refer to `./configure --hel
 
   <tr>
     <td>
-      --ip=VALUE
+      --external_log_file=VALUE
     </td>
     <td>
-      IP address to listen on
-
+      Specified the externally managed log file. This file will be
+      exposed in the webui and HTTP api. This is useful when using
+      stderr logging as the log file is otherwise unknown to Mesos.
     </td>
   </tr>
   <tr>
@@ -74,6 +75,24 @@ If you have special compilation requirements, please refer to `./configure --hel
   </tr>
   <tr>
     <td>
+      --[no-]initialize_driver_logging
+    </td>
+    <td>
+      Whether to automatically initialize Google logging of scheduler
+      and/or executor drivers. (default: true)
+    </td>
+  </tr>
+  <tr>
+    <td>
+      --ip=VALUE
+    </td>
+    <td>
+      IP address to listen on
+
+    </td>
+  </tr>
+  <tr>
+    <td>
       --log_dir=VALUE
     </td>
     <td>
@@ -316,16 +335,6 @@ file:///path/to/file (where file contains one of the above)</code></pre>
   </tr>
   <tr>
     <td>
-      --external_log_file=VALUE
-    </td>
-    <td>
-      Specified the externally managed log file. This file will be
-      exposed in the webui and HTTP api. This is useful when using
-      stderr logging as the log file is otherwise unknown to Mesos.
-    </td>
-  </tr>
-  <tr>
-    <td>
       --framework_sorter=VALUE
     </td>
     <td>
@@ -744,6 +753,15 @@ file:///path/to/file (where file contains one of the above)</code></pre>
   </tr>
   <tr>
     <td>
+      --[no-]cgroups_cpu_enable_pids_and_tids_count
+    </td>
+    <td>
+      Cgroups feature flag to enable counting of processes and threads
+      inside a container. (default: false)
+    </td>
+  </tr>
+  <tr>
+    <td>
       --[no-]cgroups_enable_cfs
     </td>
     <td>
@@ -980,31 +998,36 @@ file:///path/to/file (where file contains one of the above)</code></pre>
   </tr>
   <tr>
     <td>
-      --executor_registration_timeout=VALUE
+      --executor_environment_variables
     </td>
     <td>
-      Amount of time to wait for an executor
-      to register with the slave before considering it hung and
-      shutting it down (e.g., 60secs, 3mins, etc) (default: 1mins)
+      JSON object representing the environment variables that should be
+      passed to the executor, and thus subsequently task(s).
+      By default the executor will inherit the slave's environment variables.
+      Example:
+<pre><code>{
+  "PATH": "/bin:/usr/bin",
+  "LD_LIBRARY_PATH": "/usr/local/lib"
+}</code></pre>
     </td>
   </tr>
   <tr>
     <td>
-      --executor_shutdown_grace_period=VALUE
+      --executor_registration_timeout=VALUE
     </td>
     <td>
       Amount of time to wait for an executor
-      to shut down (e.g., 60secs, 3mins, etc) (default: 5secs)
+      to register with the slave before considering it hung and
+      shutting it down (e.g., 60secs, 3mins, etc) (default: 1mins)
     </td>
   </tr>
   <tr>
     <td>
-      --external_log_file=VALUE
+      --executor_shutdown_grace_period=VALUE
     </td>
     <td>
-      Specified the externally managed log file. This file will be
-      exposed in the webui and HTTP api. This is useful when using
-      stderr logging as the log file is otherwise unknown to Mesos.
+      Amount of time to wait for an executor
+      to shut down (e.g., 60secs, 3mins, etc) (default: 5secs)
     </td>
   </tr>
   <tr>
@@ -1139,6 +1162,17 @@ file:///path/to/file (where file contains one of the above)</code></pre>
   </tr>
   <tr>
     <td>
+      --oversubscribed_resources_interval=VALUE
+    </td>
+    <td>
+      The slave periodically updates the master with the current estimation
+      about the total amount of oversubscribed resources that are allocated
+      and available. The interval between updates is controlled by this flag.
+      (default: 15secs)
+    </td>
+  </tr>
+  <tr>
+    <td>
       --perf_duration=VALUE
     </td>
     <td>
@@ -1174,6 +1208,25 @@ file:///path/to/file (where file contains one of the above)</code></pre>
   </tr>
   <tr>
     <td>
+      --qos_controller=VALUE
+    </td>
+    <td>
+      The name of the QoS Controller to use for oversubscription.
+    </td>
+  </tr>
+  <tr>
+    <td>
+      --qos_correction_interval_min=VALUE
+    </td>
+    <td>
+      The slave polls and carries out QoS corrections from the QoS
+      Controller based on its observed performance of running tasks.
+      The smallest interval between these corrections is controlled by
+      this flag. (default: 0secs)
+    </td>
+  </tr>
+  <tr>
+    <td>
       --recover=VALUE
     </td>
     <td>
@@ -1221,6 +1274,14 @@ file:///path/to/file (where file contains one of the above)</code></pre>
   </tr>
   <tr>
     <td>
+      --resource_estimator=VALUE
+    </td>
+    <td>
+      The name of the resource estimator to use for oversubscription.
+    </td>
+  </tr>
+  <tr>
+    <td>
       --resource_monitoring_interval=VALUE
     </td>
     <td>
@@ -1240,6 +1301,16 @@ file:///path/to/file (where file contains one of the above)</code></pre>
   </tr>
   <tr>
     <td>
+      --[no-]revocable_cpu_low_priority
+    </td>
+    <td>
+      Run containers with revocable CPU at a lower priority than
+      normal containers (non-revocable cpu). Currently only
+      supported by the cgroups/cpu isolator. (default: true)
+    </td>
+  </tr>
+  <tr>
+    <td>
       --slave_subsystems=VALUE
     </td>
     <td>
@@ -1357,11 +1428,22 @@ file:///path/to/file (where file contains one of the above)</code></pre>
   </tr>
   <tr>
     <td>
-      --[no-]network_enable_socket_statistics
+      --[no-]network_enable_socket_statistics_summary
+    </td>
+    <td>
+      Whether to collect socket statistics summary for each container.
+      This flag is used for the 'network/port_mapping' isolator.
+      (default: false)
+    </td>
+  </tr>
+  <tr>
+    <td>
+      --[no-]network_enable_socket_statistics_details
     </td>
     <td>
-      Whether to collect socket statistics (e.g., TCP RTT) for
-      each container. (default: false)
+      Whether to collect socket statistics details (e.g., TCP RTT) for
+      each container. This flag is used for the 'network/port_mapping'
+      isolator. (default: false)
     </td>
   </tr>
 </table>

http://git-wip-us.apache.org/repos/asf/mesos/blob/fe0246c6/src/logging/flags.cpp
----------------------------------------------------------------------
diff --git a/src/logging/flags.cpp b/src/logging/flags.cpp
index 3de6fcd..c77f845 100644
--- a/src/logging/flags.cpp
+++ b/src/logging/flags.cpp
@@ -48,7 +48,7 @@ mesos::internal::logging::Flags::Flags()
 
   add(&Flags::initialize_driver_logging,
       "initialize_driver_logging",
-      "Whether to automatically initialize google logging of scheduler\n"
+      "Whether to automatically initialize Google logging of scheduler\n"
       "and/or executor drivers.",
       true);