Skip to content

Commit 1a757fa

Browse files
Update Quick/Regular Installation Guide for 4.14 (apache#99)
* WIP: Update Quick Installation Guide for 4.14 This is WIP - yet to be done and tested (net-tools or so...is missing, Java 11 is missing...) This (atm) is reminder to do it once 4.14 is out * Update qig.rst Undo * Java11 notice * Update qig.rst * java11 notice for regular install guide-mgmt server * java11-notice-for-agent * typo
1 parent 95b7382 commit 1a757fa

File tree

3 files changed

+31
-31
lines changed

3 files changed

+31
-31
lines changed

source/installguide/hypervisor/kvm.rst

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,15 +26,15 @@ are recommended:
2626

2727
- CentOS / RHEL: 7.X
2828

29-
- Ubuntu: 14.04
29+
- Ubuntu: 16.04
3030

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

3535
- libvirt: 1.2.0 or higher
3636

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

3939
The default bridge in CloudStack is the Linux native bridge
4040
implementation (bridge module). CloudStack includes an option to work
@@ -134,6 +134,11 @@ KVM instances.
134134
135135
#. Repeat all of these steps on every hypervisor host.
136136

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

138143
Install and configure the Agent
139144
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/installguide/management-server/_prerequisite.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,3 +91,9 @@ node.
9191
9292
#. Repeat all of these steps on every host where the Management Server
9393
will be installed.
94+
95+
.. warning::
96+
CloudStack |version| requires Java 11 JRE. Installing CloudStack packages will
97+
automatically install Java 11, but it's good to explicitly confirm that the Java 11
98+
is the selected/active one (in case you had a previous Java version already installed)
99+
with ``alternatives --config java`` after CloudStack packages are already installed.

source/quickinstallationguide/qig.rst

Lines changed: 18 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -286,7 +286,7 @@ insert the following information.
286286
287287
[cloudstack]
288288
name=cloudstack
289-
baseurl=http://download.cloudstack.org/centos/$releasev/|version|/
289+
baseurl=http://download.cloudstack.org/centos/$releasever/|version|/
290290
enabled=1
291291
gpgcheck=0
292292
@@ -374,7 +374,8 @@ Database Installation and Configuration
374374
We'll start with installing MySQL and configuring some options to ensure it
375375
runs well with CloudStack.
376376

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

379380
.. parsed-literal::
380381
# wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm
@@ -420,39 +421,17 @@ start on boot as follows:
420421
# systemctl start mysqld
421422
422423
423-
MySQL connector Installation
424+
MySQL Connector Installation
424425
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
425426

426-
Previously, we used to install Python and Java MySQL connectors using the official MySQL packages repository.
427-
Due to the version changes and introduced incompatibility in versions 8.x of those packages,
428-
it's advised to disable installing these packages from the MySQL repository (which we previously added)
429-
and install older versions instead.
430-
431-
Edit the file ``/etc/yum.repos.d/mysql-community.repo`` to add the line
432-
"exclude=mysql-connector-python,mysql-connector-java" under the ``[mysql-connectors-community]``
433-
section of the repo file, so that it looks similar to the below:
434-
435-
.. parsed-literal::
436-
437-
[mysql-connectors-community]
438-
name=MySQL Connectors Community
439-
baseurl=http://repo.mysql.com/yum/mysql-connectors-community/el/7/$basearch/
440-
enabled=1
441-
gpgcheck=1
442-
gpgkey=file:/etc/pki/rpm-gpg/RPM-GPG-KEY-mysql
443-
**exclude=mysql-connector-python,mysql-connector-java**
444-
445-
We'll proceed with installing ``mysql-connector-java`` from the Base CentOS repo,
446-
while the ``mysql-connector-python`` will be installed from the Epel repo:
427+
Install Python MySQL connector from the MySQL community repository (which we've added previously):
447428

448429
.. parsed-literal::
449430
450-
# yum -y install epel-release
451-
# yum -y install mysql-connector-java mysql-connector-python
431+
# yum -y install mysql-connector-python
452432
453-
Please ensure that the installed version are older than 8.x (i.e. the current
454-
mysql-connector-java version from Epel is 1.1.6, while the mysql-connector-python
455-
version is 5.1.25)
433+
Please note that the previously required ``mysql-connector-java`` library is now bundled with CloudStack
434+
Management server and is no more required to be installed separately.
456435

457436
Installation
458437
~~~~~~~~~~~~
@@ -464,6 +443,16 @@ following command:
464443
465444
# yum -y install cloudstack-management
466445
446+
CloudStack |version| requires Java 11 JRE. Installing the management server
447+
will automatically install Java 11, but it's good to explicitly confirm that the Java 11
448+
is the selected/active one (in case you had a previous Java version already installed):
449+
450+
.. parsed-literal::
451+
452+
$ alternatives --config java
453+
454+
Make sure that Java 11 is the chosen one.
455+
467456
With the application itself installed we can now setup the database, we'll do
468457
that with the following command and options:
469458

0 commit comments

Comments
 (0)