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/05/30 18:47:16 UTC
svn commit: r1598665 [6/16] - in /incubator/slider/site/content: ./
architecture/ configuration/ css/ developing/ images/ images/logos/
images/profiles/ img/ js/ registry/ release_notes/ slider_specs/
specification/
Added: incubator/slider/site/content/dependency-management.html
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/dependency-management.html?rev=1598665&view=auto
==============================================================================
--- incubator/slider/site/content/dependency-management.html (added)
+++ incubator/slider/site/content/dependency-management.html Fri May 30 16:47:13 2014
@@ -0,0 +1,643 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 2014-05-30
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<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) - Project Dependency Management</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>
+ </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" >
+
+ <div class="section">
+<h2>Project Dependency Management<a name="Project_Dependency_Management"></a></h2><a name="Project_Dependency_Management"></a>
+<div class="section">
+<h3>compile<a name="compile"></a></h3><a name="compile"></a>
+<p>The following is a list of compile dependencies in the DependencyManagement of this project. These dependencies can be included in the submodules to compile and run the submodule:</p>
+<table border="0" class="table table-striped">
+<tr class="a">
+<th>GroupId</th>
+<th>ArtifactId</th>
+<th>Version</th>
+<th>Classifier</th>
+<th>Type</th>
+<th>License</th></tr>
+<tr class="b">
+<td>com.beust</td>
+<td><a class="externalLink" href="http://beust.com/jcommander">jcommander</a></td>
+<td>1.30</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>com.google.code.gson</td>
+<td><a class="externalLink" href="http://code.google.com/p/google-gson/">gson</a></td>
+<td>2.2.2</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>com.google.guava</td>
+<td><a class="externalLink" href="http://code.google.com/p/guava-libraries/guava">guava</a></td>
+<td>11.0.2</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>com.google.inject</td>
+<td><a class="externalLink" href="http://code.google.com/p/google-guice/guice/">guice</a></td>
+<td>3.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>com.google.inject.extensions</td>
+<td><a class="externalLink" href="http://code.google.com/p/google-guice/extensions-parent/guice-servlet/">guice-servlet</a></td>
+<td>3.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>com.google.protobuf</td>
+<td><a class="externalLink" href="http://code.google.com/p/protobuf">protobuf-java</a></td>
+<td>2.5.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.opensource.org/licenses/bsd-license.php">New BSD license</a></td></tr>
+<tr class="b">
+<td>com.sun.jersey</td>
+<td><a class="externalLink" href="https://jersey.java.net/jersey-core/">jersey-core</a></td>
+<td>1.9</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">CDDL 1.1</a>, <a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">GPL2 w/ CPE</a></td></tr>
+<tr class="a">
+<td>com.sun.jersey</td>
+<td><a class="externalLink" href="https://jersey.java.net/jersey-json/">jersey-json</a></td>
+<td>1.9</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">CDDL 1.1</a>, <a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">GPL2 w/ CPE</a></td></tr>
+<tr class="b">
+<td>com.sun.jersey</td>
+<td><a class="externalLink" href="https://jersey.java.net/jersey-server/">jersey-server</a></td>
+<td>1.9</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">CDDL 1.1</a>, <a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">GPL2 w/ CPE</a></td></tr>
+<tr class="a">
+<td>com.sun.jersey.contribs</td>
+<td><a class="externalLink" href="https://jersey.java.net/jersey-contribs/jersey-guice/">jersey-guice</a></td>
+<td>1.9</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">CDDL 1.1</a>, <a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">GPL2 w/ CPE</a></td></tr>
+<tr class="b">
+<td>com.sun.jersey.jersey-test-framework</td>
+<td><a class="externalLink" href="https://jersey.java.net/jersey-test-framework/jersey-test-framework-core/">jersey-test-framework-core</a></td>
+<td>1.9</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">CDDL 1.1</a>, <a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">GPL2 w/ CPE</a></td></tr>
+<tr class="a">
+<td>com.sun.jersey.jersey-test-framework</td>
+<td><a class="externalLink" href="https://jersey.java.net/jersey-test-framework/jersey-test-framework-grizzly2/">jersey-test-framework-grizzly2</a></td>
+<td>1.9</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">CDDL 1.1</a>, <a class="externalLink" href="http://glassfish.java.net/public/CDDL+GPL_1_1.html">GPL2 w/ CPE</a></td></tr>
+<tr class="b">
+<td>commons-codec</td>
+<td><a class="externalLink" href="http://commons.apache.org/codec/">commons-codec</a></td>
+<td>1.4</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>commons-configuration</td>
+<td>commons-configuration</td>
+<td>1.6</td>
+<td>-</td>
+<td>jar</td>
+<td>/LICENSE.txt</td></tr>
+<tr class="b">
+<td>commons-digester</td>
+<td><a class="externalLink" href="http://jakarta.apache.org/commons/digester/">commons-digester</a></td>
+<td>1.8</td>
+<td>-</td>
+<td>jar</td>
+<td>/LICENSE.txt</td></tr>
+<tr class="a">
+<td>commons-lang</td>
+<td><a class="externalLink" href="http://commons.apache.org/lang/">commons-lang</a></td>
+<td>2.6</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>junit</td>
+<td><a class="externalLink" href="http://junit.org">junit</a></td>
+<td>4.11</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.opensource.org/licenses/cpl1.0.txt">Common Public License Version 1.0</a></td></tr>
+<tr class="a">
+<td>log4j</td>
+<td><a class="externalLink" href="http://logging.apache.org/log4j/1.2/">log4j</a></td>
+<td>1.2.17</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.accumulo</td>
+<td><a class="externalLink" href="http://accumulo.apache.org/maven-site/accumulo-core/">accumulo-core</a></td>
+<td>1.5.1</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.accumulo</td>
+<td><a class="externalLink" href="http://accumulo.apache.org/maven-site/accumulo-fate/">accumulo-fate</a></td>
+<td>1.5.1</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.accumulo</td>
+<td><a class="externalLink" href="http://accumulo.apache.org/maven-site/accumulo-minicluster/">accumulo-minicluster</a></td>
+<td>1.5.1</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.accumulo</td>
+<td><a class="externalLink" href="http://accumulo.apache.org/maven-site/accumulo-server/">accumulo-server</a></td>
+<td>1.5.1</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.accumulo</td>
+<td><a class="externalLink" href="http://accumulo.apache.org/maven-site/accumulo-start/">accumulo-start</a></td>
+<td>1.5.1</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.accumulo</td>
+<td><a class="externalLink" href="http://accumulo.apache.org/maven-site/accumulo-test/">accumulo-test</a></td>
+<td>1.5.1</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.accumulo</td>
+<td><a class="externalLink" href="http://accumulo.apache.org/maven-site/accumulo-trace/">accumulo-trace</a></td>
+<td>1.5.1</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.avro</td>
+<td><a class="externalLink" href="http://avro.apache.org">avro</a></td>
+<td>1.7.4</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.bigtop.itest</td>
+<td><a class="externalLink" href="http://bigtop.apache.org/itest-common/">itest-common</a></td>
+<td>0.7.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.curator</td>
+<td><a class="externalLink" href="http://curator.apache.org/curator-client">curator-client</a></td>
+<td>2.4.1</td>
+<td>-</td>
+<td>jar</td>
+<td>file://${basedir}/LICENSE</td></tr>
+<tr class="b">
+<td>org.apache.curator</td>
+<td><a class="externalLink" href="http://curator.apache.org/curator-framework">curator-framework</a></td>
+<td>2.4.1</td>
+<td>-</td>
+<td>jar</td>
+<td>file://${basedir}/LICENSE</td></tr>
+<tr class="a">
+<td>org.apache.curator</td>
+<td><a class="externalLink" href="http://curator.apache.org/curator-x-discovery">curator-x-discovery</a></td>
+<td>2.4.1</td>
+<td>-</td>
+<td>jar</td>
+<td>file://${basedir}/LICENSE</td></tr>
+<tr class="b">
+<td>org.apache.curator</td>
+<td><a class="externalLink" href="http://curator.apache.org/curator-x-discovery-server">curator-x-discovery-server</a></td>
+<td>2.4.1</td>
+<td>-</td>
+<td>jar</td>
+<td>file://${basedir}/LICENSE</td></tr>
+<tr class="a">
+<td>org.apache.hadoop</td>
+<td>hadoop-client</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hadoop</td>
+<td>hadoop-client</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>pom</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hadoop</td>
+<td>hadoop-common</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hadoop</td>
+<td>hadoop-common</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>test-jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hadoop</td>
+<td>hadoop-hdfs</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hadoop</td>
+<td>hadoop-mapreduce-client</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>pom</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hadoop</td>
+<td>hadoop-minicluster</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hadoop</td>
+<td>hadoop-yarn-client</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hadoop</td>
+<td>hadoop-yarn-common</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hadoop</td>
+<td>hadoop-yarn-server-common</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hadoop</td>
+<td>hadoop-yarn-server-web-proxy</td>
+<td>2.4.0</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hbase</td>
+<td><a class="externalLink" href="http://hbase.apache.org/hbase-client">hbase-client</a></td>
+<td>0.98.2-hadoop2</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hbase</td>
+<td><a class="externalLink" href="http://hbase.apache.org/hbase-common">hbase-common</a></td>
+<td>0.98.2-hadoop2</td>
+<td>tests</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hbase</td>
+<td><a class="externalLink" href="http://hbase.apache.org/hbase-common">hbase-common</a></td>
+<td>0.98.2-hadoop2</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hbase</td>
+<td><a class="externalLink" href="http://hbase.apache.org/hbase-hadoop-compat">hbase-hadoop-compat</a></td>
+<td>0.98.2-hadoop2</td>
+<td>tests</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hbase</td>
+<td><a class="externalLink" href="http://hbase.apache.org/hbase-hadoop2-compat">hbase-hadoop2-compat</a></td>
+<td>0.98.2-hadoop2</td>
+<td>tests</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hbase</td>
+<td><a class="externalLink" href="http://hbase.apache.org/hbase-it">hbase-it</a></td>
+<td>0.98.2-hadoop2</td>
+<td>tests</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.hbase</td>
+<td><a class="externalLink" href="http://hbase.apache.org/hbase-server">hbase-server</a></td>
+<td>0.98.2-hadoop2</td>
+<td>tests</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.apache.hbase</td>
+<td><a class="externalLink" href="http://hbase.apache.org/hbase-server">hbase-server</a></td>
+<td>0.98.2-hadoop2</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.apache.httpcomponents</td>
+<td><a class="externalLink" href="http://hc.apache.org/httpcomponents-client">httpclient</a></td>
+<td>4.2.5</td>
+<td>-</td>
+<td>jar</td>
+<td>LICENSE.txt</td></tr>
+<tr class="a">
+<td>org.apache.zookeeper</td>
+<td>zookeeper</td>
+<td>3.4.5</td>
+<td>-</td>
+<td>jar</td>
+<td>-</td></tr>
+<tr class="b">
+<td>org.codehaus.groovy</td>
+<td><a class="externalLink" href="http://groovy.codehaus.org/">groovy-all</a></td>
+<td>2.2.2</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.codehaus.jackson</td>
+<td><a class="externalLink" href="http://jackson.codehaus.org">jackson-core-asl</a></td>
+<td>1.9.13</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.codehaus.jackson</td>
+<td><a class="externalLink" href="http://jackson.codehaus.org">jackson-jaxrs</a></td>
+<td>1.9.13</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a>, <a class="externalLink" href="http://www.fsf.org/licensing/licenses/lgpl.txt">GNU Lesser General Public License (LGPL), Version 2.1</a></td></tr>
+<tr class="a">
+<td>org.codehaus.jackson</td>
+<td><a class="externalLink" href="http://jackson.codehaus.org">jackson-mapper-asl</a></td>
+<td>1.9.13</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.codehaus.jackson</td>
+<td><a class="externalLink" href="http://jackson.codehaus.org">jackson-xc</a></td>
+<td>1.9.13</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a>, <a class="externalLink" href="http://www.fsf.org/licensing/licenses/lgpl.txt">GNU Lesser General Public License (LGPL), Version 2.1</a></td></tr>
+<tr class="a">
+<td>org.easymock</td>
+<td><a class="externalLink" href="http://www.easymock.org/easymock">easymock</a></td>
+<td>3.1</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">Apache 2</a></td></tr>
+<tr class="b">
+<td>org.mockito</td>
+<td><a class="externalLink" href="http://www.mockito.org">mockito-core</a></td>
+<td>1.8.5</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://code.google.com/p/mockito/wiki/License">The MIT License</a></td></tr>
+<tr class="a">
+<td>org.powermock</td>
+<td><a class="externalLink" href="http://www.powermock.org/powermock-api/powermock-api-easymock">powermock-api-easymock</a></td>
+<td>1.5</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.powermock</td>
+<td><a class="externalLink" href="http://www.powermock.org">powermock-core</a></td>
+<td>1.5</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.powermock</td>
+<td><a class="externalLink" href="http://www.powermock.org">powermock-module-junit4</a></td>
+<td>1.5</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="b">
+<td>org.powermock</td>
+<td><a class="externalLink" href="http://www.powermock.org/powermock-reflect">powermock-reflect</a></td>
+<td>1.5</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.apache.org/licenses/LICENSE-2.0.txt">The Apache Software License, Version 2.0</a></td></tr>
+<tr class="a">
+<td>org.slf4j</td>
+<td><a class="externalLink" href="http://www.slf4j.org">slf4j-api</a></td>
+<td>1.7.5</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.opensource.org/licenses/mit-license.php">MIT License</a></td></tr>
+<tr class="b">
+<td>org.slf4j</td>
+<td><a class="externalLink" href="http://www.slf4j.org">slf4j-log4j12</a></td>
+<td>1.7.5</td>
+<td>-</td>
+<td>jar</td>
+<td><a class="externalLink" href="http://www.opensource.org/licenses/mit-license.php">MIT License</a></td></tr></table></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>
+</html>
Propchange: incubator/slider/site/content/dependency-management.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/slider/site/content/developing/building.html
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/developing/building.html?rev=1598665&view=auto
==============================================================================
--- incubator/slider/site/content/developing/building.html (added)
+++ incubator/slider/site/content/developing/building.html Fri May 30 16:47:13 2014
@@ -0,0 +1,507 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 2014-05-30
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<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>
+ </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" >
+
+ <!-- -
+ 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>Building Apache Slider</h1>
+<p>Here’s how to set this up.</p>
+<div class="section">
+<h2>Before you begin<a name="Before_you_begin"></a></h2>
+<div class="section">
+<h3>Networking<a name="Networking"></a></h3>
+<p>The network on the development system must be functional, with hostname lookup of the local host working. Tests will fail without this.</p></div>
+<div class="section">
+<h3>Java 7<a name="Java_7"></a></h3>
+<p>Slider is built on Java 7 -please have a JDK for Java 7 or 8 set up</p></div>
+<div class="section">
+<h3>Maven<a name="Maven"></a></h3>
+<p>You will need a version of Maven 3.0+, set up with enough memory</p>
+
+<div class="source">
+<pre>MAVEN_OPTS=-Xms256m -Xmx512m -Djava.awt.headless=true
+</pre></div>
+<p><i>Important</i>: As of October 6, 2013, Maven 3.1 is not supported due to <a class="externalLink" href="https://cwiki.apache.org/confluence/display/MAVEN/AetherClassNotFound">version issues</a>.</p></div>
+<div class="section">
+<h3>Protoc<a name="Protoc"></a></h3>
+<p>You need a copy of the <tt>protoc</tt> compiler for protobuf compilation</p>
+
+<ol style="list-style-type: decimal">
+
+<li>OS/X: <tt>brew install protobuf</tt></li>
+
+<li>Others: consult (Building Hadoop documentation)[http://wiki.apache.org/hadoop/HowToContribute].</li>
+</ol>
+<p>The version of <tt>protoc</tt> installed must be the same as that used by Hadoop itself. This is absolutely critical to prevent JAR version problems.</p></div></div>
+<div class="section">
+<h2>Building a compatible Hadoop version<a name="Building_a_compatible_Hadoop_version"></a></h2>
+<p>Slider is built against Hadoop 2 -you can download and install a copy from the <a class="externalLink" href="http://hadoop.apache.org">Apache Hadoop Web Site</a>.</p>
+<p>During development, its convenient (but not mandatory) to have a local version of Hadoop -so that we can find and fix bugs/add features in Hadoop as well in Slider.</p>
+<p>To build and install locally, check out apache svn/github, branch <tt>release-2.4.0</tt>, and create a branch off that tag</p>
+
+<div class="source">
+<pre>git clone git://git.apache.org/hadoop-common.git
+cd hadoop-common
+git remote rename origin apache
+git fetch --tags apache
+git checkout release-2.4.0 --
+git checkout -b release-2.4.0
+</pre></div>
+<p>For the scripts below, set the <tt>HADOOP_VERSION</tt> variable to the version</p>
+
+<div class="source">
+<pre>export HADOOP_VERSION=2.4.0
+</pre></div>
+<p>or, for building against a pre-release version of Hadoop 2.4</p>
+
+<div class="source">
+<pre>git checkout branch-2
+export HADOOP_VERSION=2.4.0-SNAPSHOT
+</pre></div>
+<p>To build and install it locally, skipping the tests:</p>
+
+<div class="source">
+<pre>mvn clean install -DskipTests
+</pre></div>
+<p>To make a tarball for use in test runs:</p>
+
+<div class="source">
+<pre>#On osx
+mvn clean install package -Pdist -Dtar -DskipTests -Dmaven.javadoc.skip=true
+
+# on linux
+mvn clean package -Pdist -Pnative -Dtar -DskipTests -Dmaven.javadoc.skip=true
+</pre></div>
+<p>Then expand this</p>
+
+<div class="source">
+<pre>pushd hadoop-dist/target/
+gunzip hadoop-$HADOOP_VERSION.tar.gz
+tar -xvf hadoop-$HADOOP_VERSION.tar
+popd
+</pre></div>
+<p>This creates an expanded version of Hadoop. You can now actually run Hadoop from this directory. Do note that unless you have the native code built for your target platform, Hadoop will be slower. </p></div>
+<div class="section">
+<h2>building a compatible HBase version<a name="building_a_compatible_HBase_version"></a></h2>
+<p>If you need to build a version of HBase -rather than use a released version, here are the instructions (for the hbase-0.98 release branch)</p>
+<p>Checkout the HBase <tt>trunk</tt> branch from apache svn/github. </p>
+
+<div class="source">
+<pre>git clone git://git.apache.org/hbase.git
+cd hbase
+git remote rename origin apache
+git fetch --tags apache
+</pre></div>
+<p>then</p>
+
+<div class="source">
+<pre>git checkout -b apache/0.98
+</pre></div>
+<p>or</p>
+
+<div class="source">
+<pre>git checkout tags/0.98.1
+</pre></div>
+<p>If you have already been building versions of HBase, remove the existing set of artifacts for safety:</p>
+
+<div class="source">
+<pre>rm -rf ~/.m2/repository/org/apache/hbase/
+</pre></div>
+<p>The maven command for building hbase artifacts against this hadoop version is </p>
+
+<div class="source">
+<pre>mvn clean install assembly:single -DskipTests -Dmaven.javadoc.skip=true
+</pre></div>
+<p>To use a different version of Hadoop from that defined in the <tt>hadoop-two.version</tt> property of<tt>/pom.xml</tt>:</p>
+
+<div class="source">
+<pre>mvn clean install assembly:single -DskipTests -Dmaven.javadoc.skip=true -Dhadoop-two.version=$HADOOP_VERSION
+</pre></div>
+<p>This will create an hbase <tt>tar.gz</tt> file in the directory <tt>hbase-assembly/target/</tt> in the hbase source tree. </p>
+
+<div class="source">
+<pre>export HBASE_VERSION=0.98.1
+
+pushd hbase-assembly/target
+gunzip hbase-$HBASE_VERSION-bin.tar.gz
+tar -xvf hbase-$HBASE_VERSION-bin.tar
+gzip hbase-$HBASE_VERSION-bin.tar
+popd
+</pre></div>
+<p>This will create an untarred directory containing hbase. Both the <tt>.tar.gz</tt> and untarred file are needed for testing. Most tests just work directly with the untarred file as it saves time uploading and downloading then expanding the file.</p>
+<p>(and if you set <tt>HBASE_VERSION</tt> to something else, you can pick up that version -making sure that slider is in sync)</p>
+<p>For more information (including recommended Maven memory configuration options), see <a class="externalLink" href="http://hbase.apache.org/book/build.html">HBase building</a></p>
+<p>For building just the JAR files:</p>
+
+<div class="source">
+<pre>mvn clean install -DskipTests -Dhadoop.profile=2.0 -Dhadoop-two.version=$HADOOP_VERSION
+</pre></div>
+<p><i>Tip:</i> you can force set a version in Maven by having it update all the POMs:</p>
+
+<div class="source">
+<pre>mvn versions:set -DnewVersion=0.98.1-SNAPSHOT
+</pre></div></div>
+<div class="section">
+<h2>Building Accumulo<a name="Building_Accumulo"></a></h2>
+<p>Clone accumulo from apache;</p>
+
+<div class="source">
+<pre>git clone http://git-wip-us.apache.org/repos/asf/accumulo.git
+</pre></div>
+<p>Check out branch 1.5.1-SNAPSHOT</p>
+<p>In the accumulo project directory, build it</p>
+
+<div class="source">
+<pre>mvn clean install -Passemble -DskipTests -Dmaven.javadoc.skip=true \
+ -Dhadoop.profile=2
+</pre></div>
+<p>The default Hadoop version for accumulo-1.5.1 is hadoop 2.4.0; to build against a different version use the command</p>
+
+<div class="source">
+<pre>mvn clean install -Passemble -DskipTests -Dmaven.javadoc.skip=true \
+ -Dhadoop.profile=2 -Dhadoop.version=$HADOOP_VERSION
+</pre></div>
+<p>This creates an accumulo tar.gz file in <tt>assemble/target/</tt>. Unzip then untar this, to create a .tar file and an expanded directory</p>
+
+<div class="source">
+<pre>accumulo/assemble/target/accumulo-1.5.1-SNAPSHOT-bin.tar
+</pre></div>
+<p>This can be done with the command sequence</p>
+
+<div class="source">
+<pre>export ACCUMULO_VERSION=1.5.1-SNAPSHOT
+
+pushd assemble/target/
+gunzip -f accumulo-$ACCUMULO_VERSION-bin.tar.gz
+tar -xvf accumulo-$ACCUMULO_VERSION-bin.tar
+popd
+</pre></div>
+<p>Note that the final location of the accumulo files is needed for the configuration, it may be directly under target/ or it may be in a subdirectory, with a path such as <tt>target/accumulo-$ACCUMULO_VERSION-dev/accumulo-$ACCUMULO_VERSION/</tt></p></div>
+<div class="section">
+<h2>Testing<a name="Testing"></a></h2>
+<div class="section">
+<h3>Configuring Slider to locate the relevant artifacts<a name="Configuring_Slider_to_locate_the_relevant_artifacts"></a></h3>
+<p>You must have the file <tt>src/test/resources/slider-test.xml</tt> (this is ignored by git), declaring where HBase, accumulo, Hadoop and zookeeper are:</p>
+
+<div class="source">
+<pre><configuration>
+
+ <property>
+ <name>slider.test.hbase.home</name>
+ <value>/home/slider/hbase/hbase-assembly/target/hbase-0.98.0-SNAPSHOT</value>
+ <description>HBASE Home</description>
+ </property>
+
+ <property>
+ <name>slider.test.hbase.tar</name>
+ <value>/home/slider/hbase/hbase-assembly/target/hbase-0.98.0-SNAPSHOT-bin.tar.gz</value>
+ <description>HBASE archive URI</description>
+ </property>
+
+ <property>
+ <name>slider.test.accumulo.home</name>
+ <value>/home/slider/accumulo/assemble/target/accumulo-1.5.1-SNAPSHOT/</value>
+ <description>Accumulo Home</description>
+ </property>
+
+ <property>
+ <name>slider.test.accumulo.tar</name>
+ <value>/home/slider/accumulo/assemble/target/accumulo-1.5.1-SNAPSHOT-bin.tar.gz</value>
+ <description>Accumulo archive URI</description>
+ </property>
+
+ <property>
+ <name>zk.home</name>
+ <value>
+ /home/slider/Apps/zookeeper</value>
+ <description>Zookeeper home dir on target systems</description>
+ </property>
+
+ <property>
+ <name>hadoop.home</name>
+ <value>
+ /home/slider/hadoop-common/hadoop-dist/target/hadoop-2.3.0</value>
+ <description>Hadoop home dir on target systems</description>
+ </property>
+
+</configuration>
+</pre></div></div></div>
+<div class="section">
+<h2>Debugging a failing test<a name="Debugging_a_failing_test"></a></h2>
+
+<ol style="list-style-type: decimal">
+
+<li>
+<p>Locate the directory <tt>target/$TESTNAME</tt> where TESTNAME is the name of the test case and or test method. This directory contains the Mini YARN Cluster logs. For example, <tt>TestLiveRegionService</tt> stores its data under <tt>target/TestLiveRegionService</tt></p></li>
+
+<li>
+<p>Look under that directory for <tt>-logdir</tt> directories, then an application and container containing logs. There may be more than node being simulated; every node manager creates its own logdir.</p></li>
+
+<li>
+<p>Look for the <tt>out.txt</tt> and <tt>err.txt</tt> files for stdout and stderr log output.</p></li>
+
+<li>
+<p>Slider uses SLF4J to log to <tt>out.txt</tt>; remotely executed processes may use either stream for logging</p></li>
+</ol>
+<p>Example:</p>
+
+<div class="source">
+<pre>target/TestLiveRegionService/TestLiveRegionService-logDir-nm-1_0/application_1376095770244_0001/container_1376095770244_0001_01_000001/out.txt
+</pre></div>
+
+<ol style="list-style-type: decimal">
+
+<li>The actual test log from JUnit itself goes to the console and into <tt>target/surefire/</tt>; this shows the events happening in the YARN services as well as (if configured) HDFS and Zookeeper. It is noisy -everything after the <i>teardown</i> message happens during cluster teardown, after the test itself has been completed. Exceptions and messages here can generally be ignored.</li>
+</ol>
+<p>This is all a bit complicated -debugging is simpler if a single test is run at a time, which is straightforward</p>
+
+<div class="source">
+<pre>mvn clean test -Dtest=TestLiveRegionService
+</pre></div>
+<div class="section">
+<h3>Building the JAR file<a name="Building_the_JAR_file"></a></h3>
+<p>You can create the JAR file and set up its directories with</p>
+
+<div class="source">
+<pre> mvn package -DskipTests
+</pre></div>
+<h1>Development Notes</h1>
+<!-- -
+## Git branch model
+
+
+The git branch model uses is
+[Git Flow](http://nvie.com/posts/a-successful-git-branching-model/).
+
+This is a common workflow model for Git, and built in to
+[Atlassian Source Tree](http://sourcetreeapp.com/).
+
+The command line `git-flow` tool is easy to install
+
+ brew install git-flow
+
+or
+
+ apt-get install git-flow
+
+You should then work on all significant features in their own branch and
+merge them back in when they are ready.
+
+
+ # until we get a public JIRA we're just using an in-house one. sorry
+ git flow feature start BUG-8192
+
+ # finishes merges back in to develop/
+ git flow feature finish BUG-8192
+
+ # release branch
+ git flow release start 0.4.0
+
+ git flow release finish 0.4.0 --></div></div>
+<div class="section">
+<h2>Attention OS/X developers<a name="Attention_OSX_developers"></a></h2>
+<p>YARN on OS/X doesn’t terminate subprocesses the way it does on Linux, so HBase Region Servers created by the hbase shell script remain running even after the tests terminate.</p>
+<p>This causes some tests -especially those related to flexing down- to fail, and test reruns may be very confused. If ever a test fails because there are too many region servers running, this is the likely cause</p>
+<p>After every test run: do a <tt>jps -v</tt> to look for any leftover HBase services -and kill them.</p>
+<p>Here is a handy bash command to do this</p>
+
+<div class="source">
+<pre>jps -l | grep HRegion | awk '{print $1}' | xargs kill -9
+</pre></div></div>
+<div class="section">
+<h2>Groovy<a name="Groovy"></a></h2>
+<p>Slider uses Groovy 2.x as its language for writing tests -for better assertions and easier handling of lists and closures. Although the first prototype used Groovy on the production source, this was dropped in favor of a Java-only production codebase.</p></div>
+<div class="section">
+<h2>Maven utils<a name="Maven_utils"></a></h2>
+<p>Here are some handy aliases to make maven easier </p>
+
+<div class="source">
+<pre>alias mci='mvn clean install -DskipTests'
+alias mi='mvn install -DskipTests'
+alias mvct='mvn clean test'
+alias mvnsite='mvn site:site -Dmaven.javadoc.skip=true'
+alias mvt='mvn test'
+</pre></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>
+</html>
Propchange: incubator/slider/site/content/developing/building.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/slider/site/content/developing/functional_tests.html
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/developing/functional_tests.html?rev=1598665&view=auto
==============================================================================
--- incubator/slider/site/content/developing/functional_tests.html (added)
+++ incubator/slider/site/content/developing/functional_tests.html Fri May 30 16:47:13 2014
@@ -0,0 +1,583 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 2014-05-30
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<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>
+ </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" >
+
+ <!-- -
+ 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>Testing Apache Slider</h1>
+
+<div class="source">
+<pre> 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>
+<h1>Functional Tests</h1>
+<p>The functional test suite is designed to test slider against a live cluster. </p>
+<p>For these to work you need</p>
+
+<ol style="list-style-type: decimal">
+
+<li>A YARN Cluster -secure or insecure</li>
+
+<li>A <tt>slider-client.xml</tt> file configured to interact with the cluster</li>
+
+<li>Agent</li>
+
+<li>HBase tests: HBase <tt>.tar.gz</tt> uploaded to HDFS, and a local or remote accumulo conf directory</li>
+
+<li>Accumulo Tests Accumulo <tt>.tar.gz</tt> uploaded to HDFS, and a local or remote accumulo conf directory</li>
+</ol>
+<div class="section">
+<h2>Configuration of functional tests<a name="Configuration_of_functional_tests"></a></h2>
+<p>Maven needs to be given</p>
+
+<ol style="list-style-type: decimal">
+
+<li>A path to the expanded test archive</li>
+
+<li>A path to a slider configuration directory for the cluster</li>
+</ol>
+<p>The path for the expanded test is automatically calculated as being the directory under <tt>..\slider-assembly\target</tt> where an untarred slider distribution can be found. If it is not present, the tests will fail</p>
+<p>The path to the configuration directory must be supplied in the property <tt>slider.conf.dir</tt> which can be set on the command line</p>
+
+<div class="source">
+<pre>mvn test -Dslider.conf.dir=src/test/configs/sandbox/slider
+</pre></div>
+<p>It can also be set in the (optional) file <tt>slider-funtest/build.properties</tt>:</p>
+
+<div class="source">
+<pre>slider.conf.dir=src/test/configs/sandbox/slider
+</pre></div>
+<p>This file is loaded whenever a slider build or test run takes place</p></div>
+<div class="section">
+<h2>Configuration of <tt>slider-client.xml</tt><a name="Configuration_of_slider-client.xml"></a></h2>
+<p>The <tt>slider-client.xml</tt> must have extra configuration options for both the HBase and Accumulo tests, as well as a common set for actually talking to a YARN cluster.</p></div>
+<div class="section">
+<h2>Disabling the functional tests entirely<a name="Disabling_the_functional_tests_entirely"></a></h2>
+<p>All functional tests which require a live YARN cluster can be disabled through the property <tt>slider.funtest.enabled</tt></p>
+
+<div class="source">
+<pre><property>
+ <name>slider.funtest.enabled</name>
+ <value>false</value>
+</property>
+</pre></div>
+<p>There is a configuration do do exactly this in <tt>src/test/configs/offline/slider</tt>:</p>
+
+<div class="source">
+<pre>slider.conf.dir=src/test/configs/offline/slider
+</pre></div>
+<p>Tests which do not require a live YARN cluster will still run; these verify that the <tt>bin/slider</tt> script works.</p>
+<div class="section">
+<h3>Non-mandatory options<a name="Non-mandatory_options"></a></h3>
+<p>The following test options may be added to <tt>slider-client.xml</tt> if the defaults need to be changed</p>
+
+<div class="source">
+<pre><property>
+ <name>slider.test.zkhosts</name>
+ <description>comma separated list of ZK hosts</description>
+ <value>localhost</value>
+</property>
+
+<property>
+ <name>slider.test.thaw.wait.seconds</name>
+ <description>Time to wait in seconds for a thaw to result in a running AM</description>
+ <value>60000</value>
+</property>
+
+<property>
+ <name>slider.test.freeze.wait.seconds</name>
+ <description>Time to wait in seconds for a freeze to halt the cluster</description>
+ <value>60000</value>
+</property>
+
+ <property>
+ <name>slider.test.timeout.millisec</name>
+ <description>Time out in milliseconds before a test is considered to have failed.
+ There are some maven properties which also define limits and may need adjusting</description>
+ <value>180000</value>
+</property>
+
+ <property>
+ <name>slider.test.yarn.ram</name>
+ <description>Size in MB to ask for containers</description>
+ <value>192</value>
+</property>
+</pre></div>
+<p>Note that while the same properties need to be set in <tt>slider-core/src/test/resources/slider-client.xml</tt>, those tests take a file in the local filesystem -here a URI to a path visible across all nodes in the cluster are required the tests do not copy the .tar/.tar.gz files over. The application configuration directories may be local or remote -they are copied into the <tt>.slider</tt> directory during cluster creation.</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>
+
+<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>
+</ol>
+<div class="section">
+<h3>Agent Tests<a name="Agent_Tests"></a></h3>
+<p>Agent tests are executed through the following mvn command executed at slider/slider-funtest:</p>
+
+<div class="source">
+<pre>cd slider-funtest
+mvn test -Dslider.conf.dir=../src/test/clusters/remote/slider -Dtest=TestAppsThroughAgent -DfailIfNoTests=false
+</pre></div>
+<p><b>Enable/Execute the tests</b></p>
+<p>To enable the test ensure that <i>slider.test.agent.enabled</i> is set to <i>true</i>.</p>
+
+<div class="source">
+<pre><property>
+ <name>slider.test.agent.enabled</name>
+ <description>Flag to enable/disable Agent tests</description>
+ <value>true</value>
+</property>
+</pre></div>
+<p><b>Test setup</b></p>
+<p>Edit config file src/test/clusters/remote/slider/slider-client.xml and ensure that the host names are accurate for the test cluster.</p>
+<p><b>User setup</b></p>
+<p>Ensure that the user, running the test, is present on the cluster against which you are running the tests. The user must be a member of the hadoop group.</p>
+<p>E.g. adduser <b>testuser</b> -d /home/<b>testuser</b> -G hadoop -m</p>
+<p><b>HDFS Setup</b></p>
+<p>Set up hdfs folders for slider and test user</p>
+
+<ul>
+
+<li>su hdfs</li>
+
+<li>hdfs dfs -mkdir /slider</li>
+
+<li>hdfs dfs -chown testuser:hdfs /slider</li>
+
+<li>hdfs dfs -mkdir /user/testuser</li>
+
+<li>hdfs dfs -chown testuser:hdfs /user/testuser</li>
+</ul>
+<p>Load up agent package and config</p>
+
+<ul>
+
+<li>su <b>testuser</b></li>
+
+<li>hdfs dfs -mkdir /slider/agent</li>
+
+<li>hdfs dfs -mkdir /slider/agent/conf</li>
+
+<li>hdfs dfs -copyFromLocal SLIDER_INSTALL_LOC/agent/conf/agent.ini /slider/agent/conf</li>
+</ul>
+<p>Ensure correct host name is provided for the agent tarball.</p>
+
+<div class="source">
+<pre><property>
+ <name>slider.test.agent.tar</name>
+ <description>Path to the Agent Tar file in HDFS</description>
+ <value>hdfs://NN_HOSTNAME:8020/slider/agent/slider-agent.tar.gz</value>
+</property>
+</pre></div></div>
+<div class="section">
+<h3>HBase Tests<a name="HBase_Tests"></a></h3>
+<p>The HBase tests can be enabled or disabled</p>
+
+<div class="source">
+<pre><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>
+
+<div class="source">
+<pre><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>
+</property>
+
+<property>
+ <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>
+
+<div class="source">
+<pre> <property>
+ <name>slider.test.hbase.launch.wait.seconds</name>
+ <description>Time to wait in seconds for HBase to start</description>
+ <value>1800</value>
+</property>
+</pre></div>
+<div class="section">
+<h4>Accumulo configuration options<a name="Accumulo_configuration_options"></a></h4>
+<p>Enable/disable the tests</p>
+
+<div class="source">
+<pre> <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>
+
+<div class="source">
+<pre> <property>
+ <name>slider.test.accumulo.launch.wait.seconds</name>
+ <description>Time to wait in seconds for Accumulo to start</description>
+ <value>1800</value>
+ </property>
+</pre></div></div></div>
+<div class="section">
+<h3>Configuring the YARN cluster for tests<a name="Configuring_the_YARN_cluster_for_tests"></a></h3>
+<p>Here are the configuration options we use in <tt>yarn-site.xml</tt> for testing:</p>
+<p>These tell YARN to ignore memory requirements in allocating VMs, and to keep the log files around after an application run. </p>
+
+<div class="source">
+<pre> <property>
+ <name>yarn.scheduler.minimum-allocation-mb</name>
+ <value>1</value>
+ </property>
+ <property>
+ <description>Whether physical memory limits will be enforced for
+ containers.
+ </description>
+ <name>yarn.nodemanager.pmem-check-enabled</name>
+ <value>false</value>
+ </property>
+ <!-- we really don't want checking here-->
+ <property>
+ <name>yarn.nodemanager.vmem-check-enabled</name>
+ <value>false</value>
+ </property>
+
+ <!-- how long after a failure to see what is left in the directory-->
+ <property>
+ <name>yarn.nodemanager.delete.debug-delay-sec</name>
+ <value>60000</value>
+ </property>
+
+ <!--ten seconds before the process gets a -9 -->
+ <property>
+ <name>yarn.nodemanager.sleep-delay-before-sigkill.ms</name>
+ <value>30000</value>
+ </property>
+</pre></div></div></div>
+<div class="section">
+<h2>Testing against a secure cluster<a name="Testing_against_a_secure_cluster"></a></h2>
+<p>To test against a secure cluster</p>
+
+<ol style="list-style-type: decimal">
+
+<li><tt>slider-client.xml</tt> must be configured as per <a href="../security.html">Security</a>.</li>
+
+<li>the client must have the kerberos tokens issued so that the user running the tests has access to HDFS and YARN.</li>
+</ol>
+<p>If there are problems authenticating (including the cluster being offline) the tests appear to hang</p>
+<div class="section">
+<h3>Validating the configuration<a name="Validating_the_configuration"></a></h3>
+
+<div class="source">
+<pre>mvn test -Dtest=TestBuildSetup
+</pre></div></div>
+<div class="section">
+<h3>Using relative paths in test configurations<a name="Using_relative_paths_in_test_configurations"></a></h3>
+<p>When you are sharing configurations across machines via SCM or similar, its impossible to have absolute paths in the configuration options to the location of items in the local filesystem (e.g. configuration directories).</p>
+<p>There’s two techniques</p>
+
+<ol style="list-style-type: decimal">
+
+<li>
+<p>Keep the data in HDFS and refer to it there. This works if there is a shared, persistent HDFS cluster.</p></li>
+
+<li>
+<p>Use the special property <tt>slider.test.conf.dir</tt> that is set to the path of the directory, and which can then be used to create an absolute path from paths relative to the configuration dir:</p>
+
+<div class="source">
+<pre><property>
+ <name>slider.test.hbase.appconf</name>
+ <description>Path to the directory containing the HBase application config</description>
+ <value>file://${slider.test.conf.dir}/../hbase</value>
+</property>
+</pre></div></li>
+</ol>
+<p>If the actual XML file path is required, a similar property <tt>slider.test.conf.xml</tt> is set.</p></div></div>
+<div class="section">
+<h2>Parallel execution<a name="Parallel_execution"></a></h2>
+<p>Attempts to run test cases in parallel failed -even with a configuration to run methods in a class sequentially, but separate classes independently.</p>
+<p>Even after identifying and eliminating some unintended sharing of static mutable variables, trying to run test cases in parallel seemed to hang tests and produce timeouts.</p>
+<p>For this reason parallel tests have been disabled. To accelerate test runs through parallelization, run different tests on different hosts instead.</p></div>
+<div class="section">
+<h2>Other constraints<a name="Other_constraints"></a></h2>
+
+<ul>
+
+<li>Port assignments SHOULD NOT be fixed, as this will cause clusters to fail if there are too many instances of a role on a same host, or if other tests are using the same port.</li>
+
+<li>If a test does need to fix a port, it MUST be for a single instance of a role, and it must be different from all others. The assignment should be set in <tt>org.apache.slider.funtest.itest.PortAssignments</tt> so as to ensure uniqueness over time. Otherwise: use the value of <tt>0</tt> to allow the OS to assign free ports on demand.</li>
+</ul></div>
+<div class="section">
+<h2>Test Requirements<a name="Test_Requirements"></a></h2>
+
+<ol style="list-style-type: decimal">
+
+<li>Test cases should be written so that each class works with exactly one Slider-deployed cluster</li>
+
+<li>Every test MUST have its own cluster name -preferably derived from the classname.</li>
+
+<li>This cluster should be deployed in an <tt>@BeforeClass</tt> method.</li>
+
+<li>The <tt>@AfterClass</tt> method MUST tear this cluster down.</li>
+
+<li>Tests must skip their execution if functional tests -or the specific hbase or accumulo categories- are disabled.</li>
+
+<li>Tests within the suite (i.e. class) must be designed to be independent -to work irrespectively of the ordering of other tests.</li>
+</ol></div>
+<div class="section">
+<h2>Running and debugging the functional tests.<a name="Running_and_debugging_the_functional_tests."></a></h2>
+<p>The functional tests all </p>
+
+<ol style="list-style-type: decimal">
+
+<li>
+<p>In the root <tt>slider</tt> directory, build a complete Slider release</p>
+
+<div class="source">
+<pre>mvn install -DskipTests
+</pre></div></li>
+
+<li>Start the YARN cluster/set up proxies to connect to it, etc.</li>
+
+<li>
+<p>In the <tt>slider-funtest</tt> dir, run the tests</p>
+
+<div class="source">
+<pre>mvn test
+</pre></div></li>
+</ol>
+<p>A common mistake during development is to rebuild the <tt>slider-core</tt> JARs then the <tt>slider-funtest</tt> tests without rebuilding the <tt>slider-assembly</tt>. In this situation, the tests are in sync with the latest build of the code -including any bug fixes- but the scripts executed by those tests are of a previous build of <tt>slider-core.jar</tt>. As a result, the fixes are not picked up.</p>
+<div class="section">
+<div class="section">
+<h4>To propagate changes in slider-core through to the funtest classes for<a name="To_propagate_changes_in_slider-core_through_to_the_funtest_classes_for"></a></h4>
+<p>testing, you must build/install all the slider packages from the root assembly.</p>
+
+<div class="source">
+<pre>mvn clean install -DskipTests
+</pre></div></div></div></div>
+<div class="section">
+<h2>Limitations of slider-funtest<a name="Limitations_of_slider-funtest"></a></h2>
+
+<ol style="list-style-type: decimal">
+
+<li>All tests run from a single client -workload can’t scale</li>
+
+<li>Output from failed AM and containers aren’t collected</li>
+</ol></div>
+<div class="section">
+<h2>Troubleshooting the functional tests<a name="Troubleshooting_the_functional_tests"></a></h2>
+
+<ol style="list-style-type: decimal">
+
+<li>
+<p>If application instances fail to come up as there are still outstanding requests, it means that YARN didn’t have the RAM/cores to spare for the number of containers. Edit the <tt>slider.test.yarn.ram</tt> to make it smaller.</p></li>
+
+<li>
+<p>If you are testing in a local VM and stops responding, it’ll have been swapped out to RAM. Rebooting can help, but for a long term fix go through all the Hadoop configurations (HDFS, YARN, Zookeeper) and set their heaps to smaller numbers, like 256M each. Also: turn off unused services (hcat, oozie, webHDFS)</p></li>
+
+<li>
+<p>The YARN UI will list the cluster launches -look for the one with a name close to the test and view its logs</p></li>
+
+<li>
+<p>Container logs will appear “elsewhere”. The log lists the containers used -you may be able to track the logs down from the specific nodes.</p></li>
+
+<li>
+<p>If you browse the filesystem, look for the specific test clusters in <tt>~/.slider/cluster/$testname</tt></p></li>
+
+<li>
+<p>If you are using a secure cluster, make sure that the clocks are synchronized, and that you have a current token -<tt>klist</tt> will tell you this. In a VM: install and enable <tt>ntp</tt>, consider rebooting if ther are any problems. Check also that it has the same time zone settings as the host OS.</p></li>
+</ol></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>
+</html>
Propchange: incubator/slider/site/content/developing/functional_tests.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/slider/site/content/developing/index.html
URL: http://svn.apache.org/viewvc/incubator/slider/site/content/developing/index.html?rev=1598665&view=auto
==============================================================================
--- incubator/slider/site/content/developing/index.html (added)
+++ incubator/slider/site/content/developing/index.html Fri May 30 16:47:13 2014
@@ -0,0 +1,209 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia at 2014-05-30
+ | Rendered using Apache Maven Fluido Skin 1.3.0
+-->
+<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>
+ </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" >
+
+ <!-- -
+ 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>Developing Apache Slider</h1>
+<p>Slider is an open source project -anyone is free to contributed, and we strongly encourage people to do so. </p>
+<p>Here are documents covering how to go about building, testing and releasing Slider</p>
+
+<ul>
+
+<li><a href="building.html">Building</a></li>
+
+<li><a href="../debugging.html">Debugging</a></li>
+
+<li><a href="testing.html">Testing</a></li>
+
+<li><a href="functional_tests.html">Functional Testing</a></li>
+
+<li><a href="manual_testing.html">Manual Testing</a></li>
+
+<li><a href="agent_test_setup.html">Agent test setup</a></li>
+
+<li><a href="releasing.html">Releasing</a></li>
+</ul>
+ </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>
+</html>
Propchange: incubator/slider/site/content/developing/index.html
------------------------------------------------------------------------------
svn:eol-style = native