From 23363169eb9e5307f1f7b80f50ca09b3e27bc7e5 Mon Sep 17 00:00:00 2001 From: Andrija Panic <45762285+andrijapanicsb@users.noreply.github.com> Date: Sun, 12 Apr 2020 18:00:45 +0200 Subject: [PATCH 1/7] 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 --- source/quickinstallationguide/qig.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index 0e96a8c6fc..162c73a57c 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -34,7 +34,7 @@ High level overview of the process ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This runbook will focus on building a CloudStack cloud using KVM on CentOS -7.5 with NFS storage on a flat layer-2 network utilizing layer-3 network +7.7 with NFS storage on a flat layer-2 network utilizing layer-3 network isolation (aka Security Groups), and doing it all on a single piece of hardware. @@ -53,7 +53,7 @@ To complete this runbook you'll need the following items: #. At least one computer which supports and has enabled hardware virtualization. -#. An `CentOS 7.5 x86_64 install ISO, on bootable media +#. An `CentOS 7.7 x86_64 install ISO, on bootable media `_ #. A /24 network with the gateway being at xxx.xxx.xxx.1, no DHCP should be on @@ -71,9 +71,9 @@ CloudStack. We will go over the steps to prepare now. Operating System ~~~~~~~~~~~~~~~~ -Using the CentOS 7.5 x86_64 install ISO, you'll need to install CentOS 7 +Using the CentOS 7.7 x86_64 install ISO, you'll need to install CentOS 7 on your hardware. The defaults will generally be acceptable for this -installation. You may want to configure network configuration during +installation. You may want to configure netwok configuration during setup - either using the guidelines below, or using a standard access configuration which we will modify later. @@ -277,7 +277,7 @@ We need to configure the machine to use a CloudStack package repository. to take the source release and generate RPMs and and yum repository. This guide attempts to keep things as simple as possible, and thus we are using one of the community-provided yum repositories. Furthermore, this example - assumes a 4.11 Cloudstack install - substitute versions as needed. + assumes a 4.14 Cloudstack install - substitute versions as needed. To add the CloudStack repository, create /etc/yum.repos.d/cloudstack.repo and insert the following information. @@ -286,7 +286,7 @@ insert the following information. [cloudstack] name=cloudstack - baseurl=http://download.cloudstack.org/centos/7/4.11/ + baseurl=http://download.cloudstack.org/centos/7/4.14/ enabled=1 gpgcheck=0 @@ -494,7 +494,7 @@ the system VMs images. /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \ -m /export/secondary \ - -u http://download.cloudstack.org/systemvm/4.11/systemvmtemplate-4.11.2-kvm.qcow2.bz2 \ + -u http://download.cloudstack.org/systemvm/4.14/systemvmtemplate-4.14.0-kvm.qcow2.bz2 \ -h kvm -F From ced471cc92885f8025e9f5e81d3d7e693439dc18 Mon Sep 17 00:00:00 2001 From: Andrija Panic <45762285+andrijapanicsb@users.noreply.github.com> Date: Fri, 22 May 2020 14:29:20 +0200 Subject: [PATCH 2/7] Update qig.rst Undo --- source/quickinstallationguide/qig.rst | 45 +++++++-------------------- 1 file changed, 12 insertions(+), 33 deletions(-) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index 2f866098eb..b9511bec36 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -33,7 +33,7 @@ get you up and running with CloudStack with a minimum amount of trouble. High level overview of the process ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This runbook will focus on building a CloudStack cloud using KVM on CentOS +This guide will focus on building a CloudStack cloud using KVM on CentOS 7.7 with NFS storage on a flat layer-2 network utilizing layer-3 network isolation (aka Security Groups), and doing it all on a single piece of hardware. @@ -73,7 +73,7 @@ Operating System Using the CentOS 7.7 x86_64 install ISO, you'll need to install CentOS 7 on your hardware. The defaults will generally be acceptable for this -installation. You may want to configure netwok configuration during +installation. You may want to configure network configuration during setup - either using the guidelines below, or using a standard access configuration which we will modify later. @@ -277,7 +277,7 @@ We need to configure the machine to use a CloudStack package repository. to take the source release and generate RPMs and and yum repository. This guide attempts to keep things as simple as possible, and thus we are using one of the community-provided yum repositories. Furthermore, this example - assumes a 4.14 Cloudstack install - substitute versions as needed. + assumes a |release| Cloudstack install - substitute versions as needed. To add the CloudStack repository, create /etc/yum.repos.d/cloudstack.repo and insert the following information. @@ -286,7 +286,7 @@ insert the following information. [cloudstack] name=cloudstack - baseurl=http://download.cloudstack.org/centos/7/4.14/ + baseurl=http://download.cloudstack.org/centos/$releasev/|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 ~~~~~~~~~~~~ @@ -500,7 +479,7 @@ the system VMs images. /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \ -m /export/secondary \ - -u http://download.cloudstack.org/systemvm/4.14/systemvmtemplate-4.14.0-kvm.qcow2.bz2 \ + -u |sysvm64-url-kvm| \ -h kvm -F From 51220ab23c7b9eab089bebbcc7a85f79baade8b6 Mon Sep 17 00:00:00 2001 From: Andrija Panic <45762285+andrijapanicsb@users.noreply.github.com> Date: Fri, 22 May 2020 14:39:33 +0200 Subject: [PATCH 3/7] Java11 notice --- source/quickinstallationguide/qig.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index b9511bec36..3e7e3932ab 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -443,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 the 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: From 81705cd655807576ba3630a20701642d5f5b0918 Mon Sep 17 00:00:00 2001 From: Andrija Panic <45762285+andrijapanicsb@users.noreply.github.com> Date: Fri, 22 May 2020 14:40:43 +0200 Subject: [PATCH 4/7] Update qig.rst --- source/quickinstallationguide/qig.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index 3e7e3932ab..8957f58210 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -451,7 +451,7 @@ is the selected/active one (in case you had a previous Java version already inst $ alternatives --config java -Make sure that the Java 11 is the chosen one. +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: From 3ebd3ce8ce6884c5a43187191f5c6ae2efc8e71e Mon Sep 17 00:00:00 2001 From: Andrija Panic <45762285+andrijapanicsb@users.noreply.github.com> Date: Fri, 22 May 2020 14:47:26 +0200 Subject: [PATCH 5/7] java11 notice for regular install guide-mgmt server --- source/installguide/management-server/_prerequisite.rst | 6 ++++++ 1 file changed, 6 insertions(+) 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. From 505c407ba3ff809adf5a86a3e03b1fbfb765edbe Mon Sep 17 00:00:00 2001 From: Andrija Panic <45762285+andrijapanicsb@users.noreply.github.com> Date: Fri, 22 May 2020 14:53:57 +0200 Subject: [PATCH 6/7] java11-notice-for-agent --- source/installguide/hypervisor/kvm.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) 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 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From 1289ade76452874b49c0c69df2a916b298992bd4 Mon Sep 17 00:00:00 2001 From: Andrija Panic <45762285+andrijapanicsb@users.noreply.github.com> Date: Fri, 22 May 2020 15:05:12 +0200 Subject: [PATCH 7/7] typo --- source/quickinstallationguide/qig.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index 8957f58210..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