cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pdion...@apache.org
Subject [4/4] cloudstack-docs-install git commit: update version to 4.9.0
Date Thu, 11 Aug 2016 21:20:01 GMT
update version to 4.9.0


Project: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/commit/834e36ee
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/tree/834e36ee
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/diff/834e36ee

Branch: refs/heads/4.9
Commit: 834e36eeb49fe20287b5dee8c6ce234915c10a6e
Parents: 1265b05
Author: Pierre-Luc Dion <pdion891@apache.org>
Authored: Sat Aug 6 17:30:09 2016 -0400
Committer: Pierre-Luc Dion <pdion891@apache.org>
Committed: Sat Aug 6 17:30:09 2016 -0400

----------------------------------------------------------------------
 source/building_from_source.rst            | 87 ++++++++++++++++++------
 source/conf.py                             |  4 +-
 source/management-server/_nfs.rst          |  2 +-
 source/management-server/_pkg_repo.rst     |  8 +--
 source/management-server/_prerequisite.rst |  2 +-
 source/overview/index.rst                  |  4 +-
 source/qig.rst                             | 89 ++++++++++++++++---------
 7 files changed, 134 insertions(+), 62 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/834e36ee/source/building_from_source.rst
----------------------------------------------------------------------
diff --git a/source/building_from_source.rst b/source/building_from_source.rst
index 26cbe85..a4303f7 100644
--- a/source/building_from_source.rst
+++ b/source/building_from_source.rst
@@ -92,7 +92,7 @@ To check the signature, run the following command:
 
 .. sourcecode:: bash
 
-   $ gpg --verify apache-cloudstack-4.8.0-src.tar.bz2.asc
+   $ gpg --verify apache-cloudstack-4.9.0-src.tar.bz2.asc
 
 If the signature is valid you will see a line of output that contains
 'Good signature'.
@@ -107,7 +107,7 @@ You can verify this hash by executing the following command:
 
 .. sourcecode:: bash
 
-   $ gpg --print-md MD5 apache-cloudstack-4.8.0-src.tar.bz2 | diff - apache-cloudstack-4.8.0-src.tar.bz2.md5
+   $ gpg --print-md MD5 apache-cloudstack-4.9.0-src.tar.bz2 | diff - apache-cloudstack-4.9.0-src.tar.bz2.md5
 
 If this successfully completes you should see no output. If there is any
 output from them, then there is a difference between the hash you
@@ -123,7 +123,7 @@ release. You can verify this hash by executing the following command:
 
 .. sourcecode:: bash
 
-   $ gpg --print-md SHA512 apache-cloudstack-4.8.0-src.tar.bz2 | diff - apache-cloudstack-4.8.0-src.tar.bz2.sha
+   $ gpg --print-md SHA512 apache-cloudstack-4.9.0-src.tar.bz2 | diff - apache-cloudstack-4.9.0-src.tar.bz2.sha
 
 If this command successfully completes you should see no output. If
 there is any output from them, then there is a difference between the
@@ -150,7 +150,7 @@ You will need, at a minimum, the following to compile CloudStack:
 
 #. MySQLdb (provides Python database API)
 
-#. Tomcat 6 (not 6.0.35)
+#. Tomcat 6 (not 6.0.35) or Tomcat 7
 
 #. genisoimage
 
@@ -165,13 +165,62 @@ with a single command as follows:
 
 .. sourcecode:: bash
 
-   $ tar -jxvf apache-cloudstack-4.8.0-src.tar.bz2
+   $ tar -jxvf apache-cloudstack-4.9.0-src.tar.bz2
 
 You can now move into the directory:
 
 .. sourcecode:: bash
 
-   $ cd ./apache-cloudstack-4.8.0-src
+   $ cd ./apache-cloudstack-4.9.0-src
+
+Install new MySQL connector
+---------------------------
+
+Install Python MySQL connector using the official MySQL packages repository.
+
+
+MySQL connector APT repository
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Install the following package provided by MySQL to enable official repositories:
+
+.. sourcecode:: bash
+
+   wget http://dev.mysql.com/get/mysql-apt-config_0.7.3-1_all.deb
+   sudo dpkg -i mysql-apt-config_0.7.3-1_all.deb
+
+Make sure to activate the repository for MySQL connectors.
+
+.. sourcecode:: bash
+
+   sudo apt-get update
+   sudo apt-get install mysql-connector-python   
+
+
+MySQL connector RPM repository
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Add a new yum repo ``/etc/yum.repos.d/mysql.repo``:
+
+.. sourcecode:: bash
+
+   [mysql-community]
+   name=MySQL Community connectors
+   baseurl=http://repo.mysql.com/yum/mysql-connectors-community/el/$releasever/$basearch/
+   enabled=1
+   gpgcheck=1
+
+Import GPG public key from MySQL:
+
+.. sourcecode:: bash
+
+   rpm --import http://repo.mysql.com/RPM-GPG-KEY-mysql
+
+Install mysql-connector
+
+.. sourcecode:: bash
+
+   yum install mysql-connector-python
 
 
 Building DEB packages
