Skip to content

installguide: minor wording and grammar fixes #161

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DaanHoogland merged 1 commit into from
Dec 11, 2020
Merged

installguide: minor wording and grammar fixes #161

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
91 changes: 47 additions & 44 deletions source/installguide/building_from_source.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,52 +18,56 @@ Introduction
------------

The official CloudStack release is always in source code form. You will
likely be able to find "convenience binaries," the source is the
canonical release. In this section, we'll cover acquiring the source
release and building that so that you can deploy it using Maven or
create Debian packages or RPMs.
likely be able to find "convenience binaries", where the source is the
canonical release. In this section, we will cover acquiring and building
the source release so that you can deploy using Maven or
build packages for distribution (e.g. ``.deb``, ``.rpm``).

Note that building and deploying directly from source is typically not
the most efficient way to deploy an IaaS. However, we will cover that
method as well as building RPMs or Debian packages for deploying
CloudStack.
.. note::

Building and deploying directly from source is typically not
the most efficient way to deploy CloudStack. Also, please be aware that
development branches may contain unstable code. If you run into any issues
during the build process, please check the CloudStack `Issues
<https://github.com/apache/cloudstack/issues>`_ page on GitHub. You may find
that the issue you are experiencing has already been reported.

The instructions here are likely version-specific. That is, the method
for building from source for the 4.7.x series is different from the
4.2.x series.
The instructions here are likely version-specific (i.e. Building 4.7.x
is different from building 4.2.x).

If you are working with a unreleased version of CloudStack, see the
INSTALL.md file in the top-level directory of the release.
If you are working with an unreleased version of CloudStack, please read the
``INSTALL.md`` file in the top-level directory of the release.


Downloading the release
Downloading the Release
-----------------------

You can download the latest CloudStack release from the `Apache
CloudStack project download page
CloudStack project download page
<http://cloudstack.apache.org/downloads.html>`_.

Prior releases are available via archive.apache.org as well. See the
downloads page for more information on archived releases.
Prior releases are available via `archive.apache.org
<https://archive.apache.org>`_ as well. Please see the
Downloads page for more information on archived releases.

You'll notice several links under the 'Latest release' section. A link
to a file ending in ``tar.bz2``, as well as a PGP/GPG signature, MD5,
You will notice several links under the *Latest CloudStack Releases* section.
A link to a file ending in ``tar.bz2``, as well as a PGP/GPG signature, MD5,
and SHA512 file.

- The ``tar.bz2`` file contains the Bzip2-compressed tarball with the
- The ``tar.bz2`` file contains the bzip2-compressed tarball with the
source code.

- The ``.asc`` file is a detached cryptographic signature that can be
used to help verify the authenticity of the release.
used to verify release authenticity.

- The ``.md5`` file is an MD5 hash of the release to aid in verify the
validity of the release download.
- The ``.md5`` file is a MD5 hash that can be used to verify release
authenticity.

- The ``.sha`` file is a SHA512 hash of the release to aid in verify
the validity of the release download.
- The ``.sha`` file is a SHA512 hash that can be used to verify release
authenticity.


Verifying the downloaded release
Verifying the Downloaded Release
--------------------------------

There are a number of mechanisms to check the authenticity and validity
Expand Down Expand Up @@ -202,7 +206,7 @@ Make sure to activate the repository for MySQL connectors.
.. parsed-literal::

sudo apt-get update
sudo apt-get install mysql-connector-python
sudo apt-get install mysql-connector-python

.. note::

Expand Down Expand Up @@ -250,7 +254,7 @@ several other dependencies. Note that we recommend using Maven 3.
$ sudo apt-get install python-software-properties
$ sudo apt-get update
$ sudo apt-get install debhelper openjdk-11-jdk libws-commons-util-java genisoimage libcommons-codec-java libcommons-httpclient-java liblog4j1.2-java maven

.. note::

If on Ubuntu 18.04, in above command, please replace "python-software-properties" with "software-properties-common"
Expand Down Expand Up @@ -397,10 +401,10 @@ You can now move on to the instructions under Install on Ubuntu.
Building RPMs from Source
-------------------------

As mentioned previously in `“Prerequisites for building Apache CloudStack”
<#prerequisites-for-building-apache-cloudstack>`_, you will need to install
As mentioned previously in `“Prerequisites for building Apache CloudStack”
<#prerequisites-for-building-apache-cloudstack>`_, you will need to install
several prerequisites before you can build packages for CloudStack. Here we'll
assume you're working with a 64-bit build of CentOS or Red Hat Enterprise
assume you're working with a 64-bit build of CentOS or Red Hat Enterprise
Linux.

.. parsed-literal::
Expand Down Expand Up @@ -449,16 +453,16 @@ minutes.

.. note::

Packaging has changed. If you've created packages for CloudStack
previously, you should be aware that the process has changed considerably
since the project has moved to using Apache Maven. Please be sure to follow
Packaging has changed. If you've created packages for CloudStack
previously, you should be aware that the process has changed considerably
since the project has moved to using Apache Maven. Please be sure to follow
the steps in this section closely.


Generating RPMS
~~~~~~~~~~~~~~~

Now that we have the prerequisites and source, you will cd to the
Now that we have the prerequisites and source, you will cd to the
`packaging/` directory.

.. parsed-literal::
Expand All @@ -470,7 +474,7 @@ Generating RPMs is done using the ``package.sh`` script:
.. parsed-literal::

$ ./package.sh -d centos63

For other supported options(like centos7), run ``./package.sh --help``

That will run for a bit and then place the finished packages in
Expand Down Expand Up @@ -537,19 +541,19 @@ to build from source.

.. warning::

Some of the plugins supported by CloudStack cannot be distributed with
CloudStack for licensing reasons. In some cases, some of the required
libraries/JARs are under a proprietary license. In other cases, the
required libraries may be under a license that's not compatible with
`Apache's licensing guidelines for third-party products
Some of the plugins supported by CloudStack cannot be distributed with
CloudStack for licensing reasons. In some cases, some of the required
libraries/JARs are under a proprietary license. In other cases, the
required libraries may be under a license that's not compatible with
`Apache's licensing guidelines for third-party products
<http://www.apache.org/legal/resolved.html#category-x>`_.

#. To build the Non-OSS plugins, you'll need to have the requisite JARs
installed under the ``deps`` directory.

Because these modules require dependencies that can't be distributed
with CloudStack you'll need to download them yourself. Links to the
most recent dependencies are listed on the `*How to build CloudStack*
most recent dependencies are listed on the `*How to build CloudStack*
<https://cwiki.apache.org/confluence/display/CLOUDSTACK/How+to+build+CloudStack>`_
page on the wiki.

Expand All @@ -567,6 +571,5 @@ to build from source.
$ mvn install -Dnoredist

#. Once you've built CloudStack with the ``noredist`` profile, you can
package it using the `“Building RPMs from Source” <#building-rpms-from-source>`_
package it using the `“Building RPMs from Source” <#building-rpms-from-source>`_
or `“Building DEB packages” <#building-deb-packages>`_ instructions.