Telles Nobrega 5b6bc86b66 Updating plugin documentation and release notes

Updating documentation to reflect what it means to the Sahara project,
and make it build again.
Also cleaning up release notes so we can start fresh.

Change-Id: Ic3c0f72f3845137119140da64437d7dcbf43ce31

2019-01-08 19:24:26 -03:00

3.5 KiB

Raw Blame History

Vanilla Plugin

The vanilla plugin is a reference implementation which allows users to operate a cluster with Apache Hadoop.

Since the Newton release Spark is integrated into the Vanilla plugin so you can launch Spark jobs on a Vanilla cluster.

Images

For cluster provisioning, prepared images should be used.

Support matrix for the vanilla plugin
Version (image tag)	Distribution	Build method	Version (build parameter)	Notes
2.8.2	Ubuntu 16.04, CentOS 7	sahara-image-create	2.8.2	Hive 2.3.2, Oozie 4.3.0
2.7.5	Ubuntu 16.04, CentOS 7	sahara-image-create	2.7.5	Hive 2.3.2, Oozie 4.3.0
2.7.1	Ubuntu 16.04, CentOS 7	sahara-image-create	2.7.1	Hive 0.11.0, Oozie 4.2.0

For more information about building image, refer to Sahara documentation <user/building-guest-images.html>.

Vanilla plugin requires an image to be tagged in Sahara Image Registry with two tags: 'vanilla' and '<hadoop version>' (e.g. '2.7.1').

The image requires a username. For more information, refer to the registering image <user/registering-image.html> section of the Sahara documentation.

Build settings

When sahara-image-create is used, you can override few settings by exporting the corresponding environment variables before starting the build command:

DIB_HADOOP_VERSION - version of Hadoop to install
HIVE_VERSION - version of Hive to install
OOZIE_DOWNLOAD_URL - download link for Oozie (we have built Oozie libs here: https://tarballs.openstack.org/sahara-extra/dist/oozie/)
SPARK_DOWNLOAD_URL - download link for Spark

Vanilla Plugin Requirements

The image building tools described in Building guest images <user/building-guest-images.html> add the required software to the image and their usage is strongly suggested. Nevertheless, here are listed the software that should be pre-loaded on the guest image so that it can be used to create Vanilla clusters:

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

See Swift Integration <user/hadoop-swift.html> 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/mariadb
hive

Cluster Validation

When user creates or scales a Hadoop cluster using a Vanilla plugin, the cluster topology requested by user is verified for consistency.

Currently there are the following limitations in cluster topology for Vanilla plugin:

For Vanilla Hadoop version 2.x.x:

Cluster must contain exactly one namenode
Cluster can contain at most one resourcemanager
Cluster can contain at most one secondary namenode
Cluster can contain at most one historyserver
Cluster can contain at most one oozie and this process is also required for EDP
Cluster can't contain oozie without resourcemanager and without historyserver
Cluster can't have nodemanager nodes if it doesn't have resourcemanager
Cluster can have at most one hiveserver node.
Cluster can have at most one spark history server and this process is also required for Spark EDP (Spark is available since the Newton release).

3.5 KiB Raw Blame History