diff --git a/source/installguide/hypervisor/kvm.rst b/source/installguide/hypervisor/kvm.rst index 2f2e27adfb..a498d27089 100644 --- a/source/installguide/hypervisor/kvm.rst +++ b/source/installguide/hypervisor/kvm.rst @@ -26,7 +26,7 @@ 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 @@ -34,7 +34,7 @@ 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 @@ -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 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/source/installguide/management-server/_prerequisite.rst b/source/installguide/management-server/_prerequisite.rst index e47530fae0..9c2ab52c75 100644 --- a/source/installguide/management-server/_prerequisite.rst +++ b/source/installguide/management-server/_prerequisite.rst @@ -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. diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index e9626820d8..38642c3a57 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -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 @@ -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 @@ -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 ~~~~~~~~~~~~ @@ -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: