Requirements for Guests
=======================

Sahara manages guests of various platforms (for example Ubuntu, Fedora, RHEL,
and CentOS) with various versions of the Hadoop ecosystem projects installed.
There are common requirements for all guests, and additional requirements based
on the plugin that is used for cluster deployment.

Common Requirements
-------------------

* The operating system must be Linux
* cloud-init must be installed
* ssh-server must be installed

  + if a firewall is active it must allow connections on port 22 to enable ssh

Vanilla Plugin Requirements
---------------------------

If the Vanilla Plugin is used for cluster deployment the guest is required to
have

* ssh-client installed
* Java (version >= 6)
* Apache Hadoop installed
* 'hadoop' user created

See :doc:`hadoop-swift` for information on using Swift with your sahara cluster
(for EDP support Swift integration is currently required).

To support EDP, the following components must also be installed on the guest:

* Oozie version 4 or higher
* mysql
* hive

See :doc:`vanilla_imagebuilder` for instructions on building images for this
plugin.

Hortonworks Plugin Requirements
-------------------------------

This plugin does not have any additional requirements. Currently, only the
CentOS Linux distribution is supported but other distributions will be
supported in the future.
To speed up provisioning, the HDP packages can be pre-installed on the image
used. The packages' versions depend on the HDP version being used.

Cloudera Plugin Requirements
----------------------------

Cloudera Plugin does not have any additional requirements, just build a CDH
image to deploy the cluster.

See :doc:`cdh_imagebuilder` for instructions on building images for this
plugin.
