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/06/28 01:01:51 UTC
svn commit: r1354769 - in /incubator/ambari: site/install.html
trunk/CHANGES.txt trunk/pom.xml trunk/src/site/apt/install.apt
Author: yusaku
Date: Wed Jun 27 23:01:50 2012
New Revision: 1354769
URL: http://svn.apache.org/viewvc?rev=1354769&view=rev
Log:
AMBARI-582. Update the installation guide: monitoring dashboard install instructions (Contributed by yusaku)
Modified:
incubator/ambari/site/install.html
incubator/ambari/trunk/CHANGES.txt
incubator/ambari/trunk/pom.xml
incubator/ambari/trunk/src/site/apt/install.apt
Modified: incubator/ambari/site/install.html
URL: http://svn.apache.org/viewvc/incubator/ambari/site/install.html?rev=1354769&r1=1354768&r2=1354769&view=diff
==============================================================================
--- incubator/ambari/site/install.html (original)
+++ incubator/ambari/site/install.html Wed Jun 27 23:01:50 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 Jun 27, 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="20120627" />
+
<meta http-equiv="Content-Language" content="en" />
+
<script type="text/javascript">var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-27188762-1']);
@@ -26,92 +40,174 @@
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-06-27</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">
+
<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">
+
<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
-$ ./create_hmc_rpm.sh</pre></div><p>When this succeeds, you will find two RPMs inside the build directory package/rpm/build/rpmbuild/RPMS/noarch/:</p><p>1) ambari-1.0.0-1.noarch.rpm</p><p>2) ambari-agent-1.0.0-1.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 Ambari 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:</p><div class="source"><pre>
+$ ./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:</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 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:</p><div class="source"><pre>$ sudo yum install pdsh
+$ 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:</p><div class="source"><pre>$ sudo rpm -iv ambari-1.0.0-1.noarch.rpm </pre></div><p>Hadoop requires JDK. You can download it from the Oracle website: <a class="externalLink" href="http://download.oracle.com/otn-pub/java/jdk/6u26-b03"> http://download.oracle.com/otn-pub/java/jdk/6u26-b03</a> The following two files need to be copied to /var/run/hmc/downloads/ on the Ambari master:</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 cluster nodes by visiting:</p><p>http://AMBARIMASTER/hmc/html/</p><p>from your browser. </p></div>
+$ 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
+$ ./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/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/CHANGES.txt?rev=1354769&r1=1354768&r2=1354769&view=diff
==============================================================================
--- incubator/ambari/trunk/CHANGES.txt (original)
+++ incubator/ambari/trunk/CHANGES.txt Wed Jun 27 23:01:50 2012
@@ -6,6 +6,9 @@ characters wide.
Release 1.0.0 - unreleased
+ AMBARI-582. Update the installation guide - monitoring dashboard install
+ instructions (yusaku)
+
AMBARI-569. Nagios install fails on RHEL6 due to php-pecl-json dep (hitesh)
AMBARI-546. Puppet fails to install 32-bit JDK properly on RHEL6 (hitesh)
Modified: incubator/ambari/trunk/pom.xml
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/pom.xml?rev=1354769&r1=1354768&r2=1354769&view=diff
==============================================================================
--- incubator/ambari/trunk/pom.xml (original)
+++ incubator/ambari/trunk/pom.xml Wed Jun 27 23:01:50 2012
@@ -302,7 +302,7 @@
<artifactId>maven-site-plugin</artifactId>
<version>3.0</version>
<configuration>
- <outputDirectory>../site</outputDirectory>
+ <outputDirectory>./target</outputDirectory>
</configuration>
</plugin>
</plugins>
Modified: incubator/ambari/trunk/src/site/apt/install.apt
URL: http://svn.apache.org/viewvc/incubator/ambari/trunk/src/site/apt/install.apt?rev=1354769&r1=1354768&r2=1354769&view=diff
==============================================================================
--- incubator/ambari/trunk/src/site/apt/install.apt (original)
+++ incubator/ambari/trunk/src/site/apt/install.apt Wed Jun 27 23:01:50 2012
@@ -28,8 +28,6 @@ $ ./create_hmc_rpm.sh
$ cd mon_dashboard/package/rpm
$ ./create_dashboard_rpm.sh
-$ ./create_ganglia_addon_rpm.sh
-$ ./create_nagios_addon_rpm.sh
+--
When this succeeds, you will find following RPMs inside the ambari directory:
@@ -40,10 +38,6 @@ $ ./create_nagios_addon_rpm.sh
3) mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_dashboard-0.0.1-2.noarch.rpm
- 4) mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_ganglia_addons-0.0.1-2.noarch.rpm
-
- 5) mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_nagios_addons-0.0.1-2.noarch.rpm
-
Steps to run before you use Ambari to install Hadoop on your cluster
@@ -124,19 +118,13 @@ $ sudo yum install puppet-2.7.9
$ sudo yum install ruby-devel
+--
- To install Ambari and Monitoring Dashboard RPMs on Ambari master:
+ To install Ambari on Ambari master:
+--
$ sudo rpm -iv ambari-1.0.0-1.noarch.rpm
$ sudo rpm -iv hdp_mon_dashboard-0.0.1-2.noarch.rpm
+--
- Note: if you have made any changes to Nagios or Ganglia addons code, you will also have to install the
- hdp_mon_ganglia_addons-0.0.1-2.noarch.rpm and hdp_mon_nagios_addons-0.0.1-2.noarch.rpm on the
- Ganglia and Nagios server respectively. After Hadoop is installed using Ambari, go to Nagios and Ganglia server,
- remove these preinstalled addon RPMs for ganglia and nagios and install the new ones built from the source (See,
- "How to build Ambari" section).
-
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
@@ -159,3 +147,26 @@ $ sudo service ambari start
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.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:
+
++--
+$ 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.1-2.noarch.rpm
+
+ * mon_dashboard/package/rpm/build/rpmbuild/RPMS/noarch/hdp_mon_nagios_addons-0.0.1-2.noarch.rpm
+
\ No newline at end of file