Dear Wiki user, You have subscribed to a wiki page or wiki category on "Hadoop Wiki" for change notification.
The following page has been changed by TerenceKwan: http://wiki.apache.org/hadoop/Chukwa_Console_Integration_Guide ------------------------------------------------------------------------------ == Introduction == - This document will provide a high level overview of the Chukwa Console (aka HICC) and what it can provide to the developer. Then it will describe how to setup the Chukwa system and integrate with the Chukwa console as a management portal. It is targeted to developers who just want to use the Chukwa web UI component to display their own data set. + This document provides a high level overview of the Chukwa Console (aka HICC). Then it will describe how to setup the Chukwa HICC console and integrate the Chukwa console as a standalone management portal. It is targeted to developers who just want to use the Chukwa web UI component to display their own data set. For information about setting up the full Chukwa system, please read ["Chukwa Quick Start"]. @@ -9, +9 @@ - TBD. Describe the Pros and Cons of Chukwa Console. == Install Chukwa Console == + Chukwa HICC UI is a Java web application running on top of the Tomcat application server. Here is the steps required to get it up and running. + * Building the HICC war file (hicc.war). - * Check out the Chukwa source try from Hadoop distribution. (You can view the source as part of the Hadoop Apache SVN repository [http://svn.apache.org/viewvc/hadoop/core/trunk/src/contrib/chukwa/ here] ) + * Check out the Chukwa source code from Hadoop distribution. (You can get the source code as part of the Hadoop Apache SVN repository [http://svn.apache.org/viewvc/hadoop/core/trunk/src/contrib/chukwa/ here] ) - * Make sure you have Java and Ant installed in your system. Please read at the readme.txt file in the distribution for build information. To build the HICC component, + * Make sure you have Java JDK and Ant installed in your system. For detail installation instruction, please read the readme.txt file in the distribution. To build the HICC component alone, do the following * cd chukwa/trunk * ant - * After the build, you will find the '''hicc.war''' in the build/ directory. + * After the build, you will find the '''hicc.war''' in the chukwa/trunk/build/hicc.war. * Installation - * Install [http://tomcat.apache.org/ tomcat] on your server + * Install [http://tomcat.apache.org/ tomcat] on your server. * Download the latest tomcat * unzip the tomcat package * copy hicc.war to the '''tomcat/webapps''' directory + * start tomcat. + * tomcat/bin/catalina.sh start * setup configuration * make a directory for chukwa data and chukwa configuration. You can put it anywhere you want. For this example, I will put them in ~/ * mkdir ~/chukwa @@ -28, +32 @@ * export CHUKWA_CONF_DIR=~/chukwa/conf * mkdir ~/chukwa/data * mkdir ~/chukwa/data/descriptors - * cp webapps/hicc/descriptors/* ~/chukwa/data/descriptors + * cp tomcat/webapps/hicc/descriptors/* ~/chukwa/data/descriptors - * mkdir /tmp/chukwa/data/views + * mkdir ~/chukwa/data/views - * cp webapps/hicc/views/* ~/chukwa/data/views + * cp tomcat/webapps/hicc/views/* ~/chukwa/data/views * export CHUKWA_DATA_DIR=~/chukwa/data - * start the tomcat. + * restart the tomcat. + * tomcat/bin/catalina.sh stop * tomcat/bin/catalina.sh start * check out the web UI * goto: http://<host>:8080/hicc
