You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ah...@apache.org on 2012/09/12 02:38:57 UTC
[10/50] [abbrv] 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/df7069d7
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/tree/df7069d7
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/diff/df7069d7
Branch: refs/heads/javelin
Commit: df7069d771e6199962e9e6d75ca2ae2253d96520
Parents: 32c53b8
Author: Radhika Puthiyetath <ra...@citrix.com>
Authored: Tue Sep 11 21:31:51 2012 +0530
Committer: Alex Huang <al...@citrix.com>
Committed: Tue Sep 11 17:38:23 2012 -0700
----------------------------------------------------------------------
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/df7069d7/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/df7069d7/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 <management-server-secret-key>. 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 <optional-management-server-secret-key> -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 <optional-management-server-secret-key> -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 <optional-management-server-secret-key> -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>