sahara/doc/source/user/guest-requirements.rst
Luigi Toscano a70a74aa23 Restructure the documentation according the new spec
Group the existing pages in the new top-level categories; each
category can be seen as a separate document and it has its own
index file.
The content of the pages was not changed, with the obvious
exception of the links between pages.

The autogenerated configuration has not been added yet to
configuration/; it will be fixed in a future commit.

At the same time, as suggested by the doc team, consistently
use only one separator in file names (dash, '-') instead of a mix
of dashes, dots and underscores. This may break even more links on
the Internet, but we are breaking them anyway by moving files.
Redirects can be set, but not in this commit.

Closes-Bug: #1706184
Change-Id: I5a10378d9da2603d617ad4193ea8d90e2afc5104
2017-08-04 18:05:40 +02:00

1.7 KiB

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 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 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 and Ubuntu distributions are 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 cdh-imagebuilder for instructions on building images for this plugin.