You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ed...@apache.org on 2012/09/12 08:43:29 UTC

[13/41] git commit: Feature Documentation for s2svpn interVlan Reviewed-By:Jessica Tomechak

Feature Documentation for s2svpn interVlan Reviewed-By:Jessica Tomechak


Project: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/commit/a19c962b
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/a19c962b
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/a19c962b

Branch: refs/heads/4.0
Commit: a19c962bf5e4fd5b7364f275d0df33e7f9991bef
Parents: 4a8bb9d
Author: Radhika Puthiyetath <ra...@citrix.com>
Authored: Tue Sep 11 21:31:51 2012 +0530
Committer: Pranav Saxena <pr...@citrix.com>
Committed: Tue Sep 11 21:31:51 2012 +0530

----------------------------------------------------------------------
 docs/en-US/installation-complete.xml      |   39 ++++++++++++++++
 docs/en-US/prepare-system-vm-template.xml |   57 ++++++++++++++++++++++++
 2 files changed, 96 insertions(+), 0 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a19c962b/docs/en-US/installation-complete.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/installation-complete.xml b/docs/en-US/installation-complete.xml
new file mode 100644
index 0000000..b39040b
--- /dev/null
+++ b/docs/en-US/installation-complete.xml
@@ -0,0 +1,39 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- 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.
+-->
+
+<section id="installation-complete">
+	<title>Installation Complete! Next Steps</title>
+	<para>Congratulations! You have now installed &PRODUCT; Management Server and the database it uses to persist system data.</para>
+	<mediaobject>
+		<imageobject>
+			<imagedata fileref="./images/installation-complete.png" />
+		</imageobject>
+		<textobject><phrase>installation-complete.png: Finished installs with single Management Server and multiple Management Servers</phrase></textobject>
+	</mediaobject>
+	<para>What should you do next?</para>
+	<itemizedlist>
+		<listitem><para>Even without adding any cloud infrastructure, you can run the UI to get a feel for what's offered and how you will interact with &PRODUCT; on an ongoing basis. See <xref linkend="ui" />.</para></listitem>
+		<listitem><para>When you're ready, add the cloud infrastructure and try running some virtual machines on it, so you can watch how &PRODUCT; manages the infrastructure. See <xref linkend="provisioning-steps" />.</para></listitem>
+	</itemizedlist>
+</section>

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/a19c962b/docs/en-US/prepare-system-vm-template.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/prepare-system-vm-template.xml b/docs/en-US/prepare-system-vm-template.xml
new file mode 100644
index 0000000..160cea4
--- /dev/null
+++ b/docs/en-US/prepare-system-vm-template.xml
@@ -0,0 +1,57 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "file:///C:/Program%20Files%20(x86)/Publican/DocBook_DTD/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- 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.
+-->
+
+<section id="prepare-system-vm-template">
+	<title>Prepare the System VM Template</title>
+	<para>Secondary storage must be seeded with a template that is used for &PRODUCT; system VMs.</para>
+	<note><para>When copying and pasting a command, be sure the command has pasted as a single line before executing. Some document viewers may introduce unwanted line breaks in copied text.</para></note>
+	<orderedlist>
+		<listitem><para>On the Management Server, run one or more of the following cloud-install-sys-tmplt commands to retrieve and decompress the system VM template. Run the command for each hypervisor type that you expect end users to run in this Zone.</para>
+			<para>If your secondary storage mount point is not named /mnt/secondary, substitute your own mount point name.</para>
+			<para>If you set the &PRODUCT; database encryption type to "web" when you set up the database, you must now add the parameter -s &lt;management-server-secret-key&gt;. See About Password and Key Encryption.</para>
+			<para>This process will require approximately 5 GB of free space on the local file system and up to 30 minutes each time it runs.</para>
+			<itemizedlist>
+				<listitem><para>For XenServer:</para>
+					<programlisting># /usr/lib64/cloud/agent/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.vhd.bz2 -h xenserver -s &lt;optional-management-server-secret-key&gt; -F</programlisting>
+				</listitem>
+				<listitem><para>For vSphere:</para>
+					<programlisting># /usr/lib64/cloud/agent/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.ova -h vmware -s &lt;optional-management-server-secret-key&gt;  -F</programlisting>
+				</listitem>
+				<listitem><para>For KVM:</para>
+					<programlisting># /usr/lib64/cloud/agent/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.qcow2.bz2 -h kvm -s &lt;optional-management-server-secret-key&gt; -F</programlisting>
+				</listitem>
+			</itemizedlist>
+		</listitem>
+		<listitem><para>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 this step.</para>
+			<para>When the script has finished, unmount secondary storage and remove the created directory.</para>
+			<programlisting>
+# umount /mnt/secondary 
+# rmdir /mnt/secondary
+			</programlisting>
+		</listitem>
+		<listitem><para>Repeat these steps for each secondary storage server.</para>
+		</listitem>
+	</orderedlist>
+</section>