incubator-cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ahu...@apache.org
Subject [14/50] [abbrv] git commit: https://reviews.apache.org/r/6852 - Docbook transition for section: Advanced Zone Configuration
Date Wed, 05 Sep 2012 21:31:49 GMT
https://reviews.apache.org/r/6852 - Docbook transition for section: Advanced Zone Configuration


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

Branch: refs/heads/javelin
Commit: 8a2259d2afb0d229ac163334ba25b1db0ad06f3a
Parents: ac3d70d
Author: Gavin Lee <gavin.lxh@gmail.com>
Authored: Mon Sep 3 09:32:50 2012 -0400
Committer: David Nalley <david@gnsa.us>
Committed: Mon Sep 3 09:32:50 2012 -0400

----------------------------------------------------------------------
 docs/en-US/about-physical-networks.xml       |    1 +
 docs/en-US/advanced-zone-configuration.xml   |  156 ++++++++++++++++++++-
 docs/en-US/cloud-infrastructure-concepts.xml |    1 +
 3 files changed, 157 insertions(+), 1 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/8a2259d2/docs/en-US/about-physical-networks.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/about-physical-networks.xml b/docs/en-US/about-physical-networks.xml
index b35aeeb..8edb9e0 100644
--- a/docs/en-US/about-physical-networks.xml
+++ b/docs/en-US/about-physical-networks.xml
@@ -40,4 +40,5 @@
     <xi:include href="advanced-zone-network-traffic-types.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
     <xi:include href="advanced-zone-guest-ip-addresses.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
     <xi:include href="advanced-zone-public-ip-addresses.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
+    <xi:include href="system-reserved-ip-addresses.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
 </section>

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/8a2259d2/docs/en-US/advanced-zone-configuration.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/advanced-zone-configuration.xml b/docs/en-US/advanced-zone-configuration.xml
index d73bcf8..85909e3 100644
--- a/docs/en-US/advanced-zone-configuration.xml
+++ b/docs/en-US/advanced-zone-configuration.xml
@@ -24,5 +24,159 @@
 
 <section id="advanced-zone-configuration">
     <title>Advanced Zone Configuration</title>
