You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ambari.apache.org by yu...@apache.org on 2012/12/14 08:17:46 UTC
svn commit: r1421699 - in /incubator/ambari/trunk/docs: ./ src/ src/site/
src/site/apt/ src/site/resources/ src/site/resources/images/
Author: yusaku
Date: Fri Dec 14 07:17:42 2012
New Revision: 1421699
URL: http://svn.apache.org/viewvc?rev=1421699&view=rev
Log:
Added docs. (yusaku)
Added:
incubator/ambari/trunk/docs/
incubator/ambari/trunk/docs/pom.xml
incubator/ambari/trunk/docs/src/
incubator/ambari/trunk/docs/src/site/
incubator/ambari/trunk/docs/src/site/apt/
incubator/ambari/trunk/docs/src/site/apt/index.apt
incubator/ambari/trunk/docs/src/site/apt/install-0.9.apt
incubator/ambari/trunk/docs/src/site/apt/install.apt
incubator/ambari/trunk/docs/src/site/apt/privacy-policy.apt
incubator/ambari/trunk/docs/src/site/apt/whats-new.apt
incubator/ambari/trunk/docs/src/site/resources/
incubator/ambari/trunk/docs/src/site/resources/images/
incubator/ambari/trunk/docs/src/site/resources/images/apache-ambari-project.png (with props)
incubator/ambari/trunk/docs/src/site/site.xml
Added: incubator/ambari/trunk/docs/pom.xml
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/docs/pom.xml?rev=1421699&view=auto
==============================================================================
--- incubator/ambari/trunk/docs/pom.xml (added)
+++ incubator/ambari/trunk/docs/pom.xml Fri Dec 14 07:17:42 2012
@@ -0,0 +1,347 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ 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.
+-->
+
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+ <name>Ambari</name>
+ <description>
+ Ambari is a web-based tool for performing installation, management, and monitoring of Apache Hadoop clusters. The stack of components that are currently supported by
+ Ambari includes HBase, HCatalog, HDFS, Hive, MapReduce, Oozie, Pig, Scoop, Templeton, and Zookeeper.
+ </description>
+ <url>http://incubator.apache.org/ambari</url>
+ <modelVersion>4.0.0</modelVersion>
+
+ <groupId>org.apache.ambari</groupId>
+ <version>1.0.0-SNAPSHOT</version>
+ <artifactId>ambari</artifactId>
+ <packaging>pom</packaging>
+
+ <properties>
+ <buildtype>test</buildtype>
+ <BUILD_NUMBER>${env.BUILD_NUMBER}</BUILD_NUMBER>
+ <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+ <package.prefix>/usr</package.prefix>
+ <package.conf.dir>/etc/ambari</package.conf.dir>
+ <package.log.dir>/var/log/ambari</package.log.dir>
+ <package.pid.dir>/var/run/ambari</package.pid.dir>
+ <package.release>1</package.release>
+ <package.type>tar.gz</package.type>
+ <ambari.version>1.0.0-SNAPSHOT</ambari.version>
+ <final.name>${project.artifactId}-${ambari.version}</final.name>
+ </properties>
+
+ <licenses>
+ <license>
+ <name>Apache 2</name>
+ <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
+ <distribution>repo</distribution>
+ </license>
+ </licenses>
+
+ <scm>
+ <connection>scm:svn:http://svn.apache.org/repos/asf/incubator/ambari</connection>
+ <developerConnection>scm:svn:https://svn.apache.org/repos/asf/incubator/ambari</developerConnection>
+ <tag>HEAD</tag>
+ <url>http://svn.apache.org/repos/asf/incubator/ambari</url>
+ </scm>
+
+ <issueManagement>
+ <system>Jira</system>
+ <url>http://issues.apache.org/jira/browse/AMBARI</url>
+ </issueManagement>
+
+ <mailingLists>
+ <mailingList>
+ <name>User list</name>
+ <subscribe>mailto:ambari-user-subscribe@incubator.apache.org
+ </subscribe>
+ <unsubscribe>mailto:ambari-user-unsubscribe@incubator.apache.org
+ </unsubscribe>
+ <post>mailto:ambari-user@incubator.apache.org</post>
+ <archive></archive>
+ </mailingList>
+ <mailingList>
+ <name>Development list</name>
+ <subscribe>mailto:ambari-dev-subscribe@incubator.apache.org
+ </subscribe>
+ <unsubscribe>mailto:ambari-dev-unsubscribe@incubator.apache.org
+ </unsubscribe>
+ <post>mailto:ambari-dev@incubator.apache.org</post>
+ <archive></archive>
+ </mailingList>
+ <mailingList>
+ <name>Commit list</name>
+ <subscribe>mailto:ambari-commits-subscribe@incubator.apache.org
+ </subscribe>
+ <unsubscribe>mailto:ambari-commits-unsubscribe@incubator.apache.org
+ </unsubscribe>
+ <post>mailto:ambari-commits@incubator.apache.org</post>
+ <archive></archive>
+ </mailingList>
+ </mailingLists>
+
+ <developers>
+ <developer>
+ <id>omalley</id>
+ <name>Owen O'Malley</name>
+ <email>omalley@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>berndf</id>
+ <name>Bernd Fondermann</name>
+ <email>berndf@apache.org</email>
+ <timezone>+1</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ </developer>
+ <developer>
+ <id>ddas</id>
+ <name>Devaraj Das</name>
+ <email>ddas@hortonworks.com</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>eyang</id>
+ <name>Eric Yang</name>
+ <email>eyang@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ IBM
+ </organization>
+ </developer>
+ <developer>
+ <id>hitesh</id>
+ <name>Hitesh Shah</name>
+ <email>hitesh@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>jagane</id>
+ <name>Jagane Sundar</name>
+ <email>jagane@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+
+ </organization>
+ </developer>
+ <developer>
+ <id>jitendra</id>
+ <name>Jitendra Pandey</name>
+ <email>jitendra@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>kzhang</id>
+ <name>Kan Zhang</name>
+ <email>kanzhangmail@yahoo.com</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ IBM
+ </organization>
+ </developer>
+ <developer>
+ <id>mahadev</id>
+ <name>Mahadev Konar</name>
+ <email>mahadev@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>ramya</id>
+ <name>Ramya Sunil</name>
+ <email>ramya@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>reznor</id>
+ <name>Varun Kapoor</name>
+ <email>reznor@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>Committer</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>vikram</id>
+ <name>Vikram Dixit</name>
+ <email>vikram@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>Committer</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>vgogate</id>
+ <name>Vitthal Suhas Gogate</name>
+ <email>vgogate@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>vinodkv</id>
+ <name>Vinod Kumar Vavilapalli</name>
+ <email>vinodkv@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>Committer</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ <developer>
+ <id>yusaku</id>
+ <name>Yusaku Sako</name>
+ <email>yusaku@apache.org</email>
+ <timezone>-8</timezone>
+ <roles>
+ <role>PMC</role>
+ </roles>
+ <organization>
+ Hortonworks
+ </organization>
+ </developer>
+ </developers>
+ <organization>
+ <name>Apache Software Foundation</name>
+ <url>http://www.apache.org/</url>
+ </organization>
+
+ <build>
+ <resources>
+ <resource>
+ <directory>src/main/resources</directory>
+ <filtering>true</filtering>
+ </resource>
+ </resources>
+ <pluginManagement>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-resources-plugin</artifactId>
+ <version>2.4.3</version>
+ <configuration>
+ <encoding>UTF-8</encoding>
+ </configuration>
+ </plugin>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-site-plugin</artifactId>
+ <version>3.0</version>
+ <configuration>
+ <outputDirectory>./target</outputDirectory>
+ </configuration>
+ </plugin>
+ </plugins>
+ </pluginManagement>
+ </build>
+
+ <reporting>
+ <excludeDefaults>true</excludeDefaults>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-project-info-reports-plugin</artifactId>
+ <version>2.4</version>
+ <reportSets>
+ <reportSet>
+ <reports>
+ <report>project-team</report>
+ <report>mailing-list</report>
+ <report>issue-tracking</report>
+ <report>license</report>
+<!-- for now
+ <report>modules</report>
+ <report>dependencies</report>
+ <report>cim</report>
+ <report>scm</report>
+-->
+ </reports>
+ </reportSet>
+ </reportSets>
+ </plugin>
+ </plugins>
+ </reporting>
+
+ <distributionManagement>
+ <site>
+ <id>apache-website</id>
+ <name>Apache website</name>
+ <url>scpexe://people.apache.org/www/incubator.apache.org/ambari</url>
+ </site>
+ </distributionManagement>
+
+</project>
Added: incubator/ambari/trunk/docs/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/docs/src/site/apt/index.apt?rev=1421699&view=auto
==============================================================================
--- incubator/ambari/trunk/docs/src/site/apt/index.apt (added)
+++ incubator/ambari/trunk/docs/src/site/apt/index.apt Fri Dec 14 07:17:42 2012
@@ -0,0 +1,114 @@
+~~ 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.
+~~
+Introduction
+
+ Apache Ambari is a web-based tool for provisioning, managing, and monitoring Apache Hadoop clusters. The set of
+ Hadoop components that are currently supported by Ambari includes:
+
+ * {{{http://hadoop.apache.org/docs/hdfs} Apache Hadoop - HDFS}}
+
+ * {{{http://hadoop.apache.org/docs/mapreduce} Apache Hadoop - MapReduce}}
+
+ * {{{http://hive.apache.org} Apache Hive}}
+
+ * {{{http://incubator.apache.org/hcatalog} Apache HCatalog}}
+
+ * {{{http://people.apache.org/~thejas/templeton_doc_latest/index.html} Apache Templeton}}
+
+ * {{{http://hbase.apache.org} Apache HBase}}
+
+ * {{{http://zookeeper.apache.org} Apache Zookeeper}}
+
+ * {{{http://incubator.apache.org/oozie/} Apache Oozie}}
+
+ * {{{http://pig.apache.org} Apache Pig}}
+
+ * {{{http://sqoop.apache.org} Apache Sqoop}}
+
+ []
+
+ Ambari enables System Administrators to:
+
+ * Provision a Hadoop Cluster
+
+ * Ambari provides an easy-to-use, step-by-step wizard for installing Hadoop services across any number of hosts.
+
+ * Ambari handles configuration of Hadoop services for the cluster.
+
+ []
+
+ * Manage a Hadoop Cluster
+
+ * Ambari provides central management for starting, stopping, and reconfiguring Hadoop services across the entire cluster.
+
+ []
+
+ * Monitor a Hadoop Cluster
+
+ * Ambari provides a dashboard for monitoring health and status of the Hadoop cluster.
+
+ * Ambari leverages {{{http://ganglia.sourceforge.net/} Ganglia}} for metrics collection.
+
+ * Ambari leverages {{{http://www.nagios.org/} Nagios}} for system alerting and will send emails when your attention is needed (e.g., a node goes down, remaining disk space is low, etc).
+
+ []
+
+Ambari Source
+
+ Follow the {{{./install-0.9.html} installation guide for 0.9 (stable)}} or check out the work going on in {{{./whats-new.html} trunk}}.
+
+Roadmap
+
+ * Support for additional Operating Systems
+
+ * Ambari currently supports 64-bit RHEL and CentOS 5 + 6
+
+ * Future support for SLES 11 is coming soon
+
+ []
+
+ * RESTful API for integration
+
+ * Ambari will expose a unified, RESTful API to enable third-party applications to integrate
+ Hadoop cluster management and monitoring capabilities.
+
+ []
+
+ * Granular configurations
+
+ * Ambari currently applies service configurations at the cluster-level. For more
+ flexibility, Ambari will allow for configurations in a more granular manner, such as
+ applying a set of configurations to a specific group of hosts.
+
+ []
+
+ * Security
+
+ * Installation of secure Hadoop clusters (Kerberos-based)
+
+ * Role-based user authentication, authorization, and auditing
+
+ * Support for LDAP and Active Directory
+
+ []
+
+ * Visualization
+
+ * Interactive visualization of current and historical states of the cluster for a number of key metrics
+
+ * Interactive visualization of Pig, Hive, and MapReduce jobs
+
+ []
Added: incubator/ambari/trunk/docs/src/site/apt/install-0.9.apt
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/docs/src/site/apt/install-0.9.apt?rev=1421699&view=auto
==============================================================================
--- incubator/ambari/trunk/docs/src/site/apt/install-0.9.apt (added)
+++ incubator/ambari/trunk/docs/src/site/apt/install-0.9.apt Fri Dec 14 07:17:42 2012
@@ -0,0 +1,158 @@
+~~ Licensed 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. See accompanying LICENSE file.
+
+Supported Operating Systems
+
+ * Ambari currently supports:
+
+ * RHEL/CentOS 5.*, 64-bit version
+
+ * RHEL/CentOS 6.*, 64-bit version
+
+Getting Ambari
+
+ The source can be checked out anonymously from SVN with the following command:
+
++--
+$ svn checkout http://svn.apache.org/repos/asf/incubator/ambari/branches/branch-0.9 ambari
++--
+
+How to build Ambari
+
+ You need to build Ambari RPMs from the source code that you checked out:
+
++--
+$ yum install rpm-build
+$ cd ambari/hmc/package/rpm
+$ ./create_hmc_rpm.sh
+
+$ cd ambari/mon_dashboard/package/rpm
+$ ./create_dashboard_rpm.sh
++--
+
+ When this succeeds, you will find following RPMs inside the ambari directory:
+
+ 1) ambari/hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-0.9.0-1[.el6].noarch.rpm
+
+ 2) ambari/hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-agent-0.9.0-1[.el6].noarch.rpm
+
+ 3) ambari/mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_dashboard-0.0.2.14-1.noarch.rpm
+
+
+Installing Ambari
+
+ We will refer to the node running the Ambari server as <Ambari master>
+ and the nodes to which Hadoop services will be installed as <cluster nodes>.
+
+ 1) Set up password-less SSH for root on all your cluster nodes.
+
+ * Copy root's SSH public key to all the cluster nodes in the .ssh/authorized_keys file.
+
+ * Save the corresponding SSH private key file locally. You will be prompted by Ambari UI to upload it during cluster installation.
+
+ 2) Install ambari-agent on each of the cluster nodes.
+
+ * To install ambari-agent, point to the freely accessible HDP repo
+that contains the required dependencies (e.g., Puppet). Then use yum to install ambari-agent RPM and all of its dependencies.
+
+ On RHEL/CentOS 5:
+
++--
+$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.1.14/repos/centos5/hdp-release-1.0.1.14-1.el5.noarch.rpm
+$ sudo yum install epel-release
+$ sudo yum install ambari-agent-0.9.0-1.noarch.rpm --nogpgcheck
++--
+
+ On RHEL/CentOS 6:
+
++--
+$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.1.14/repos/centos6/hdp-release-1.0.1.14-1.el6.noarch.rpm
+$ sudo yum install epel-release
+$ sudo yum install ambari-agent-0.9.0-1.el6.noarch.rpm
++--
+
+ 3) Stop iptables on Ambari master:
+
+ * Run the following command on the Ambari master:
+
++--
+$ sudo service iptables stop
++--
+
+ 4) Install Ambari server on Ambari master:
+
+ * To install Ambari server, point to the freely accessible HDP repo that contains the required dependencies (e.g., Puppet, PHP, Ruby, etc). Then use yum to install Ambari RPMs and all of the dependencies.
+
+ On RHEL/CentOS 5:
+
++--
+$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.1.14/repos/centos5/hdp-release-1.0.1.14-1.el5.noarch.rpm
+$ sudo yum install epel-release
+$ sudo yum install php-pecl-json
+$ sudo yum install ambari-0.9.0-1.noarch.rpm --nogpgcheck
+$ sudo yum install hdp_mon_dashboard-0.0.2.14-1.noarch.rpm --nogpgcheck
++--
+
+ On RHEL/CentOS 6:
+
++--
+$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.1.14/repos/centos6/hdp-release-1.0.1.14-1.el6.noarch.rpm
+$ sudo yum install epel-release
+$ sudo yum install ambari-0.9.0-1.el6.noarch.rpm
+$ sudo yum install hdp_mon_dashboard-0.0.2.14-1.noarch.rpm
++--
+
+ * Hadoop requires JDK. You can download following files from the Oracle website:
+ {{{http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u26-download-400750.html} http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u26-download-400750.html}}
+ After accepting the license and downloading the files, copy them to /var/run/hmc/downloads/ directory on the
+ Ambari master (Note: Upon download, these files may have .sh extension, so make sure you remove the .sh extension
+ from the filenames and also set the execute permission on them)
+
+ 1) jdk-6u26-linux-x64.bin
+
+ 2) jdk-6u26-linux-i586.bin
+
+
+How to run Ambari
+
++--
+$ sudo service ambari start
++--
+
+ Now that Ambari server is installed and started, you can start installing Apache Hadoop and its ecosystem components on your cluster nodes by visiting:
+
+ http://AMBARIMASTER/hmc/html/
+
+ from your browser.
+
+
+Notes for Developers
+
+ If you have made any changes to Nagios or Ganglia addons code (mon_dashboard/src/addOns/[ganglia|nagios]), you will also have to install
+ hdp_mon_ganglia_addons-0.0.2.14-1.noarch.rpm and hdp_mon_nagios_addons-0.0.2.14-1.noarch.rpm on the hosts running
+ Ganglia and Nagios server, respectively, to make your changes effective.
+ After your Hadoop cluster is installed using Ambari, go to the host(s) running Nagios and Ganglia server,
+ remove these pre-installed addon RPMs for Nagios and Ganglia, and install the new ones built from the source.
+ To build these RPMs from the source, run:
+
++--
+$ cd mon_dashboard/package/rpm
+$ ./create_ganglia_addon_rpm.sh
+$ ./create_nagios_addon_rpm.sh
++--
+
+ Running the above creates the following two RPMs:
+
+ * mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_ganglia_addons-0.0.2.14-1.noarch.rpm
+
+ * mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_nagios_addons-0.0.2.14-1.noarch.rpm
+
Added: incubator/ambari/trunk/docs/src/site/apt/install.apt
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/docs/src/site/apt/install.apt?rev=1421699&view=auto
==============================================================================
--- incubator/ambari/trunk/docs/src/site/apt/install.apt (added)
+++ incubator/ambari/trunk/docs/src/site/apt/install.apt Fri Dec 14 07:17:42 2012
@@ -0,0 +1,161 @@
+~~ Licensed 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. See accompanying LICENSE file.
+
+Supported Operating Systems
+
+ * Ambari currently supports:
+
+ * RHEL/CentOS 5.*, 64-bit version
+
+ * RHEL/CentOS 6.*, 64-bit version
+
+Getting Ambari
+
+ The source can be checked out anonymously from SVN with the following command:
+
++--
+$ svn checkout http://svn.apache.org/repos/asf/incubator/ambari/trunk ambari
++--
+
+How to build Ambari
+
+ You need to build Ambari RPMs from the source code that you checked out:
+
++--
+$ yum install rpm-build
+$ cd ambari/hmc/package/rpm
+$ ./create_hmc_rpm.sh
+
+$ cd ambari/mon_dashboard/package/rpm
+$ ./create_dashboard_rpm.sh
++--
+
+ When this succeeds, you will find following RPMs inside the ambari directory:
+
+ 1) ambari/hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-1.0.0-1[.el6].noarch.rpm
+
+ 2) ambari/hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-agent-1.0.0-1[.el6].noarch.rpm
+
+ 3) ambari/mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_dashboard-0.0.2.14-1.noarch.rpm
+
+
+Installing Ambari
+
+ We will refer to the node running the Ambari server as <Ambari master>
+ and the nodes to which Hadoop services will be installed as <cluster nodes>.
+
+ 1) Set up password-less SSH for root on all your cluster nodes.
+
+ * Copy root's SSH public key to all the cluster nodes in the .ssh/authorized_keys file.
+
+ * Save the corresponding SSH private key file locally. You will be prompted by Ambari UI to upload it during cluster installation.
+
+ 2) Install ambari-agent on each of the cluster nodes.
+
+ * To install ambari-agent, point to the freely accessible HDP repo
+that contains the required dependencies (e.g., Puppet). Then use yum to install ambari-agent RPM and all of its dependencies.
+
+ On RHEL/CentOS 5:
+
++--
+$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.1.14/repos/centos5/hdp-release-1.0.1.14-1.el5.noarch.rpm
+$ sudo yum install epel-release
+$ sudo yum install ambari-agent-1.0.0-1.noarch.rpm --nogpgcheck
++--
+
+ On RHEL/CentOS 6:
+
++--
+$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.1.14/repos/centos6/hdp-release-1.0.1.14-1.el6.noarch.rpm
+$ sudo yum install epel-release
+$ sudo yum install ambari-agent-1.0.0-1.el6.noarch.rpm
++--
+
+ 3) Stop iptables on Ambari master:
+
+ * Run the following command on the Ambari master:
+
++--
+$ sudo service iptables stop
++--
+
+ 4) Install Ambari server on Ambari master:
+
+ * To install Ambari server, point to the freely accessible HDP repo that contains the required dependencies (e.g., Puppet, PHP, Ruby, etc). Then use yum to install Ambari RPMs and all of the dependencies.
+
+ On RHEL/CentOS 5:
+
++--
+$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.1.14/repos/centos5/hdp-release-1.0.1.14-1.el5.noarch.rpm
+$ sudo yum install epel-release
+$ sudo yum install php-pecl-json
+$ sudo yum install ambari-1.0.0-1.noarch.rpm --nogpgcheck
+$ sudo yum install hdp_mon_dashboard-0.0.2.14-1.noarch.rpm --nogpgcheck
++--
+
+ On RHEL/CentOS 6:
+
++--
+$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.1.14/repos/centos6/hdp-release-1.0.1.14-1.el6.noarch.rpm
+$ sudo yum install epel-release
+$ sudo yum install ambari-1.0.0-1.el6.noarch.rpm
+$ sudo yum install hdp_mon_dashboard-0.0.2.14-1.noarch.rpm
++--
+
+ * Hadoop requires JDK. You can download the JDK files from the Oracle website:
+ {{{http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u26-download-400750.html} http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u26-download-400750.html}}
+ After accepting the license and downloading the files, copy them to /var/run/hmc/downloads/ directory on the
+ Ambari master (Note: Upon download, these files may have .sh extension, so make sure you remove the .sh extension
+ from the filenames and also set the execute permission on them).
+ Also, JCE Policy Files 6 needs to be downloaded and uploaded to the same directory on the Ambari master server (/var/run/hmc/downloads/).
+ You can download it from {{{http://www.oracle.com/technetwork/java/javase/downloads/jce-6-download-429243.html} http://www.oracle.com/technetwork/java/javase/downloads/jce-6-download-429243.html}}
+
+ 1) jdk-6u26-linux-x64.bin
+
+ 2) jdk-6u26-linux-i586.bin
+
+ 3) jce_policy-6.zip
+
+
+How to run Ambari
+
++--
+$ sudo service ambari start
++--
+
+ Now that Ambari server is installed and started, you can start installing Apache Hadoop and its ecosystem components on your cluster nodes by visiting:
+
+ http://AMBARIMASTER/hmc/html/
+
+ from your browser.
+
+
+Notes for Developers
+
+ If you have made any changes to Nagios or Ganglia addons code (mon_dashboard/src/addOns/[ganglia|nagios]), you will also have to install
+ hdp_mon_ganglia_addons-0.0.2.14-1.noarch.rpm and hdp_mon_nagios_addons-0.0.2.14-1.noarch.rpm on the hosts running
+ Ganglia and Nagios server, respectively, to make your changes effective.
+ After your Hadoop cluster is installed using Ambari, go to the host(s) running Nagios and Ganglia server,
+ remove these pre-installed addon RPMs for Nagios and Ganglia, and install the new ones built from the source.
+ To build these RPMs from the source, run:
+
++--
+$ cd mon_dashboard/package/rpm
+$ ./create_ganglia_addon_rpm.sh
+$ ./create_nagios_addon_rpm.sh
++--
+
+ Running the above creates the following two RPMs:
+
+ * mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_ganglia_addons-0.0.2.14-1.noarch.rpm
+
+ * mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_nagios_addons-0.0.2.14-1.noarch.rpm
Added: incubator/ambari/trunk/docs/src/site/apt/privacy-policy.apt
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/docs/src/site/apt/privacy-policy.apt?rev=1421699&view=auto
==============================================================================
--- incubator/ambari/trunk/docs/src/site/apt/privacy-policy.apt (added)
+++ incubator/ambari/trunk/docs/src/site/apt/privacy-policy.apt Fri Dec 14 07:17:42 2012
@@ -0,0 +1,55 @@
+ ----
+ Privacy Policy
+ -----
+ Olivier Lamy
+ -----
+ 2012-06-18
+ -----
+
+~~ 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.
+
+~~ NOTE: For help with the syntax of this file, see:
+~~ http://maven.apache.org/doxia/references/apt-format.html
+
+Privacy Policy
+
+ Information about your use of this website is collected using server access logs and a tracking cookie. The
+ collected information consists of the following:
+
+ [[1]] The IP address from which you access the website;
+
+ [[2]] The type of browser and operating system you use to access our site;
+
+ [[3]] The date and time you access our site;
+
+ [[4]] The pages you visit; and
+
+ [[5]] The addresses of pages from where you followed a link to our site.
+
+ []
+
+ Part of this information is gathered using a tracking cookie set by the
+ {{{http://www.google.com/analytics/}Google Analytics}} service and handled by Google as described in their
+ {{{http://www.google.com/privacy.html}privacy policy}}. See your browser documentation for instructions on how to
+ disable the cookie if you prefer not to share this data with Google.
+
+ We use the gathered information to help us make our site more useful to visitors and to better understand how and
+ when our site is used. We do not track or collect personally identifiable information or associate gathered data
+ with any personally identifying information from other sources.
+
+ By using this website, you consent to the collection of this data in the manner and for the purpose described above.
\ No newline at end of file
Added: incubator/ambari/trunk/docs/src/site/apt/whats-new.apt
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/docs/src/site/apt/whats-new.apt?rev=1421699&view=auto
==============================================================================
--- incubator/ambari/trunk/docs/src/site/apt/whats-new.apt (added)
+++ incubator/ambari/trunk/docs/src/site/apt/whats-new.apt Fri Dec 14 07:17:42 2012
@@ -0,0 +1,60 @@
+~~ 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.
+~~
+
+What's New?
+
+ Thereâs a lot of activity occurring in trunk. Weâve had a great response from the
+ community and received a lot of input into the direction. To date, we have added
+ many new features. To highlight a few...
+
+ * Added more options on provisioning so you can better target your cluster
+ setup for your needs
+
+ * More service controls, including the ability to run ad hoc smoke tests
+
+ * Exposed a RESTful API for cluster metrics (with management and
+ provisioning to follow)
+
+ * Moved to a JavaScript front-end for Ambari Web and refreshed the entire UI
+ experience
+
+ * Used that RESTful API and added more charts and heatmaps to the dashboard
+
+ * Reduced the number of dependencies on the Ambari Server + Ambari Agent
+
+ * Added support for SLES 11
+
+Getting Ambari Source
+
+ The source can be checked out anonymously from SVN with the following command:
+
++--
+$ svn checkout http://svn.apache.org/repos/asf/incubator/ambari/trunk ambari
++--
+
+JIRA
+
+ You can follow all the work going on by watching the Ambari JIRA project. We
+ anticipate the next release of Apache Ambari to be version 1.2.0. You can see the
+ JIRA details for this release here:
+
+ {{{https://issues.apache.org/jira/issues/?jql=fixVersion%20%3D%20%221.2.0%22%20AND%20project%20%3D%20AMBARI} https://issues.apache.org/jira/issues/?jql=fixVersion%20%3D%20%221.2.0%22%20AND%20project%20%3D%20AMBARI}}
+
+Stay Tuned
+
+ {{{http://incubator.apache.org/ambari/mail-lists.html} Subscribe to the Ambari mailing lists}} and check back here often to learn about our
+ upcoming releases.
+
Added: incubator/ambari/trunk/docs/src/site/resources/images/apache-ambari-project.png
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/docs/src/site/resources/images/apache-ambari-project.png?rev=1421699&view=auto
==============================================================================
Binary file - no diff available.
Propchange: incubator/ambari/trunk/docs/src/site/resources/images/apache-ambari-project.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/ambari/trunk/docs/src/site/site.xml
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/docs/src/site/site.xml?rev=1421699&view=auto
==============================================================================
--- incubator/ambari/trunk/docs/src/site/site.xml (added)
+++ incubator/ambari/trunk/docs/src/site/site.xml Fri Dec 14 07:17:42 2012
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+ 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.
+-->
+
+<project xmlns="http://maven.apache.org/DECORATION/1.3.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/DECORATION/1.3.0 http://maven.apache.org/xsd/decoration-1.3.0.xsd"
+ name="Ambari">
+ <skin>
+ <groupId>org.apache.maven.skins</groupId>
+ <artifactId>maven-fluido-skin</artifactId>
+ <version>1.3.0</version>
+ </skin>
+ <custom>
+ <fluidoSkin>
+ <topBarEnabled>true</topBarEnabled>
+ <sideBarEnabled>false</sideBarEnabled>
+ </fluidoSkin>
+ </custom>
+ <bannerLeft>
+ <name>Ambari</name>
+ <src>http://incubator.apache.org/ambari/images/apache-ambari-project.png</src>
+ <href>http://incubator.apache.org/ambari</href>
+ </bannerLeft>
+
+ <publishDate position="right"/>
+ <version position="right"/>
+
+ <body>
+ <head>
+ <!-- Start of Google analytics -->
+ <script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-27188762-1']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script');
+ ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ?
+ 'https://ssl' : 'http://www') +
+ '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0];
+ s.parentNode.insertBefore(ga, s);
+ })();
+ </script>
+ <!-- End of Google analytics -->
+ </head>
+
+ <links>
+ <item name="JIRA" href="https://issues.apache.org/jira/browse/AMBARI" />
+ <item name="SVN" href="https://svn.apache.org/repos/asf/incubator/ambari/" />
+ <item name="WIKI" href="https://cwiki.apache.org/confluence/display/AMBARI/Ambari" />
+ </links>
+
+ <breadcrumbs>
+ <item name="Ambari" href="index.html"/>
+ </breadcrumbs>
+
+ <menu name="Ambari">
+ <item name="What's New?" href="whats-new.html"/>
+ <item name="About" href="index.html"/>
+ <item name="Wiki" href="https://cwiki.apache.org/confluence/display/AMBARI/Ambari"/>
+ <item name="Project Team" href="team-list.html"/>
+ <item name="Mailing Lists" href="mail-lists.html"/>
+ <item name="Issue Tracking" href="issue-tracking.html"/>
+ <item name="Project License" href="license.html"/>
+ </menu>
+
+ <menu name="Releases">
+ <item name="0.9 (stable)" href="http://www.apache.org/dist/incubator/ambari/ambari-0.9-incubating/"/>
+ <item name="1.2.0 (coming soon)" href="whats-new.html"/>
+ </menu>
+
+ <menu name="Documentation">
+ <item name="Install Guide for 0.9 (stable)" href="install-0.9.html"/>
+ </menu>
+
+ <footer>
+ <div class="row span12">
+ Apache Ambari, Apache, the Apache feather logo, and the Apache Ambari project logos are trademarks
+ of The Apache Software Foundation.
+ All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+ </div>
+ <div class="row span12">
+ <a href="${project.url}/privacy-policy.html">Privacy Policy</a>
+ </div>
+ </footer>
+
+ </body>
+</project>