git commit: Updated upgrades document for 0.18.0.

[vi...@apache.org]

Updated Branches:
  refs/heads/master 2f2fbfad9 -> 0380095a9


Updated upgrades document for 0.18.0.


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

Branch: refs/heads/master
Commit: 0380095a979e8d7e745c7b6848c9e0c3c80546bd
Parents: 2f2fbfa
Author: Ian Downes <ia...@gmail.com>
Authored: Tue Feb 11 17:51:48 2014 -0800
Committer: Vinod Kone <vi...@twitter.com>
Committed: Tue Feb 11 17:53:11 2014 -0800

----------------------------------------------------------------------
 docs/upgrades.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/mesos/blob/0380095a/docs/upgrades.md
----------------------------------------------------------------------
diff --git a/docs/upgrades.md b/docs/upgrades.md
index fe8b604..2fa9edd 100644
--- a/docs/upgrades.md
+++ b/docs/upgrades.md
@@ -5,6 +5,28 @@ layout: documentation
 # Upgrading Mesos
 This document serves as a guide for users who wish to upgrade an existing mesos cluster. Some versions require particular upgrade techniques when upgrading a running cluster. Some upgrades will have incompatible changes.
 
+## Upgrading from 0.17.0 to 0.18.0.
+
+In order to upgrade a running cluster:
+
+Note: This upgrade requires a system reboot for slaves that use Linux cgroups for isolation.
+
+* Install the new master binaries and restart the masters.
+* Upgrade the schedulers by linking the latest native library and mesos jar (if necessary).
+* Restart the schedulers.
+* Install the new slave binaries then perform one of the following two steps, depending on if cgroups isolation is used:
+  * [no cgroups]
+      - Restart the slaves. The "--isolation" flag has changed and "process" has been deprecated in favor of "posix/cpu,posix/mem".
+  * [cgroups]
+      - Change from a single mountpoint for all controllers to separate mountpoints for each controller, e.g., /sys/fs/cgroup/memory/ and /sys/fs/cgroup/cpu/.
+      - The suggested configuration is to mount a tmpfs filesystem to /sys/fs/cgroup and to let the slave mount the required controllers. However, the slave will also use previously mounted controllers if they are appropriately mounted under "--cgroups_hierarchy".
+      - It has been observed that unmounting and remounting of cgroups from the single to separate configuration is unreliable and a reboot into the new configuration is strongly advised. Restart the slaves after reboot.
+      - The "--cgroups_hierarchy" now defaults to "/sys/fs/cgroup". The "--cgroups_root" flag default remains "mesos".
+      -  The "--isolation" flag has changed and "cgroups" has been deprecated in favor of "cgroups/cpu,cgroups/mem".
+      - The "--cgroup_subsystems" flag is no longer required and will be ignored.
+* Upgrade the executors by linking the latest native library and mesos jar (if necessary).
+
+
 ## Upgrading from 0.16.0 to 0.17.0.
 
 In order to upgrade a running cluster: