This is an automated email from the ASF dual-hosted git repository.
andrijapanic pushed a commit to branch 4.13
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.13 by this push:
new c44c790 4.13 Quick install guide updates (#93)
c44c790 is described below
commit c44c7906a58e14e5c1a313d1f20aa6b417c90265
Author: Spaceman1984 <[email protected]>
AuthorDate: Fri May 22 11:56:58 2020 +0200
4.13 Quick install guide updates (#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 <[email protected]>
Co-authored-by: PaulAngus <[email protected]>
Co-authored-by: Andrija Panic
<[email protected]>
---
source/quickinstallationguide/qig.rst | 56 +++++++++++++++++--------------
source/upgrading/upgrade/upgrade-4.11.rst | 17 ++++++----
2 files changed, 41 insertions(+), 32 deletions(-)
diff --git a/source/quickinstallationguide/qig.rst
b/source/quickinstallationguide/qig.rst
index 2650397..e962682 100644
--- a/source/quickinstallationguide/qig.rst
+++ b/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
~~~~~~~~~~~~
diff --git a/source/upgrading/upgrade/upgrade-4.11.rst
b/source/upgrading/upgrade/upgrade-4.11.rst
index b97eac1..cfbe00b 100644
--- a/source/upgrading/upgrade/upgrade-4.11.rst
+++ b/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