-    <para>TODO</para>
+    <orderedlist>
+	<listitem><para>After you select Advanced in the Add Zone wizard and click Next,
you will be asked to enter the following details. Then click Next.</para>
+	    <itemizedlist>
+		<listitem><para><emphasis role="bold">Name.</emphasis> A name for
the zone.</para></listitem>
+		<listitem><para><emphasis role="bold">DNS 1 and 2.</emphasis> These
are DNS servers for use by guest VMs in the zone. These DNS servers will be accessed via the
public network you will add later. The public IP addresses for the zone must have a route
to the DNS server named here.</para></listitem>
+		<listitem><para><emphasis role="bold">Internal DNS 1 and Internal DNS
2.</emphasis> These are DNS servers for use by system VMs in the zone(these are VMs
used by &PRODUCT; itself, such as virtual routers, console proxies,and Secondary Storage
VMs.) These DNS servers will be accessed via the management traffic network interface of the
System VMs. The private IP address you provide for the pods must have a route to the internal
DNS server named here.</para></listitem>
+		<listitem><para><emphasis role="bold">Network Domain.</emphasis>
(Optional) If you want to assign a special domain name to the guest VM network, specify the
DNS suffix.</para></listitem>
+		<listitem><para><emphasis role="bold">Guest CIDR.</emphasis> This
is the CIDR that describes the IP addresses in use in the guest virtual networks in this zone.
For example, 10.1.1.0/24. As a matter of good practice you should set different CIDRs for
different zones. This will make it easier to set up VPNs between networks in different zones.</para></listitem>
+		<listitem><para><emphasis role="bold">Hypervisor.</emphasis> (Introduced
in version 3.0.1) Choose the hypervisor for the first cluster in the zone. You can add clusters
with different hypervisors later, after you finish adding the zone.</para></listitem>
+		<listitem><para><emphasis role="bold">Public.</emphasis> A public
zone is available to all users. A zone that is not public will be assigned to a particular
domain.  Only users in that domain will be allowed to create guest VMs in this zone.</para></listitem>
+	    </itemizedlist>
+	</listitem>
+	<listitem><para>Choose which traffic types will be carried by the physical network.</para>
+	    <para>The traffic types are management, public, guest, and storage traffic. For
more information about the types, roll over the icons to display their tool tips, or see <xref
linkend="advanced-zone-network-traffic-types" />. This screen starts out with one network
already configured. If you have multiple physical networks, you need to add more. Drag and
drop traffic types onto a greyed-out network and it will become active. You can move the traffic
icons from one network to another; for example, if the default traffic types shown for Network
1 do not match your actual setup, you can move them down. You can also change the network
names if desired.</para>
+	</listitem>
+	<listitem><para>(Introduced in version 3.0.1) Assign a network traffic label
to each traffic type on each physical network. These labels must match the labels you have
already defined on the hypervisor host. To assign each label, click the Edit button under
the traffic type icon within each physical network. A popup dialog appears where you can type
the label, then click OK.</para>
+	    <para>These traffic labels will be defined only for the hypervisor selected for
the first cluster. For all other hypervisors, the labels can be configured after the zone
is created.</para>
+	    <para>(VMware only) If you have enabled Nexus dvSwitch in the environment, you
must specify the corresponding Ethernet port profile names as network traffic label for each
traffic type on the physical network. For more information on Nexus dvSwitch, see Configuring
a vSphere Cluster with Nexus 1000v Virtual Switch.</para>
+	</listitem>
+	<listitem><para>Click Next.</para>
+	</listitem>
+	<listitem><para>Configure the IP range for public Internet traffic. Enter the
following details, then click Add. If desired, you can repeat this step to add more public
Internet IP ranges. When done, click Next.</para>
+	    <itemizedlist>
+		<listitem><para><emphasis role="bold">Gateway.</emphasis> The gateway
in use for these IP addresses.</para></listitem>
+		<listitem><para><emphasis role="bold">Netmask.</emphasis> The netmask
associated with this IP range.</para></listitem>
+		<listitem><para><emphasis role="bold">VLAN.</emphasis> The VLAN
that will be used for public traffic.</para></listitem>
+		<listitem><para><emphasis role="bold">Start IP/End IP.</emphasis>
A range of IP addresses that are assumed to be accessible from the Internet and will be allocated
for access to guest networks.</para></listitem>
+	    </itemizedlist>
+	</listitem>
+	<listitem><para>In a new zone, &PRODUCT; adds the first pod for you. You
can always add more pods later. For an overview of what a pod is, see <xref linkend="about-pods"
/>.</para>
+	    <para>To configure the first pod, enter the following, then click Next:</para>
+	    <itemizedlist>
+		<listitem><para><emphasis role="bold">Pod Name.</emphasis> A name
for the pod.</para></listitem>
+		<listitem><para><emphasis role="bold">Reserved system gateway.</emphasis>
The gateway for the hosts in that pod.</para></listitem>
+		<listitem><para><emphasis role="bold">Reserved system netmask.</emphasis>
The network prefix that defines the pod's subnet. Use CIDR notation.</para></listitem>
+		<listitem><para><emphasis role="bold">Start/End Reserved System IP.</emphasis>
The IP range in the management network that &PRODUCT; uses to manage various system VMs,
such as Secondary Storage VMs, Console Proxy VMs, and DHCP. For more information, see <xref
linkend="system-reserved-ip-addresses" />.</para></listitem>
+	    </itemizedlist>
+	</listitem>
+	<listitem><para>Specify a range of VLAN IDs to carry guest traffic for each
physical network (see VLAN Allocation Example ), then click Next.</para>
+	</listitem>
+	<listitem><para>In a new pod, &PRODUCT; adds the first cluster for you.
You can always add more clusters later. For an overview of what a cluster is, see <xref
linkend="about-clusters" />.</para>
+	    <para>To configure the first cluster, enter the following, then click Next:</para>
+	    <itemizedlist>
+		<listitem><para><emphasis role="bold">Hypervisor.</emphasis> (Version
3.0.0 only; in 3.0.1, this field is read only) Choose the type of hypervisor software that
all hosts in this cluster will run. If you choose VMware, additional fields appear so you
can give information about a vSphere cluster. For vSphere servers, we recommend creating the
cluster of hosts in vCenter and then adding the entire cluster to &PRODUCT;. See Add Cluster:
vSphere .</para></listitem>
+		<listitem><para><emphasis role="bold">Cluster name.</emphasis>
Enter a name for the cluster.  This can be text of your choosing and is not used by &PRODUCT;.</para></listitem>
+	    </itemizedlist>
+	</listitem>
+	<listitem><para>In a new cluster, &PRODUCT; adds the first host for you.
You can always add more hosts later. For an overview of what a host is, see <xref linkend="about-hosts"
/>.</para>
+	    <note><para>When you deploy &PRODUCT;, the hypervisor host must not
have any VMs already running.</para></note>
+	    <para>Before you can configure the host, you need to install the hypervisor software
on the host. You will need to know which version of the hypervisor software version is supported
by &PRODUCT; and what additional configuration is required to ensure the host will work
with &PRODUCT;. To find these installation details, see:</para>
+	    <itemizedlist>
+		<listitem><para>Citrix XenServer Installation for &PRODUCT;</para></listitem>
+		<listitem><para>VMware vSphere Installation and Configuration</para></listitem>
+		<listitem><para>KVM Installation and Configuration</para></listitem>
+		<listitem><para>Oracle VM (OVM) Installation and Configuration</para></listitem>
+	    </itemizedlist>
+	    <para>To configure the first host, enter the following, then click Next:</para>
+	    <itemizedlist>
+		<listitem><para><emphasis role="bold">Host Name.</emphasis> The
DNS name or IP address of the host.</para></listitem>
+		<listitem><para><emphasis role="bold">Username.</emphasis> Usually
root.</para></listitem>
+		<listitem><para><emphasis role="bold">Password.</emphasis> This
is the password for the user named above (from your XenServer or KVM install).</para></listitem>
+		<listitem><para><emphasis role="bold">Host Tags.</emphasis> (Optional)
Any labels that you use to categorize hosts for ease of maintenance. For example, you can
set to the cloud's HA tag (set in the ha.tag global configuration parameter) if you want this
host to be used only for VMs with the "high availability" feature enabled. For more information,
see HA-Enabled Virtual Machines as well as HA for Hosts, both in the Administration Guide.</para></listitem>
+	    </itemizedlist>
+	</listitem>
+	<listitem><para>In a new cluster, &PRODUCT; adds the first primary storage
server for you. You can always add more servers later. For an overview of what primary storage
is, see <xref linkend="about-primary-storage" />.</para>
+	    <para>To configure the first primary storage server, enter the following, then
click Next:</para>
+	    <itemizedlist>
+		<listitem><para><emphasis role="bold">Name.</emphasis> The name
of the storage device.</para></listitem>
+		<listitem><para><emphasis role="bold">Protocol.</emphasis> For
XenServer, choose either NFS, iSCSI, or PreSetup.  For KVM, choose NFS or SharedMountPoint.
 For vSphere choose either VMFS (iSCSI or FiberChannel) or NFS. The remaining fields in the