@@ -185,7 +234,7 @@ several other dependencies. Note that we recommend using Maven 3.
    $ sudo apt-get update
    $ sudo apt-get install python-software-properties
    $ sudo apt-get update
-   $ sudo apt-get install ant debhelper openjdk-7-jdk tomcat6 libws-commons-util-java genisoimage
python-mysqldb libcommons-codec-java libcommons-httpclient-java liblog4j1.2-java maven
+   $ sudo apt-get install ant debhelper openjdk-7-jdk tomcat6 libws-commons-util-java genisoimage
libcommons-codec-java libcommons-httpclient-java liblog4j1.2-java maven
 
 While we have defined, and you have presumably already installed the
 bootstrap prerequisites, there are a number of build time prerequisites
@@ -210,13 +259,11 @@ all of the following:
 
 .. sourcecode:: bash
 
-   cloudstack-common-4.8.0.amd64.deb
-   cloudstack-management-4.8.0.amd64.deb
-   cloudstack-agent-4.8.0.amd64.deb
-   cloudstack-usage-4.8.0.amd64.deb
-   cloudstack-awsapi-4.8.0.amd64.deb
-   cloudstack-cli-4.8.0.amd64.deb
-   cloudstack-docs-4.8.0.amd64.deb
+   cloudstack-common-4.9.0.amd64.deb
+   cloudstack-management-4.9.0.amd64.deb
+   cloudstack-agent-4.9.0.amd64.deb
+   cloudstack-usage-4.9.0.amd64.deb
+   cloudstack-cli-4.9.0.amd64.deb
 
 
 Setting up an APT repo
@@ -366,13 +413,11 @@ You should see the following RPMs in that directory:
 
 .. sourcecode:: bash
 
-   cloudstack-agent-4.8.0.el6.x86_64.rpm
-   cloudstack-awsapi-4.8.0.el6.x86_64.rpm
-   cloudstack-cli-4.8.0.el6.x86_64.rpm
-   cloudstack-common-4.8.0.el6.x86_64.rpm
-   cloudstack-docs-4.8.0.el6.x86_64.rpm
-   cloudstack-management-4.8.0.el6.x86_64.rpm
-   cloudstack-usage-4.8.0.el6.x86_64.rpm
+   cloudstack-agent-4.9.0.el6.x86_64.rpm
+   cloudstack-cli-4.9.0.el6.x86_64.rpm
+   cloudstack-common-4.9.0.el6.x86_64.rpm
+   cloudstack-management-4.9.0.el6.x86_64.rpm
+   cloudstack-usage-4.9.0.el6.x86_64.rpm
 
 
 Creating a yum repo

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/834e36ee/source/conf.py
----------------------------------------------------------------------
diff --git a/source/conf.py b/source/conf.py
index 40920c0..a6f184c 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -61,9 +61,9 @@ copyright = u'2016, Apache Software Foundation'
 # built documents.
 #
 # The short X.Y version.
-version = '4.8'
+version = '4.9'
 # The full version, including alpha/beta/rc tags.
-release = '4.8.0'
+release = '4.9.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/834e36ee/source/management-server/_nfs.rst
----------------------------------------------------------------------
diff --git a/source/management-server/_nfs.rst b/source/management-server/_nfs.rst
index 312a946..6a42925 100644
--- a/source/management-server/_nfs.rst
+++ b/source/management-server/_nfs.rst
@@ -101,7 +101,7 @@ operating system version.
 
    .. sourcecode:: bash
 
-      mount -t nfs nfsservername:/nfs/share/secondary /mnt/secondary
+      mount -t nfs nfsservername:/export/secondary /mnt/secondary
 
 
 .. _using-the-management-server-as-the-nfs-server:

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/834e36ee/source/management-server/_pkg_repo.rst
----------------------------------------------------------------------
diff --git a/source/management-server/_pkg_repo.rst b/source/management-server/_pkg_repo.rst
index f2606bc..d6d8557 100644
--- a/source/management-server/_pkg_repo.rst
+++ b/source/management-server/_pkg_repo.rst
@@ -23,8 +23,8 @@ build from source.
 
 If you didn't follow the steps to build your own packages from source in
 the sections for `“Building RPMs from Source” 
-<building_from_source.html#building-rpms-from-source>`_ or 
-`“Building DEB packages” <building_from_source.html#building-deb-packages>`_ 
+<../building_from_source.html#building-rpms-from-source>`_ or 
+`“Building DEB packages” <../building_from_source.html#building-deb-packages>`_

 you may find pre-built DEB and RPM packages for your convenience linked from 
 the `downloads <http://cloudstack.apache.org/downloads.html>`_ page.
 
@@ -53,7 +53,7 @@ information.
 
    [cloudstack]
    name=cloudstack
-   baseurl=http://cloudstack.apt-get.eu/centos/6/4.8/
+   baseurl=http://cloudstack.apt-get.eu/centos/$releasever/4.9/
    enabled=1
    gpgcheck=0
 
@@ -73,7 +73,7 @@ repository to the file:
 
 .. sourcecode:: bash
 
-   deb http://cloudstack.apt-get.eu/ubuntu precise 4.8
+   deb http://cloudstack.apt-get.eu/ubuntu precise 4.9
 
 We now have to add the public key to the trusted keys.
 

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/834e36ee/source/management-server/_prerequisite.rst
----------------------------------------------------------------------
diff --git a/source/management-server/_prerequisite.rst b/source/management-server/_prerequisite.rst
index 494bfe0..5bcbf72 100644
--- a/source/management-server/_prerequisite.rst
+++ b/source/management-server/_prerequisite.rst
@@ -72,7 +72,7 @@ node.
 
    .. sourcecode:: bash
 
-      ping www.cloudstack.org
+      ping cloudstack.apache.org
 
 #. Turn on NTP for time synchronization.
 

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/834e36ee/source/overview/index.rst
----------------------------------------------------------------------
diff --git a/source/overview/index.rst b/source/overview/index.rst
index 8b0ef53..1305f4a 100644
--- a/source/overview/index.rst
+++ b/source/overview/index.rst
@@ -35,8 +35,8 @@ build from source.
 
 If you didn't follow the steps to build your own packages from source in
 the sections for `“Building RPMs from Source” 
-<building_from_source.html#building-rpms-from-source>`_ or 
-`“Building DEB packages” <building_from_source.html#building-deb-packages>`_ 
+<../building_from_source.html#building-rpms-from-source>`_ or 
+`“Building DEB packages” <../building_from_source.html#building-deb-packages>`_

 you may find pre-built DEB and RPM packages for your convenience linked from 
 the `downloads <http://cloudstack.apache.org/downloads.html>`_ page.
 

http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/834e36ee/source/qig.rst
----------------------------------------------------------------------
diff --git a/source/qig.rst b/source/qig.rst
index 4158c1b..31b52ac 100644
--- a/source/qig.rst
+++ b/source/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 
-6.5 with NFS storage on a flat layer-2 network utilizing layer-3 network 
+6.8 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.
 
-#. The `CentOS 6.5 x86_64 minimal install CD 
+#. The `CentOS 6.8 x86_64 minimal install CD 
    <http://mirrors.kernel.org/centos/6/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 6.5 x86_64 minimal install ISO, you'll need to install CentOS 6 
+Using the CentOS 6.8 x86_64 minimal install ISO, you'll need to install CentOS 6 
 on your hardware. The defaults will generally be acceptable for this 
 installation.
 
@@ -256,7 +256,7 @@ insert the following information.
 
    [cloudstack]
    name=cloudstack
-   baseurl=http://cloudstack.apt-get.eu/centos/6/4.8/
+   baseurl=http://cloudstack.apt-get.eu/centos/6/4.9/
    enabled=1
    gpgcheck=0
 
@@ -278,8 +278,8 @@ the following content:
 
 .. sourcecode:: bash
 
-   /secondary *(rw,async,no_root_squash,no_subtree_check)
-   /primary *(rw,async,no_root_squash,no_subtree_check)
+   /export/secondary *(rw,async,no_root_squash,no_subtree_check)
+   /export/primary *(rw,async,no_root_squash,no_subtree_check)
 
 You will note that we specified two directories that don't exist (yet) on the 
 system. We'll go ahead and create those directories and set permissions 
@@ -287,8 +287,8 @@ appropriately on them with the following commands:
 
 .. sourcecode:: bash
 
-   # mkdir /primary
-   # mkdir /secondary
+   # mkdir -p /export/primary
+   # mkdir /export/secondary
 
 CentOS 6.x releases use NFSv4 by default. NFSv4 requires that domain setting 
 matches on all clients. In our case, the domain is cloud.priv, so ensure that 
@@ -380,6 +380,33 @@ start on boot as follows:
    # chkconfig mysqld on
 
 
+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:
+
+.. sourcecode:: bash
+
+   [mysql-connectors-community]
+   name=MySQL Community connectors
+   baseurl=http://repo.mysql.com/yum/mysql-connectors-community/el/$releasever/$basearch/
+   enabled=1
+   gpgcheck=1
+
+Import GPG public key from MySQL:
+
+.. sourcecode:: bash
+
+   rpm --import http://repo.mysql.com/RPM-GPG-KEY-mysql
+
+Install mysql-connector
+
+.. sourcecode:: bash
+
+   yum install mysql-connector-python
+
+
 Installation
 ~~~~~~~~~~~~
 
