Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
9 changes: 7 additions & 2 deletions source/installguide/hypervisor/kvm.rst
Original file line number Diff line number Diff line change
Expand Up @@ -26,15 +26,15 @@ are recommended:

- CentOS / RHEL: 7.X

- Ubuntu: 14.04
- Ubuntu: 16.04

The main requirement for KVM hypervisors is the libvirt and Qemu
version. No matter what Linux distribution you are using, make sure the
following requirements are met:

- libvirt: 1.2.0 or higher

- Qemu/KVM: 2.0 or higher
- Qemu/KVM: 1.5 or higher (2.5 or higher recommended)

The default bridge in CloudStack is the Linux native bridge
implementation (bridge module). CloudStack includes an option to work
Expand Down Expand Up @@ -134,6 +134,11 @@ KVM instances.

#. Repeat all of these steps on every hypervisor host.

.. warning::
CloudStack |version| requires Java 11 JRE. Installing CloudStack agent will
automatically install Java 11, but it's good to explicitly confirm that the Java 11
is the selected/active one (in case you had a previous Java version already installed)
with ``alternatives --config java``, after CloudStack agent is installed.

Install and configure the Agent
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down
6 changes: 6 additions & 0 deletions source/installguide/management-server/_prerequisite.rst
Original file line number Diff line number Diff line change
Expand Up @@ -91,3 +91,9 @@ node.

#. Repeat all of these steps on every host where the Management Server
will be installed.

.. warning::
CloudStack |version| requires Java 11 JRE. Installing CloudStack packages will
automatically install Java 11, but it's good to explicitly confirm that the Java 11
is the selected/active one (in case you had a previous Java version already installed)
with ``alternatives --config java`` after CloudStack packages are already installed.
47 changes: 18 additions & 29 deletions source/quickinstallationguide/qig.rst
Original file line number Diff line number Diff line change
Expand Up @@ -286,7 +286,7 @@ insert the following information.

[cloudstack]
name=cloudstack
baseurl=http://download.cloudstack.org/centos/$releasev/|version|/
baseurl=http://download.cloudstack.org/centos/$releasever/|version|/
enabled=1
gpgcheck=0

Expand Down Expand Up @@ -374,7 +374,8 @@ Database Installation and Configuration
We'll start with installing MySQL and configuring some options to ensure it
runs well with CloudStack.

First, as CentOS 7 no longer provides the MySQL binaries, we need to add a repository:
First, as CentOS 7 no longer provides the MySQL binaries, we need to add a MySQL community repository,
that will provide MySQL Server (and the Python MySQL connector later) :

.. parsed-literal::
# wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm
Expand Down Expand Up @@ -420,39 +421,17 @@ start on boot as follows:
# systemctl start mysqld


MySQL connector Installation
MySQL Connector Installation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Previously, we used to install Python and Java MySQL connectors using the official MySQL packages repository.
Due to the version changes and introduced incompatibility in versions 8.x of those packages,
it's advised to disable installing these packages from the MySQL repository (which we previously added)
and install older versions instead.

Edit the file ``/etc/yum.repos.d/mysql-community.repo`` to add the line
"exclude=mysql-connector-python,mysql-connector-java" under the ``[mysql-connectors-community]``
section of the repo file, so that it looks similar to the below:

.. parsed-literal::

[mysql-connectors-community]
name=MySQL Connectors Community
baseurl=http://repo.mysql.com/yum/mysql-connectors-community/el/7/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:/etc/pki/rpm-gpg/RPM-GPG-KEY-mysql
**exclude=mysql-connector-python,mysql-connector-java**

We'll proceed with installing ``mysql-connector-java`` from the Base CentOS repo,
while the ``mysql-connector-python`` will be installed from the Epel repo:
Install Python MySQL connector from the MySQL community repository (which we've added previously):

.. parsed-literal::

# yum -y install epel-release
# yum -y install mysql-connector-java mysql-connector-python
# yum -y install mysql-connector-python

Please ensure that the installed version are older than 8.x (i.e. the current
mysql-connector-java version from Epel is 1.1.6, while the mysql-connector-python
version is 5.1.25)
Please note that the previously required ``mysql-connector-java`` library is now bundled with CloudStack
Management server and is no more required to be installed separately.

Installation
~~~~~~~~~~~~
Expand All @@ -464,6 +443,16 @@ following command:

# yum -y install cloudstack-management

CloudStack |version| requires Java 11 JRE. Installing the management server
will automatically install Java 11, but it's good to explicitly confirm that the Java 11
is the selected/active one (in case you had a previous Java version already installed):

.. parsed-literal::

$ alternatives --config java

Make sure that Java 11 is the chosen one.

With the application itself installed we can now setup the database, we'll do
that with the following command and options:

Expand Down