incubator-ambari-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From yus...@apache.org
Subject svn commit: r1354769 - in /incubator/ambari: site/install.html trunk/CHANGES.txt trunk/pom.xml trunk/src/site/apt/install.apt
Date Wed, 27 Jun 2012 23:01:51 GMT
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>
+
                   &nbsp;| <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 &#169;                    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



Mime
View raw message