screen vary depending on what you choose here.</para>
+		    <informaltable frame="all">
+			<tgroup cols="2" align="left" colsep="1" rowsep="1">
+			    <colspec colname="c1" />
+			    <colspec colname="c2" />
+			    <tbody>
+				<row>
+				    <entry><para>NFS</para></entry>
+				    <entry>
+	                                <itemizedlist>
+		                            <listitem><para><emphasis role="bold">Server.</emphasis>
The IP address or DNS name of the storage device.</para></listitem>
+		                            <listitem><para><emphasis role="bold">Path.</emphasis>
The exported path from the server.</para></listitem>
+					    <listitem>
+						<para><emphasis role="bold">Tags (optional).</emphasis> The comma-separated
list of tags for this storage device.  It should be an equivalent set or superset of the tags
on your disk offerings.</para>
+		                                <para>The tag sets on primary storage across clusters
in a Zone must be identical.  For example, if cluster A provides primary storage that has
tags T1 and T2, all other clusters in the Zone must also provide primary storage that has
tags T1 and T2.</para>
+					    </listitem>
+	                                </itemizedlist>
+				    </entry>
+			        </row>
+				<row>
+				    <entry><para>iSCSI</para></entry>
+				    <entry>
+	                                <itemizedlist>
+		                            <listitem><para><emphasis role="bold">Server.</emphasis>
The IP address or DNS name of the storage device.</para></listitem>
+		                            <listitem><para><emphasis role="bold">Target
IQN.</emphasis> The IQN of the target. For example, iqn.1986-03.com.sun:02:01ec9bb549-1271378984.</para></listitem>
+		                            <listitem><para><emphasis role="bold">Lun.</emphasis>
The LUN number. For example, 3.</para></listitem>
+					    <listitem>
+						<para><emphasis role="bold">Tags (optional).</emphasis> The comma-separated
list of tags for this storage device.  It should be an equivalent set or superset of the tags
on your disk offerings.</para>
+					        <para>The tag sets on primary storage across clusters in a Zone must be
identical.  For example, if cluster A provides primary storage that has tags T1 and T2, all
other clusters in the Zone must also provide primary storage that has tags T1 and T2.</para>
+					    </listitem>
+	                                </itemizedlist>
+				    </entry>
+			        </row>
+				<row>
+				    <entry><para>preSetup</para></entry>
+				    <entry>
+	                                <itemizedlist>
+		                            <listitem><para><emphasis role="bold">Server.</emphasis>
The IP address or DNS name of the storage device.</para></listitem>
+		                            <listitem><para><emphasis role="bold">SR
Name-Label.</emphasis> Enter the name-label of the SR that has been set up outside &PRODUCT;.</para></listitem>
+					    <listitem>
+						<para><emphasis role="bold">Tags (optional).</emphasis> The comma-separated
list of tags for this storage device.  It should be an equivalent set or superset of the tags
on your disk offerings.</para>
+		                                <para>The tag sets on primary storage across clusters
in a Zone must be identical.  For example, if cluster A provides primary storage that has
tags T1 and T2, all other clusters in the Zone must also provide primary storage that has
tags T1 and T2.</para>
+					    </listitem>
+	                                </itemizedlist>
+				    </entry>
+			        </row>
+				<row>
+				    <entry><para>SharedMountPoint</para></entry>
+				    <entry>
+	                                <itemizedlist>
+					    <listitem><para><emphasis role="bold">Path.</emphasis> The
path on each host that is where this primary storage is mounted.  For example, "/mnt/primary".</para></listitem>
+					    <listitem>
+						<para><emphasis role="bold">Tags (optional).</emphasis> The comma-separated
list of tags for this storage device.  It should be an equivalent set or superset of the tags
on your disk offerings.</para>
+		                                <para>The tag sets on primary storage across clusters
in a Zone must be identical.  For example, if cluster A provides primary storage that has
tags T1 and T2, all other clusters in the Zone must also provide primary storage that has
tags T1 and T2.</para>
+					    </listitem>
+	                                </itemizedlist>
+				    </entry>
+			        </row>
+				<row>
+				    <entry><para>VMFS</para></entry>
+				    <entry>
+	                                <itemizedlist>
+		                            <listitem><para><emphasis role="bold">Server.</emphasis>
The IP address or DNS name of the vCenter server.</para></listitem>
+					    <listitem><para><emphasis role="bold">Path.</emphasis> A
combination of the datacenter name and the datastore name.  The format is "/" datacenter name
"/" datastore name.  For example, "/cloud.dc.VM/cluster1datastore".</para></listitem>
+					    <listitem>
+						<para><emphasis role="bold">Tags (optional).</emphasis> The comma-separated
list of tags for this storage device.  It should be an equivalent set or superset of the tags
on your disk offerings.</para>
+		                                <para>The tag sets on primary storage across clusters
in a Zone must be identical.  For example, if cluster A provides primary storage that has
tags T1 and T2, all other clusters in the Zone must also provide primary storage that has
tags T1 and T2.</para>
+					    </listitem>
+	                                </itemizedlist>
+				    </entry>
+			        </row>
+			    </tbody>
+			</tgroup>
+		    </informaltable>
+		</listitem>
+	    </itemizedlist>
+	</listitem>
+	<listitem><para>In a new zone, &PRODUCT; adds the first secondary storage
server for you. For an overview of what secondary storage is, see <xref linkend="about-secondary-storage"
/>.</para>
+	    <para>Before you can fill out this screen, you need to prepare the secondary storage
by setting up NFS shares and installing the latest &PRODUCT; System VM template. See Adding
Secondary Storage :</para>
+	    <itemizedlist>
+		<listitem><para><emphasis role="bold">NFS Server.</emphasis> The
IP address of the server.</para></listitem>
+		<listitem><para><emphasis role="bold">Path.</emphasis> The exported
path from the server.</para></listitem>
+	    </itemizedlist>
+	</listitem>
+	<listitem><para>Click Launch.</para>
+	</listitem>
+    </orderedlist>
 </section>

http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/8a2259d2/docs/en-US/cloud-infrastructure-concepts.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/cloud-infrastructure-concepts.xml b/docs/en-US/cloud-infrastructure-concepts.xml
index 40ceff8..58f8844 100644
--- a/docs/en-US/cloud-infrastructure-concepts.xml
+++ b/docs/en-US/cloud-infrastructure-concepts.xml
@@ -30,4 +30,5 @@
   <xi:include href="about-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="about-primary-storage.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
   <xi:include href="about-secondary-storage.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
+  <xi:include href="about-physical-networks.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
/>
 </section>


Mime
View raw message