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/08/25 04:34:32 UTC
svn commit: r1377184 - in /incubator/ambari/site: index.html
install-0.9.html install.html
Author: yusaku
Date: Sat Aug 25 02:34:31 2012
New Revision: 1377184
URL: http://svn.apache.org/viewvc?rev=1377184&view=rev
Log:
AMBARI-686. Update documentation for RHEL/CentOS 6 install steps and a more streamlined procedure in general (Contributed by yusaku)
Added:
incubator/ambari/site/install-0.9.html
Modified:
incubator/ambari/site/index.html
incubator/ambari/site/install.html
Modified: incubator/ambari/site/index.html
URL: http://svn.apache.org/viewvc/incubator/ambari/site/index.html?rev=1377184&r1=1377183&r2=1377184&view=diff
==============================================================================
--- incubator/ambari/site/index.html (original)
+++ incubator/ambari/site/index.html Sat Aug 25 02:34:31 2012
@@ -1,17 +1,31 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia at Jun 20, 2012 -->
+
+<!-- Generated by Apache Maven Doxia at Aug 24, 2012 -->
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
<head>
+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
<title></title>
+
<style type="text/css" media="all">
+
@import url("./css/maven-base.css");
+
@import url("./css/maven-theme.css");
+
@import url("./css/site.css");
+
</style>
+
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20120620" />
+
+ <meta name="Date-Revision-yyyymmdd" content="20120824" />
+
<meta http-equiv="Content-Language" content="en" />
+
<script type="text/javascript">var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-27188762-1']);
@@ -26,78 +40,154 @@
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
})();</script>
+
+
</head>
+
<body class="composite">
+
<div id="banner">
+
<a href="./" id="bannerLeft">
+
<img src="images/apache-ambari-project.png" alt="Ambari" />
+
</a>
+
<div class="clear">
+
<hr/>
+
</div>
+
</div>
+
<div id="breadcrumbs">
+
+
+
<div class="xleft">
- <span id="publishDate">Last Published: 2012-06-20</span>
+
+ <span id="publishDate">Last Published: 2012-08-24</span>
+
| <span id="projectVersion">Version: 1.0.0-SNAPSHOT</span>
+
</div>
+
<div class="xright"> <a href="https://issues.apache.org/jira/browse/AMBARI" class="externalLink" title="JIRA">JIRA</a>
+
|
+
<a href="https://svn.apache.org/repos/asf/incubator/ambari/" class="externalLink" title="SVN">SVN</a>
+
+
+
</div>
+
<div class="clear">
+
<hr/>
+
</div>
+
</div>
+
<div id="leftColumn">
+
<div id="navcolumn">
+
+
+
<h5>Ambari</h5>
+
<ul>
+
<li class="none">
+
<strong>About</strong>
+
</li>
+
<li class="none">
+
<a href="install.html" title="Installation Guide">Installation Guide</a>
+
</li>
+
</ul>
+
<h5>Project Documentation</h5>
+
<ul>
+
<li class="collapsed">
+
<a href="project-info.html" title="Project Information">Project Information</a>
+
</li>
+
</ul>
+
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+
<img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+
</a>
+
+
+
</div>
+
</div>
+
<div id="bodyColumn">
+
<div id="contentBox">
- <!-- 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. --><!-- --><div class="section"><h2>Introduction<a name="Introduction"></a></h2><p>Apache Ambari is a web-based tool for
installing, managing, and monitoring Apache Hadoop clusters. The set of Hadoop components that are currently supported by Ambari includes:</p><ul><li><a class="externalLink" href="http://hbase.apache.org"> Apache HBase</a></li><li><a class="externalLink" href="http://incubator.apache.org/hcatalog"> Apache HCatalog</a></li><li><a class="externalLink" href="http://hadoop.apache.org/hdfs"> Apache Hadoop HDFS</a></li><li><a class="externalLink" href="http://hive.apache.org"> Apache Hive</a></li><li><a class="externalLink" href="http://hadoop.apache.org/mapreduce"> Apache Hadoop MapReduce</a></li><li><a class="externalLink" href="http://incubator.apache.org/oozie/"> Apache Oozie</a></li><li><a class="externalLink" href="http://pig.apache.org"> Apache Pig</a></li><li><a class="externalLink" href="http://sqoop.apache.org"> Apache Sqoop</a></li><li><a class="externalLink" href="http://people.apache.org/~thejas/templeton_doc_latest/index.html"> Apache Templeton</a></li><li><a class=
"externalLink" href="http://zookeeper.apache.org"> Apache Zookeeper</a></li></ul><p>Ambari's primary audience is system administrators responsible for managing Hadoop clusters.</p><p>Ambari allows them to:</p><ul><li>Easily Install a Hadoop Cluster <ul><li>Ambari provides an easy-to-use, step-by-step wizard for installing Hadoop services across any number of nodes.</li><li>Ambari leverages <a class="externalLink" href="http://puppetlabs.com/"> Puppet</a> to perform installation and configuration of Hadoop services for the cluster. </li></ul></li></ul><ul><li>Manage a Hadoop Cluster<ul><li>Ambari provides central management for starting, stopping, and reconfiguring Hadoop services across the entire cluster.</li></ul></li></ul><ul><li>Monitor a Hadoop Cluster<ul><li>Ambari provides a dashboard for monitoring health and status of the Hadoop cluster. Ambari leverages <a class="externalLink" href="http://ganglia.sourceforge.net/"> Ganglia</a> to render graphs.</li><li>Ambari send
s email alerts when your attention is needed (e.g., a node goes down, remaining disk space is low, etc). Ambari leverages <a class="externalLink" href="http://www.nagios.org/"> Nagios</a> to monitor and trigger alerts.</li></ul></li></ul><p>In the future, Ambari will allow third-party tool developers to integrate Hadoop cluster management and monitoring capabilities via its RESTful interface. </p></div><div class="section"><h2>Ambari Installation<a name="Ambari_Installation"></a></h2><p>Follow the <a href="./install.html"> installation guide</a>.</p></div><div class="section"><h2>Roadmap<a name="Roadmap"></a></h2><ul><li>Support for Hadoop Security</li></ul><ul><li>Support for various operating systems<ul><li>Ambari currently supports:<ul><li>64-bit RHEL 5.*</li><li>64-bit CentOS 5.*</li></ul></li><li>Support for RHEL/CentOS 6.* is coming soon. Contributions to support other operating systems are welcome.</li></ul></li></ul><ul><li>Support for more granular configurations<ul
><li>Ambari currently applies configurations at the cluster-level. To allow for more flexibility, Ambari needs to allow for configurations in a more granular manner (e.g., apply a set of configurations to a specific group of nodes, etc.) </li></ul></li></ul><ul><li>Interactive visualization of current and historical states of the cluster</li></ul><ul><li>RESTful API for third-party integration<ul><li>Ambari will expose a unified, RESTful API to enable third-party applications to integrate Hadoop cluster management and monitoring capabilities.</li></ul></li></ul></div>
+
+ <!-- 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. --><!-- --><div class="section"><h2>Introduction<a name="Introduction"></a></h2><p>Apache Ambari is a web-based tool for
installing, managing, and monitoring Apache Hadoop clusters. The set of Hadoop components that are currently supported by Ambari includes:</p><ul><li><a class="externalLink" href="http://hbase.apache.org"> Apache HBase</a></li><li><a class="externalLink" href="http://incubator.apache.org/hcatalog"> Apache HCatalog</a></li><li><a class="externalLink" href="http://hadoop.apache.org/hdfs"> Apache Hadoop HDFS</a></li><li><a class="externalLink" href="http://hive.apache.org"> Apache Hive</a></li><li><a class="externalLink" href="http://hadoop.apache.org/mapreduce"> Apache Hadoop MapReduce</a></li><li><a class="externalLink" href="http://incubator.apache.org/oozie/"> Apache Oozie</a></li><li><a class="externalLink" href="http://pig.apache.org"> Apache Pig</a></li><li><a class="externalLink" href="http://sqoop.apache.org"> Apache Sqoop</a></li><li><a class="externalLink" href="http://people.apache.org/~thejas/templeton_doc_latest/index.html"> Apache Templeton</a></li><li><a class=
"externalLink" href="http://zookeeper.apache.org"> Apache Zookeeper</a></li></ul><p>Ambari's primary audience is system administrators responsible for managing Hadoop clusters.</p><p>Ambari allows them to:</p><ul><li>Easily Install a Hadoop Cluster <ul><li>Ambari provides an easy-to-use, step-by-step wizard for installing Hadoop services across any number of nodes.</li><li>Ambari leverages <a class="externalLink" href="http://puppetlabs.com/"> Puppet</a> to perform installation and configuration of Hadoop services for the cluster. </li></ul></li></ul><ul><li>Manage a Hadoop Cluster<ul><li>Ambari provides central management for starting, stopping, and reconfiguring Hadoop services across the entire cluster.</li></ul></li></ul><ul><li>Monitor a Hadoop Cluster<ul><li>Ambari provides a dashboard for monitoring health and status of the Hadoop cluster. Ambari leverages <a class="externalLink" href="http://ganglia.sourceforge.net/"> Ganglia</a> to render graphs.</li><li>Ambari send
s email alerts when your attention is needed (e.g., a node goes down, remaining disk space is low, etc). Ambari leverages <a class="externalLink" href="http://www.nagios.org/"> Nagios</a> to monitor and trigger alerts.</li></ul></li></ul><p>In the future, Ambari will allow third-party tool developers to integrate Hadoop cluster management and monitoring capabilities via its RESTful interface. </p></div><div class="section"><h2>Ambari Installation<a name="Ambari_Installation"></a></h2><p>Follow the <a href="./install.html"> installation guide for trunk</a> or <a href="./install-0.9.html"> installation guide for 0.9</a>.</p></div><div class="section"><h2>Roadmap<a name="Roadmap"></a></h2><ul><li>Support for Hadoop Security</li></ul><ul><li>Support for various operating systems<ul><li>Ambari currently supports:<ul><li>64-bit RHEL 5.*</li><li>64-bit CentOS 5.*</li></ul></li><li>Support for RHEL/CentOS 6.* is coming soon. Contributions to support other operating systems are welco
me.</li></ul></li></ul><ul><li>Support for more granular configurations<ul><li>Ambari currently applies configurations at the cluster-level. To allow for more flexibility, Ambari needs to allow for configurations in a more granular manner (e.g., apply a set of configurations to a specific group of nodes, etc.) </li></ul></li></ul><ul><li>Interactive visualization of current and historical states of the cluster</li></ul><ul><li>RESTful API for third-party integration<ul><li>Ambari will expose a unified, RESTful API to enable third-party applications to integrate Hadoop cluster management and monitoring capabilities.</li></ul></li></ul></div>
+
</div>
+
</div>
+
<div class="clear">
+
<hr/>
+
</div>
+
<div id="footer">
+
<div class="xright">
+
Copyright © 2012
+
<a href="http://www.apache.org/">Apache Software Foundation</a>.
+
All Rights Reserved.
+
+
</div>
+
<div class="clear">
+
<hr/>
+
</div>
+
</div>
+
</body>
+
</html>
+
Added: incubator/ambari/site/install-0.9.html
URL: http://svn.apache.org/viewvc/incubator/ambari/site/install-0.9.html?rev=1377184&view=auto
==============================================================================
--- incubator/ambari/site/install-0.9.html (added)
+++ incubator/ambari/site/install-0.9.html Sat Aug 25 02:34:31 2012
@@ -0,0 +1,211 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<!-- Generated by Apache Maven Doxia at Aug 24, 2012 -->
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+
+ <head>
+
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+ <title></title>
+
+ <style type="text/css" media="all">
+
+ @import url("./css/maven-base.css");
+
+ @import url("./css/maven-theme.css");
+
+ @import url("./css/site.css");
+
+ </style>
+
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+
+ <meta name="Date-Revision-yyyymmdd" content="20120824" />
+
+ <meta http-equiv="Content-Language" content="en" />
+
+
+<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>
+
+
+
+ </head>
+
+ <body class="composite">
+
+ <div id="banner">
+
+ <a href="./" id="bannerLeft">
+
+ <img src="images/apache-ambari-project.png" alt="Ambari" />
+
+ </a>
+
+ <div class="clear">
+
+ <hr/>
+
+ </div>
+
+ </div>
+
+ <div id="breadcrumbs">
+
+
+
+
+
+ <div class="xleft">
+
+ <span id="publishDate">Last Published: 2012-08-24</span>
+
+ | <span id="projectVersion">Version: 0.9.0</span>
+
+ </div>
+
+ <div class="xright"> <a href="https://issues.apache.org/jira/browse/AMBARI" class="externalLink" title="JIRA">JIRA</a>
+
+ |
+
+ <a href="https://svn.apache.org/repos/asf/incubator/ambari/" class="externalLink" title="SVN">SVN</a>
+
+
+
+
+
+ </div>
+
+ <div class="clear">
+
+ <hr/>
+
+ </div>
+
+ </div>
+
+ <div id="leftColumn">
+
+ <div id="navcolumn">
+
+
+
+
+
+ <h5>Ambari</h5>
+
+ <ul>
+
+ <li class="none">
+
+ <a href="index.html" title="About">About</a>
+
+ </li>
+
+ <li class="none">
+
+ <strong>Installation Guide</strong>
+
+ </li>
+
+ </ul>
+
+ <h5>Project Documentation</h5>
+
+ <ul>
+
+ <li class="collapsed">
+
+ <a href="project-info.html" title="Project Information">Project Information</a>
+
+ </li>
+
+ </ul>
+
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+
+ <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+
+ </a>
+
+
+
+
+
+ </div>
+
+ </div>
+
+ <div id="bodyColumn">
+
+ <div id="contentBox">
+
+ <!-- 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. --><div class="section"><h2>Supported Operating Systems<a name="Supported_Operating_Systems"></a></h2><ul><li>Ambari currently supports:<ul><li>RHEL/CentOS 5.*, 64-bit version</li><li>RHEL/CentOS 6.*, 64-bit version</li></ul></li></ul></div><div class="section"><h2>Getting Ambari<a name="Getting_Ambari"></a></h2><p>The source can be checked ou
t anonymously from SVN with the following command:</p><div class="source"><pre>$ svn checkout http://svn.apache.org/repos/asf/incubator/ambari/branches/branch-0.9 ambari</pre></div></div><div class="section"><h2>How to build Ambari<a name="How_to_build_Ambari"></a></h2><p>You need to build Ambari RPMs from the source code that you checked out:</p><div class="source"><pre>$ yum install rpm-build
+$ cd ambari/hmc/package/rpm
+$ ./create_hmc_rpm.sh
+
+$ cd ambari/mon_dashboard/package/rpm
+$ ./create_dashboard_rpm.sh</pre></div><p>When this succeeds, you will find following RPMs inside the ambari directory:</p><p>1) ambari/hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-0.9.0-1[.el6].noarch.rpm</p><p>2) ambari/hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-agent-0.9.0-1[.el6].noarch.rpm</p><p>3) ambari/mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_dashboard-0.0.1-2.noarch.rpm</p></div><div class="section"><h2>Installing Ambari<a name="Installing_Ambari"></a></h2><p>We will refer to the node running the Ambari server as <i>Ambari master</i> and the nodes to which Hadoop services will be installed as <i>cluster nodes</i>.</p><p>1) Set up password-less SSH for root on all your cluster nodes.</p><ul><li>Copy root's SSH public key to all the cluster nodes in the .ssh/authorized_keys file.</li><li>Save the corresponding SSH private key file locally. You will be prompted by Ambari UI to upload it during cluster installation.</li></ul><p>2) Install
ambari-agent on each of the cluster nodes.</p><ul><li>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.<p>On RHEL/CentOS 5:</p><div class="source"><pre>$ 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</pre></div><p>On RHEL/CentOS 6:</p><div class="source"><pre>$ 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</pre></div></li></ul><p>3) Stop iptables on Ambari master:</p><ul><li>Run the following command on the Ambari master:<div class="source"><pre>$ sudo service iptables stop</pre></div></li></ul><p>4) Install Ambari server on Ambari master:</p><ul><li>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.<p>On RHEL/CentOS 5:</p><div class="source"><pre>$ 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.1-2.noarch.rpm --nogpgcheck</pre></div><p>On RHEL/CentOS 6:</p><div class="source"><pre>$ 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.1-2.noarch.rpm</pre></div></li><li>Hadoop requires JDK. You can download following files from the Oracle website: <a class="externalLink" href="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</a> 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)<p>1) jdk-6u26-linux-x64.bin</p><p>2) jdk-6u26-linux-i586.bin</p></li></ul></div><div class="section"><h2>How to run Ambari<a name="How_to_run_Ambari"></a></h2><div class="source"><pre>$ sudo service ambari start</pre></div><p>Now that Ambari server is installed and started, you can start installing Apache Hadoop and its ecosystem compone
nts on your cluster nodes by visiting:</p><p>http://AMBARIMASTER/hmc/html/</p><p>from your browser. </p></div><div class="section"><h2>Notes for Developers<a name="Notes_for_Developers"></a></h2><p>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.1-2.noarch.rpm and hdp_mon_nagios_addons-0.0.1-2.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:</p><div class="source"><pre>$ cd mon_dashboard/package/rpm
+$ ./create_ganglia_addon_rpm.sh
+$ ./create_nagios_addon_rpm.sh</pre></div><p>Running the above creates the following two RPMs:</p><ul><li>mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_ganglia_addons-0.0.1-2.noarch.rpm</li><li>mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_nagios_addons-0.0.1-2.noarch.rpm</li></ul></div>
+
+ </div>
+
+ </div>
+
+ <div class="clear">
+
+ <hr/>
+
+ </div>
+
+ <div id="footer">
+
+ <div class="xright">
+
+ Copyright © 2012
+
+ <a href="http://www.apache.org/">Apache Software Foundation</a>.
+
+ All Rights Reserved.
+
+
+
+ </div>
+
+ <div class="clear">
+
+ <hr/>
+
+ </div>
+
+ </div>
+
+ </body>
+
+</html>
+
Modified: incubator/ambari/site/install.html
URL: http://svn.apache.org/viewvc/incubator/ambari/site/install.html?rev=1377184&r1=1377183&r2=1377184&view=diff
==============================================================================
--- incubator/ambari/site/install.html (original)
+++ incubator/ambari/site/install.html Sat Aug 25 02:34:31 2012
@@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia at Jun 27, 2012 -->
+<!-- Generated by Apache Maven Doxia at Aug 24, 2012 -->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -22,7 +22,7 @@
<link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20120627" />
+ <meta name="Date-Revision-yyyymmdd" content="20120824" />
<meta http-equiv="Content-Language" content="en" />
@@ -71,7 +71,7 @@
<div class="xleft">
- <span id="publishDate">Last Published: 2012-06-27</span>
+ <span id="publishDate">Last Published: 2012-08-24</span>
| <span id="projectVersion">Version: 1.0.0-SNAPSHOT</span>
@@ -153,25 +153,23 @@
<div id="contentBox">
- <div class="section"><h2>Supported Operating Systems<a name="Supported_Operating_Systems"></a></h2><ul><li>Ambari currently supports:<ul><li>64-bit RHEL 5.*</li><li>64-bit CentOS 5.*</li></ul><p>RHEL/CentOS 6.* support is coming shortly.</p></li></ul></div><div class="section"><h2>Getting Ambari<a name="Getting_Ambari"></a></h2><p>The source can be checked out anonymously from SVN with this command:</p><div class="source"><pre>$ svn checkout http://svn.apache.org/repos/asf/incubator/ambari/trunk ambari</pre></div></div><div class="section"><h2>How to build Ambari<a name="How_to_build_Ambari"></a></h2><p>You need to build Ambari RPMs from the source code that you checked out:</p><div class="source"><pre>$ yum install rpm-build
-$ cd hmc/package/rpm
+ <!-- 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. --><div class="section"><h2>Supported Operating Systems<a name="Supported_Operating_Systems"></a></h2><ul><li>Ambari currently supports:<ul><li>RHEL/CentOS 5.*, 64-bit version</li><li>RHEL/CentOS 6.*, 64-bit version</li></ul></li></ul></div><div class="section"><h2>Getting Ambari<a name="Getting_Ambari"></a></h2><p>The source can be checked ou
t anonymously from SVN with the following command:</p><div class="source"><pre>$ svn checkout http://svn.apache.org/repos/asf/incubator/ambari/trunk ambari</pre></div></div><div class="section"><h2>How to build Ambari<a name="How_to_build_Ambari"></a></h2><p>You need to build Ambari RPMs from the source code that you checked out:</p><div class="source"><pre>$ yum install rpm-build
+$ cd ambari/hmc/package/rpm
$ ./create_hmc_rpm.sh
-$ cd mon_dashboard/package/rpm
-$ ./create_dashboard_rpm.sh</pre></div><p>When this succeeds, you will find following RPMs inside the ambari directory:</p><p>1) hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-1.0.0-1.noarch.rpm</p><p>2) hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-agent-1.0.0-1.noarch.rpm</p><p>3) mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_dashboard-0.0.1-2.noarch.rpm</p></div><div class="section"><h2>Steps to run before you use Ambari to install Hadoop on your cluster<a name="Steps_to_run_before_you_use_Ambari_to_install_Hadoop_on_your_cluster"></a></h2><p>We will refer to the node running the Ambari server as <i>Ambari master</i> and the nodes to which Hadoop services will be installed as <i>cluster nodes</i>.</p><p>1) Set up password-less SSH for root on all your cluster nodes.</p><ul><li>Copy root's SSH public key to all the cluster nodes in the <i>authorized_keys</i> file.</li><li>Save the corresponding SSH private key file locally. You will be prompted by Amb
ari UI to upload it during cluster installation.</li></ul><p>2) Install ambari-agent-1.0.0-1.noarch.rpm on each of the cluster nodes by running:</p><div class="source"><pre>$ sudo rpm -Uvh ambari-agent-1.0.0-1.noarch.rpm</pre></div><p>3) Stop iptables on the Ambari master:</p><div class="source"><pre>$ sudo service iptables stop</pre></div></div><div class="section"><h2>How to install Ambari<a name="How_to_install_Ambari"></a></h2><p>Ambari has several external runtime dependencies. Major dependencies are:</p><p>1) puppet</p><p>2) php</p><p>3) ruby</p><p>To simplify the installation of the dependencies, you should enable the following yum repos. To do that, you can simply install the corresponding RPMs.</p><p>1) EPEL repo</p><p>2) Puppet Passenger</p><p>3) Hadoop repo</p><p>You should run the following at the command line on Ambari master:</p><div class="source"><pre>
-$ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/x86_64/epel-release-5-4.noarch.rpm
-OR
-$ sudo rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm
-
-$ sudo rpm -Uvh http://passenger.stealthymonkeys.com/rhel/5/passenger-release.noarch.rpm
-$ sudo rpm -Uvh http://public-repo-1.hortonworks.com/HDP-1.0.13/repos/centos5/hdp-release-1.0.13-1.el5.noarch.rpm</pre></div><p>To install necessary PHP modules on Ambari master:</p><div class="source"><pre>$ sudo yum install php-pecl-json # version 1.2.1 compatible with php-5.1 or php-5.2
-$ sudo yum install php-pdo
-$ php -m | grep posix</pre></div><p>If the posix module is not found, run:</p><div class="source"><pre>$ sudo yum install php-process</pre></div><p>Depending on which packages you have already installed, you may need to run following on Ambari master:</p><div class="source"><pre>$ sudo yum install pdsh
-$ sudo yum install httpd-devel
-$ sudo yum install mod_passenger
-$ sudo yum install puppet-2.7.9
-$ sudo yum install ruby-devel</pre></div><p>To install Ambari on Ambari master:</p><div class="source"><pre>$ sudo rpm -iv ambari-1.0.0-1.noarch.rpm
-$ sudo rpm -iv hdp_mon_dashboard-0.0.1-2.noarch.rpm</pre></div><p>Hadoop requires JDK. You can download following files from the Oracle website: <a class="externalLink" href="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</a> 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)</p><p>1) jdk-6u26-linux-x64.bin</p><p>2) jdk-6u26-linux-i586.bin</p></div><div class="section"><h2>How to run Ambari<a name="How_to_run_Ambari"></a></h2><div class="source"><pre>$ sudo service ambari start</pre></div><p>Now that Ambari server is installed and started, you can start installing Apache Hadoop and its ecosystem components on your clus
ter nodes by visiting:</p><p>http://AMBARIMASTER/hmc/html/</p><p>from your browser. </p></div><div class="section"><h2>Notes for Developers<a name="Notes_for_Developers"></a></h2><p>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.1-2.noarch.rpm and hdp_mon_nagios_addons-0.0.1-2.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:</p><div class="source"><pre>$ cd mon_dashboard/package/rpm
+$ cd ambari/mon_dashboard/package/rpm
+$ ./create_dashboard_rpm.sh</pre></div><p>When this succeeds, you will find following RPMs inside the ambari directory:</p><p>1) ambari/hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-1.0.0-1[.el6].noarch.rpm</p><p>2) ambari/hmc/package/rpm/build/rpmbuild/RPMS/noarch/ambari-agent-1.0.0-1[.el6].noarch.rpm</p><p>3) ambari/mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_dashboard-0.0.1-2.noarch.rpm</p></div><div class="section"><h2>Installing Ambari<a name="Installing_Ambari"></a></h2><p>We will refer to the node running the Ambari server as <i>Ambari master</i> and the nodes to which Hadoop services will be installed as <i>cluster nodes</i>.</p><p>1) Set up password-less SSH for root on all your cluster nodes.</p><ul><li>Copy root's SSH public key to all the cluster nodes in the .ssh/authorized_keys file.</li><li>Save the corresponding SSH private key file locally. You will be prompted by Ambari UI to upload it during cluster installation.</li></ul><p>2) Install
ambari-agent on each of the cluster nodes.</p><ul><li>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.<p>On RHEL/CentOS 5:</p><div class="source"><pre>$ 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</pre></div><p>On RHEL/CentOS 6:</p><div class="source"><pre>$ 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</pre></div></li></ul><p>3) Stop iptables on Ambari master:</p><ul><li>Run the following command on the Ambari master:<div class="source"><pre>$ sudo service iptables stop</pre></div></li></ul><p>4) Install Ambari server on Ambari master:</p><ul><li>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.<p>On RHEL/CentOS 5:</p><div class="source"><pre>$ 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.1-2.noarch.rpm --nogpgcheck</pre></div><p>On RHEL/CentOS 6:</p><div class="source"><pre>$ 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.1-2.noarch.rpm</pre></div></li><li>Hadoop requires JDK. You can download the JDK files from the Oracle website: <a class="externalLink" href="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</a> 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 <a class="externalLink" href="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</a><p>1) jdk-6u26-linux-x64.bin</p><p>2) jdk-6u26-linux-i586.bin</p><p>3) jce_policy-6.jar</p></li></ul></div><div class="section"><h2>How to run Ambari<a name="How_to_run_Ambari"></a></h2><div class="source"><pre>$ sudo service ambari start</pre></div><p>Now that Ambari server is installed and started, you can start installing Apache Hadoop and its ecosystem components on your cluster nodes by visiting:</p><p>http://AMBARIMASTER/hmc/html/</p><p>from your browser.</p></div><div class="section"><h2>Notes for Developers<a name="Notes_for_Developers"></a></h2><p>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.1-2.noarch.rpm and hdp_mon_nagios_addons-0.0.1-2.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 Nagio
s 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:</p><div class="source"><pre>$ cd mon_dashboard/package/rpm
$ ./create_ganglia_addon_rpm.sh
$ ./create_nagios_addon_rpm.sh</pre></div><p>Running the above creates the following two RPMs:</p><ul><li>mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_ganglia_addons-0.0.1-2.noarch.rpm</li><li>mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_nagios_addons-0.0.1-2.noarch.rpm</li></ul></div>