hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Hadoop Wiki] Trivial Update of "Chukwa Quick Start" by andykonwinski
Date Sat, 11 Oct 2008 02:10:14 GMT
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 andykonwinski:

New page:
(This is copied from the README.TXT file that comes with the Chukwa distribution)
The Chukwa monitoring system has a number of components.
This section gives guidance on starting each of them on your local machine. 

You should start the collector first, then the agent, and finally any adaptors.

*  Compiling and installing Chukwa

   - If Chukwa is in the hadoop contrib directory, you should be able to just
     say ``ant'' in the project root directory.
   - Otherwise, 

*  Configuring and starting the Collector

   - Copy conf/chukwa-collector-conf.xml.template to conf/chukwa-collector-conf.xml
   - Edit the writer.hdfs.filesystem property to point to a real filesystem.
   - If you are running hadoop, this should be the path to the namenode.
   - If you are not running hadoop, you can just juse a local path, of the form
   - Copy conf/chukwa-env.sh-template to conf/chukwa-env.sh.  Set JAVA_HOME in file.
   - In the chukwa root directory, say ``bash bin/jettyCollector.sh''

*  Configuring and starting the Local Agent
  - Copy conf/chukwa-agent-conf.xml.template to conf/chukwa-agent-conf.xml
  - Copy conf/collectors.template to conf/collectors

  - In the chukwa root directory, say ``bash bin/agent.sh''

*  Starting Adaptors
  The local agent speaks a simple text-based protocol, by default over port 9093.
Suppose you want Chukwa to start tailing a file /path/to/file of type MyFileType 
on localhost:

  - Telnet to localhost 9093
  - Type [without quotation marks] "ADD CharFileTailerUTF8 MyFileType /path/to/file 0"

  - Chukwa internal Namenode's type is NameNodeType so for namenode log
  Type [without quotation marks] "ADD CharFileTailerUTF8 NameNodeType /path/to/nameNodeFie
  - Type "list" -- you should see the adaptor you just started, listed as running. 
  - Type  "close" to break the connection.
  If you don't have telnet, you can get the same effect with netcat (``nc''). 
*  Configuring and starting the demux job

  - Edit bin/chukwa-config.sh to match your system configuration
  - In the chukwa root directory, say ``bash bin/processSinkFiles.sh'' 
*  Configuring and starting HICC

  - Download Apache Tomcat from http://tomcat.apache.org/download-60.cgi
  - Configure CHUKWA_HOME environment variable pointing to the Chukwa home directory.

  - Copy hicc.war into Apache Tomcat webapps directory.

  - Startup Tomcat.


Running Chukwa in a networked context is essentially similar to the single-machine
deployment discussed above.  However, in a network context, you would also need to
tell the local agent where the collector[s] live, by listing them in conf/collectors.

View raw message