You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mesos.apache.org by dl...@apache.org on 2014/02/14 03:29:28 UTC
svn commit: r1568190 - in /mesos/site: ./ publish/ publish/documentation/
publish/documentation/getting-started/ publish/documentation/latest/
publish/documentation/latest/getting-started/
publish/documentation/latest/release-guide/ publish/documentati...
Author: dlester
Date: Fri Feb 14 02:29:28 2014
New Revision: 1568190
URL: http://svn.apache.org/r1568190
Log:
Updates rakefile to reflect new location of getting started guide, and reflects updated documentation.
Added:
mesos/site/publish/documentation/getting-started/
mesos/site/publish/documentation/getting-started/index.html
mesos/site/publish/documentation/latest/getting-started/
mesos/site/publish/documentation/latest/getting-started/index.html
mesos/site/publish/documentation/latest/release-guide/
mesos/site/publish/documentation/latest/release-guide/index.html
mesos/site/publish/documentation/release-guide/
mesos/site/publish/documentation/release-guide/index.html
mesos/site/source/documentation/latest/getting-started.md
mesos/site/source/documentation/latest/release-guide.md
Removed:
mesos/site/source/gettingstarted.html.md
Modified:
mesos/site/Rakefile
mesos/site/config.rb
mesos/site/publish/documentation/index.html
mesos/site/publish/documentation/latest/index.html
mesos/site/publish/documentation/latest/upgrades/index.html
mesos/site/publish/documentation/upgrades/index.html
mesos/site/publish/gettingstarted/index.html
mesos/site/publish/sitemap.xml
mesos/site/source/documentation/latest.md
mesos/site/source/documentation/latest/upgrades.md
Modified: mesos/site/Rakefile
URL: http://svn.apache.org/viewvc/mesos/site/Rakefile?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/Rakefile (original)
+++ mesos/site/Rakefile Fri Feb 14 02:29:28 2014
@@ -27,7 +27,7 @@ task :update_docs do
puts "Cloning Apache Mesos codebase"
system("mkdir -p #{tmp_dir}")
- system("git clone --depth 1 git://git.apache.org/mesos.git #{tmp_dir}/mesos")
+ system("git clone --depth 1 http://git-wip-us.apache.org/repos/asf/mesos.git #{tmp_dir}/mesos")
puts "Updating docs to the latest version"
system("rm -f source/documentation/latest/*.md")
system("cp -a #{tmp_dir}/mesos/docs/*.md source/documentation/latest/")
@@ -43,7 +43,6 @@ task :update_docs do
end
puts "Moving documentation index to its own 'latest' directory"
system("mv source/documentation/latest/home.md source/documentation/latest.md")
- system("rm -f source/documentation/latest/getting-started.md")
puts "Documentation updated"
end
Modified: mesos/site/config.rb
URL: http://svn.apache.org/viewvc/mesos/site/config.rb?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/config.rb (original)
+++ mesos/site/config.rb Fri Feb 14 02:29:28 2014
@@ -41,6 +41,7 @@ end
page "/documentation/*", :layout => "documentation"
proxy "/documentation/index.html", "/documentation/latest.html", :layout => "documentation"
+proxy "/gettingstarted/index.html", "/documentation/latest/getting-started.html", :layout => "documentation"
latest_doc_pages = Dir.glob("./source/documentation/latest/*.md")
latest_doc_pages.each do |page_path|
page_name = File.basename(page_path, '.md')
Added: mesos/site/publish/documentation/getting-started/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/getting-started/index.html?rev=1568190&view=auto
==============================================================================
--- mesos/site/publish/documentation/getting-started/index.html (added)
+++ mesos/site/publish/documentation/getting-started/index.html Fri Feb 14 02:29:28 2014
@@ -0,0 +1,226 @@
+<!DOCTYPE html>
+<!--
+
+ ______ __
+ /\ _ \ /\ \
+ \ \ \L\ \ _____ __ ___\ \ \___ __
+ \ \ __ \/\ '__`\ /'__`\ /'___\ \ _ `\ /'__`\
+ \ \ \/\ \ \ \L\ \/\ \L\.\_/\ \__/\ \ \ \ \/\ __/
+ \ \_\ \_\ \ ,__/\ \__/.\_\ \____\\ \_\ \_\ \____\
+ \/_/\/_/\ \ \/ \/__/\/_/\/____/ \/_/\/_/\/____/
+ \ \_\
+ \/_/
+
+ /'\_/`\
+ /\ \ __ ____ ___ ____
+ \ \ \__\ \ /'__`\ /',__\ / __`\ /',__\
+ \ \ \_/\ \/\ __//\__, `\/\ \L\ \/\__, `\
+ \ \_\\ \_\ \____\/\____/\ \____/\/\____/
+ \/_/ \/_/\/____/\/___/ \/___/ \/___/
+
+-->
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="description" content="">
+ <meta name="author" content="">
+
+ <!-- Le styles -->
+ <link href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css" rel="stylesheet">
+
+ <link href="../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+
+ <!-- Google Analytics Magic -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-20226872-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <!-- navbar excitement -->
+ <div class="navbar navbar-static-top" role="navigation">
+ <div class="navbar-inner">
+ <div class="container">
+ <a href="/" class="logo"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo" /></a>
+ <div class="nav-collapse">
+ <ul class="nav nav-pills navbar-right">
+ <li><a href="/gettingstarted/">Getting Started</a></li>
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Community</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div><!-- /.navbar -->
+
+ <div class="container">
+
+ <!-- magical breadcrumbs -->
+ <ul class="breadcrumb">
+ <li>
+ <div class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="http://www.apache.org">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ </li>
+ <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
+
+ </ul><!-- /breadcrumb -->
+
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Getting Started with Apache Mesos</h1>
+
+<h2>Downloading Mesos</h2>
+
+<p>There are different ways you can get Mesos:</p>
+
+<ol>
+<li><p>Download the latest stable release from <a href="http://mesos.apache.org/downloads/">Apache</a> (<strong><em>Recommended</em></strong>)</p>
+
+<pre><code> $ wget http://www.apache.org/dist/mesos/0.14.0/mesos-0.14.0.tar.gz
+ $ tar -zxf mesos-0.14.0.tar.gz
+</code></pre></li>
+<li><p>Clone the Mesos git <a href="http://git-wip-us.apache.org/repos/asf/mesos.git">repository</a> (<strong><em>Advanced Users Only</em></strong>)</p>
+
+<pre><code> $ git clone http://git-wip-us.apache.org/repos/asf/mesos.git
+</code></pre></li>
+</ol>
+
+
+<h2>System Requirements</h2>
+
+<ul>
+<li><p>Mesos runs on Linux (64 Bit) and Mac OSX (64 Bit).</p></li>
+<li><p>Following are the instructions for stock Ubuntu 12.04 64 Bit. If you are using a different OS please install the packages accordingly.</p>
+
+<pre><code> # Ensure apt-get is up to date.
+ $ sudo apt-get update
+
+ # Install build tools.
+ $ sudo apt-get install build-essential
+
+ # Install OpenJDK java.
+ $ sudo apt-get install openjdk-6-jdk
+
+ # Install devel python.
+ $ sudo apt-get install python-dev
+
+ # Install devel libcurl (***Optional***).
+ $ sudo apt-get install libcurl4-nss-dev
+
+ # Install devel libsasl (***Only required for Mesos 0.14.0 or newer***).
+ $ sudo apt-get install libsasl2-dev
+</code></pre></li>
+</ul>
+
+
+<p>If you are building from git repository, you will need to additionally install the following packages.</p>
+
+<pre><code> # Install autotoconf and automake.
+ $ sudo apt-get install autoconf
+
+ # Install libtool.
+ $ sudo apt-get install libtool
+</code></pre>
+
+<h2>Building Mesos</h2>
+
+<pre><code> # Change working directory.
+ $ cd mesos
+
+ # Bootstrap (***Skip this if you are not building from git repo***).
+ $ ./bootstrap
+
+ # Configure and build.
+ $ mkdir build
+ $ cd build
+ $ ../configure
+ $ make -j
+
+ # Run test suite.
+ $ make -j check
+
+ # Install (***Optional***).
+ $ make install
+</code></pre>
+
+<h2>Examples</h2>
+
+<p>Mesos comes bundled with example frameworks written in <code>C++</code>, <code>Java</code> and <code>Python</code>.</p>
+
+<pre><code> # Change into build directory.
+ $ cd build
+
+ # Start mesos master.
+ $ ./bin/mesos-master.sh --ip=127.0.0.1
+
+ # Start mesos slave.
+ $ ./bin/mesos-slave.sh --master=127.0.0.1:5050
+
+ # Visit the mesos web page.
+ $ http://127.0.0.1:5050
+
+ # Run C++ framework (***Exits after successfully running some tasks.***).
+ $ ./src/test-framework --master=127.0.0.1:5050
+
+ # Run Java framework (***Exits after successfully running some tasks.***).
+ $ ./src/examples/java/test-framework 127.0.0.1:5050
+
+ # Run Python framework (***Exits after successfully running some tasks.***).
+ $ ./src/examples/python/test-framework 127.0.0.1:5050
+</code></pre>
+
+<p><em>NOTE: To build the example frameworks, make sure you build the test suite by doing <code>make check</code>.</em></p>
+
+ </div>
+</div>
+
+
+ <hr>
+
+ <!-- footer -->
+ <div class="footer">
+ <p>© 2012-2013 <a href="http://apache.org">The Apache Software Foundation</a>.
+ Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.<p>
+ </div><!-- /footer -->
+
+ </div> <!-- /container -->
+
+ <!-- JS -->
+ <script src="../../assets/js/jquery-1.10.1.min.js" type="text/javascript"></script>
+ <script src="../../assets/js/bootstrap.js" type="text/javascript"></script>
+ <script src="../../assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+ </body>
+</html>
\ No newline at end of file
Modified: mesos/site/publish/documentation/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/index.html?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/publish/documentation/index.html (original)
+++ mesos/site/publish/documentation/index.html Fri Feb 14 02:29:28 2014
@@ -105,13 +105,12 @@
<h2>Users Documentation</h2>
<ul>
-<li><a href="configuration">Mesos Configuration</a> command-line arguments</li>
+<li><a href="configuration">Mesos Configuration</a> for command-line arguments</li>
<li><a href="deploy-scripts">Deploy Scripts</a> for launching a Mesos cluster on a set of machines.</li>
<li><a href="ec2-scripts">EC2 scripts</a> for launching a Mesos cluster on Amazon EC2.</li>
-<li><a href="logging-and-debugging">Logging and Debugging</a> – viewing Mesos and framework logs.</li>
+<li><a href="logging-and-debugging">Logging and Debugging</a> for viewing Mesos and framework logs.</li>
<li><a href="high-availability">High Availability</a> for running multiple masters simultaneously.</li>
-<li><a href="slave-recovery">Slave Recovery</a></li>
-<li><a href="using-the-mesos-submit-tool">Using Mesos Submit Tool</a> for launching a framework with a single task.</li>
+<li><a href="slave-recovery">Slave Recovery</a> for doing seamless upgrades</li>
</ul>
@@ -144,6 +143,7 @@
<ul>
<li><a href="mesos-developers-guide">Mesos Developers Guide</a> includes resources for developers contributing to Mesos and the process of submitting patches for review.</li>
<li><a href="mesos-c++-style-guide">C++ Style Guide</a></li>
+<li><a href="release-guide">Release Guide</a></li>
<li><a href="mesos-roadmap">Mesos Development Road Map</a></li>
</ul>
Added: mesos/site/publish/documentation/latest/getting-started/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/getting-started/index.html?rev=1568190&view=auto
==============================================================================
--- mesos/site/publish/documentation/latest/getting-started/index.html (added)
+++ mesos/site/publish/documentation/latest/getting-started/index.html Fri Feb 14 02:29:28 2014
@@ -0,0 +1,226 @@
+<!DOCTYPE html>
+<!--
+
+ ______ __
+ /\ _ \ /\ \
+ \ \ \L\ \ _____ __ ___\ \ \___ __
+ \ \ __ \/\ '__`\ /'__`\ /'___\ \ _ `\ /'__`\
+ \ \ \/\ \ \ \L\ \/\ \L\.\_/\ \__/\ \ \ \ \/\ __/
+ \ \_\ \_\ \ ,__/\ \__/.\_\ \____\\ \_\ \_\ \____\
+ \/_/\/_/\ \ \/ \/__/\/_/\/____/ \/_/\/_/\/____/
+ \ \_\
+ \/_/
+
+ /'\_/`\
+ /\ \ __ ____ ___ ____
+ \ \ \__\ \ /'__`\ /',__\ / __`\ /',__\
+ \ \ \_/\ \/\ __//\__, `\/\ \L\ \/\__, `\
+ \ \_\\ \_\ \____\/\____/\ \____/\/\____/
+ \/_/ \/_/\/____/\/___/ \/___/ \/___/
+
+-->
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="description" content="">
+ <meta name="author" content="">
+
+ <!-- Le styles -->
+ <link href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css" rel="stylesheet">
+
+ <link href="../../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+
+ <!-- Google Analytics Magic -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-20226872-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <!-- navbar excitement -->
+ <div class="navbar navbar-static-top" role="navigation">
+ <div class="navbar-inner">
+ <div class="container">
+ <a href="/" class="logo"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo" /></a>
+ <div class="nav-collapse">
+ <ul class="nav nav-pills navbar-right">
+ <li><a href="/gettingstarted/">Getting Started</a></li>
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Community</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div><!-- /.navbar -->
+
+ <div class="container">
+
+ <!-- magical breadcrumbs -->
+ <ul class="breadcrumb">
+ <li>
+ <div class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="http://www.apache.org">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ </li>
+ <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
+
+ </ul><!-- /breadcrumb -->
+
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Getting Started with Apache Mesos</h1>
+
+<h2>Downloading Mesos</h2>
+
+<p>There are different ways you can get Mesos:</p>
+
+<ol>
+<li><p>Download the latest stable release from <a href="http://mesos.apache.org/downloads/">Apache</a> (<strong><em>Recommended</em></strong>)</p>
+
+<pre><code> $ wget http://www.apache.org/dist/mesos/0.14.0/mesos-0.14.0.tar.gz
+ $ tar -zxf mesos-0.14.0.tar.gz
+</code></pre></li>
+<li><p>Clone the Mesos git <a href="http://git-wip-us.apache.org/repos/asf/mesos.git">repository</a> (<strong><em>Advanced Users Only</em></strong>)</p>
+
+<pre><code> $ git clone http://git-wip-us.apache.org/repos/asf/mesos.git
+</code></pre></li>
+</ol>
+
+
+<h2>System Requirements</h2>
+
+<ul>
+<li><p>Mesos runs on Linux (64 Bit) and Mac OSX (64 Bit).</p></li>
+<li><p>Following are the instructions for stock Ubuntu 12.04 64 Bit. If you are using a different OS please install the packages accordingly.</p>
+
+<pre><code> # Ensure apt-get is up to date.
+ $ sudo apt-get update
+
+ # Install build tools.
+ $ sudo apt-get install build-essential
+
+ # Install OpenJDK java.
+ $ sudo apt-get install openjdk-6-jdk
+
+ # Install devel python.
+ $ sudo apt-get install python-dev
+
+ # Install devel libcurl (***Optional***).
+ $ sudo apt-get install libcurl4-nss-dev
+
+ # Install devel libsasl (***Only required for Mesos 0.14.0 or newer***).
+ $ sudo apt-get install libsasl2-dev
+</code></pre></li>
+</ul>
+
+
+<p>If you are building from git repository, you will need to additionally install the following packages.</p>
+
+<pre><code> # Install autotoconf and automake.
+ $ sudo apt-get install autoconf
+
+ # Install libtool.
+ $ sudo apt-get install libtool
+</code></pre>
+
+<h2>Building Mesos</h2>
+
+<pre><code> # Change working directory.
+ $ cd mesos
+
+ # Bootstrap (***Skip this if you are not building from git repo***).
+ $ ./bootstrap
+
+ # Configure and build.
+ $ mkdir build
+ $ cd build
+ $ ../configure
+ $ make -j
+
+ # Run test suite.
+ $ make -j check
+
+ # Install (***Optional***).
+ $ make install
+</code></pre>
+
+<h2>Examples</h2>
+
+<p>Mesos comes bundled with example frameworks written in <code>C++</code>, <code>Java</code> and <code>Python</code>.</p>
+
+<pre><code> # Change into build directory.
+ $ cd build
+
+ # Start mesos master.
+ $ ./bin/mesos-master.sh --ip=127.0.0.1
+
+ # Start mesos slave.
+ $ ./bin/mesos-slave.sh --master=127.0.0.1:5050
+
+ # Visit the mesos web page.
+ $ http://127.0.0.1:5050
+
+ # Run C++ framework (***Exits after successfully running some tasks.***).
+ $ ./src/test-framework --master=127.0.0.1:5050
+
+ # Run Java framework (***Exits after successfully running some tasks.***).
+ $ ./src/examples/java/test-framework 127.0.0.1:5050
+
+ # Run Python framework (***Exits after successfully running some tasks.***).
+ $ ./src/examples/python/test-framework 127.0.0.1:5050
+</code></pre>
+
+<p><em>NOTE: To build the example frameworks, make sure you build the test suite by doing <code>make check</code>.</em></p>
+
+ </div>
+</div>
+
+
+ <hr>
+
+ <!-- footer -->
+ <div class="footer">
+ <p>© 2012-2013 <a href="http://apache.org">The Apache Software Foundation</a>.
+ Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.<p>
+ </div><!-- /footer -->
+
+ </div> <!-- /container -->
+
+ <!-- JS -->
+ <script src="../../../assets/js/jquery-1.10.1.min.js" type="text/javascript"></script>
+ <script src="../../../assets/js/bootstrap.js" type="text/javascript"></script>
+ <script src="../../../assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+ </body>
+</html>
\ No newline at end of file
Modified: mesos/site/publish/documentation/latest/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/index.html?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/publish/documentation/latest/index.html (original)
+++ mesos/site/publish/documentation/latest/index.html Fri Feb 14 02:29:28 2014
@@ -105,13 +105,12 @@
<h2>Users Documentation</h2>
<ul>
-<li><a href="configuration">Mesos Configuration</a> command-line arguments</li>
+<li><a href="configuration">Mesos Configuration</a> for command-line arguments</li>
<li><a href="deploy-scripts">Deploy Scripts</a> for launching a Mesos cluster on a set of machines.</li>
<li><a href="ec2-scripts">EC2 scripts</a> for launching a Mesos cluster on Amazon EC2.</li>
-<li><a href="logging-and-debugging">Logging and Debugging</a> – viewing Mesos and framework logs.</li>
+<li><a href="logging-and-debugging">Logging and Debugging</a> for viewing Mesos and framework logs.</li>
<li><a href="high-availability">High Availability</a> for running multiple masters simultaneously.</li>
-<li><a href="slave-recovery">Slave Recovery</a></li>
-<li><a href="using-the-mesos-submit-tool">Using Mesos Submit Tool</a> for launching a framework with a single task.</li>
+<li><a href="slave-recovery">Slave Recovery</a> for doing seamless upgrades</li>
</ul>
@@ -144,6 +143,7 @@
<ul>
<li><a href="mesos-developers-guide">Mesos Developers Guide</a> includes resources for developers contributing to Mesos and the process of submitting patches for review.</li>
<li><a href="mesos-c++-style-guide">C++ Style Guide</a></li>
+<li><a href="release-guide">Release Guide</a></li>
<li><a href="mesos-roadmap">Mesos Development Road Map</a></li>
</ul>
Added: mesos/site/publish/documentation/latest/release-guide/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/release-guide/index.html?rev=1568190&view=auto
==============================================================================
--- mesos/site/publish/documentation/latest/release-guide/index.html (added)
+++ mesos/site/publish/documentation/latest/release-guide/index.html Fri Feb 14 02:29:28 2014
@@ -0,0 +1,214 @@
+<!DOCTYPE html>
+<!--
+
+ ______ __
+ /\ _ \ /\ \
+ \ \ \L\ \ _____ __ ___\ \ \___ __
+ \ \ __ \/\ '__`\ /'__`\ /'___\ \ _ `\ /'__`\
+ \ \ \/\ \ \ \L\ \/\ \L\.\_/\ \__/\ \ \ \ \/\ __/
+ \ \_\ \_\ \ ,__/\ \__/.\_\ \____\\ \_\ \_\ \____\
+ \/_/\/_/\ \ \/ \/__/\/_/\/____/ \/_/\/_/\/____/
+ \ \_\
+ \/_/
+
+ /'\_/`\
+ /\ \ __ ____ ___ ____
+ \ \ \__\ \ /'__`\ /',__\ / __`\ /',__\
+ \ \ \_/\ \/\ __//\__, `\/\ \L\ \/\__, `\
+ \ \_\\ \_\ \____\/\____/\ \____/\/\____/
+ \/_/ \/_/\/____/\/___/ \/___/ \/___/
+
+-->
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="description" content="">
+ <meta name="author" content="">
+
+ <!-- Le styles -->
+ <link href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css" rel="stylesheet">
+
+ <link href="../../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+
+ <!-- Google Analytics Magic -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-20226872-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <!-- navbar excitement -->
+ <div class="navbar navbar-static-top" role="navigation">
+ <div class="navbar-inner">
+ <div class="container">
+ <a href="/" class="logo"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo" /></a>
+ <div class="nav-collapse">
+ <ul class="nav nav-pills navbar-right">
+ <li><a href="/gettingstarted/">Getting Started</a></li>
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Community</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div><!-- /.navbar -->
+
+ <div class="container">
+
+ <!-- magical breadcrumbs -->
+ <ul class="breadcrumb">
+ <li>
+ <div class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="http://www.apache.org">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ </li>
+ <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
+
+ </ul><!-- /breadcrumb -->
+
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Release Guide</h1>
+
+<p>This guide describes the process of doing an official release of Mesos.</p>
+
+<hr />
+
+<h2>Prerequisites</h2>
+
+<ol>
+<li><p>Go to <a href="https://issues.apache.org/jira/browse/MESOS">Apache Jira</a> and make sure that
+the CHANGELOG for the release version is up to date.</p>
+
+<blockquote><p>NOTE: You should move all <strong>Unresolved</strong> tickets marked with <code>Fix Version</code> as the
+ release version to the next release version.</p>
+
+<p>PROTIP: Use <code>bulk edit</code> option in JIRA to move the tickets and make sure to
+ <strong>uncheck</strong> the option that emails everyone about the move.</p></blockquote></li>
+<li><p>Update and commit the <code>CHANGELOG</code> for the release.</p>
+
+<blockquote><p>NOTE: You should use JIRA to generate the CHANGELOG for you. Click on the release
+ version in <a href="https://issues.apache.org/jira/browse/MESOS#selectedTab=com.atlassian.jira.plugin.system.project%3Aversions-panel">JIRA</a> and click
+ on the <code>Release Notes</code>. Make sure to configure the release notes in text format.</p></blockquote></li>
+<li><p>Update and commit the <code>docs/upgrades</code> with instructions about how to upgrade
+a live cluster from the previous release version to this release version.</p></li>
+<li><p>If this is a major release please write and commit documentation for this feature.</p></li>
+</ol>
+
+
+<h2>Tagging the release candidate</h2>
+
+<ol>
+<li><p>Ensure that you can build and pass all the tests.</p>
+
+<pre><code> $ make -j3 distcheck
+</code></pre></li>
+<li><p>First tag the required SHA locally.</p>
+
+<pre><code> $ git tag <X.Y.Z-rcR>
+</code></pre>
+
+<blockquote><p>NOTE: <code>X.Y.Z</code> is based on <a href="http://semver.org/">semantic versioning</a> scheme. <code>R</code> is release
+ candidate version that starts with 1.</p></blockquote></li>
+<li><p>Tag the release externally and deploy the corresponding JAR to the Apache maven repository.
+It is recommended to use the <code>support/tag.sh</code> script to accomplish this.</p>
+
+<pre><code> $ ./support/tag.sh X.Y.Z R
+</code></pre>
+
+<blockquote><p>NOTE: This script assumes that you have the requisite permissions to deploy the JAR. For
+ instructions on how to set it up, please refer to <code>src/java/MESOS-MAVEN-README</code>.</p></blockquote></li>
+<li><p>It is not uncommon to release multiple release candidates, with increasing release candidate
+version, if there are bugs found.</p></li>
+</ol>
+
+
+<h2>Voting the release candidate</h2>
+
+<ol>
+<li><p>Once a release candidate is deemed worthy to be officially released you should call a vote on
+the <code>dev@meosos.apache.org</code> (and optionally <code>user@mesos.apache.org</code>) mailing list.</p></li>
+<li><p>It is recommended to use the <code>support/vote.sh</code> script to vote the release candidate.</p>
+
+<pre><code> $ ./support/vote.sh X.Y.Z R
+</code></pre></li>
+<li><p>The release script also spits out an email template that you could use to send the vote email.</p></li>
+</ol>
+
+
+<h2>Releasing the release candidate</h2>
+
+<ol>
+<li><p>You should only release an official version if the vote passes with at least <strong>3 +1 binding votes
+and no -1 votes</strong>. For more information, please refer to <a href="http://www.apache.org/dev/release.html">Apache release guidelines</a>.</p></li>
+<li><p>It is recommended to use <code>support/release.sh</code> script to release the candidate.</p>
+
+<pre><code> $ ./support/release.sh X.Y.Z R
+</code></pre></li>
+<li><p>The release script also spits out an email template that you could use to notify the mailing lists about
+the result of the vote and the release.</p>
+
+<blockquote><p>NOTE: Make sure you fill the email template with the names of binding voters.</p></blockquote></li>
+</ol>
+
+
+<h2>Updating the website</h2>
+
+<ol>
+<li><p>After a successful release please update the website pointing to the new release.</p></li>
+<li><p>It is also recommended to write a blog post announcing the feature.</p></li>
+</ol>
+
+
+ </div>
+</div>
+
+
+ <hr>
+
+ <!-- footer -->
+ <div class="footer">
+ <p>© 2012-2013 <a href="http://apache.org">The Apache Software Foundation</a>.
+ Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.<p>
+ </div><!-- /footer -->
+
+ </div> <!-- /container -->
+
+ <!-- JS -->
+ <script src="../../../assets/js/jquery-1.10.1.min.js" type="text/javascript"></script>
+ <script src="../../../assets/js/bootstrap.js" type="text/javascript"></script>
+ <script src="../../../assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+ </body>
+</html>
\ No newline at end of file
Modified: mesos/site/publish/documentation/latest/upgrades/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/latest/upgrades/index.html?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/publish/documentation/latest/upgrades/index.html (original)
+++ mesos/site/publish/documentation/latest/upgrades/index.html Fri Feb 14 02:29:28 2014
@@ -104,6 +104,42 @@
<p>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.</p>
+<h2>Upgrading from 0.17.0 to 0.18.0.</h2>
+
+<p>In order to upgrade a running cluster:</p>
+
+<p>Note: This upgrade requires a system reboot for slaves that use Linux cgroups for isolation.</p>
+
+<ul>
+<li>Install the new master binaries and restart the masters.</li>
+<li>Upgrade the schedulers by linking the latest native library and mesos jar (if necessary).</li>
+<li>Restart the schedulers.</li>
+<li>Install the new slave binaries then perform one of the following two steps, depending on if cgroups isolation is used:
+
+<ul>
+<li>[no cgroups]
+
+<ul>
+<li>Restart the slaves. The “–isolation” flag has changed and “process” has been deprecated in favor of “posix/cpu,posix/mem”.</li>
+</ul>
+</li>
+<li>[cgroups]
+
+<ul>
+<li>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/.</li>
+<li>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”.</li>
+<li>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.</li>
+<li>The “–cgroups_hierarchy” now defaults to “/sys/fs/cgroup”. The “–cgroups_root” flag default remains “mesos”.</li>
+<li> The “–isolation” flag has changed and “cgroups” has been deprecated in favor of “cgroups/cpu,cgroups/mem”.</li>
+<li>The “–cgroup_subsystems” flag is no longer required and will be ignored.</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>Upgrade the executors by linking the latest native library and mesos jar (if necessary).</li>
+</ul>
+
+
<h2>Upgrading from 0.16.0 to 0.17.0.</h2>
<p>In order to upgrade a running cluster:</p>
Added: mesos/site/publish/documentation/release-guide/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/release-guide/index.html?rev=1568190&view=auto
==============================================================================
--- mesos/site/publish/documentation/release-guide/index.html (added)
+++ mesos/site/publish/documentation/release-guide/index.html Fri Feb 14 02:29:28 2014
@@ -0,0 +1,214 @@
+<!DOCTYPE html>
+<!--
+
+ ______ __
+ /\ _ \ /\ \
+ \ \ \L\ \ _____ __ ___\ \ \___ __
+ \ \ __ \/\ '__`\ /'__`\ /'___\ \ _ `\ /'__`\
+ \ \ \/\ \ \ \L\ \/\ \L\.\_/\ \__/\ \ \ \ \/\ __/
+ \ \_\ \_\ \ ,__/\ \__/.\_\ \____\\ \_\ \_\ \____\
+ \/_/\/_/\ \ \/ \/__/\/_/\/____/ \/_/\/_/\/____/
+ \ \_\
+ \/_/
+
+ /'\_/`\
+ /\ \ __ ____ ___ ____
+ \ \ \__\ \ /'__`\ /',__\ / __`\ /',__\
+ \ \ \_/\ \/\ __//\__, `\/\ \L\ \/\__, `\
+ \ \_\\ \_\ \____\/\____/\ \____/\/\____/
+ \/_/ \/_/\/____/\/___/ \/___/ \/___/
+
+-->
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+ <meta name="description" content="">
+ <meta name="author" content="">
+
+ <!-- Le styles -->
+ <link href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css" rel="stylesheet">
+
+ <link href="../../assets/css/main.css" media="screen" rel="stylesheet" type="text/css" />
+
+
+ <!-- Google Analytics Magic -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-20226872-1']);
+ _gaq.push(['_setDomainName', 'apache.org']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ </head>
+ <body>
+ <!-- navbar excitement -->
+ <div class="navbar navbar-static-top" role="navigation">
+ <div class="navbar-inner">
+ <div class="container">
+ <a href="/" class="logo"><img src="/assets/img/mesos_logo.png" alt="Apache Mesos logo" /></a>
+ <div class="nav-collapse">
+ <ul class="nav nav-pills navbar-right">
+ <li><a href="/gettingstarted/">Getting Started</a></li>
+ <li><a href="/documentation/latest/">Documentation</a></li>
+ <li><a href="/downloads/">Downloads</a></li>
+ <li><a href="/community/">Community</a></li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ </div><!-- /.navbar -->
+
+ <div class="container">
+
+ <!-- magical breadcrumbs -->
+ <ul class="breadcrumb">
+ <li>
+ <div class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">Apache Software Foundation <b class="caret"></b></a>
+ <ul class="dropdown-menu" role="menu">
+ <li><a href="http://www.apache.org">Apache Homepage</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+ <li><a href="http://www.apache.org/security/">Security</a></li>
+ </ul>
+ </div>
+ </li>
+ <li><a href="http://mesos.apache.org">Apache Mesos</a></li>
+
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
+
+ </ul><!-- /breadcrumb -->
+
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Release Guide</h1>
+
+<p>This guide describes the process of doing an official release of Mesos.</p>
+
+<hr />
+
+<h2>Prerequisites</h2>
+
+<ol>
+<li><p>Go to <a href="https://issues.apache.org/jira/browse/MESOS">Apache Jira</a> and make sure that
+the CHANGELOG for the release version is up to date.</p>
+
+<blockquote><p>NOTE: You should move all <strong>Unresolved</strong> tickets marked with <code>Fix Version</code> as the
+ release version to the next release version.</p>
+
+<p>PROTIP: Use <code>bulk edit</code> option in JIRA to move the tickets and make sure to
+ <strong>uncheck</strong> the option that emails everyone about the move.</p></blockquote></li>
+<li><p>Update and commit the <code>CHANGELOG</code> for the release.</p>
+
+<blockquote><p>NOTE: You should use JIRA to generate the CHANGELOG for you. Click on the release
+ version in <a href="https://issues.apache.org/jira/browse/MESOS#selectedTab=com.atlassian.jira.plugin.system.project%3Aversions-panel">JIRA</a> and click
+ on the <code>Release Notes</code>. Make sure to configure the release notes in text format.</p></blockquote></li>
+<li><p>Update and commit the <code>docs/upgrades</code> with instructions about how to upgrade
+a live cluster from the previous release version to this release version.</p></li>
+<li><p>If this is a major release please write and commit documentation for this feature.</p></li>
+</ol>
+
+
+<h2>Tagging the release candidate</h2>
+
+<ol>
+<li><p>Ensure that you can build and pass all the tests.</p>
+
+<pre><code> $ make -j3 distcheck
+</code></pre></li>
+<li><p>First tag the required SHA locally.</p>
+
+<pre><code> $ git tag <X.Y.Z-rcR>
+</code></pre>
+
+<blockquote><p>NOTE: <code>X.Y.Z</code> is based on <a href="http://semver.org/">semantic versioning</a> scheme. <code>R</code> is release
+ candidate version that starts with 1.</p></blockquote></li>
+<li><p>Tag the release externally and deploy the corresponding JAR to the Apache maven repository.
+It is recommended to use the <code>support/tag.sh</code> script to accomplish this.</p>
+
+<pre><code> $ ./support/tag.sh X.Y.Z R
+</code></pre>
+
+<blockquote><p>NOTE: This script assumes that you have the requisite permissions to deploy the JAR. For
+ instructions on how to set it up, please refer to <code>src/java/MESOS-MAVEN-README</code>.</p></blockquote></li>
+<li><p>It is not uncommon to release multiple release candidates, with increasing release candidate
+version, if there are bugs found.</p></li>
+</ol>
+
+
+<h2>Voting the release candidate</h2>
+
+<ol>
+<li><p>Once a release candidate is deemed worthy to be officially released you should call a vote on
+the <code>dev@meosos.apache.org</code> (and optionally <code>user@mesos.apache.org</code>) mailing list.</p></li>
+<li><p>It is recommended to use the <code>support/vote.sh</code> script to vote the release candidate.</p>
+
+<pre><code> $ ./support/vote.sh X.Y.Z R
+</code></pre></li>
+<li><p>The release script also spits out an email template that you could use to send the vote email.</p></li>
+</ol>
+
+
+<h2>Releasing the release candidate</h2>
+
+<ol>
+<li><p>You should only release an official version if the vote passes with at least <strong>3 +1 binding votes
+and no -1 votes</strong>. For more information, please refer to <a href="http://www.apache.org/dev/release.html">Apache release guidelines</a>.</p></li>
+<li><p>It is recommended to use <code>support/release.sh</code> script to release the candidate.</p>
+
+<pre><code> $ ./support/release.sh X.Y.Z R
+</code></pre></li>
+<li><p>The release script also spits out an email template that you could use to notify the mailing lists about
+the result of the vote and the release.</p>
+
+<blockquote><p>NOTE: Make sure you fill the email template with the names of binding voters.</p></blockquote></li>
+</ol>
+
+
+<h2>Updating the website</h2>
+
+<ol>
+<li><p>After a successful release please update the website pointing to the new release.</p></li>
+<li><p>It is also recommended to write a blog post announcing the feature.</p></li>
+</ol>
+
+
+ </div>
+</div>
+
+
+ <hr>
+
+ <!-- footer -->
+ <div class="footer">
+ <p>© 2012-2013 <a href="http://apache.org">The Apache Software Foundation</a>.
+ Apache Mesos, the Apache feather logo, and the Apache Mesos project logo are trademarks of The Apache Software Foundation.<p>
+ </div><!-- /footer -->
+
+ </div> <!-- /container -->
+
+ <!-- JS -->
+ <script src="../../assets/js/jquery-1.10.1.min.js" type="text/javascript"></script>
+ <script src="../../assets/js/bootstrap.js" type="text/javascript"></script>
+ <script src="../../assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+ </body>
+</html>
\ No newline at end of file
Modified: mesos/site/publish/documentation/upgrades/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/documentation/upgrades/index.html?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/publish/documentation/upgrades/index.html (original)
+++ mesos/site/publish/documentation/upgrades/index.html Fri Feb 14 02:29:28 2014
@@ -104,6 +104,42 @@
<p>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.</p>
+<h2>Upgrading from 0.17.0 to 0.18.0.</h2>
+
+<p>In order to upgrade a running cluster:</p>
+
+<p>Note: This upgrade requires a system reboot for slaves that use Linux cgroups for isolation.</p>
+
+<ul>
+<li>Install the new master binaries and restart the masters.</li>
+<li>Upgrade the schedulers by linking the latest native library and mesos jar (if necessary).</li>
+<li>Restart the schedulers.</li>
+<li>Install the new slave binaries then perform one of the following two steps, depending on if cgroups isolation is used:
+
+<ul>
+<li>[no cgroups]
+
+<ul>
+<li>Restart the slaves. The “–isolation” flag has changed and “process” has been deprecated in favor of “posix/cpu,posix/mem”.</li>
+</ul>
+</li>
+<li>[cgroups]
+
+<ul>
+<li>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/.</li>
+<li>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”.</li>
+<li>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.</li>
+<li>The “–cgroups_hierarchy” now defaults to “/sys/fs/cgroup”. The “–cgroups_root” flag default remains “mesos”.</li>
+<li> The “–isolation” flag has changed and “cgroups” has been deprecated in favor of “cgroups/cpu,cgroups/mem”.</li>
+<li>The “–cgroup_subsystems” flag is no longer required and will be ignored.</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>Upgrade the executors by linking the latest native library and mesos jar (if necessary).</li>
+</ul>
+
+
<h2>Upgrading from 0.16.0 to 0.17.0.</h2>
<p>In order to upgrade a running cluster:</p>
Modified: mesos/site/publish/gettingstarted/index.html
URL: http://svn.apache.org/viewvc/mesos/site/publish/gettingstarted/index.html?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/publish/gettingstarted/index.html (original)
+++ mesos/site/publish/gettingstarted/index.html Fri Feb 14 02:29:28 2014
@@ -22,7 +22,7 @@
<html>
<head>
<meta charset="utf-8">
- <title>Apache Mesos | Getting Started</title>
+ <title></title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="">
<meta name="author" content="">
@@ -83,123 +83,129 @@
</li>
<li><a href="http://mesos.apache.org">Apache Mesos</a></li>
- <li><a href="/gettingstarted/">Getting Started</a></li>
+
+ <li><a href="/documentation
+/">Documentation
+</a></li>
+
</ul><!-- /breadcrumb -->
- <p> <div class="row">
- <div class="col-md-2">
- <ul class="list-group">
- <li class="list-group-item"><a href="#system-requirements">Requirements</a></li>
- <li class="list-group-item"><a href="#downloading-mesos">Download Mesos</a></li>
- <li class="list-group-item"><a href="#buildingmesos">Build Mesos</a></li>
- <li class="list-group-item"><a href="#running-example-frameworks">Run Frameworks</a></li>
- </ul>
- </div>
- <div class="col-md-10">
- <h1>Getting Started with Apache Mesos</h1></p>
-
-<h3><a name="system-requirements">System Requirements</a></h3>
-
-
-
-
-<p>Mesos runs on Linux and Mac OS X, and has previously also been tested on OpenSolaris. You will need the following packages to run it:</p>
-
+ <div class="row-fluid">
+ <div class="col-md-4">
+ <h4>If you're new to Mesos</h4>
+ <p>See the <a href="/gettingstarted/">getting started</a> page for more information about downloading, building, and deploying Mesos.</p>
+
+ <h4>If you'd like to get involved or you're looking for support</h4>
+ <p>See our <a href="/community/">community</a> page for more details.</p>
+ </div>
+ <div class="col-md-8">
+ <h1>Getting Started with Apache Mesos</h1>
+
+<h2>Downloading Mesos</h2>
+
+<p>There are different ways you can get Mesos:</p>
+
+<ol>
+<li><p>Download the latest stable release from <a href="http://mesos.apache.org/downloads/">Apache</a> (<strong><em>Recommended</em></strong>)</p>
+
+<pre><code> $ wget http://www.apache.org/dist/mesos/0.14.0/mesos-0.14.0.tar.gz
+ $ tar -zxf mesos-0.14.0.tar.gz
+</code></pre></li>
+<li><p>Clone the Mesos git <a href="http://git-wip-us.apache.org/repos/asf/mesos.git">repository</a> (<strong><em>Advanced Users Only</em></strong>)</p>
+
+<pre><code> $ git clone http://git-wip-us.apache.org/repos/asf/mesos.git
+</code></pre></li>
+</ol>
+<h2>System Requirements</h2>
<ul>
- <li>g++ 4.1 or higher.</li>
- <li>Python 2.6 (for the Mesos web UI). On Mac OS X 10.6 or earlier, get Python from <a href="http://www.macports.org">MacPorts</a> via <code>port install python26</code>, because OS X's version of Python is not 64-bit.</li>
- <li>Python 2.6 developer packages (on red-hat - <code>sudo yum install python26-devel python-devel</code>) (on debian - <code>sudo apt-get python2.6-dev</code>)</li>
- <li>cppunit (for building zookeeper) (on red-hat - <code>sudo yum install cppunit-devel</code>) (on debian - <code>sudo apt-get install libcppunit-dev</code>)</li>
- <li>libunwind (for building gperftools) (on red-hat - <code>sudo yum install libunwind-devel</code>) (on debian - <code>sudo apt-get install libunwind7-dev</code>)</li>
- <li>Java JDK 1.6 or higher. Mac OS X 10.6 users will need to install the JDK from http://connect.apple.com/ and set <code>JAVA_HEADERS=/System/Library/Frameworks/JavaVM.framework/Versions/A/Headers</code>.</li>
-</ul>
+<li><p>Mesos runs on Linux (64 Bit) and Mac OSX (64 Bit).</p></li>
+<li><p>Following are the instructions for stock Ubuntu 12.04 64 Bit. If you are using a different OS please install the packages accordingly.</p>
+<pre><code> # Ensure apt-get is up to date.
+ $ sudo apt-get update
+ # Install build tools.
+ $ sudo apt-get install build-essential
+ # Install OpenJDK java.
+ $ sudo apt-get install openjdk-6-jdk
-<h3><a name="downloading-mesos">Downloading Mesos</a></h3>
+ # Install devel python.
+ $ sudo apt-get install python-dev
+ # Install devel libcurl (***Optional***).
+ $ sudo apt-get install libcurl4-nss-dev
-
-
-<p>Mesos is available as a tar file, or the source can be downloaded directly from git. To get running with Mesos version 0.16.0, our most-recent release by either:</p>
-
-
-
-
-<ul>
- <li><a href="http://www.apache.org/dyn/mirrors/mirrors.cgi/mesos/0.16.0/">Download Mesos 0.16.0</a></li>
- <li>Obtain the current Mesos development HEAD by checking it out from Apache Git mirror repository, using: <code>git clone git://git.apache.org/mesos.git</code>, or <code>https://git-wip-us.apache.org/repos/asf/mesos.git</code></li>
+ # Install devel libsasl (***Only required for Mesos 0.14.0 or newer***).
+ $ sudo apt-get install libsasl2-dev
+</code></pre></li>
</ul>
+<p>If you are building from git repository, you will need to additionally install the following packages.</p>
+<pre><code> # Install autotoconf and automake.
+ $ sudo apt-get install autoconf
-<h3><a name="buildingmesos">Building Mesos</a></h3>
+ # Install libtool.
+ $ sudo apt-get install libtool
+</code></pre>
+<h2>Building Mesos</h2>
+<pre><code> # Change working directory.
+ $ cd mesos
+ # Bootstrap (***Skip this if you are not building from git repo***).
+ $ ./bootstrap
-<ul>
- <li>Only if running from source code cloned from git, run <code>./bootstrap</code> otherwise skip to step 3</li>
- <li>If you get error <code>Autoreconf may not be installed</code>, on debian run <code>sudo apt-get install autoconf</code>
- <li>If you get error <code>Makefile.am:27: Libtool library used but `LIBTOOL' is undefined</code>, on debian run <code>sudo apt-get update && sudo apt-get install autotools-dev libltdl-dev libtool autoconf autopoint </code></li>
- <li>Run <code>./configure</code>, which includes the web UI and included Zookeeper. Advanced users may want to exclude these options or include other options, see <a href="http://mesos.apache.org/documentation/latest/configuration/">Mesos Command-Line Flags</a>.</li>
- <li>Run <code>make</code></li>
-</ul>
-
-
-
-
-<h4>NOTES:</h4>
-
-
-<ul>
- <li>The build process attempts to guess where your Java include directory is, but if you have set the $JAVA_HOME environment variable, it will use $JAVA_HOME/include, which may not be correct (or exist) on your machine (in which case you will see an error such as: "configure: error: failed to build against JDK (using libtool)"). If this is the case, we suggest you unset the JAVA_HOME environment variable.</li>
- <li>`configure` may print a warning at the end about "unrecognized options: --with-java-home, ...". This comes from one of the nested `configure` scripts that we call, so it doesn't mean that your options were ignored.</li>
- <li>(NOT SURE IF THIS IS STILL RELEVANT) On 32-bit platforms, you should set `CXXFLAGS="-march=i486"` when running `configure` to ensure certain atomic instructions can be used.</li>
-</ul>
-
-
-
+ # Configure and build.
+ $ mkdir build
+ $ cd build
+ $ ../configure
+ $ make -j
-<h3><a name="running-example-frameworks">Running Example Frameworks</a></h3>
+ # Run test suite.
+ $ make -j check
+ # Install (***Optional***).
+ $ make install
+</code></pre>
+<h2>Examples</h2>
+<p>Mesos comes bundled with example frameworks written in <code>C++</code>, <code>Java</code> and <code>Python</code>.</p>
-<p>Currently, in order to run the example frameworks (in src/examples), you must first build the test suite, as instructed below.</p>
+<pre><code> # Change into build directory.
+ $ cd build
+ # Start mesos master.
+ $ ./bin/mesos-master.sh --ip=127.0.0.1
+ # Start mesos slave.
+ $ ./bin/mesos-slave.sh --master=127.0.0.1:5050
+ # Visit the mesos web page.
+ $ http://127.0.0.1:5050
-<p>After you build Mesos by running the `make` command, you can set up a small Mesos cluster and run a job on it as follows:</p>
+ # Run C++ framework (***Exits after successfully running some tasks.***).
+ $ ./src/test-framework --master=127.0.0.1:5050
+ # Run Java framework (***Exits after successfully running some tasks.***).
+ $ ./src/examples/java/test-framework 127.0.0.1:5050
+ # Run Python framework (***Exits after successfully running some tasks.***).
+ $ ./src/examples/python/test-framework 127.0.0.1:5050
+</code></pre>
+<p><em>NOTE: To build the example frameworks, make sure you build the test suite by doing <code>make check</code>.</em></p>
-<ul>
- <li>Go into the directory where you built Mesos.
- <li>Type `bin/mesos-master.sh` to launch the master.
- <li>Take note of the IP and port that the master is running on, which will look something like <code>192.168.0.1:5050</code>. <i>Note: In this example the IP address of master is 192.168.0.1, and the port is 5050. We will continue to use the URL shown here for the rest of this example; however when you run the following commands replace all instances of it with the URL of your master.</i></li>
- <li>URL of master: <code>192.168.0.1:5050</code>
- <li>View the master's web UI at `http://[hostname of master]:5050`.
- <li>Launch a slave by typing <code>bin/mesos-slave.sh --master=192.168.0.1:5050</code>. The slave will show up on the master's web UI if you refresh it.
- <li>Run the C++ test framework (a sample that just runs five tasks on the cluster) using <code> src/test-framework --master=localhost:5050 </code>. It should successfully exit after running five tasks.</li>
- <li>You can also try the example python or Java frameworks, with commands like the following:</li>
- <ul>
- <li>`src/examples/java/test-framework 192.168.0.1:5050`</li>
- <li>`src/examples/python/test-framework 192.168.0.1:5050`</li>
- </ul>
-</ul>
-
-
-<p> </div>
- </div></p>
+ </div>
+</div>
<hr>
Modified: mesos/site/publish/sitemap.xml
URL: http://svn.apache.org/viewvc/mesos/site/publish/sitemap.xml?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/publish/sitemap.xml (original)
+++ mesos/site/publish/sitemap.xml Fri Feb 14 02:29:28 2014
@@ -2,222 +2,238 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>http://mesos.apache.org/blog/slave-recovery-in-apache-mesos/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/blog/mesos-0-14-2-released/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/blog/niklas-nielsen-becomes-mesos-committer/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/blog/framework-authentication-in-apache-mesos-0-15-0/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/blog/mesos-0-16-0-released/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/blog/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/community/committers/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/community/user-groups/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/community/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/allocation-module/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/app-framework-development-guide/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/committers-guide/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/configuration/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/deploy-scripts/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/ec2-scripts/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
+ </url>
+ <url>
+ <loc>http://mesos.apache.org/documentation/latest/getting-started/</loc>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/high-availability/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/logging-and-debugging/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/mesos-architecture/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/mesos-c++-style-guide/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/mesos-code-internals/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/mesos-developers-guide/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/mesos-presentations/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/mesos-roadmap/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/powered-by-mesos/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
+ </url>
+ <url>
+ <loc>http://mesos.apache.org/documentation/latest/release-guide/</loc>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/running-a-web-application-farm-on-mesos/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/running-torque-or-mpi-on-mesos/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/slave-recovery/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/upgrades/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/using-the-mesos-submit-tool/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/latest/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/downloads/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
- </url>
- <url>
- <loc>http://mesos.apache.org/gettingstarted/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
+ </url>
+ <url>
+ <loc>http://mesos.apache.org/gettingstarted/</loc>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/allocation-module/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/app-framework-development-guide/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/committers-guide/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/configuration/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/deploy-scripts/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/ec2-scripts/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
+ </url>
+ <url>
+ <loc>http://mesos.apache.org/documentation/getting-started/</loc>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/high-availability/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/logging-and-debugging/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/mesos-architecture/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/mesos-c++-style-guide/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/mesos-code-internals/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/mesos-developers-guide/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/mesos-presentations/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/mesos-roadmap/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/powered-by-mesos/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
+ </url>
+ <url>
+ <loc>http://mesos.apache.org/documentation/release-guide/</loc>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/running-a-web-application-farm-on-mesos/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/running-torque-or-mpi-on-mesos/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/slave-recovery/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/upgrades/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
<url>
<loc>http://mesos.apache.org/documentation/using-the-mesos-submit-tool/</loc>
- <lastmod>2014-02-11T00:00:00-08:00</lastmod>
+ <lastmod>2014-02-13T00:00:00-08:00</lastmod>
</url>
</urlset>
\ No newline at end of file
Modified: mesos/site/source/documentation/latest.md
URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest.md?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/source/documentation/latest.md (original)
+++ mesos/site/source/documentation/latest.md Fri Feb 14 02:29:28 2014
@@ -6,13 +6,12 @@ layout: documentation
## Users Documentation
-* [Mesos Configuration](configuration) command-line arguments
+* [Mesos Configuration](configuration) for command-line arguments
* [Deploy Scripts](deploy-scripts) for launching a Mesos cluster on a set of machines.
* [EC2 scripts](ec2-scripts) for launching a Mesos cluster on Amazon EC2.
-* [Logging and Debugging](logging-and-debugging) -- viewing Mesos and framework logs.
+* [Logging and Debugging](logging-and-debugging) for viewing Mesos and framework logs.
* [High Availability](high-availability) for running multiple masters simultaneously.
-* [Slave Recovery](slave-recovery)
-* [Using Mesos Submit Tool](using-the-mesos-submit-tool) for launching a framework with a single task.
+* [Slave Recovery](slave-recovery) for doing seamless upgrades
## Running Mesos Frameworks
@@ -36,6 +35,7 @@ layout: documentation
* [Mesos Developers Guide](mesos-developers-guide) includes resources for developers contributing to Mesos and the process of submitting patches for review.
* [C++ Style Guide](mesos-c++-style-guide)
+* [Release Guide](release-guide)
* [Mesos Development Road Map](mesos-roadmap)
## More Info about Mesos
Added: mesos/site/source/documentation/latest/getting-started.md
URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest/getting-started.md?rev=1568190&view=auto
==============================================================================
--- mesos/site/source/documentation/latest/getting-started.md (added)
+++ mesos/site/source/documentation/latest/getting-started.md Fri Feb 14 02:29:28 2014
@@ -0,0 +1,98 @@
+---
+layout: documentation
+---
+
+# Getting Started with Apache Mesos
+
+## Downloading Mesos
+
+There are different ways you can get Mesos:
+
+1. Download the latest stable release from [Apache](http://mesos.apache.org/downloads/) (***Recommended***)
+
+ $ wget http://www.apache.org/dist/mesos/0.14.0/mesos-0.14.0.tar.gz
+ $ tar -zxf mesos-0.14.0.tar.gz
+
+2. Clone the Mesos git [repository](http://git-wip-us.apache.org/repos/asf/mesos.git) (***Advanced Users Only***)
+
+ $ git clone http://git-wip-us.apache.org/repos/asf/mesos.git
+
+## System Requirements
+
+- Mesos runs on Linux (64 Bit) and Mac OSX (64 Bit).
+
+- Following are the instructions for stock Ubuntu 12.04 64 Bit. If you are using a different OS please install the packages accordingly.
+
+ # Ensure apt-get is up to date.
+ $ sudo apt-get update
+
+ # Install build tools.
+ $ sudo apt-get install build-essential
+
+ # Install OpenJDK java.
+ $ sudo apt-get install openjdk-6-jdk
+
+ # Install devel python.
+ $ sudo apt-get install python-dev
+
+ # Install devel libcurl (***Optional***).
+ $ sudo apt-get install libcurl4-nss-dev
+
+ # Install devel libsasl (***Only required for Mesos 0.14.0 or newer***).
+ $ sudo apt-get install libsasl2-dev
+
+
+If you are building from git repository, you will need to additionally install the following packages.
+
+ # Install autotoconf and automake.
+ $ sudo apt-get install autoconf
+
+ # Install libtool.
+ $ sudo apt-get install libtool
+
+
+## Building Mesos
+
+ # Change working directory.
+ $ cd mesos
+
+ # Bootstrap (***Skip this if you are not building from git repo***).
+ $ ./bootstrap
+
+ # Configure and build.
+ $ mkdir build
+ $ cd build
+ $ ../configure
+ $ make -j
+
+ # Run test suite.
+ $ make -j check
+
+ # Install (***Optional***).
+ $ make install
+
+## Examples
+Mesos comes bundled with example frameworks written in `C++`, `Java` and `Python`.
+
+ # Change into build directory.
+ $ cd build
+
+ # Start mesos master.
+ $ ./bin/mesos-master.sh --ip=127.0.0.1
+
+ # Start mesos slave.
+ $ ./bin/mesos-slave.sh --master=127.0.0.1:5050
+
+ # Visit the mesos web page.
+ $ http://127.0.0.1:5050
+
+ # Run C++ framework (***Exits after successfully running some tasks.***).
+ $ ./src/test-framework --master=127.0.0.1:5050
+
+ # Run Java framework (***Exits after successfully running some tasks.***).
+ $ ./src/examples/java/test-framework 127.0.0.1:5050
+
+ # Run Python framework (***Exits after successfully running some tasks.***).
+ $ ./src/examples/python/test-framework 127.0.0.1:5050
+
+*NOTE: To build the example frameworks, make sure you build the test suite by doing `make check`.*
Added: mesos/site/source/documentation/latest/release-guide.md
URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest/release-guide.md?rev=1568190&view=auto
==============================================================================
--- mesos/site/source/documentation/latest/release-guide.md (added)
+++ mesos/site/source/documentation/latest/release-guide.md Fri Feb 14 02:29:28 2014
@@ -0,0 +1,100 @@
+---
+layout: documentation
+---
+
+# Release Guide
+
+This guide describes the process of doing an official release of Mesos.
+
+-----------------------------------------------------------------------
+
+## Prerequisites
+
+1. Go to [Apache Jira](https://issues.apache.org/jira/browse/MESOS) and make sure that
+ the CHANGELOG for the release version is up to date.
+
+ > NOTE: You should move all **Unresolved** tickets marked with `Fix Version` as the
+ release version to the next release version.
+
+ > PROTIP: Use `bulk edit` option in JIRA to move the tickets and make sure to
+ **uncheck** the option that emails everyone about the move.
+
+
+2. Update and commit the `CHANGELOG` for the release.
+
+ > NOTE: You should use JIRA to generate the CHANGELOG for you. Click on the release
+ version in [JIRA](https://issues.apache.org/jira/browse/MESOS#selectedTab=com.atlassian.jira.plugin.system.project%3Aversions-panel) and click
+ on the `Release Notes`. Make sure to configure the release notes in text format.
+
+
+3. Update and commit the `docs/upgrades` with instructions about how to upgrade
+ a live cluster from the previous release version to this release version.
+
+
+4. If this is a major release please write and commit documentation for this feature.
+
+
+## Tagging the release candidate
+
+1. Ensure that you can build and pass all the tests.
+
+ $ make -j3 distcheck
+
+2. First tag the required SHA locally.
+
+ $ git tag <X.Y.Z-rcR>
+
+ > NOTE: `X.Y.Z` is based on [semantic versioning](http://semver.org/) scheme. `R` is release
+ candidate version that starts with 1.
+
+
+3. Tag the release externally and deploy the corresponding JAR to the Apache maven repository.
+ It is recommended to use the `support/tag.sh` script to accomplish this.
+
+ $ ./support/tag.sh X.Y.Z R
+
+ > NOTE: This script assumes that you have the requisite permissions to deploy the JAR. For
+ instructions on how to set it up, please refer to `src/java/MESOS-MAVEN-README`.
+
+
+4. It is not uncommon to release multiple release candidates, with increasing release candidate
+ version, if there are bugs found.
+
+
+## Voting the release candidate
+
+1. Once a release candidate is deemed worthy to be officially released you should call a vote on
+ the `dev@meosos.apache.org` (and optionally `user@mesos.apache.org`) mailing list.
+
+
+2. It is recommended to use the `support/vote.sh` script to vote the release candidate.
+
+ $ ./support/vote.sh X.Y.Z R
+
+
+3. The release script also spits out an email template that you could use to send the vote email.
+
+
+## Releasing the release candidate
+
+1. You should only release an official version if the vote passes with at least **3 +1 binding votes
+ and no -1 votes**. For more information, please refer to [Apache release guidelines](http://www.apache.org/dev/release.html).
+
+
+2. It is recommended to use `support/release.sh` script to release the candidate.
+
+ $ ./support/release.sh X.Y.Z R
+
+
+3. The release script also spits out an email template that you could use to notify the mailing lists about
+ the result of the vote and the release.
+
+ > NOTE: Make sure you fill the email template with the names of binding voters.
+
+
+## Updating the website
+
+1. After a successful release please update the website pointing to the new release.
+
+
+2. It is also recommended to write a blog post announcing the feature.
Modified: mesos/site/source/documentation/latest/upgrades.md
URL: http://svn.apache.org/viewvc/mesos/site/source/documentation/latest/upgrades.md?rev=1568190&r1=1568189&r2=1568190&view=diff
==============================================================================
--- mesos/site/source/documentation/latest/upgrades.md (original)
+++ mesos/site/source/documentation/latest/upgrades.md Fri Feb 14 02:29:28 2014
@@ -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: