Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 9B062200B5C for ; Thu, 11 Aug 2016 23:20:00 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 9994F160A90; Thu, 11 Aug 2016 21:20:00 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 696EC160AB4 for ; Thu, 11 Aug 2016 23:19:59 +0200 (CEST) Received: (qmail 27726 invoked by uid 500); 11 Aug 2016 21:19:58 -0000 Mailing-List: contact commits-help@cloudstack.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cloudstack.apache.org Delivered-To: mailing list commits@cloudstack.apache.org Received: (qmail 27625 invoked by uid 99); 11 Aug 2016 21:19:58 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 11 Aug 2016 21:19:58 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 2A7ADE3A9C; Thu, 11 Aug 2016 21:19:58 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: pdion891@apache.org To: commits@cloudstack.apache.org Date: Thu, 11 Aug 2016 21:20:01 -0000 Message-Id: In-Reply-To: References: X-Mailer: ASF-Git Admin Mailer Subject: [4/4] cloudstack-docs-install git commit: update version to 4.9.0 archived-at: Thu, 11 Aug 2016 21:20:00 -0000 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 Authored: Sat Aug 6 17:30:09 2016 -0400 Committer: Pierre-Luc Dion 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” -`_ or -`“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 `_ 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” -`_ or -`“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 `_ 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 `_ #. 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.