4.13 Quick install guide updates (apache#93)

* Update upgrade-4.11.rst

reword warning

* Updated repo, systemvm template location, added python-dns and added mysql-connector-java downgrade

* Update qig.rst

* Update qig.rst

* Update qig.rst

* Update upgrade-4.11.rst

* Update qig.rst

Co-authored-by: Rohit Yadav <rohit.yadav@shapeblue.com>
Co-authored-by: PaulAngus <paul.angus@shapeblue.com>
Co-authored-by: Andrija Panic <45762285+andrijapanicsb@users.noreply.github.com>

Author: 4 people

source/quickinstallationguide/qig.rst

@@ -33,8 +33,8 @@ 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 
-7.5 with NFS storage on a flat layer-2 network utilizing layer-3 network 
+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.
 
@@ -49,11 +49,11 @@ virtual machines.
 Prerequisites
 ~~~~~~~~~~~~~
 
-To complete this runbook you'll need the following items:
+To complete this guide 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 
    <http://mirrors.kernel.org/centos/7/isos/x86_64/>`_
 
 #. A /24 network with the gateway being at xxx.xxx.xxx.1, no DHCP should be on 
@@ -71,7 +71,7 @@ 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
 setup - either using the guidelines below, or using a standard access
@@ -101,10 +101,10 @@ will need to configure it to work in your environment. Since we specified
 that there will be no DHCP server in this environment we will be manually 
 configuring your network interface. 
 
-Before going any further, make sure that "brctl" is installed and available:
+Before going any further, make sure that "brctl" and "net-tools" are installed and available:
 
 .. parsed-literal::
-   # yum install bridge-utils -y
+   # yum install bridge-utils net-tools -y
 
 Connecting via the console you should login as root. We will start by creating
 the bridge that Cloudstack will use for networking. Create and open
@@ -277,16 +277,16 @@ 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 |release| Cloudstack install - substitute versions as needed.
 
 To add the CloudStack repository, create /etc/yum.repos.d/cloudstack.repo and 
 insert the following information.
 
-::
+.. parsed-literal::
 
    [cloudstack]
    name=cloudstack
-   baseurl=http://download.cloudstack.org/centos/7/4.11/
+   baseurl=http://download.cloudstack.org/centos/$releasev/|version|/
    enabled=1
    gpgcheck=0
 
@@ -379,7 +379,6 @@ First, as CentOS 7 no longer provides the MySQL binaries, we need to add a repos
 .. parsed-literal::
    # wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm
    # rpm -ivh mysql-community-release-el7-5.noarch.rpm
-   # yum -y update
 
 Install by running the following command: 
 
@@ -424,29 +423,36 @@ start on boot as follows:
 MySQL connector Installation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Install Python MySQL connector using the official MySQL packages repository.
-Create the file ``/etc/yum.repos.d/mysql.repo`` with the following content:
+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 Community connectors
-   baseurl=http://repo.mysql.com/yum/mysql-connectors-community/el/$releasever/$basearch/
+   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**
 
-Import GPG public key from MySQL:
-
-.. parsed-literal::
-
-   rpm --import http://repo.mysql.com/RPM-GPG-KEY-mysql
+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 mysql-connector
-
-.. parsed-literal::
-
-   yum install mysql-connector-python
+.. parsed-literal:: 
 
+   # yum -y install epel-release
+   # yum -y install mysql-connector-java 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)
 
 Installation
 ~~~~~~~~~~~~

source/upgrading/upgrade/upgrade-4.11.rst

@@ -50,14 +50,17 @@ Overview of Upgrade Steps:
 .. include:: _customisation_warnings.rst
 
 .. warning::
-    If you are not already using the |sysvm64-version| System VM template you will need to 
-    upgrade your System VM template prior to performing the upgrade of the 
-    CloudStack packages.
+    If you have not registered the 4.11.3 System VM templates for your hypervisors,
+    you will need to register them prior to performing the upgrade of the CloudStack
+    packages. This includes those currently running a **clean** install of CloudStack 4.11.3 (i.e. you
+    did not upgrade from another version to reach 4.11.3) - you will still need to 
+    explicitly register the 4.11.3 System VM template(s), but you will not need
+    to restart the existing system VMs. 
 
-.. warning::
-    Even if you are currently running a **clean** install of CloudStack 4.11.3, you will need to explicitely register the 
-    |sysvm64-version| System VM template. If you are running CloudStack 4.11.3 that was upgraded from some of the previous versions,
-    you don't need to register a new |sysvm64-version| System VM template.
+    If you are running an instance of CloudStack 4.11.3
+    that was upgraded from a the previous versions,
+    you will already have explicitly registered the 4.11.3 System VM template(s) and
+    need not to do it again.
 
 .. include:: _sysvm_templates.rst