Update Quick/Regular Installation Guide for 4.14 (#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
diff --git a/source/installguide/hypervisor/kvm.rst b/source/installguide/hypervisor/kvm.rst
index 2f2e27a..a498d27 100644
--- a/source/installguide/hypervisor/kvm.rst
+++ b/source/installguide/hypervisor/kvm.rst
@@ -26,7 +26,7 @@
- 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
@@ -34,7 +34,7 @@
- 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
@@ -134,6 +134,11 @@
#. 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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/source/installguide/management-server/_prerequisite.rst b/source/installguide/management-server/_prerequisite.rst
index e47530f..9c2ab52 100644
--- a/source/installguide/management-server/_prerequisite.rst
+++ b/source/installguide/management-server/_prerequisite.rst
@@ -91,3 +91,9 @@
#. 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.
diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst
index e962682..38642c3 100644
--- a/source/quickinstallationguide/qig.rst
+++ b/source/quickinstallationguide/qig.rst
@@ -286,7 +286,7 @@
[cloudstack]
name=cloudstack
- baseurl=http://download.cloudstack.org/centos/$releasev/|version|/
+ baseurl=http://download.cloudstack.org/centos/$releasever/|version|/
enabled=1
gpgcheck=0
@@ -374,7 +374,8 @@
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
@@ -420,39 +421,17 @@
# 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
~~~~~~~~~~~~
@@ -464,6 +443,16 @@
# 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: