openstack
/
sahara
Code Issues Proposed changes

doc: update distro information and cloud-init users 

- centralize the information about the default cloud-init users
  for various distributions to point to the existing specialized
  page;
- remove all CentOS 6 and Ubuntu 12.04 (Precise) references, and
  do not refer to Ubuntu 14.04 for the vanilla plugin;
- add Ubuntu 16.04 (Xenial) details when needed;
- update the pointers to few packages.

Change-Id: I4654e6ec2821bcec5207f41b93c5d0f0633ba18c
This commit is contained in:
Luigi Toscano 2018-09-13 23:05:20 +02:00
parent aa514b51e5
commit 10e48a379f
10 changed files with 22 additions and 77 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/source/user/ambari-plugin.rst
View File

@ -31,9 +31,8 @@ For more information about Ambari images, refer to
HDP plugin requires an image to be tagged in sahara Image Registry with two
tags: 'ambari' and '<plugin version>' (e.g. '2.5').
Also in the Image Registry you will need to specify username for an image.
The username specified should be 'cloud-user' in case of CentOS 6.x image,
'centos' for CentOS 7 images and 'ubuntu' for Ubuntu images.
The image requires a username. For more information, refer to the
:doc:`registering-image` section.
High Availability for HDFS and YARN
-----------------------------------

6
doc/source/user/cdh-imagebuilder.rst
View File

@ -21,9 +21,9 @@ Elements for building Cloudera images are stored in
Sahara requires images with cloud-init package installed:
* `For CentOS 6 <http://mirror.centos.org/centos/6/extras/x86_64/Packages/cloud-init-0.7.5-10.el6.centos.2.x86_64.rpm>`_
* `For CentOS 7 <http://mirror.centos.org/centos/7/extras/x86_64/Packages/cloud-init-0.7.5-10.el7.centos.1.x86_64.rpm>`_
* `For Ubuntu 14 <http://packages.ubuntu.com/trusty/cloud-init>`_
* `For CentOS 7 <http://mirror.centos.org/centos/7/os/x86_64/Packages/cloud-init-0.7.9-24.el7.centos.x86_64.rpm>`_
* `For Ubuntu 14.04 <http://packages.ubuntu.com/trusty/cloud-init>`_
* `For Ubuntu 16.04 <http://packages.ubuntu.com/xenial/cloud-init>`_
To create cloudera images follow these steps:

25
doc/source/user/cdh-plugin.rst
View File

@ -16,29 +16,8 @@ with two tags: 'cdh' and '<cloudera version>' (e.g. '5', '5.3.0', '5.4.0',
'5.5.0', '5.7.0', '5.9.0' or '5.9.1', here '5' stands for '5.0.0').
The default username specified for these images is different for each
distribution:
for 5.0.0, 5.3.0 and 5.4.0 version:
+--------------+------------+
| OS | username |
+==============+============+
| Ubuntu 12.04 | ubuntu |
+--------------+------------+
| CentOS 6.6 | cloud-user |
+--------------+------------+
for 5.5.0 and higher versions:
+--------------+------------+
| OS | username |
+==============+============+
| Ubuntu 14.04 | ubuntu |
+--------------+------------+
| CentOS 6.6 | cloud-user |
+--------------+------------+
| CentOS 7 | centos |
+--------------+------------+
distribution. For more information, refer to the
:doc:`registering-image` section.
Services Supported
------------------

13
doc/source/user/mapr-plugin.rst
View File

@ -41,17 +41,8 @@ MapR plugin needs an image to be tagged in Sahara Image Registry with
two tags: 'mapr' and '<MapR version>' (e.g. '5.2.0.mrv2').
The default username specified for these images is different for each
distribution:
+--------------+------------+
| OS | username |
+==============+============+
| Ubuntu 14 | ubuntu |
+--------------+------------+
| CentOS 6 | cloud-user |
+--------------+------------+
| CentOS 7 | centos |
+--------------+------------+
distribution. For more information, refer to the
:doc:`registering-image` section.
Hadoop Version Support
----------------------

12
doc/source/user/quickstart.rst
View File

@ -101,16 +101,8 @@ machine image in the sahara image registry.
Register the image with the username ``ubuntu``.
.. note::
The username will vary depending on the source image used, as follows:
Ubuntu: ``ubuntu``
CentOS 7: ``centos``
CentOS 6: ``cloud-user``
Fedora: ``fedora``
Note that the Sahara team recommends using CentOS 7 instead of CentOS 6 as
a base OS wherever possible; it is better supported throughout OpenStack
image maintenance infrastructure and its more modern filesystem is much
more appropriate for large-scale data processing. For more please see
:doc:`../user/vanilla-plugin`
The username will vary depending on the source image used.
For more information, refer to the :doc:`registering-image` section.
.. sourcecode:: console

6
doc/source/user/registering-image.rst
View File

@ -21,13 +21,11 @@ for each distribution:
+--------------+------------+
| OS | username |
+==============+============+
| Ubuntu 12.04 | ubuntu |
+--------------+------------+
| Ubuntu 14.04 | ubuntu |
+--------------+------------+
| Ubuntu 16.04 | ubuntu |
+--------------+------------+
| Fedora | fedora |
+--------------+------------+
| CentOS 6.x | cloud-user |
+--------------+------------+
| CentOS 7.x | centos |
+--------------+------------+

5
doc/source/user/spark-plugin.rst
View File

@ -22,9 +22,8 @@ CDH 5.4.0 HDFS and Apache Spark installed.
The Spark plugin requires an image to be tagged in the sahara image registry
with two tags: 'spark' and '<Spark version>' (e.g. '1.6.0').
Also you should specify the username of the default cloud-user used in the
image. For the images available at the URLs listed above and for all the ones
generated with the DIB it is `ubuntu`.
The image requires a username. For more information, refer to the
:doc:`registering-image` section.
Note that the Spark cluster is deployed using the scripts available in the
Spark distribution, which allow the user to start all services (master and

4
doc/source/user/storm-plugin.rst
View File

@ -18,8 +18,8 @@ sahara-image-elements:
The Storm plugin requires an image to be tagged in the sahara image registry
with two tags: 'storm' and '<Storm version>' (e.g. '1.1.0').
Also you should specify the username of the default cloud-user used in the
image.
The image requires a username. For more information, refer to the
:doc:`registering-image` section.
Note that the Storm cluster is deployed using the scripts available in the
Storm distribution, which allow the user to start all services (nimbus,

7
doc/source/user/vanilla-imagebuilder.rst
View File

@ -21,10 +21,9 @@ Elements for building vanilla images are stored in the
Sahara requires images with cloud-init package installed:
* `For Fedora <http://pkgs.fedoraproject.org/cgit/cloud-init.git/>`_
* `For Ubuntu 14 <http://packages.ubuntu.com/trusty/cloud-init>`_
* `For CentOS 6 <http://mirror.centos.org/centos/6/extras/x86_64/Packages/cloud-init-0.7.5-10.el6.centos.2.x86_64.rpm>`_
* `For CentOS 7 <http://mirror.centos.org/centos/7/extras/x86_64/Packages/cloud-init-0.7.5-10.el7.centos.1.x86_64.rpm>`_
* `For Ubuntu 16.04 <http://packages.ubuntu.com/xenial/cloud-init>`_
* `For CentOS 7 <http://mirror.centos.org/centos/7/os/x86_64/Packages/cloud-init-0.7.9-24.el7.centos.x86_64.rpm>`_
* `For Fedora <https://src.fedoraproject.org/rpms/cloud-init>`_
To create vanilla images follow these steps:

16
doc/source/user/vanilla-plugin.rst
View File

@ -15,20 +15,8 @@ You may build images by yourself using :doc:`vanilla-imagebuilder`.
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 default username specified for these images is different
for each distribution:
+--------------+------------+
| OS | username |
+==============+============+
| Ubuntu 14 | ubuntu |
+--------------+------------+
| Fedora 20 | fedora |
+--------------+------------+
| CentOS 6 | cloud-user |
+--------------+------------+
| CentOS 7 | centos |
+--------------+------------+
The image requires a username. For more information, refer to the
:doc:`registering-image` section.
Cluster Validation
------------------