You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by pd...@apache.org on 2014/07/30 20:26:20 UTC
[1/2] git commit: add make.sh and global.rst
Repository: cloudstack-docs-install
Updated Branches:
refs/heads/master 86fb099a2 -> f0422e61c
add make.sh and global.rst
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/44fa2a89
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/tree/44fa2a89
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/diff/44fa2a89
Branch: refs/heads/master
Commit: 44fa2a89af412baa5caa488b41200649832652c8
Parents: 86fb099
Author: pdion891 <pd...@apache.org>
Authored: Wed Jul 30 14:25:08 2014 -0400
Committer: pdion891 <pd...@apache.org>
Committed: Wed Jul 30 14:25:08 2014 -0400
----------------------------------------------------------------------
make.sh | 3 +++
source/_global.rst | 23 +++++++++++++++++++++++
2 files changed, 26 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/44fa2a89/make.sh
----------------------------------------------------------------------
diff --git a/make.sh b/make.sh
new file mode 100755
index 0000000..d4e96fd
--- /dev/null
+++ b/make.sh
@@ -0,0 +1,3 @@
+rm -fr build
+mkdir build
+sphinx-build -b html source build
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/44fa2a89/source/_global.rst
----------------------------------------------------------------------
diff --git a/source/_global.rst b/source/_global.rst
new file mode 100644
index 0000000..2e3ccc4
--- /dev/null
+++ b/source/_global.rst
@@ -0,0 +1,23 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+
+.. This file contain Variables shared across .rst files in this project
+
+.. _Documentation home: http://docs.cloudstack.apache.org
+.. _Installation Guide: http://docs.cloudstack.apache.org/projects/cloudstack-installation
+.. _Administration Guide: http://docs.cloudstack.apache.org/projects/cloudstack-administration
+.. _Release Notes: http://docs.cloudstack.apache.org/projects/cloudstack-release-notes
+
[2/2] git commit: initial update content for 4.4.0 release
Posted by pd...@apache.org.
initial update content for 4.4.0 release
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/f0422e61
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/tree/f0422e61
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/diff/f0422e61
Branch: refs/heads/master
Commit: f0422e61ccc948d49ba6f00e385749bfc78dbfa2
Parents: 44fa2a8
Author: pdion891 <pd...@apache.org>
Authored: Wed Jul 30 14:25:46 2014 -0400
Committer: pdion891 <pd...@apache.org>
Committed: Wed Jul 30 14:25:46 2014 -0400
----------------------------------------------------------------------
source/building_from_source.rst | 38 ++++++++++----------
source/index.rst | 11 +++---
source/installation.rst | 68 +++++++++++++++++++++++-------------
source/qig.rst | 17 +++++----
4 files changed, 80 insertions(+), 54 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/f0422e61/source/building_from_source.rst
----------------------------------------------------------------------
diff --git a/source/building_from_source.rst b/source/building_from_source.rst
index 56f03e4..9d67a57 100644
--- a/source/building_from_source.rst
+++ b/source/building_from_source.rst
@@ -91,7 +91,7 @@ To check the signature, run the following command:
.. sourcecode:: bash
- $ gpg --verify apache-cloudstack-4.3.0-src.tar.bz2.asc
+ $ gpg --verify apache-cloudstack-4.4.0-src.tar.bz2.asc
If the signature is valid you will see a line of output that contains
'Good signature'.
@@ -106,7 +106,7 @@ You can verify this hash by executing the following command:
.. sourcecode:: bash
- $ gpg --print-md MD5 apache-cloudstack-4.3.0-src.tar.bz2 | diff - apache-cloudstack-4.3.0-src.tar.bz2.md5
+ $ gpg --print-md MD5 apache-cloudstack-4.4.0-src.tar.bz2 | diff - apache-cloudstack-4.4.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
@@ -122,7 +122,7 @@ release. You can verify this hash by executing the following command:
.. sourcecode:: bash
- $ gpg --print-md SHA512 apache-cloudstack-4.3.0-src.tar.bz2 | diff - apache-cloudstack-4.3.0-src.tar.bz2.sha
+ $ gpg --print-md SHA512 apache-cloudstack-4.4.0-src.tar.bz2 | diff - apache-cloudstack-4.4.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
@@ -164,13 +164,13 @@ with a single command as follows:
.. sourcecode:: bash
- $ tar -jxvf apache-cloudstack-4.3.0-src.tar.bz2
+ $ tar -jxvf apache-cloudstack-4.4.0-src.tar.bz2
You can now move into the directory:
.. sourcecode:: bash
- $ cd ./apache-cloudstack-4.3.0-src
+ $ cd ./apache-cloudstack-4.4.0-src
Building DEB packages
@@ -214,13 +214,13 @@ all of the following:
.. sourcecode:: bash
- cloudstack-common-4.3.0.amd64.deb
- cloudstack-management-4.3.0.amd64.deb
- cloudstack-agent-4.3.0.amd64.deb
- cloudstack-usage-4.3.0.amd64.deb
- cloudstack-awsapi-4.3.0.amd64.deb
- cloudstack-cli-4.3.0.amd64.deb
- cloudstack-docs-4.3.0.amd64.deb
+ cloudstack-common-4.4.0.amd64.deb
+ cloudstack-management-4.4.0.amd64.deb
+ cloudstack-agent-4.4.0.amd64.deb
+ cloudstack-usage-4.4.0.amd64.deb
+ cloudstack-awsapi-4.4.0.amd64.deb
+ cloudstack-cli-4.4.0.amd64.deb
+ cloudstack-docs-4.4.0.amd64.deb
Setting up an APT repo
@@ -367,13 +367,13 @@ You should see the following RPMs in that directory:
.. sourcecode:: bash
- cloudstack-agent-4.3.0.el6.x86_64.rpm
- cloudstack-awsapi-4.3.0.el6.x86_64.rpm
- cloudstack-cli-4.3.0.el6.x86_64.rpm
- cloudstack-common-4.3.0.el6.x86_64.rpm
- cloudstack-docs-4.3.0.el6.x86_64.rpm
- cloudstack-management-4.3.0.el6.x86_64.rpm
- cloudstack-usage-4.3.0.el6.x86_64.rpm
+ cloudstack-agent-4.4.0.el6.x86_64.rpm
+ cloudstack-awsapi-4.4.0.el6.x86_64.rpm
+ cloudstack-cli-4.4.0.el6.x86_64.rpm
+ cloudstack-common-4.4.0.el6.x86_64.rpm
+ cloudstack-docs-4.4.0.el6.x86_64.rpm
+ cloudstack-management-4.4.0.el6.x86_64.rpm
+ cloudstack-usage-4.4.0.el6.x86_64.rpm
Creating a yum repo
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/f0422e61/source/index.rst
----------------------------------------------------------------------
diff --git a/source/index.rst b/source/index.rst
index 55f960f..854807f 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -24,6 +24,7 @@ Welcome to CloudStack Installation Documentation
.. figure:: /_static/images/acslogo.png
:align: center
+ :target: http://cloudstack.apache.org/
.. warning::
We are in the process of changing documentation format as well as hosting
@@ -33,13 +34,11 @@ Welcome to CloudStack Installation Documentation
This is the Apache CloudStack installation guide, for the Documentation home,
the administrator guide or the Release-Notes please see:
-- `Documentation home <http://docs.cloudstack.apache.org>`_
+- `Documentation home`_
-- `Administration Guide
- <http://docs.cloudstack.apache.org/projects/cloudstack-administration>`_
+- `Administration Guide`_
-- `Release Notes
- <http://docs.cloudstack.apache.org/projects/cloudstack-release-notes>`_
+- `Release Notes`_
.. note::
In this guide we first go through some design and architectural choices_ to
@@ -141,3 +140,5 @@ Optional Installation
:maxdepth: 2
optional_installation
+
+.. include:: _global.rst
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/f0422e61/source/installation.rst
----------------------------------------------------------------------
diff --git a/source/installation.rst b/source/installation.rst
index 1ad3a26..635f0d3 100644
--- a/source/installation.rst
+++ b/source/installation.rst
@@ -177,7 +177,7 @@ repository to the file:
.. sourcecode:: bash
- $ deb http://cloudstack.apt-get.eu/ubuntu precise 4.3
+ $ deb http://cloudstack.apt-get.eu/ubuntu precise 4.4
We now have to add the public key to the trusted keys.
@@ -215,7 +215,7 @@ information.
[cloudstack]
name=cloudstack
- baseurl=http://cloudstack.apt-get.eu/rhel/4.3/
+ baseurl=http://cloudstack.apt-get.eu/rhel/4.4/
enabled=1
gpgcheck=0
@@ -347,7 +347,8 @@ Install on Ubuntu
apt-get install libmysql-java
- This bug has been fixed in master and upcoming 4.4 release and will also be fixed in bug fix releases 4.3.x
+ This bug has been fixed in 4.4 release and will also be fixed in bug fix releases 4.3.1
+
Downloading vhd-util
^^^^^^^^^^^^^^^^^^^^
@@ -1146,41 +1147,60 @@ CloudStack system VMs.
This process will require approximately 5 GB of free space on the
local file system and up to 30 minutes each time it runs.
- - For Hyper-V
-
- .. sourcecode:: bash
-
- # /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-hyperv.vhd.bz2 -h hyperv -s <optional-management-server-secret-key> -F
+ * For Hyper-V
- - For XenServer:
-
- .. sourcecode:: bash
+ .. sourcecode:: bash
- # /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-xen.vhd.bz2 -h xenserver -s <optional-management-server-secret-key> -F
+ /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \
+ -m /mnt/secondary \
+ -u http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-hyperv.vhd \
+ -h hyperv \
+ -s <optional-management-server-secret-key> \
+ -F
- - For vSphere:
+ * For XenServer:
- .. sourcecode:: bash
+ .. sourcecode:: bash
- # /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-vmware.ova -h vmware -s <optional-management-server-secret-key> -F
+ /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \
+ -m /mnt/secondary \
+ -u http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-xen.vhd.bz2 \
+ -h xenserver \
+ -s <optional-management-server-secret-key> \
+ -F
- - For KVM:
+ * For vSphere:
- .. sourcecode:: bash
+ .. sourcecode:: bash
- # /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-kvm.qcow2.bz2 -h kvm -s <optional-management-server-secret-key> -F
+ /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \
+ -m /mnt/secondary \
+ -u http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-vmware.ova \
+ -h vmware \
+ -s <optional-management-server-secret-key> \
+ -F
- - For LXC:
+ * For KVM:
- .. sourcecode:: bash
+ .. sourcecode:: bash
- # /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/4.3/systemvm64template-2014-06-23-master-kvm.qcow2.bz2 -h lxc -s <optional-management-server-secret-key> -F
+ /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \
+ -m /mnt/secondary \
+ -u http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-kvm.qcow2.bz2 \
+ -h kvm \
+ -s <optional-management-server-secret-key> \
+ -F
- On Ubuntu, use the following path instead:
+ * For LXC:
- .. sourcecode:: bash
+ .. sourcecode:: bash
- # /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt
+ /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \
+ -m /mnt/secondary \
+ -u http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-kvm.qcow2.bz2 \
+ -h lxc \
+ -s <optional-management-server-secret-key> \
+ -F
#. If you are using a separate NFS server, perform this step. If you are
using the Management Server as the NFS server, you MUST NOT perform
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/f0422e61/source/qig.rst
----------------------------------------------------------------------
diff --git a/source/qig.rst b/source/qig.rst
index cdd69c3..614815e 100644
--- a/source/qig.rst
+++ b/source/qig.rst
@@ -53,7 +53,7 @@ To complete this runbook you'll need the following items:
#. At least one computer which supports hardware virtualization.
-#. The `CentOS 6.4 x86_64 minimal install CD
+#. The `CentOS 6.5 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.4 x86_64 minimal install ISO, you'll need to install CentOS
+Using the CentOS 6.5 x86_64 minimal install ISO, you'll need to install CentOS
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/rhel/4.3/
+ baseurl=http://cloudstack.apt-get.eu/rhel/4.4/
enabled=1
gpgcheck=0
@@ -278,8 +278,8 @@ the following content:
.. sourcecode:: bash
- /secondary *(rw,async,no_root_squash)
- /primary *(rw,async,no_root_squash)
+ /secondary *(rw,async,no_root_squash,no_subtree_check)
+ /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
@@ -422,7 +422,11 @@ the system VMs images.
.. sourcecode:: bash
- # /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt -m /secondary -u http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-kvm.qcow2.bz2 -h kvm -F
+ /usr/share/cloudstack-common/scripts/storage/secondary/cloud-install-sys-tmplt \
+ -m /secondary \
+ -u http://cloudstack.apt-get.eu/systemvm/4.4/systemvm64template-4.4.0-6-kvm.qcow2.bz2 \
+ -h kvm -F
+
That concludes our setup of the management server. We still need to configure
CloudStack, but we will do that after we get our hypervisor set up.
@@ -652,3 +656,4 @@ Now, click Launch and your cloud should begin setup - it may take several
minutes depending on your internet connection speed for setup to finalize.
That's it, you are done with installation of your Apache CloudStack cloud.
+