@@ -425,7 +452,7 @@ the system VMs images.
 .. sourcecode:: bash
   
    /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \
-   -m /secondary \
+   -m /export/secondary \
    -u http://cloudstack.apt-get.eu/systemvm/4.6/systemvm64template-4.6.0-kvm.qcow2.bz2 \
    -h kvm -F
 
@@ -489,9 +516,9 @@ KVM configuration is relatively simple at only a single item. We need
to edit
 the QEMU VNC configuration. This is done by editing /etc/libvirt/qemu.conf and 
 ensuring the following line is present and uncommented.
 
-..
+::
 
-  vnc_listen=0.0.0.0
+   vnc_listen=0.0.0.0
 
 
 Libvirt Configuration
@@ -575,13 +602,13 @@ for us there are 5 pieces of information that we need.
 
 #. Name - we will set this to the ever-descriptive 'Zone1' for our cloud.
 
-#. Public DNS 1 - we will set this to '8.8.8.8' for our cloud.
+#. Public DNS 1 - we will set this to ``8.8.8.8`` for our cloud.
 
-#. Public DNS 2 - we will set this to '8.8.4.4' for our cloud.
+#. Public DNS 2 - we will set this to ``8.8.4.4`` for our cloud.
 
-#. Internal DNS1 - we will also set this to '8.8.8.8' for our cloud.
+#. Internal DNS1 - we will also set this to ``8.8.8.8`` for our cloud.
 
-#. Internal DNS2 - we will also set this to '8.8.4.4' for our cloud. 
+#. Internal DNS2 - we will also set this to ``8.8.4.4`` for our cloud. 
 
 .. note:: 
    CloudStack distinguishes between internal and public DNS. Internal DNS is 
@@ -601,19 +628,19 @@ Pod Configuration
 Now that we've added a Zone, the next step that comes up is a prompt for 
 information regading a pod. Which is looking for several items.
 
-#. Name - We'll use Pod1 for our cloud.
+#. Name - We'll use ``Pod1`` for our cloud.
 
-#. Gateway - We'll use 172.16.10.1 as our gateway
+#. Gateway - We'll use ``172.16.10.1`` as our gateway
 
-#. Netmask - We'll use 255.255.255.0
+#. Netmask - We'll use ``255.255.255.0``
 
-#. Start/end reserved system IPs - we will use 172.16.10.10-172.16.10.20
+#. Start/end reserved system IPs - we will use ``172.16.10.10-172.16.10.20``
 
-#. Guest gateway - We'll use 172.16.10.1
+#. Guest gateway - We'll use ``172.16.10.1``
 
-#. Guest netmask - We'll use 255.255.255.0
+#. Guest netmask - We'll use ``255.255.255.0``
 
-#. Guest start/end IP - We'll use 172.16.10.30-172.16.10.200
+#. Guest start/end IP - We'll use ``172.16.10.30-172.16.10.200``
 
 
 Cluster
@@ -622,17 +649,17 @@ Cluster
 Now that we've added a Zone, we need only add a few more items for configuring 
 the cluster.
 
-#. Name - We'll use Cluster1
+#. Name - We'll use ``Cluster1``
 
-#. Hypervisor - Choose KVM
+#. Hypervisor - Choose ``KVM``
 
 You should be prompted to add the first host to your cluster at this point. 
 Only a few bits of information are needed.
 
-#. Hostname - we'll use the IP address 172.16.10.2 since we didn't set up a 
+#. Hostname - we'll use the IP address ``172.16.10.2`` since we didn't set up a 
    DNS server.
 
-#. Username - we'll use 'root'
+#. Username - we'll use ``root``
 
 #. Password - enter the operating system password for the root user
 
@@ -644,11 +671,11 @@ With your cluster now setup - you should be prompted for primary storage
 information. Choose NFS as the storage type and then enter the following 
 values in the fields:
 
-#. Name - We'll use 'Primary1'
+#. Name - We'll use ``Primary1``
 
-#. Server - We'll be using the IP address 172.16.10.2
+#. Server - We'll be using the IP address ``172.16.10.2``
 
-#. Path - Well define /primary as the path we are using
+#. Path - Well define ``/export/primary`` as the path we are using
 
 
 Secondary Storage
@@ -657,9 +684,9 @@ Secondary Storage
 If this is a new zone, you'll be prompted for secondary storage information - 
 populate it as follows:
 
-#. NFS server - We'll use the IP address 172.16.10.2
+#. NFS server - We'll use the IP address ``172.16.10.2``
 
-#. Path - We'll use /secondary
+#. Path - We'll use ``/export/secondary``
 
 Now, click Launch and your cloud should begin setup - it may take several 
 minutes depending on your internet connection speed for setup to finalize.


Mime
View raw message