Cloudera Desktop

1.1. Installing Hadoop on Debian Systems

If you are running on a Debian-based platform, you can download our packages using apt.

Setting up your Apt Repository

1. Add repository. Create a new file /etc/apt/sources.list.d/cloudera.list with the following contents, taking care to replace DISTRO with the name of your distribution (find out by running lsb_release -c)

   deb http://archive.cloudera.com/debian DISTRO-testing contrib
   deb-src http://archive.cloudera.com/debian DISTRO-testing contrib

2. Add repository key. (optional) Add the Cloudera Public GPG Key to your repository by executing the following command:

   # curl -s http://archive.cloudera.com/debian/archive.key | apt-key add -

   This allows you to verify that you are downloading genuine packages.

3. Update APT package index. Simply run:

   # apt-get update

4. Find and install packages. You may now find and install packages from the Cloudera repository using your favorite APT package manager (e.g apt-get, aptitude, or dselect). For example:

   # apt-cache search hadoop
   # apt-get install hadoop

1.2. Installing Hadoop on Redhat Systems

If you are running on a Redhat-based system, you can easily download our software using yum. You can also just download the RPMs directory from http://archive.cloudera.com/redhat/cdh.

Setting up Yum access

1. Add the Yum repository. Download the cloudera-testing.repo file and drop it ito your /etc/yum.repos.d/ directory.

2. Update the Yum package index. Simple run:

   # yum update yum

3. Find and install packages. For example:

   # yum search hadoop
   # yum install hadoop-0.20

1.3. Required Hadoop Version

To use Cloudera Desktop, you must be running Cloudera's Distribution for Hadoop with a version number of at least 0.20.1+133. If you are not running at least this version of Hadoop, please upgrade your cluster before proceeding.

1.4. Getting Cloudera Desktop

Cloudera Desktop consists of a web service that runs on a special node in your cluster. You should pick one node to run Cloudera Desktop. From this point on, we'll refer to that node as the "Cloudera Desktop Server". This should be one of the nodes within your cluster for optimal performance, though it can be a remote node as long as there are no overly restrictive firewalls.

For small clusters of less than 10 nodes, it is fine to choose your existing master node as the Cloudera Desktop Server.

# yum install cloudera-desktop

# yum install cloudera-desktop.x86_64

# yum install cloudera-desktop-plugins

# apt-get install cloudera-desktop

# apt-get install cloudera-desktop-plugins

1.5. Enabling Hadoop Plugins

Cloudera Desktop requires that you install and configure some plugins in your Hadoop installation.

When you installed the cloudera-desktop-plugins package above, your package manager automatically added the required plugin jar to your Hadoop installation's lib directory, making them available to Hadoop. In order to enable the plugins, you'll need to make some small additions to your configuration.

These configuration changes should be made on each node in your cluster by editing the files in /etc/hadoop-0.20/conf/

<property>
  <name>dfs.namenode.plugins</name>
  <value>org.apache.hadoop.thriftfs.NamenodePlugin</value>
  <description>Comma-separated list of namenode plug-ins to be activated.
  </description>
</property>
<property>
  <name>dfs.datanode.plugins</name>
  <value>org.apache.hadoop.thriftfs.DatanodePlugin</value>
  <description>Comma-separated list of datanode plug-ins to be activated.
  </description>
</property>
<property>
  <name>dfs.thrift.address</name>
  <value>0.0.0.0:9090</value>
</property>

<property>
  <name>jobtracker.thrift.address</name>
  <value>0.0.0.0:9290</value>
</property>
<property>
  <name>mapred.jobtracker.plugins</name>
  <value>org.apache.hadoop.thriftfs.ThriftJobTrackerPlugin</value>
  <description>Comma-separated list of jobtracker plug-ins to be activated.
  </description>
</property>

# Exposes /metrics URL endpoint for metrics information.
dfs.class=org.apache.hadoop.metrics.spi.NoEmitMetricsContext
mapred.class=org.apache.hadoop.metrics.spi.NoEmitMetricsContext
jvm.class=org.apache.hadoop.metrics.spi.NoEmitMetricsContext
rpc.class=org.apache.hadoop.metrics.spi.NoEmitMetricsContext

1.6. Restart your cluster

At this point you should restart all of the daemons in your cluster so that the plugins can be loaded.

You can confirm that the plugins are running correctly by tailing the daemon logs:

$ tail --lines=500 /var/log/hadoop-0.20/hadoop*namenode*.log | grep ThriftPlugin
2009-09-28 16:30:44,337 INFO org.apache.hadoop.thriftfs.ThriftPluginServer: Starting Thrift server
2009-09-28 16:30:44,419 INFO org.apache.hadoop.thriftfs.ThriftPluginServer: Thrift server listening on 0.0.0.0:9090

	Configuring your firewall for Cloudera Desktop
	Cloudera Desktop currently requires that the machines within your cluster can speak to each other freely over TCP. The machines outside your cluster only need to be able to open TCP port 8088 on the Cloudera Desktop Server to interact with the system.

2.1. Pointing Cloudera Desktop to your master nodes

If Cloudera Desktop is running on a different node than your Hadoop master nodes, you'll need to point it at the correct host names to talk to your cluster. To do so, simply change the namenode_host and jobtracker_host lines in the configuration file. The inline comments in the existing file will guide you.

	Using multiple files to store your configuration
	Cloudera Desktop will load and merge all of the files located in the conf/ directory. Files that are alphabetically later will take precedence.

2.2. Configuring PAM authentication

Cloudera Desktop ships with a wide-open authentication mechanism by default — users may enter any username and password when logging in. To instead use PAM authentication, follow the instructions under the [[auth]] section of the file.

	Password Security and PAM Authentication
	Cloudera Desktop does not ship with SSL enabled by default. If you choose to enable PAM authentication, be aware that HTTP is not an encrypted protocol and users' authentication details may be revealed over the network.

4.1. Feedback

Cloudera Desktop is currently in a public beta, and we're excited to receive your feedback and criticisms. We expect that you may uncover some bugs and mishaps. The best way to send feedback is to post to our GetSatisfaction page at http://getsatisfaction.com/cloudera/products/cloudera_cloudera_desktop.

4.2. Reporting Bugs

If you find that something doesn't work, it'll often be helpful to include logs from your server. These are available at the /logs URL on Desktop's webserver (not part of the graphical Desktop UI). Please download the logs as a zip (or cut and paste the ones that look relevant) and send those with your bug reports.