You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@slider.apache.org by bi...@apache.org on 2014/07/07 21:03:40 UTC
svn commit: r1608561 [9/16] - in /incubator/slider/site/content: ./ css/
design/ design/registry/ design/specification/ developing/ docs/
docs/configuration/ docs/slider_specs/ downloads/ fonts/ images/ js/
release_notes/
Modified: incubator/slider/site/content/developing/testing.html
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/developing/testing.html?rev=1608561&r1=1608560&r2=1608561&view=diff
==============================================================================
--- incubator/slider/site/content/developing/testing.html (original)
+++ incubator/slider/site/content/developing/testing.html Mon Jul 7 19:03:38 2014
@@ -1,173 +1,159 @@
<!DOCTYPE html>
+<html lang="en">
+<head>
<!--
- | Generated by Apache Maven Doxia at 2014-05-30
- | Rendered using Apache Maven Fluido Skin 1.3.0
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
-->
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
- <head>
- <meta charset="UTF-8" />
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20140530" />
- <meta http-equiv="Content-Language" content="en" />
- <title>Apache Slider 0.30 (incubating) - </title>
- <link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
- <link rel="stylesheet" href="../css/site.css" />
- <link rel="stylesheet" href="../css/print.css" media="print" />
-
-
- <script type="text/javascript" src="../js/apache-maven-fluido-1.3.0.min.js"></script>
-
-
- </head>
- <body class="topBarEnabled">
-
-
-
-
-
- <div id="topbar" class="navbar navbar-fixed-top ">
- <div class="navbar-inner">
- <div class="container"><div class="nav-collapse">
-
-
- <ul class="nav">
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project Documentation <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li class="dropdown-submenu">
- <a href="../project-info.html" title="Project Information">Project Information</a>
- <ul class="dropdown-menu">
- <li> <a href="../index.html" title="About">About</a>
-</li>
- <li> <a href="../plugin-management.html" title="Plugin Management">Plugin Management</a>
-</li>
- <li> <a href="../distribution-management.html" title="Distribution Management">Distribution Management</a>
-</li>
- <li> <a href="../dependency-info.html" title="Dependency Information">Dependency Information</a>
-</li>
- <li> <a href="../dependency-convergence.html" title="Dependency Convergence">Dependency Convergence</a>
-</li>
- <li> <a href="../source-repository.html" title="Source Repository">Source Repository</a>
-</li>
- <li> <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
-</li>
- <li> <a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
-</li>
- <li> <a href="../integration.html" title="Continuous Integration">Continuous Integration</a>
-</li>
- <li> <a href="../plugins.html" title="Project Plugins">Project Plugins</a>
-</li>
- <li> <a href="../license.html" title="Project License">Project License</a>
-</li>
- <li> <a href="../modules.html" title="Project Modules">Project Modules</a>
-</li>
- <li> <a href="../dependency-management.html" title="Dependency Management">Dependency Management</a>
-</li>
- <li> <a href="../team-list.html" title="Project Team">Project Team</a>
-</li>
- <li> <a href="../project-summary.html" title="Project Summary">Project Summary</a>
-</li>
- <li> <a href="../dependencies.html" title="Dependencies">Dependencies</a>
-</li>
- </ul>
- </li>
-
- <li class="dropdown-submenu">
- <a href="../project-reports.html" title="Project Reports">Project Reports</a>
- <ul class="dropdown-menu">
- <li> <a href="../surefire-report.html" title="Surefire Report">Surefire Report</a>
-</li>
- </ul>
- </li>
- </ul>
- </li>
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documents <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li> <a href="../getting_started.html" title="Getting Started">Getting Started</a>
-</li>
-
- <li> <a href="../manpage.html" title="manpage">manpage</a>
-</li>
-
- <li> <a href="../troubleshooting.html" title="Troubleshooting">Troubleshooting</a>
-</li>
-
- <li> <a href="../architecture/index.html" title="Architecture">Architecture</a>
-</li>
-
- <li> <a href="../developing/index.html" title="Developing">Developing</a>
-</li>
-
- <li> <a href="../exitcodes.html" title="Exitcodes">Exitcodes</a>
-</li>
- </ul>
- </li>
- <li class="dropdown">
- <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
- <ul class="dropdown-menu">
-
- <li> <a href="http://www.apache.org/foundation/how-it-works.html" title="How Apache Works">How Apache Works</a>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <link href="/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/css/bootstrap-theme.min.css" rel="stylesheet">
+ <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
+ <script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script>
+ <![endif]-->
+ <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script>
+ <script src="/js/bootstrap.min.js"></script>
+ <link href="/css/slider.css" rel="stylesheet" type="text/css">
+ <link href="//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.css" rel="stylesheet">
+ <title></title>
+
+</head>
+
+<body>
+<nav class="navbar navbar-default navbar-fixed-top" role="navigation">
+<div class="container-fluid">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#navbar-items">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/index.html">Slider</a>
+ </div>
+ <div class="collapse navbar-collapse" id="navbar-items">
+ <ul class="nav navbar-nav">
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ Project <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_index"><a href="/index.html">Home</a></li>
+<li id="nav_downloads"><a href="/downloads">Downloads</a></li>
+<li id="nav_source"><a href="https://git-wip-us.apache.org/repos/asf/incubator-slider.git"><i class="fa fa-external-link"></i> Source</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0"><i class="fa fa-external-link"></i> License</a></li>
+<li class="divider"></li>
+<li class="dropdown-header">Community</li>
+<li id="nav_team"><a href="/team.html">Team</a></li>
+<li id="nav_mailinglists"><a href="/mailing_lists.html">Mailing Lists</a></li>
+<li class="divider"></li>
+<li class="dropdown-header">Tools</li>
+<li id="nav_jira"><a href="https://issues.apache.org/jira/browse/SLIDER"><i class="fa fa-external-link"></i> Issues</a></li>
+<li id="nav_builds"><a href="https://builds.apache.org/job/Slider-develop"><i class="fa fa-external-link"></i> Builds</a></li>
+</ul>
</li>
-
- <li> <a href="http://www.apache.org/dev/" title="Developer Documentation">Developer Documentation</a>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="/design">
+ Design <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_design_overview"><a href="/design/architecture.html">Overview</a></li>
+<li id="nav_app_needs"><a href="/docs/slider_specs/application_needs.html">Application Needs</a></li>
+<li id="nav_spec"><a href="/design/specification/index.html">Expected Behavior</a></li>
+<li id="nav_registry"><a href="/design/registry/index.html">Service Registry</a></li>
+<li id="nav_role_history"><a href="/design/rolehistory.html">Role History</a></li>
+</ul>
</li>
-
- <li> <a href="http://www.apache.org/foundation/" title="Foundation">Foundation</a>
+
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="/developing">
+ Developing <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_dev_building"><a href="/developing/building.html">Building</a></li>
+<li id="nav_dev_debugging"><a href="/docs/debugging.html">Debugging</a></li>
+<li id="nav_dev_testing"><a href="/developing/testing.html">Testing</a></li>
+<li id="nav_dev_funtesting"><a href="/developing/functional_tests.html">Functional Testing</a></li>
+<li id="nav_dev_manual_testing"><a href="/developing/manual_testing.html">Manual Testing</a></li>
+<li id="nav_releasing"><a href="/developing/releasing.html">Releasing</a></li>
+</ul>
</li>
-
- <li> <a href="http://www.apache.org/foundation/sponsorship.html" title="Sponsor Apache">Sponsor Apache</a>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ Using <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_use_getting_started"><a href="/docs/getting_started.html">Getting Started</a></li>
+<li id="nav_use_manpage"><a href="/docs/manpage.html">Man Page</a></li>
+<li id="nav_use_examples"><a href="/docs/examples.html">Examples</a></li>
+<li id="nav_use_client_config"><a href="/docs/client-configuration.html">Client Configuration</a></li>
+<li id="nav_use_exitcodes"><a href="/docs/exitcodes.html">Client Exit Codes</a></li>
+<li id="nav_use_security"><a href="/docs/security.html">Security</a></li>
+<li id="nav_use_app_package"><a href="/docs/slider_specs/index.html">App Packaging</a></li>
+<li id="nav_use_app_configuration"><a href="/docs/configuration/index.html">App Configuration Model</a></li>
+<li id="nav_use_debugging"><a href="/docs/debugging.html">Debugging</a></li>
+<li id="nav_use_troubleshooting"><a href="/docs/troubleshooting.html">Troubleshooting</a></li>
+</ul>
</li>
-
- <li> <a href="http://www.apache.org/foundation/thanks.html" title="Thanks">Thanks</a>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ ASF Links <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li><a href="http://www.apache.org"><i class="fa fa-external-link"></i> Apache Software Foundation</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html"><i class="fa fa-external-link"></i> Sponsorship</a></li>
+<li><a href="http://www.apache.org/security/"><i class="fa fa-external-link"></i> Security</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html"><i class="fa fa-external-link"></i> Thanks</a></li>
+</ul>
</li>
- </ul>
- </li>
- </ul>
-
-
-
-
- </div>
-
- </div>
- </div>
- </div>
-
- <div class="container">
- <div id="banner">
- <div class="pull-left">
- <a href=".././" id="bannerLeft">
- <h2>Apache Slider (incubating)</h2>
- </a>
- </div>
- <div class="pull-right"> <div id="bannerRight">
- <img src="http://incubator.apache.org/images/apache-incubator-logo.png" />
- </div>
- </div>
- <div class="clear"><hr/></div>
- </div>
-
- <div id="breadcrumbs">
- <ul class="breadcrumb">
-
-
- <li id="publishDate">Last Published: 2014-05-30</li>
-
-
-
- <li id="projectVersion" class="pull-right">Version: 0.30</li>
-
- </ul>
- </div>
-
-
-
- <div id="bodyColumn" >
-
- <!-- -
+</ul>
+
+ </div>
+
+</div>
+</nav>
+
+
+<div class="container-fluid">
+<div class="row">
+ <div class="col-md-2" id="sidebar">
+ <div style="text-align: center">
+ <h1><a href="/index.html">Apache Slider (incubating)</a></h1>
+ <hr>
+Latest release: <strong>0.30-incubating</strong><br>
+ <br>
+ <a id="download-button-sidebar" class="btn btn-success btn-block" href="/downloads/" role="button">Download</a>
+ </div>
+ <hr>
+ <a href="http://incubator.apache.org"><img id="logo" alt="Apache Incubator ™" class="img-responsive" src="http://incubator.apache.org/images/apache-incubator-logo.png"/></a>
+ </div>
+ <div class="col-md-8 col-md-offset-1">
+
+ <div id="content">
+
+ <h1 class="title"></h1>
+
+ <!---
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
@@ -181,36 +167,34 @@
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
- limitations under the License. --><h1>Testing Apache Slider</h1>
+ limitations under the License.
+-->
-<div class="source">
-<pre> The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
+<h1 id="testing-apache-slider">Testing Apache Slider</h1>
+<pre class="codehilite"><code> The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in
- RFC 2119.
-</pre></div>
-<div class="section">
-<h2>Standalone Tests<a name="Standalone_Tests"></a></h2>
-<p>Slider core contains a suite of tests that are designed to run on the local machine, using Hadoop’s <tt>MiniDFSCluster</tt> and <tt>MiniYARNCluster</tt> classes to create small, one-node test clusters. All the YARN/HDFS code runs in the JUnit process; the AM and spawned processeses run independently.</p>
-<div class="section">
-<h3>For HBase Tests in <tt>slider-providers/hbase</tt><a name="For_HBase_Tests_in_slider-providershbase"></a></h3>
-<p>Requirements * A copy of <tt>hbase.tar.gz</tt> in the local filesystem * A an expanded <tt>hbase.tar.gz</tt> in the local filesystem</p></div>
-<div class="section">
-<h3>For Accumulo Tests in <tt>slider-providers/accumulo</tt><a name="For_Accumulo_Tests_in_slider-providersaccumulo"></a></h3>
+ RFC 2119.</code></pre>
+
+<h2 id="standalone-tests">Standalone Tests</h2>
+<p>Slider core contains a suite of tests that are designed to run on the local machine,
+using Hadoop's <code>MiniDFSCluster</code> and <code>MiniYARNCluster</code> classes to create small,
+one-node test clusters. All the YARN/HDFS code runs in the JUnit process; the
+AM and spawned processeses run independently.</p>
+<h3 id="for-hbase-tests-in-slider-providershbase">For HBase Tests in <code>slider-providers/hbase</code></h3>
+<p>Requirements
+<em> A copy of <code>hbase.tar.gz</code> in the local filesystem
+</em> A an expanded <code>hbase.tar.gz</code> in the local filesystem</p>
+<h3 id="for-accumulo-tests-in-slider-providersaccumulo">For Accumulo Tests in <code>slider-providers/accumulo</code></h3>
<ul>
-
-<li>A copy of <tt>accumulo.tar.gz</tt> in the local filesystem,</li>
-
-<li>An expanded <tt>accumulo.tar.gz</tt> in the local filesystem,</li>
-
+<li>A copy of <code>accumulo.tar.gz</code> in the local filesystem, </li>
+<li>An expanded <code>accumulo.tar.gz</code> in the local filesystem, </li>
<li>an expanded Zookeeper installation</li>
</ul>
-<p>All of these need to be defined in the file <tt>slider-core/src/test/resources/slider-test.xml</tt></p>
+<p>All of these need to be defined in the file <code>slider-core/src/test/resources/slider-test.xml</code></p>
<p>Example:</p>
-
-<div class="source">
-<pre><configuration>
+<pre class="codehilite"><code><configuration>
<property>
<name>slider.test.hbase.enabled</name>
@@ -267,37 +251,35 @@
<description>Hadoop home dir on target systems</description>
</property>
-</configuration>
-</pre></div>
-<p><i>Important:</i> For the local tests, a simple local filesystem path is used for all the values. </p>
-<p>For the functional tests, the accumulo and hbase tar properties will need to be set to a URL of a tar file that is accessible to all the nodes in the cluster -which usually means HDFS, and so an <tt>hdfs://</tt> URL</p></div></div>
-<div class="section">
-<h2>Provider-specific parameters<a name="Provider-specific_parameters"></a></h2>
-<p>An individual provider can pick up settings from their own <tt>src/test/resources/slider-client.xml</tt> file, or the one in <tt>slider-core</tt>. We strongly advice placing all the values in the <tt>slider-core</tt> file.</p>
+</configuration></code></pre>
-<ol style="list-style-type: decimal">
-
-<li>All uncertainty about which file is picked up on the class path first goes away</li>
-
-<li>There’s one place to keep all the configuration values in sync.</li>
+
+<p><em>Important:</em> For the local tests, a simple local filesystem path is used for
+all the values. </p>
+<p>For the functional tests, the accumulo and hbase tar properties will
+need to be set to a URL of a tar file that is accessible to all the
+nodes in the cluster -which usually means HDFS, and so an <code>hdfs://</code> URL</p>
+<h2 id="provider-specific-parameters">Provider-specific parameters</h2>
+<p>An individual provider can pick up settings from their own
+<code>src/test/resources/slider-client.xml</code> file, or the one in <code>slider-core</code>.
+We strongly advice placing all the values in the <code>slider-core</code> file.</p>
+<ol>
+<li>All uncertainty about which file is picked up on the class path first goes
+away</li>
+<li>There's one place to keep all the configuration values in sync.</li>
</ol>
-<div class="section">
-<h3>Agent Tests<a name="Agent_Tests"></a></h3></div>
-<div class="section">
-<h3>HBase Tests<a name="HBase_Tests"></a></h3>
+<h3 id="agent-tests">Agent Tests</h3>
+<h3 id="hbase-tests">HBase Tests</h3>
<p>The HBase tests can be enabled or disabled</p>
-
-<div class="source">
-<pre><property>
+<pre class="codehilite"><code><property>
<name>slider.test.hbase.enabled</name>
<description>Flag to enable/disable HBase tests</description>
<value>true</value>
-</property>
-</pre></div>
-<p>Mandatory test parameters must be added to <tt>slider-client.xml</tt></p>
+</property></code></pre>
+
-<div class="source">
-<pre><property>
+<p>Mandatory test parameters must be added to <code>slider-client.xml</code></p>
+<pre class="codehilite"><code><property>
<name>slider.test.hbase.tar</name>
<description>Path to the HBase Tar file in HDFS</description>
<value>hdfs://sandbox:8020/user/slider/hbase.tar.gz</value>
@@ -307,60 +289,55 @@
<name>slider.test.hbase.appconf</name>
<description>Path to the directory containing the HBase application config</description>
<value>file://${user.dir}/src/test/configs/sandbox/hbase</value>
-</property>
-</pre></div>
-<p>Optional parameters: </p>
+</property></code></pre>
+
-<div class="source">
-<pre> <property>
+<p>Optional parameters: </p>
+<pre class="codehilite"><code> <property>
<name>slider.test.hbase.launch.wait.seconds</name>
<description>Time to wait in seconds for HBase to start</description>
<value>180000</value>
-</property>
-</pre></div>
-<div class="section">
-<h4>Accumulo configuration options<a name="Accumulo_configuration_options"></a></h4>
-<p>Enable/disable the tests</p>
+</property></code></pre>
+
-<div class="source">
-<pre> <property>
+<h4 id="accumulo-configuration-options">Accumulo configuration options</h4>
+<p>Enable/disable the tests</p>
+<pre class="codehilite"><code> <property>
<name>slider.test.accumulo.enabled</name>
<description>Flag to enable/disable Accumulo tests</description>
<value>true</value>
- </property>
-</pre></div>
-<p>Optional parameters</p>
+ </property></code></pre>
+
-<div class="source">
-<pre> <property>
+<p>Optional parameters</p>
+<pre class="codehilite"><code> <property>
<name>slider.test.accumulo.launch.wait.seconds</name>
<description>Time to wait in seconds for Accumulo to start</description>
<value>180000</value>
- </property>
-</pre></div></div></div></div>
- </div>
- </div>
-
- <hr/>
-
- <footer>
- <div class="container">
- <div class="row span12">Copyright © 2014
- <a href="http://www.apache.org/">The Apache Software Foundation</a>.
- All Rights Reserved.
-
- </div>
-
- <?xml version="1.0" encoding="UTF-8"?>
-<div class="row-fluid">Apache Slider, Slider, Apache, and the Apache Incubator logo are trademarks of The Apache Software Foundation.</div>
-
- <p id="poweredBy" class="pull-right">
- <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
- <img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
- </a>
- </p>
-
- </div>
- </footer>
- </body>
+ </property></code></pre>
+ </div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif" width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011-2014 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ Apache Slider, Slider, Apache, the Apache feather logo, and the Apache Incubator
+ project logo are trademarks of the <a href="http://www.apache.org">Apache Software Foundation</a>.<br />
+ Site created with <a href="http://getbootstrap.com/">Bootstrap</a> including icons from <a href="http://glyphicons.com/">GLYPHICONS</a> and <a href="http://fontawesome.io/">Font Awesome</a>.
+ </p>
+ </div>
+ </div>
+ </div>
+
+</div>
+</div>
+
+<script type="text/javascript">
+
+</script>
+</body>
</html>
Added: incubator/slider/site/content/docs/client-configuration.html
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/client-configuration.html?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/client-configuration.html (added)
+++ incubator/slider/site/content/docs/client-configuration.html Mon Jul 7 19:03:38 2014
@@ -0,0 +1,428 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <link href="/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/css/bootstrap-theme.min.css" rel="stylesheet">
+ <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
+ <script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script>
+ <![endif]-->
+ <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script>
+ <script src="/js/bootstrap.min.js"></script>
+ <link href="/css/slider.css" rel="stylesheet" type="text/css">
+ <link href="//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.css" rel="stylesheet">
+ <title></title>
+
+</head>
+
+<body>
+<nav class="navbar navbar-default navbar-fixed-top" role="navigation">
+<div class="container-fluid">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#navbar-items">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/index.html">Slider</a>
+ </div>
+ <div class="collapse navbar-collapse" id="navbar-items">
+ <ul class="nav navbar-nav">
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ Project <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_index"><a href="/index.html">Home</a></li>
+<li id="nav_downloads"><a href="/downloads">Downloads</a></li>
+<li id="nav_source"><a href="https://git-wip-us.apache.org/repos/asf/incubator-slider.git"><i class="fa fa-external-link"></i> Source</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0"><i class="fa fa-external-link"></i> License</a></li>
+<li class="divider"></li>
+<li class="dropdown-header">Community</li>
+<li id="nav_team"><a href="/team.html">Team</a></li>
+<li id="nav_mailinglists"><a href="/mailing_lists.html">Mailing Lists</a></li>
+<li class="divider"></li>
+<li class="dropdown-header">Tools</li>
+<li id="nav_jira"><a href="https://issues.apache.org/jira/browse/SLIDER"><i class="fa fa-external-link"></i> Issues</a></li>
+<li id="nav_builds"><a href="https://builds.apache.org/job/Slider-develop"><i class="fa fa-external-link"></i> Builds</a></li>
+</ul>
+</li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="/design">
+ Design <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_design_overview"><a href="/design/architecture.html">Overview</a></li>
+<li id="nav_app_needs"><a href="/docs/slider_specs/application_needs.html">Application Needs</a></li>
+<li id="nav_spec"><a href="/design/specification/index.html">Expected Behavior</a></li>
+<li id="nav_registry"><a href="/design/registry/index.html">Service Registry</a></li>
+<li id="nav_role_history"><a href="/design/rolehistory.html">Role History</a></li>
+</ul>
+</li>
+
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="/developing">
+ Developing <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_dev_building"><a href="/developing/building.html">Building</a></li>
+<li id="nav_dev_debugging"><a href="/docs/debugging.html">Debugging</a></li>
+<li id="nav_dev_testing"><a href="/developing/testing.html">Testing</a></li>
+<li id="nav_dev_funtesting"><a href="/developing/functional_tests.html">Functional Testing</a></li>
+<li id="nav_dev_manual_testing"><a href="/developing/manual_testing.html">Manual Testing</a></li>
+<li id="nav_releasing"><a href="/developing/releasing.html">Releasing</a></li>
+</ul>
+</li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ Using <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_use_getting_started"><a href="/docs/getting_started.html">Getting Started</a></li>
+<li id="nav_use_manpage"><a href="/docs/manpage.html">Man Page</a></li>
+<li id="nav_use_examples"><a href="/docs/examples.html">Examples</a></li>
+<li id="nav_use_client_config"><a href="/docs/client-configuration.html">Client Configuration</a></li>
+<li id="nav_use_exitcodes"><a href="/docs/exitcodes.html">Client Exit Codes</a></li>
+<li id="nav_use_security"><a href="/docs/security.html">Security</a></li>
+<li id="nav_use_app_package"><a href="/docs/slider_specs/index.html">App Packaging</a></li>
+<li id="nav_use_app_configuration"><a href="/docs/configuration/index.html">App Configuration Model</a></li>
+<li id="nav_use_debugging"><a href="/docs/debugging.html">Debugging</a></li>
+<li id="nav_use_troubleshooting"><a href="/docs/troubleshooting.html">Troubleshooting</a></li>
+</ul>
+</li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ ASF Links <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li><a href="http://www.apache.org"><i class="fa fa-external-link"></i> Apache Software Foundation</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html"><i class="fa fa-external-link"></i> Sponsorship</a></li>
+<li><a href="http://www.apache.org/security/"><i class="fa fa-external-link"></i> Security</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html"><i class="fa fa-external-link"></i> Thanks</a></li>
+</ul>
+</li>
+</ul>
+
+ </div>
+
+</div>
+</nav>
+
+
+<div class="container-fluid">
+<div class="row">
+ <div class="col-md-2" id="sidebar">
+ <div style="text-align: center">
+ <h1><a href="/index.html">Apache Slider (incubating)</a></h1>
+ <hr>
+Latest release: <strong>0.30-incubating</strong><br>
+ <br>
+ <a id="download-button-sidebar" class="btn btn-success btn-block" href="/downloads/" role="button">Download</a>
+ </div>
+ <hr>
+ <a href="http://incubator.apache.org"><img id="logo" alt="Apache Incubator ™" class="img-responsive" src="http://incubator.apache.org/images/apache-incubator-logo.png"/></a>
+ </div>
+ <div class="col-md-8 col-md-offset-1">
+
+ <div id="content">
+
+ <h1 class="title"></h1>
+
+ <!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<h1 id="apache-slider-client-configuration">Apache Slider Client Configuration</h1>
+<p>This document covers how the client application is itself configured.</p>
+<h2 id="summary">Summary</h2>
+<p>The client application can be configured</p>
+<ol>
+<li>On the command line, which can set client options and JVM system properties.</li>
+<li>With Hadoop-style configuration options in the file <code>slider-client.xml</code>
+ in the configuration directory<code>conf/</code> dir</li>
+<li>Or, if the environment variable <code>SLIDER_CONF_DIR</code> is set, in the
+ file <code>$SLIDER_CONF_DIR/slider-client.xml</code></li>
+<li>Logging is defined in the <code>log4j.properties</code> file in the same configuration
+directory.</li>
+<li>VM options can be defined in <code>SLIDER_JVM_OPTS</code></li>
+</ol>
+<p>The options defined in a Slider cluster configuration are only used by the client
+when creating a cluster -not for the actual client itself.</p>
+<h2 id="introduction">Introduction</h2>
+<p>The Slider client needs to be configured to talk to a Hadoop filesystem and a
+YARN resource manager ("the RM"). In a secure cluster it needs to be told the Kerberos
+identity, the <em>principal</em> of both the HDFS namenode and the YARN RM -and it may
+also need some JVM options set in order for Java's Kerberos module to
+correctly identify itself to these services.</p>
+<p>It cannot rely on local <code>HADOOP_PREFIX/conf/hadoop-site.xml</code> and
+<code>$YARN_PREFIX/conf/yarn-site.xml</code> files -because it is designed to
+work on client machines that may not have Hadoop and YARN installed.</p>
+<p>Instead all client-side (non-JVM) options can be predefined in the
+configuration file <code>slider-client.xml</code>. </p>
+<h2 id="setting-slider-jvm-options">Setting Slider JVM options</h2>
+<p>Core JVM options can be set in the environment variable <code>SLIDER_JVM_OPTS</code>;
+if unset the <code>bin/slider</code> script will use the default values that were
+current when that version of Slider was released. These values may change
+across versions, and may in fact be.</p>
+<p>At the time of writing, the default values were:</p>
+<pre class="codehilite"><code>"-Djava.net.preferIPv4Stack=true -Djava.awt.headless=true -Xmx256m -Dslider.confdir=${confdir}"</code></pre>
+
+
+<p>To allow some Java system properties to be set without editing this
+environment variable, such system properties may be set on the Slider command
+line through the <code>-S</code> parameter. For example, the following two operations are
+equivalent in terms of setting the system property <code>java.security.krb5.realm</code>
+to the value <code>LOCAL</code>.</p>
+<pre class="codehilite"><code>export SLIDER_JVM_OPTS="-Djava.security.krb5.realm=LOCAL"</code></pre>
+
+
+<p>and</p>
+<pre class="codehilite"><code>slider -S java.security.krb5.realm=LOCAL</code></pre>
+
+
+<p>Note that the first declaration invalidates all default JVM options; if any of
+those were desired, they should be included in the new definition.</p>
+<p>Multiple system property declarations are allowed on the command line -including
+duplicate declarations. In such a case the order of assignment is undefined.</p>
+<p>For any system property that the user expects to have to issue on every command
+-including any kerberos-related properties, adding them to the JVM options
+environment variable guarantees that they are always set.</p>
+<h2 id="setting-slider-client-options-on-the-command-line-with-the-d-parameter">Setting Slider client options on the command line with the <code>-D</code> parameter</h2>
+<p>The slider client is configured via Hadoop-style configuration options.
+To be precise, all standard Hadoop-common, hadoop-hdfs client and hadoop-yar
+client-side options control how Slider communicates with the Hadoop YARN cluster.</p>
+<p>There are extra options specific to Slider itself, options which
+are again set as Hadoop configuration parameters.</p>
+<p>All Hadoop and Slider options can be set on the command line using the <code>-D</code>
+parameter followed by the appropriate <code>key=value</code> argument</p>
+<p>For example, here is a definition of the default Hadoop filesystem:</p>
+<pre class="codehilite"><code>-D fs.defaultFS=hdfs://namenode:9000</code></pre>
+
+
+<p>Multiple definitions are of course allowed on the command line </p>
+<pre class="codehilite"><code>-D fs.defaultFS=hdfs://namenode:9000 -D dfs.namenode.kerberos.principal=hdfs/namenode@LOCAL</code></pre>
+
+
+<p>Slider-specific options can be made the same way</p>
+<pre class="codehilite"><code>-D slider.kerberos.principal=</code></pre>
+
+
+<p>If duplicate declarations are made the order of assignment is undefined.</p>
+<h1 id="setting-common-options-through-specific-command-line-arguments">Setting common options through specific command-line arguments</h1>
+<p>Some Hadoop and Slider options are so common that they have specific
+shortcut commands to aid their use</p>
+<p><code>-m</code>, <code>--manager</code> : sets the YARN resource manager. Equivalent to setting the
+<code>yarn.resourcemanager.address</code> option</p>
+<p><code>--fs</code>, <code>--filesystem</code>: defines the filesystem. Equivalent to setting the
+<code>fs.defaultFS</code> option</p>
+<p>If these shortcuts are used and the options are also defined via <code>-D</code>
+declarations, the order of assignment is undefined.</p>
+<h1 id="defining-hadoop-and-slider-options-in-the-slider-clientxml-file">Defining Hadoop and Slider Options in the <code>slider-client.xml</code> file.</h1>
+<p>In the Slider installation, alongside the <code>bin/slider</code> script is
+a configuration directory <code>conf</code>. This contains the files:</p>
+<ol>
+<li><code>log4j.properties</code></li>
+<li><code>slider-client.xml</code></li>
+</ol>
+<p>The <code>log4j.properties</code> file is not covered here -it is a standard Log4J file.
+At the time of writing, this log configuration file is used on both the
+client and the server.</p>
+<p>The <code>slider-client.xml</code> file is a hadoop-formatted XML options file, which
+is read by the Slider client -but not by they Slider Application Master.</p>
+<p>Here is an example file:</p>
+<pre class="codehilite"><code><property>
+ <name>yarn.resourcemanager.address</name>
+ <value>namenode:8033</value>
+</property>
+
+<property>
+ <name>fs.defaultFS</name>
+ <value>hdfs://namenode:9000</value>
+</property>
+
+<property>
+ <name>ipc.client.fallback-to-simple-auth-allowed</name>
+ <value>false</value>
+</property></code></pre>
+
+
+<p>This defines both the filesystem and the YARN RM, and so obviates the need
+to declare either on the command line.</p>
+<p>If an option is defined in the <code>slider-client.xml</code> file and on the command line
+-be it by a <code>-D key=value</code> declaration or a <code>--manager</code> or <code>--filesystem</code>
+definition. (this holds even if the value is declared with <code><final>true</final></code>).</p>
+<h2 id="selecting-an-alternate-slider-configuration-directory">Selecting an alternate Slider configuration directory</h2>
+<p>The environment variable <code>SLIDER_CONF_DIR</code> can be used to declare an alternate
+configuration directory. If set, the directory it identifies will be used
+as the source of the <code>log4j.properties</code> and <code>slider-client.xml</code> files.</p>
+<h2 id="slider-client-configuration-options">Slider Client Configuration options</h2>
+<p>As well as standard YARN and Hadoop configuration options, Slider supports
+a limited number of slider-specific configuration parameters.</p>
+<pre class="codehilite"><code><property>
+ <name>slider.zookeeper.quorum</name>
+ <value>localhost:2181,zookeeper2:4545</value>
+</property>
+
+<property>
+ <name>slider.yarn.queue</name>
+ <value>default</value>
+</property>
+
+<property>
+ <name>slider.security.enabled</name>
+ <value>false</value>
+</property>
+
+<property>
+ <name>slider.yarn.queue</name>
+ <value>default</value>
+</property>
+
+<property>
+ <name>slider.yarn.queue.priority</name>
+ <value>1</value>
+</property>
+
+<property>
+ <name>slider.yarn.restart.limit</name>
+ <value>5</value>
+ <description>How many times to start/restart the Slider AM</description>
+</property>
+
+<property>
+ <name>slider.cluster.directory.permissions</name>
+ <value>750</value>
+</property>
+
+<property>
+ <name>slider.data.directory.permissions</name>
+ <value>750</value>
+</property></code></pre>
+
+
+<h3 id="sliderzookeeperquorum-the-zookeeper-quorum"><code>slider.zookeeper.quorum</code> - the zookeeper quorum.</h3>
+<p>This defines the zookeeper quorum for this YARN cluster. </p>
+<p>It is used to locate the service registry, enable running instances to publish
+information about their application, and for clients to query this. </p>
+<p>It is also used as the default zookeeper binding for any application that
+uses zookeeper in its configuration -the value set when the application is
+defined will be copied into the instance definition file.</p>
+<h3 id="sliderregistrypath-the-zookeeper-path-for-the-service-registry"><code>"slider.registry.path"</code> - the zookeeper path for the service registry</h3>
+<p>This declares the the zookeeper path for the service registry. </p>
+<h3 id="slidersecurityenabled-enable-security"><code>slider.security.enabled</code> - enable security.</h3>
+<p>This turns security on; consult <a href="/docs/security.html">Security</a> for more information.</p>
+<h3 id="slideryarnrestartlimit-set-limit-on-application-master-restarts"><code>slider.yarn.restart.limit</code> - set limit on Application Master Restarts</h3>
+<p>This limits how many times YARN should start a failed application master.</p>
+<p>A short restart limit is useful when initially creating a cluster, as it
+ensures that YARN does not repeatedly try to restart a failing application.</p>
+<p>In production, however, a large number prevents YARN from halting a Slider
+application merely because failures in the underlying YARN cluster have
+triggered restarts.</p>
+<p><em>Important:</em> The cluster-wide limit of <code>yarn.resourcemanager.am.max-attempts</code>
+places an upper limit on the number of retries that any application can request.
+If the application fails after less restarts than requested, check this cluster
+setting.</p>
+<h3 id="slideryarnqueue-the-name-of-the-yarn-queue-for-the-cluster"><code>slider.yarn.queue</code> - the name of the YARN queue for the cluster.</h3>
+<p>This identifies the queue submit the application creation request to, which can
+define the priority, resource limits and other values of an application. All
+containers created in the Slider cluster will share this same queue.</p>
+<p>Default value: <code>default</code>.</p>
+<h3 id="slideryarnqueuepriority-the-name-of-the-yarn-queue-for-the-cluster"><code>slider.yarn.queue.priority</code> - the name of the YARN queue for the cluster.</h3>
+<p>This identifies the priority within the queue. The lower the value, the higher the
+priority</p>
+<p>Default value: <code>1</code>.</p>
+<pre class="codehilite"><code>bin/slider thaw cl1 -D slider.yarn.queue.priority=5</code></pre>
+
+
+<h4 id="sliderclusterdirectorypermissions"><code>slider.cluster.directory.permissions</code></h4>
+<p>An octal-format (<code>chmod</code>-style) permissions mask for the directory
+that contains the cluster specification <code>${user.home}/.slider/clusters/${clustername}</code></p>
+<pre class="codehilite"><code><property>
+ <name>slider.cluster.directory.permissions</name>
+ <value>750</value>
+</property></code></pre>
+
+
+<h4 id="sliderdatadirectorypermissions"><code>slider.data.directory.permissions</code></h4>
+<p>An octal-format (<code>chmod</code>-style) permissions mask for the directory
+that contains the application data <code>${user.home}/.slider/clusters/${clustername}/database</code></p>
+<pre class="codehilite"><code><property>
+ <name>slider.data.directory.permissions</name>
+ <value>750</value>
+</property></code></pre>
+
+
+<h2 id="debugging-configuration-issues">Debugging configuration issues</h2>
+<p>If the slider packages are set to log at debug level in the log4j configuration
+file, details on properties will be part of the copious output.</p>
+<h2 id="how-client-options-are-passed-down-to-created-clusters">How client options are passed down to created clusters.</h2>
+<p>Apart from the filesystem bindings, Client configuration options are
+not passed down to the XML site specification of the created cluster.</p>
+<p>The sole options passed down are the HDFS bindings: <code>fs.defaultFS</code>,
+which is passed down both as that property and as <code>fs.default.name</code>,
+and, in a secure cluster, the security flag (<code>slider.security.enabled</code>)
+and the HDFS Kerberos principal.</p>
+ </div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif" width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011-2014 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ Apache Slider, Slider, Apache, the Apache feather logo, and the Apache Incubator
+ project logo are trademarks of the <a href="http://www.apache.org">Apache Software Foundation</a>.<br />
+ Site created with <a href="http://getbootstrap.com/">Bootstrap</a> including icons from <a href="http://glyphicons.com/">GLYPHICONS</a> and <a href="http://fontawesome.io/">Font Awesome</a>.
+ </p>
+ </div>
+ </div>
+ </div>
+
+</div>
+</div>
+
+<script type="text/javascript">
+
+</script>
+</body>
+</html>
Propchange: incubator/slider/site/content/docs/client-configuration.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/slider/site/content/docs/configuration/core.html
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/configuration/core.html?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/configuration/core.html (added)
+++ incubator/slider/site/content/docs/configuration/core.html Mon Jul 7 19:03:38 2014
@@ -0,0 +1,545 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <link href="/css/bootstrap.min.css" rel="stylesheet">
+ <link href="/css/bootstrap-theme.min.css" rel="stylesheet">
+ <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/libs/html5shiv/3.7.0/html5shiv.js"></script>
+ <script src="https://oss.maxcdn.com/libs/respond.js/1.4.2/respond.min.js"></script>
+ <![endif]-->
+ <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js"></script>
+ <script src="/js/bootstrap.min.js"></script>
+ <link href="/css/slider.css" rel="stylesheet" type="text/css">
+ <link href="//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.css" rel="stylesheet">
+ <title></title>
+
+</head>
+
+<body>
+<nav class="navbar navbar-default navbar-fixed-top" role="navigation">
+<div class="container-fluid">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#navbar-items">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/index.html">Slider</a>
+ </div>
+ <div class="collapse navbar-collapse" id="navbar-items">
+ <ul class="nav navbar-nav">
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ Project <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_index"><a href="/index.html">Home</a></li>
+<li id="nav_downloads"><a href="/downloads">Downloads</a></li>
+<li id="nav_source"><a href="https://git-wip-us.apache.org/repos/asf/incubator-slider.git"><i class="fa fa-external-link"></i> Source</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0"><i class="fa fa-external-link"></i> License</a></li>
+<li class="divider"></li>
+<li class="dropdown-header">Community</li>
+<li id="nav_team"><a href="/team.html">Team</a></li>
+<li id="nav_mailinglists"><a href="/mailing_lists.html">Mailing Lists</a></li>
+<li class="divider"></li>
+<li class="dropdown-header">Tools</li>
+<li id="nav_jira"><a href="https://issues.apache.org/jira/browse/SLIDER"><i class="fa fa-external-link"></i> Issues</a></li>
+<li id="nav_builds"><a href="https://builds.apache.org/job/Slider-develop"><i class="fa fa-external-link"></i> Builds</a></li>
+</ul>
+</li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="/design">
+ Design <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_design_overview"><a href="/design/architecture.html">Overview</a></li>
+<li id="nav_app_needs"><a href="/docs/slider_specs/application_needs.html">Application Needs</a></li>
+<li id="nav_spec"><a href="/design/specification/index.html">Expected Behavior</a></li>
+<li id="nav_registry"><a href="/design/registry/index.html">Service Registry</a></li>
+<li id="nav_role_history"><a href="/design/rolehistory.html">Role History</a></li>
+</ul>
+</li>
+
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="/developing">
+ Developing <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_dev_building"><a href="/developing/building.html">Building</a></li>
+<li id="nav_dev_debugging"><a href="/docs/debugging.html">Debugging</a></li>
+<li id="nav_dev_testing"><a href="/developing/testing.html">Testing</a></li>
+<li id="nav_dev_funtesting"><a href="/developing/functional_tests.html">Functional Testing</a></li>
+<li id="nav_dev_manual_testing"><a href="/developing/manual_testing.html">Manual Testing</a></li>
+<li id="nav_releasing"><a href="/developing/releasing.html">Releasing</a></li>
+</ul>
+</li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ Using <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li id="nav_use_getting_started"><a href="/docs/getting_started.html">Getting Started</a></li>
+<li id="nav_use_manpage"><a href="/docs/manpage.html">Man Page</a></li>
+<li id="nav_use_examples"><a href="/docs/examples.html">Examples</a></li>
+<li id="nav_use_client_config"><a href="/docs/client-configuration.html">Client Configuration</a></li>
+<li id="nav_use_exitcodes"><a href="/docs/exitcodes.html">Client Exit Codes</a></li>
+<li id="nav_use_security"><a href="/docs/security.html">Security</a></li>
+<li id="nav_use_app_package"><a href="/docs/slider_specs/index.html">App Packaging</a></li>
+<li id="nav_use_app_configuration"><a href="/docs/configuration/index.html">App Configuration Model</a></li>
+<li id="nav_use_debugging"><a href="/docs/debugging.html">Debugging</a></li>
+<li id="nav_use_troubleshooting"><a href="/docs/troubleshooting.html">Troubleshooting</a></li>
+</ul>
+</li>
+
+ <li class="dropdown">
+ <a class="dropdown-toggle" data-toggle="dropdown" href="#">
+ ASF Links <span class="caret"></span>
+ </a>
+<ul class="dropdown-menu">
+<li><a href="http://www.apache.org"><i class="fa fa-external-link"></i> Apache Software Foundation</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html"><i class="fa fa-external-link"></i> Sponsorship</a></li>
+<li><a href="http://www.apache.org/security/"><i class="fa fa-external-link"></i> Security</a></li>
+<li><a href="http://www.apache.org/foundation/thanks.html"><i class="fa fa-external-link"></i> Thanks</a></li>
+</ul>
+</li>
+</ul>
+
+ </div>
+
+</div>
+</nav>
+
+
+<div class="container-fluid">
+<div class="row">
+ <div class="col-md-2" id="sidebar">
+ <div style="text-align: center">
+ <h1><a href="/index.html">Apache Slider (incubating)</a></h1>
+ <hr>
+Latest release: <strong>0.30-incubating</strong><br>
+ <br>
+ <a id="download-button-sidebar" class="btn btn-success btn-block" href="/downloads/" role="button">Download</a>
+ </div>
+ <hr>
+ <a href="http://incubator.apache.org"><img id="logo" alt="Apache Incubator ™" class="img-responsive" src="http://incubator.apache.org/images/apache-incubator-logo.png"/></a>
+ </div>
+ <div class="col-md-8 col-md-offset-1">
+
+ <div id="content">
+
+ <h1 class="title"></h1>
+
+ <!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<h1 id="apache-slider-core-configuration-specification">Apache Slider Core Configuration Specification</h1>
+<h2 id="terminology">Terminology</h2>
+<p><em>Application</em> A single application, such as an HBase cluster. An application
+is distribed across the YARN cluster.</p>
+<p><em>Component</em> A single executable part of the larger application. An application
+may have multiple components, and multiple instances of each component. </p>
+<p><em>YARN</em> Yet Another Resource Negotiator</p>
+<p><em>YARN Resource Requirements</em> The requirements for a YARN resource request.
+Currently this consists of RAM and CPU requirements.</p>
+<p><em>YARN Container</em>. An allocation portion of a servers resources granted
+to satisfy the requested YARN resource requirements. A process can be deployed
+to a container.</p>
+<p><em><code>resources.json</code></em>: A file that describes the
+size of the application in terms of its component requirements: how many,
+and what their resource requirements are. </p>
+<p><em><code>application.json</code></em>: A file that describes the
+size of the application in terms of its component requirements: how many,
+and what their resource requirements are. </p>
+<h2 id="structure">Structure</h2>
+<p>Configurations are stored in well-formed JSON files.
+1. Text MUST be saved in the UTF-8 format.
+1. Duplicate entries MUST NOT occur in any section.
+1. The ordering of elements is NOT significant.</p>
+<p>The JSON specification files all have a similar structure</p>
+<ol>
+<li>
+<p>A <code>schema</code> string indicating version. Currently this is temporarily set to</p>
+<pre class="codehilite"><code>"http://example.org/specification/v2.0.0"</code></pre>
+
+
+</li>
+<li>
+<p>A global section, <code>/global</code> containing string properties</p>
+</li>
+<li>A component section, <code>/components</code>.</li>
+<li>0 or more sections under <code>/components</code> for each component, identified by component name,
+ containing string properties.</li>
+<li>0 or 1 section <code>/metadata</code> containing arbitrary metadata (such as a description,
+author, or any other information that is not parsed or processed directly).</li>
+</ol>
+<p>The simplest valid specification file is </p>
+<pre class="codehilite"><code>{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+ },
+ "components": {
+ }
+}</code></pre>
+
+
+<h2 id="property-inheritance-model-and-resolution">Property inheritance model and <em>resolution</em></h2>
+<p>There is a simple global to component inheritance model.</p>
+<ol>
+<li>Properties defined in <code>/global</code> define parameters across the entire application.</li>
+<li>Properties defined a section under <code>/components</code> define parameters for
+a specific component in the application.</li>
+<li>All global properties are propagated to each component.</li>
+<li>A component section may override any global property.</li>
+<li>The final set of configuration properties for a component is the global
+properties extended and overridden by the global set.</li>
+<li>The process of expanding the properties is termed <em>resolution</em>; the <em>resolved</em>
+specification is the outcome.</li>
+<li>There is NO form of explicitly cross-referencing another attribute. This
+MAY be added in future.</li>
+<li>There is NO sharing of information from the different <code>.json</code> files in a
+an application configuration.</li>
+</ol>
+<h3 id="example">Example</h3>
+<p>Here is an example configuration</p>
+<pre class="codehilite"><code>{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+ "g1": "a",
+ "g2": "b"
+ },
+ "components": {
+ "simple": {
+ },
+ "master": {
+ "name": "m",
+ "g1": "overridden"
+
+ },
+ "worker": {
+ "name": "w",
+ "g1": "overridden-by-worker",
+ "timeout": "1000"
+ }
+ }
+}</code></pre>
+
+
+<p>The <code>/global</code> section defines two properties</p>
+<pre class="codehilite"><code>g1="a"
+g2="b"</code></pre>
+
+
+<p>These are the values visible to any part of the application which is
+not itself one of the components. </p>
+<p>There are three components defined, <code>simple</code>, <code>master</code> and <code>worker</code>.</p>
+<h4 id="component-simple">component <code>simple</code>:</h4>
+<pre class="codehilite"><code>g1="a"
+g2="b"</code></pre>
+
+
+<p>No settings have been defined specifically for the component; the global
+settings are applied.</p>
+<h4 id="component-master">component <code>master</code>:</h4>
+<pre class="codehilite"><code>name="m",
+g1="overridden"
+g2="b"</code></pre>
+
+
+<p>A new attribute, <code>name</code>, has been defined with the value <code>"m"</code>, and the
+global property <code>g1</code> has been overridden with the new value, <code>"overridden"</code>.
+The global property <code>g2</code> is passed down unchanged.</p>
+<h4 id="component-worker">component <code>worker</code>:</h4>
+<pre class="codehilite"><code>name="w",
+g1="overridden-by-worker"
+g2="b"
+timeout: "1000"</code></pre>
+
+
+<p>A new attribute, <code>name</code>, has been defined with the value <code>"w"</code>, and another,
+<code>timeout</code>, value "1000". </p>
+<p>The global property <code>g1</code> has been overridden with the new value, <code>"overridden-by-worker"</code>.</p>
+<p>The global property <code>g2</code> is passed down unchanged.</p>
+<p>This example shows some key points about the design</p>
+<ul>
+<li>each component gets its own map of properties, which is independent from
+ that of other components.</li>
+<li>all global properties are either present or overridden by a new value.
+ They can not be "undefined"</li>
+<li>new properties defined in a component are not visible to any other component.</li>
+</ul>
+<p>The final <em>resolved</em> model is as follows</p>
+<pre class="codehilite"><code>{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+ "g1": "a",
+ "g2": "b"
+ },
+ "components": {
+ "simple": {
+ "g1": "a",
+ "g2": "b"
+ },
+ "master": {
+ "name": "m",
+ "g1": "overridden",
+ "g2": "b"
+ },
+ "worker": {
+ "name": "m",
+ "g1": "overridden-by-worker",
+ "g2": "b",
+ "timeout": "1000"
+ }
+ }
+}</code></pre>
+
+
+<p>This the specification JSON that would have generate exactly the same result as
+in the example, without any propagation of data from the global section
+to individual components. </p>
+<p>Note that a resolved specification can still have the resolution operation applied
+to it -it just does not have any effect.</p>
+<h2 id="metadata">Metadata</h2>
+<p>The metadata section can contain arbitrary string values for use in diagnostics
+and by other applications.</p>
+<p>To avoid conflict with other applications, please use a unique name in strings,
+such as java-style package names.</p>
+<h1 id="resource-requirements-resourcesjson">Resource Requirements: <code>resources.json</code></h1>
+<p>This file declares the resource requirements for YARN for the components
+of an application.</p>
+<p><code>instances</code>: the number of instances of a role desired.
+<code>yarn.vcores</code>: number of "virtual" required by a component.
+<code>yarn.memory</code>: the number of megabytes required by a component.</p>
+<pre class="codehilite"><code>{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "metadata": {
+ "description": "example of a resources file"
+ },
+
+ "global": {
+ "yarn.vcores": "1",
+ "yarn.memory": "512"
+ },
+
+ "components": {
+ "master": {
+ "instances": "1",
+ "yarn.memory": "1024"
+ },
+ "worker": {
+ "instances":"5"
+ }
+ }
+}</code></pre>
+
+
+<p>The resolved file would be</p>
+<pre class="codehilite"><code>{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "metadata": {
+ "description": "example of a resources file"
+ },
+
+ "global": {
+ "yarn.vcores": "1",
+ "yarn.memory": "512"
+ },
+
+ "components": {
+ "master": {
+ "instances": "1",
+ "yarn.vcores": "1",
+ "yarn.memory": "1024"
+ },
+ "worker": {
+ "instances":"5",
+ "yarn.vcores": "1",
+ "yarn.memory": "512"
+ }
+ }
+}</code></pre>
+
+
+<p>This declares this deployment of the application to consist of one instance of
+the master component, using 1 vcore and 1024MB of RAM, and five worker components
+each using one vcore and 512 MB of RAM.</p>
+<h2 id="internal-information-internaljson">Internal information, <code>internal.json</code></h2>
+<p>This contains internal data related to the deployment -it is not
+intended for manual editing.</p>
+<p>There MAY be a component, <code>diagnostics</code>. If defined, its content contains
+diagnostic information for support calls, and MUST NOT be interpreted
+during application deployment, (though it may be included in the generation
+of diagnostics reports)</p>
+<pre class="codehilite"><code>{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "metadata": {
+ "description": "Internal configuration DO NOT EDIT"
+ },
+ "global": {
+ "name": "small_cluster",
+ "application": "hdfs://cluster:8020/apps/hbase/v/1.0.0/application.tar"
+ },
+ "components": {
+
+ "diagnostics": {
+ "create.hadoop.deployed.info": "(release-2.3.0) @dfe463",
+ "create.hadoop.build.info": "2.3.0",
+ "create.time.millis": "1393512091276",
+ "create.time": "27 Feb 2014 14:41:31 GMT"
+ }
+ }
+}</code></pre>
+
+
+<h2 id="deployment-specification-app_configurationjson">Deployment specification: <code>app_configuration.json</code></h2>
+<p>This defines parameters that are to be used when creating the instance of the
+application, and instances of the individual components.</p>
+<pre class="codehilite"><code>{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+
+ "zookeeper.port": "2181",
+ "zookeeper.path": "/yarnapps_small_cluster",
+ "zookeeper.hosts": "zoo1,zoo2,zoo3",
+ "env.MALLOC_ARENA_MAX": "4",
+ "site.hbase.master.startup.retainassign": "true",
+ "site.fs.defaultFS": "hdfs://cluster:8020",
+ "site.fs.default.name": "hdfs://cluster:8020",
+ "site.hbase.master.info.port": "0",
+ "site.hbase.regionserver.info.port": "0"
+ },
+ "components": {
+
+ "worker": {
+ "jvm.heapsize": "512M"
+ },
+ "master": {
+ "jvm.heapsize": "512M"
+ }
+ }
+}</code></pre>
+
+
+<p>The resolved specification defines the values that are passed to the
+different components.</p>
+<pre class="codehilite"><code>{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+ "zookeeper.port": "2181",
+ "zookeeper.path": "/yarnapps_small_cluster",
+ "zookeeper.hosts": "zoo1,zoo2,zoo3",
+ "env.MALLOC_ARENA_MAX": "4",
+ "site.hbase.master.startup.retainassign": "true",
+ "site.fs.defaultFS": "hdfs://cluster:8020",
+ "site.fs.default.name": "hdfs://cluster:8020",
+ "site.hbase.master.info.port": "0",
+ "site.hbase.regionserver.info.port": "0"
+ },
+ "components": {
+
+ "worker": {
+ "zookeeper.port": "2181",
+ "zookeeper.path": "/yarnapps_small_cluster",
+ "zookeeper.hosts": "zoo1,zoo2,zoo3",
+ "env.MALLOC_ARENA_MAX": "4",
+ "site.hbase.master.startup.retainassign": "true",
+ "site.fs.defaultFS": "hdfs://cluster:8020",
+ "site.fs.default.name": "hdfs://cluster:8020",
+ "site.hbase.master.info.port": "0",
+ "site.hbase.regionserver.info.port": "0",
+ "jvm.heapsize": "512M"
+ },
+ "master": {
+ "zookeeper.port": "2181",
+ "zookeeper.path": "/yarnapps_small_cluster",
+ "zookeeper.hosts": "zoo1,zoo2,zoo3",
+ "env.MALLOC_ARENA_MAX": "4",
+ "site.hbase.master.startup.retainassign": "true",
+ "site.fs.defaultFS": "hdfs://cluster:8020",
+ "site.fs.default.name": "hdfs://cluster:8020",
+ "site.hbase.master.info.port": "0",
+ "site.hbase.regionserver.info.port": "0",
+ "jvm.heapsize": "512M"
+ }
+ }
+}</code></pre>
+
+
+<p>The <code>site.</code> properties have been passed down to each component, components
+whose templates may generate local site configurations. The override model
+does not prevent any component from overriding global configuration so as
+to create local configurations incompatible with the global state. (i.e.,
+there is no way to declare an attribute as final). It is the responsibility
+of the author of the configuration file (and their tools) to detect such issues.</p>
+ </div>
+
+ <div id="footer">
+ <a alt="Apache Software Foundation" href="http://www.apache.org">
+ <img id="asf-logo" alt="Apache Software Foundation" src="/images/feather-small.gif" width="100">
+ </a>
+ <div class="copyright">
+ <p>
+ Copyright © 2011-2014 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ Apache Slider, Slider, Apache, the Apache feather logo, and the Apache Incubator
+ project logo are trademarks of the <a href="http://www.apache.org">Apache Software Foundation</a>.<br />
+ Site created with <a href="http://getbootstrap.com/">Bootstrap</a> including icons from <a href="http://glyphicons.com/">GLYPHICONS</a> and <a href="http://fontawesome.io/">Font Awesome</a>.
+ </p>
+ </div>
+ </div>
+ </div>
+
+</div>
+</div>
+
+<script type="text/javascript">
+
+</script>
+</body>
+</html>
Propchange: incubator/slider/site/content/docs/configuration/core.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/slider/site/content/docs/configuration/example-app_configuration-resolved.json
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/configuration/example-app_configuration-resolved.json?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/configuration/example-app_configuration-resolved.json (added)
+++ incubator/slider/site/content/docs/configuration/example-app_configuration-resolved.json Mon Jul 7 19:03:38 2014
@@ -0,0 +1,42 @@
+{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+ "zookeeper.port": "2181",
+ "zookeeper.path": "/yarnapps_small_cluster",
+ "zookeeper.hosts": "zoo1,zoo2,zoo3",
+ "env.MALLOC_ARENA_MAX": "4",
+ "site.hbase.master.startup.retainassign": "true",
+ "site.fs.defaultFS": "hdfs://cluster:8020",
+ "site.fs.default.name": "hdfs://cluster:8020",
+ "site.hbase.master.info.port": "0",
+ "site.hbase.regionserver.info.port": "0"
+ },
+ "components": {
+
+ "worker": {
+ "zookeeper.port": "2181",
+ "zookeeper.path": "/yarnapps_small_cluster",
+ "zookeeper.hosts": "zoo1,zoo2,zoo3",
+ "env.MALLOC_ARENA_MAX": "4",
+ "site.hbase.master.startup.retainassign": "true",
+ "site.fs.defaultFS": "hdfs://cluster:8020",
+ "site.fs.default.name": "hdfs://cluster:8020",
+ "site.hbase.master.info.port": "0",
+ "site.hbase.regionserver.info.port": "0",
+ "jvm.heapsize": "512M"
+ },
+ "master": {
+ "zookeeper.port": "2181",
+ "zookeeper.path": "/yarnapps_small_cluster",
+ "zookeeper.hosts": "zoo1,zoo2,zoo3",
+ "env.MALLOC_ARENA_MAX": "4",
+ "site.hbase.master.startup.retainassign": "true",
+ "site.fs.defaultFS": "hdfs://cluster:8020",
+ "site.fs.default.name": "hdfs://cluster:8020",
+ "site.hbase.master.info.port": "0",
+ "site.hbase.regionserver.info.port": "0",
+ "jvm.heapsize": "512M"
+ }
+ }
+}
\ No newline at end of file
Added: incubator/slider/site/content/docs/configuration/example-app_configuration.json
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/configuration/example-app_configuration.json?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/configuration/example-app_configuration.json (added)
+++ incubator/slider/site/content/docs/configuration/example-app_configuration.json Mon Jul 7 19:03:38 2014
@@ -0,0 +1,25 @@
+{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+
+ "zookeeper.port": "2181",
+ "zookeeper.path": "/yarnapps_small_cluster",
+ "zookeeper.hosts": "zoo1,zoo2,zoo3",
+ "env.MALLOC_ARENA_MAX": "4",
+ "site.hbase.master.startup.retainassign": "true",
+ "site.fs.defaultFS": "hdfs://cluster:8020",
+ "site.fs.default.name": "hdfs://cluster:8020",
+ "site.hbase.master.info.port": "0",
+ "site.hbase.regionserver.info.port": "0"
+ },
+ "components": {
+
+ "worker": {
+ "jvm.heapsize": "512M"
+ },
+ "master": {
+ "jvm.heapsize": "512M"
+ }
+ }
+}
\ No newline at end of file
Added: incubator/slider/site/content/docs/configuration/example-empty.json
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/configuration/example-empty.json?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/configuration/example-empty.json (added)
+++ incubator/slider/site/content/docs/configuration/example-empty.json Mon Jul 7 19:03:38 2014
@@ -0,0 +1,8 @@
+{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+ },
+ "components": {
+ }
+}
\ No newline at end of file
Added: incubator/slider/site/content/docs/configuration/example-internal.json
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/configuration/example-internal.json?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/configuration/example-internal.json (added)
+++ incubator/slider/site/content/docs/configuration/example-internal.json Mon Jul 7 19:03:38 2014
@@ -0,0 +1,21 @@
+{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "metadata": {
+ "description": "Internal configuration DO NOT EDIT"
+ },
+ "global": {
+ "application.name": "small_cluster",
+ "application.type": "hbase",
+ "application": "hdfs://cluster:8020/apps/hbase/v/1.0.0/application.tar"
+ },
+ "components": {
+
+ "diagnostics": {
+ "create.hadoop.deployed.info": "(release-2.3.0) @dfe463",
+ "create.hadoop.build.info": "2.3.0",
+ "create.time.millis": "1393512091276",
+ "create.time": "27 Feb 2014 14:41:31 GMT"
+ }
+ }
+}
\ No newline at end of file
Added: incubator/slider/site/content/docs/configuration/example-overridden-resolved.json
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/configuration/example-overridden-resolved.json?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/configuration/example-overridden-resolved.json (added)
+++ incubator/slider/site/content/docs/configuration/example-overridden-resolved.json Mon Jul 7 19:03:38 2014
@@ -0,0 +1,25 @@
+{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+ "g1": "a",
+ "g2": "b"
+ },
+ "components": {
+ "simple": {
+ "g1": "a",
+ "g2": "b"
+ },
+ "master": {
+ "name": "m",
+ "g1": "overridden",
+ "g2": "b"
+ },
+ "worker": {
+ "name": "m",
+ "g1": "overridden-by-worker",
+ "g2": "b",
+ "timeout": "1000"
+ }
+ }
+}
\ No newline at end of file
Added: incubator/slider/site/content/docs/configuration/example-overridden.json
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/configuration/example-overridden.json?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/configuration/example-overridden.json (added)
+++ incubator/slider/site/content/docs/configuration/example-overridden.json Mon Jul 7 19:03:38 2014
@@ -0,0 +1,23 @@
+{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "global": {
+ "g1": "a",
+ "g2": "b"
+ },
+ "components": {
+ "simple": {
+ },
+ "master": {
+ "name": "m",
+ "g1": "overridden"
+
+ },
+ "worker": {
+ "name": "m",
+ "g1": "overridden-by-worker",
+ "timeout": "1000"
+
+ }
+ }
+}
\ No newline at end of file
Added: incubator/slider/site/content/docs/configuration/example-resources.json
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/docs/configuration/example-resources.json?rev=1608561&view=auto
==============================================================================
--- incubator/slider/site/content/docs/configuration/example-resources.json (added)
+++ incubator/slider/site/content/docs/configuration/example-resources.json Mon Jul 7 19:03:38 2014
@@ -0,0 +1,25 @@
+{
+ "schema": "http://example.org/specification/v2.0.0",
+
+ "metadata": {
+ "description": "example of a resources file"
+ },
+
+ "global": {
+ "yarn.vcores": "1",
+ "yarn.memory": "512"
+ },
+
+ "components": {
+ "master": {
+ "instances": "1",
+ "yarn.vcores": "1",
+ "yarn.memory": "1024"
+ },
+ "worker": {
+ "instances":"5",
+ "yarn.vcores": "1",
+ "yarn.memory": "512"
+ }
+ }
+}
\ No newline at end of file