cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ke4...@apache.org
Subject [21/51] [partial] Adding documents from 4.2
Date Wed, 02 Oct 2013 14:23:22 GMT
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/vpc.xml
----------------------------------------------------------------------
diff --git a/en-US/vpc.xml b/en-US/vpc.xml
new file mode 100644
index 0000000..d1f0c52
--- /dev/null
+++ b/en-US/vpc.xml
@@ -0,0 +1,189 @@
+<?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="vpc">
+  <title>About Virtual Private Clouds</title>
+  <para>&PRODUCT; Virtual Private Cloud is a private, isolated part of &PRODUCT;. A VPC can have its
+    own virtual network topology that resembles a traditional physical network. You can launch VMs
+    in the virtual network that can have private addresses in the range of your choice, for example:
+    10.0.0.0/16. You can define network tiers within your VPC network range, which in turn enables
+    you to group similar kinds of instances based on IP address range.</para>
+  <para>For example, if a VPC has the private range 10.0.0.0/16, its guest networks can have the
+    network ranges 10.0.1.0/24, 10.0.2.0/24, 10.0.3.0/24, and so on.</para>
+  <formalpara>
+    <title>Major Components of a VPC:</title>
+    <para>A VPC is comprised of the following network components:</para>
+  </formalpara>
+  <itemizedlist>
+    <listitem>
+      <para><emphasis role="bold">VPC</emphasis>: A VPC acts as a container for multiple isolated
+        networks that can communicate with each other via its virtual router.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">Network Tiers</emphasis>: Each tier acts as an isolated network
+        with its own VLANs and CIDR list, where you can place groups of resources, such as VMs. The
+        tiers are segmented by means of VLANs. The NIC of each tier acts as its gateway.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">Virtual Router</emphasis>: A virtual router is automatically
+        created and started when you create a VPC. The virtual router connect the tiers and direct
+        traffic among the public gateway, the VPN gateways, and the NAT instances. For each tier, a
+        corresponding NIC and IP exist in the virtual router. The virtual router provides DNS and
+        DHCP services through its IP.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">Public Gateway</emphasis>: The traffic to and from the Internet
+        routed to the VPC through the public gateway. In a VPC, the public gateway is not exposed to
+        the end user; therefore, static routes are not support for the public gateway.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">Private Gateway</emphasis>: All the traffic to and from a private
+        network routed to the VPC through the private gateway. For more information, see <xref
+          linkend="add-gateway-vpc"/>.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">VPN Gateway</emphasis>: The VPC side of a VPN connection.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">Site-to-Site VPN Connection</emphasis>: A hardware-based VPN
+        connection between your VPC and your datacenter, home network, or co-location facility. For
+        more information, see <xref linkend="site-to-site-vpn"/>.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">Customer Gateway</emphasis>: The customer side of a VPN
+        Connection. For more information, see <xref linkend="create-vpn-customer-gateway"/>.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">NAT Instance</emphasis>: An instance that provides Port Address
+        Translation for instances to access the Internet via the public gateway. For more
+        information, see <xref linkend="enable-disable-static-nat-vpc"/>.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">Network ACL</emphasis>:  Network ACL is a group of Network ACL
+        items. Network ACL items are nothing but numbered rules that are evaluated in order,
+        starting with the lowest numbered rule. These rules determine whether traffic is allowed in
+        or out of any tier associated with the network ACL. For more information, see <xref linkend="configure-acl"/>.</para>
+    </listitem>
+  </itemizedlist>
+  <formalpara>
+    <title>Network Architecture in a VPC</title>
+    <para>In a VPC, the following four basic options of network architectures are present:</para>
+  </formalpara>
+  <itemizedlist>
+    <listitem>
+      <para>VPC with a public gateway only</para>
+    </listitem>
+    <listitem>
+      <para>VPC with public and private gateways</para>
+    </listitem>
+    <listitem>
+      <para>VPC with public and private gateways and site-to-site VPN access</para>
+    </listitem>
+    <listitem>
+      <para>VPC with a private gateway only and site-to-site VPN access</para>
+    </listitem>
+  </itemizedlist>
+  <formalpara>
+    <title>Connectivity Options for a VPC</title>
+    <para>You can connect your VPC to:</para>
+  </formalpara>
+  <itemizedlist>
+    <listitem>
+      <para>The Internet through the public gateway.</para>
+    </listitem>
+    <listitem>
+      <para>The corporate datacenter by using a site-to-site VPN connection through the VPN
+        gateway.</para>
+    </listitem>
+    <listitem>
+      <para>Both the Internet and your corporate datacenter by using both the public gateway and a
+        VPN gateway.</para>
+    </listitem>
+  </itemizedlist>
+  <formalpara>
+    <title>VPC Network Considerations</title>
+    <para>Consider the following before you create a VPC:</para>
+  </formalpara>
+  <itemizedlist>
+    <listitem>
+      <para>A VPC, by default, is created in the enabled state.</para>
+    </listitem>
+    <listitem>
+      <para>A VPC can be created in Advance zone only, and can't belong to more than one zone at a
+        time.</para>
+    </listitem>
+    <listitem>
+      <para>The default number of VPCs an account can create is 20. However, you can change it by
+        using the max.account.vpcs global parameter, which controls the maximum number of VPCs an
+        account is allowed to create.</para>
+    </listitem>
+    <listitem>
+      <para>The default number of tiers an account can create within a VPC is 3. You can configure
+        this number by using the vpc.max.networks parameter.</para>
+    </listitem>
+    <listitem>
+      <para>Each tier should have an unique CIDR in the VPC. Ensure that the tier's CIDR should be
+        within the VPC CIDR range.</para>
+    </listitem>
+    <listitem>
+      <para>A tier belongs to only one VPC. </para>
+    </listitem>
+    <listitem>
+      <para>All network tiers inside the VPC should belong to the same account.</para>
+    </listitem>
+    <listitem>
+      <para>When a VPC is created, by default, a SourceNAT IP is allocated to it. The Source NAT IP
+        is released only when the VPC is removed.</para>
+    </listitem>
+    <listitem>
+      <para>A public IP can be used for only one purpose at a time. If the IP is a sourceNAT, it
+        cannot be used for StaticNAT or port forwarding.</para>
+    </listitem>
+    <listitem>
+      <para>The instances can only have a private IP address that you provision. To communicate with
+        the Internet, enable NAT to an instance that you launch in your VPC.</para>
+    </listitem>
+    <listitem>
+      <para>Only new networks can be added to a VPC. The maximum number of networks per VPC is
+        limited by the value you specify in the vpc.max.networks parameter. The default value is
+        three.</para>
+    </listitem>
+    <listitem>
+      <para>The load balancing service can be supported by only one tier inside the VPC.</para>
+    </listitem>
+    <listitem>
+      <para>If an IP address is assigned to a tier:</para>
+      <itemizedlist>
+        <listitem>
+          <para>That IP can't be used by more than one tier at a time in the VPC. For example, if
+            you have tiers A and B, and a public IP1, you can create a port forwarding rule by using
+            the IP either for A or B, but not for both.</para>
+        </listitem>
+        <listitem>
+          <para>That IP can't be used for StaticNAT, load balancing, or port forwarding rules for
+            another guest network inside the VPC.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+    <listitem>
+      <para>Remote access VPN is not supported in VPC networks.</para>
+    </listitem>
+  </itemizedlist>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/vpn.xml
----------------------------------------------------------------------
diff --git a/en-US/vpn.xml b/en-US/vpn.xml
new file mode 100644
index 0000000..1f8098c
--- /dev/null
+++ b/en-US/vpn.xml
@@ -0,0 +1,62 @@
+<?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="vpn">
+  <title>Remote Access VPN</title>
+  <para>&PRODUCT; account owners can create virtual private networks (VPN) to access their virtual
+    machines. If the guest network is instantiated from a network offering that offers the Remote
+    Access VPN service, the virtual router (based on the System VM) is used to provide the service.
+    &PRODUCT; provides a L2TP-over-IPsec-based remote access VPN service to guest virtual networks.
+    Since each network gets its own virtual router, VPNs are not shared across the networks. VPN
+    clients native to Windows, Mac OS X and iOS can be used to connect to the guest networks. The
+    account owner can create and manage users for their VPN. &PRODUCT; does not use its account
+    database for this purpose but uses a separate table. The VPN user database is shared across all
+    the VPNs created by the account owner. All VPN users get access to all VPNs created by the
+    account owner.</para>
+  <note>
+    <para>Make sure that not all traffic goes through the VPN. That is, the route installed by the
+      VPN should be only for the guest network and not for all traffic.</para>
+  </note>
+  <para/>
+  <itemizedlist>
+    <listitem>
+      <para><emphasis role="bold">Road Warrior / Remote Access</emphasis>. Users want to be able to
+        connect securely from a home or office to a private network in the cloud. Typically, the IP
+        address of the connecting client is dynamic and cannot be preconfigured on the VPN
+        server.</para>
+    </listitem>
+    <listitem>
+      <para><emphasis role="bold">Site to Site</emphasis>. In this scenario, two private subnets are
+        connected over the public Internet with a secure VPN tunnel. The cloud user’s subnet (for
+        example, an office network) is connected through a gateway to the network in the cloud. The
+        address of the user’s gateway must be preconfigured on the VPN server in the cloud. Note
+        that although L2TP-over-IPsec can be used to set up Site-to-Site VPNs, this is not the
+        primary intent of this feature. For more information, see <xref linkend="site-to-site-vpn"
+        /></para>
+    </listitem>
+  </itemizedlist>
+  <xi:include href="configure-vpn.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="using-vpn-with-windows.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="using-vpn-with-mac.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="site-to-site-vpn.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/whatis.xml
----------------------------------------------------------------------
diff --git a/en-US/whatis.xml b/en-US/whatis.xml
new file mode 100644
index 0000000..5103b2e
--- /dev/null
+++ b/en-US/whatis.xml
@@ -0,0 +1,41 @@
+<?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="whatis">
+    <title>What Is &PRODUCT;?</title>
+    <para>&PRODUCT; is an open source software platform that pools computing resources to build public, private, and hybrid Infrastructure as a Service (IaaS) clouds. &PRODUCT; manages the network, storage, and compute nodes that make up a cloud infrastructure. Use &PRODUCT; to deploy, manage, and configure cloud computing environments.</para>
+    <para>Typical users are service providers and enterprises. With &PRODUCT;, you can:</para>
+    <itemizedlist>
+        <listitem>
+            <para>Set up an on-demand, elastic cloud computing service. Service providers can sell self service virtual machine instances, storage volumes, and networking configurations over the Internet.</para></listitem>
+        <listitem>
+            <para>Set up an on-premise private cloud for use by employees. Rather than managing virtual machines in the same way as physical machines, with &PRODUCT; an enterprise can offer self-service virtual machines to users without involving IT departments.</para></listitem>
+    </itemizedlist>
+    <mediaobject>
+        <imageobject>
+            <imagedata fileref="./images/1000-foot-view.png" />
+        </imageobject>
+        <textobject><phrase>1000-foot-view.png: Overview of &PRODUCT;</phrase></textobject>
+    </mediaobject>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/whats-in-this-adminguide.xml
----------------------------------------------------------------------
diff --git a/en-US/whats-in-this-adminguide.xml b/en-US/whats-in-this-adminguide.xml
new file mode 100644
index 0000000..68717dd
--- /dev/null
+++ b/en-US/whats-in-this-adminguide.xml
@@ -0,0 +1,28 @@
+<?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="whats-in-this-adminguide">
+        <title>Who Should Read This</title>
+        <para>If you have already installed &PRODUCT; or you want to learn more about the ongoing operation and maintenance of a &PRODUCT;-powered cloud, read this documentation. It will help you start using, configuring, and managing the ongoing operation of your cloud.</para>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/whats-new.xml
----------------------------------------------------------------------
diff --git a/en-US/whats-new.xml b/en-US/whats-new.xml
new file mode 100644
index 0000000..04733c7
--- /dev/null
+++ b/en-US/whats-new.xml
@@ -0,0 +1,55 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter 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.
+-->
+<chapter id="whats-new">
+  <title>What's New in the API?</title>
+  <para>The following describes any new major features of each &PRODUCT; version as it applies to
+  API usage.</para>
+  <section id="whats-new-in-api-4.2">
+    <title>What's New in the API for 4.2</title>
+    <xi:include href="added-API-commands-4.2.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="changed-API-commands-4.2.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="removed-api-4.2.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  </section>
+  <section id="whats-new-in-api-4.1">
+    <title>What's New in the API for 4.1</title>
+    <xi:include href="add-remove-nic.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="ipv6-support.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="vmx-settings-dev.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="reset-ssh-key-dev.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="changed-apicommands-4.1.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="added-API-commands-4-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  </section>
+  <section id="whats-new-in-api-4.0">
+    <title>What's New in the API for 4.0</title>
+    <xi:include href="changed-apicommands-4-0.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="added-API-commands-4-0.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  </section>
+  <section id="whats-new-in-api-3.0">
+    <title>What's New in the API for 3.0</title>
+    <xi:include href="enabling-port-8096.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="stopped-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="change-to-behavior-of-list-commands.xml"
+      xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="removed-API-commands.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="added-API-commands.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="added-error-codes.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  </section>
+</chapter>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/who-should-read-installation.xml
----------------------------------------------------------------------
diff --git a/en-US/who-should-read-installation.xml b/en-US/who-should-read-installation.xml
new file mode 100644
index 0000000..eb55ee4
--- /dev/null
+++ b/en-US/who-should-read-installation.xml
@@ -0,0 +1,28 @@
+<?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="who-should-read-installation">
+    <title>Who Should Read This</title>
+    <para>For those who have already gone through a design phase and planned a more sophisticated deployment, or those who are ready to start scaling up a trial installation.  With the following procedures, you can start using the more powerful features of &PRODUCT;, such as advanced VLAN networking, high availability, additional network elements such as load balancers and firewalls, and support for multiple hypervisors including Citrix XenServer, KVM, and VMware vSphere.</para>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/windows-installation.xml
----------------------------------------------------------------------
diff --git a/en-US/windows-installation.xml b/en-US/windows-installation.xml
new file mode 100644
index 0000000..bcecc80
--- /dev/null
+++ b/en-US/windows-installation.xml
@@ -0,0 +1,30 @@
+<?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="windows-installation">
+	<title>Windows OS Installation</title>
+  <para>Download the installer, CloudInstanceManager.msi, from 
+    <ulink url="http://cloudstack.org/download.html">Download page</ulink> 
+    and run the installer in the newly created Windows VM.
+  </para>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/work-with-usage.xml
----------------------------------------------------------------------
diff --git a/en-US/work-with-usage.xml b/en-US/work-with-usage.xml
new file mode 100644
index 0000000..0017293
--- /dev/null
+++ b/en-US/work-with-usage.xml
@@ -0,0 +1,38 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter 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.
+-->
+<chapter id="work-with-usage">
+  <title>Working with Usage</title>
+  <para>The Usage Server is an optional, separately-installed part of &PRODUCT; that provides
+    aggregated usage records which you can use to create billing integration for &PRODUCT;. The
+    Usage Server works by taking data from the events log and creating summary usage records that
+    you can access using the listUsageRecords API call. </para>
+  <para>The usage records show the amount of resources, such as VM run time or template storage
+    space, consumed by guest instances.</para>
+  <para>The Usage Server runs at least once per day. It can be configured to run multiple times per
+    day.</para>
+  <xi:include href="configure-usage-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="set-usage-limit.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="globally-configured-limits.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="limit-accounts-domains.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+</chapter>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/working-with-documentation.xml
----------------------------------------------------------------------
diff --git a/en-US/working-with-documentation.xml b/en-US/working-with-documentation.xml
new file mode 100644
index 0000000..6774842
--- /dev/null
+++ b/en-US/working-with-documentation.xml
@@ -0,0 +1,32 @@
+<?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.
+-->
+
+<chapter id="working-with-documentation">
+  <title>Preparing and Building &PRODUCT; Documentation</title>
+  <para>This chapter describes how to install publican, how to write new documentation and build a guide as well as how to build a translated version of the documentation using transifex</para>
+  <xi:include href="installing-publican.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="building-documentation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="writing-new-documentation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+  <xi:include href="building-translation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</chapter>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/working-with-hosts.xml
----------------------------------------------------------------------
diff --git a/en-US/working-with-hosts.xml b/en-US/working-with-hosts.xml
new file mode 100644
index 0000000..d1fc74f
--- /dev/null
+++ b/en-US/working-with-hosts.xml
@@ -0,0 +1,39 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter 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.
+-->
+
+<chapter id="working-with-hosts">
+    <title>Working With Hosts</title>
+    <section id="adding-hosts">
+        <title>Adding Hosts</title>
+    <para>Additional hosts can be added at any time to provide more capacity for guest VMs. For requirements and instructions, see <xref linkend="host-add"/>.</para>
+    </section>
+    <xi:include href="scheduled-maintenance-maintenance-mode-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="disable-enable-zones-pods-clusters.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="removing-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="re-install-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="maintain-hypervisors-on-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="change-host-password.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="over-provisioning-service-offering-limits.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="vlan-provisioning.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</chapter>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/working-with-iso.xml
----------------------------------------------------------------------
diff --git a/en-US/working-with-iso.xml b/en-US/working-with-iso.xml
new file mode 100644
index 0000000..9872106
--- /dev/null
+++ b/en-US/working-with-iso.xml
@@ -0,0 +1,33 @@
+<?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="working-with-iso">
+	<title>Working with ISOs</title>
+	<para>&PRODUCT; supports ISOs and their attachment to guest VMs. An ISO is a read-only file that has an ISO/CD-ROM style file system. Users can upload their own ISOs and mount them on their guest VMs.</para>
+	<para>ISOs are uploaded based on a URL. HTTP is the supported protocol. Once the ISO is available via HTTP specify an upload URL such as http://my.web.server/filename.iso.</para>
+	<para>ISOs may be public or private, like templates.ISOs are not hypervisor-specific.  That is, a guest on vSphere can mount the exact same image that a guest on KVM can mount.</para>
+	<para>ISO images may be stored in the system and made available with a privacy level similar to templates. ISO images are classified as either bootable or not bootable. A bootable ISO image is one that contains an OS image. &PRODUCT; allows a user to boot a guest VM off of an ISO image. Users can also attach ISO images to guest VMs. For example, this enables installing PV drivers into Windows.  ISO images are not hypervisor-specific.</para>
+    <xi:include href="add-iso.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="attach-iso-to-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="update-iso-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/working-with-snapshots.xml
----------------------------------------------------------------------
diff --git a/en-US/working-with-snapshots.xml b/en-US/working-with-snapshots.xml
new file mode 100644
index 0000000..2d8cada
--- /dev/null
+++ b/en-US/working-with-snapshots.xml
@@ -0,0 +1,37 @@
+<?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="working-with-snapshots">
+	<title>Working with Snapshots</title>
+    <para>(Supported for the following hypervisors: <emphasis role="bold">XenServer</emphasis>, <emphasis role="bold">VMware vSphere</emphasis>, and <emphasis role="bold">KVM</emphasis>)</para>
+    <para>&PRODUCT; supports snapshots of disk volumes. Snapshots are a point-in-time capture of virtual machine disks. Memory and CPU states are not captured. <!-- If you are using the Oracle VM hypervisor, you can not take snapshots, since OVM does not support them. --></para>
+    <para>Snapshots may be taken for volumes, including both root and data disks. The administrator places a limit on the number of stored snapshots per user. Users can create new volumes from the snapshot for recovery of particular files and they can create templates from snapshots to boot from a restored disk.</para>
+	<para>Users can create snapshots manually or by setting up automatic recurring snapshot policies. Users can also create disk volumes from snapshots, which may be attached to a VM like any other disk volume. Snapshots of both root disks and data disks are supported. However, &PRODUCT; does not currently support booting a VM from a recovered root disk. A disk recovered from snapshot of a root disk is treated as a regular data disk; the data on recovered disk can be accessed by attaching the disk to a VM.</para>
+	<para>A completed snapshot is copied from primary storage to secondary storage, where it is stored until deleted or purged by newer snapshot.</para>
+    <xi:include href="automatic-snapshot-creation-retention.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 
+    <xi:include href="incremental-snapshots-backup.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 
+    <xi:include href="volume-status.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> 
+    <xi:include href="snapshot-restore.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="snapshot-throttling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="snapshot-performance-vmware.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/working-with-system-vm.xml
----------------------------------------------------------------------
diff --git a/en-US/working-with-system-vm.xml b/en-US/working-with-system-vm.xml
new file mode 100644
index 0000000..073d077
--- /dev/null
+++ b/en-US/working-with-system-vm.xml
@@ -0,0 +1,40 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter 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.
+-->
+<chapter id="working-with-system-vm">
+  <title>Working with System Virtual Machines</title>
+  <para>&PRODUCT; uses several types of system virtual machines to perform tasks in the cloud. In
+    general &PRODUCT; manages these system VMs and creates, starts, and stops them as needed based
+    on scale and immediate needs. However, the administrator should be aware of them and their roles
+    to assist in debugging issues.</para>
+  <note>
+    <para>You can configure the system.vm.random.password parameter to create a random system VM
+      password to ensure higher security. If you reset the value for system.vm.random.password to
+      true and restart the Management Server, a random password is generated and stored encrypted in
+      the database. You can view the decrypted password under the system.vm.password global
+      parameter on the &PRODUCT; UI or by calling the listConfigurations API.</para>
+  </note>
+  <xi:include href="system-vm-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="accessing-system-vms.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="multiple-system-vm-vmware.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="console-proxy.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="virtual-router.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="secondary-storage-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+</chapter>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/working-with-templates.xml
----------------------------------------------------------------------
diff --git a/en-US/working-with-templates.xml b/en-US/working-with-templates.xml
new file mode 100644
index 0000000..9f4e750
--- /dev/null
+++ b/en-US/working-with-templates.xml
@@ -0,0 +1,44 @@
+<?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.
+-->
+
+<chapter id="working-with-templates">
+	<title>Working with Templates</title>
+	<para>A template is a reusable configuration for virtual machines. When users launch VMs, they can choose from a list of templates in &PRODUCT;.</para>
+	<para>Specifically, a template is a virtual disk image that includes one of a variety of operating systems, optional additional software such as office applications, and settings such as access control to determine who can use the template. Each template is associated with a particular type of hypervisor, which is specified when the template is added to &PRODUCT;.</para>
+	<para>&PRODUCT; ships with a default template. In order to present more choices to users, &PRODUCT; administrators and users can create templates and add them to &PRODUCT;.</para>
+    <xi:include href="create-templates-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="requirements-templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="best-practices-templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="default-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="private-public-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="create-template-from-existing-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="create-template-from-snapshot.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="upload-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="export-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="create-windows-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="import-ami.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="convert-hyperv-vm-to-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="add-password-management-to-templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="delete-templates.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</chapter>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/working-with-usage-data.xml
----------------------------------------------------------------------
diff --git a/en-US/working-with-usage-data.xml b/en-US/working-with-usage-data.xml
new file mode 100644
index 0000000..5324617
--- /dev/null
+++ b/en-US/working-with-usage-data.xml
@@ -0,0 +1,35 @@
+<?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.
+-->
+
+<chapter id="working-with-usage-data">
+    <title>Working With Usage Data</title>
+    <para>The Usage Server provides aggregated usage records which you can use to create billing integration for the &PRODUCT; platform. The Usage Server works by taking data from the events log and creating summary usage records that you can access using the listUsageRecords API call.</para>
+    <para>The usage records show the amount of resources, such as VM run time or template storage space, consumed by guest instances. In the special case of bare metal instances, no template storage resources are consumed, but records showing zero usage are still included in the Usage Server's output.</para>
+    <para>The Usage Server runs at least once per day. It can be configured to run multiple times per day. Its behavior is controlled by configuration settings as described in the &PRODUCT; Administration Guide.</para>
+    <xi:include href="usage-record-format.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="usage-types.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="example-response-from-listUsageRecords.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="dates-in-usage-record.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    <xi:include href="globally-configured-limits.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</chapter>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/working-with-volumes.xml
----------------------------------------------------------------------
diff --git a/en-US/working-with-volumes.xml b/en-US/working-with-volumes.xml
new file mode 100644
index 0000000..5de5e6c
--- /dev/null
+++ b/en-US/working-with-volumes.xml
@@ -0,0 +1,53 @@
+<?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="working-with-volumes">
+  <title>Working With Volumes</title>
+  <para>A volume provides storage to a guest VM. The volume can provide for a root disk or an
+    additional data disk. &PRODUCT; supports additional volumes for guest VMs. </para>
+  <para>Volumes are created for a specific hypervisor type. A volume that has been attached to guest
+    using one hypervisor type (e.g, XenServer) may not be attached to a guest that is using another
+    hypervisor type, for example:vSphere, KVM. This is because the different hypervisors use different
+    disk image formats. </para>
+  <para>&PRODUCT; defines a volume as a unit of storage available to a guest VM. Volumes are either
+    root disks or data disks. The root disk has "/" in the file system and is usually the boot
+    device. Data disks provide for additional storage, for example: "/opt" or "D:". Every guest VM
+    has a root disk, and VMs can also optionally have a data disk. End users can mount multiple data
+    disks to guest VMs. Users choose data disks from the disk offerings created by administrators.
+    The user can create a template from a volume as well; this is the standard procedure for private
+    template creation. Volumes are hypervisor-specific: a volume from one hypervisor type may not be
+    used on a guest of another hypervisor type. </para>
+  <note>
+    <para>&PRODUCT; supports attaching up to 13 data disks to a VM on XenServer hypervisor versions
+      6.0 and above. For the VMs on other hypervisor types, the data disk limit is 6.</para>
+  </note>
+  <xi:include href="creating-new-volumes.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="upload-existing-volume-to-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="attaching-volume.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="detach-move-volumes.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="vm-storage-migration.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="resizing-volumes.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="reset-volume-on-reboot.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <xi:include href="volume-deletion-garbage-collection.xml"
+    xmlns:xi="http://www.w3.org/2001/XInclude"/>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/writing-new-documentation.xml
----------------------------------------------------------------------
diff --git a/en-US/writing-new-documentation.xml b/en-US/writing-new-documentation.xml
new file mode 100644
index 0000000..7557359
--- /dev/null
+++ b/en-US/writing-new-documentation.xml
@@ -0,0 +1,100 @@
+<?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="writing-new-documentation">
+    <title>Writing &PRODUCT; Documentation</title>
+    <para>&PRODUCT; documentation is written in DocBook xml format. Each guide defined with a publican configuration file refers to a DocBook <emphasis>book</emphasis>.</para> 
+    <para>These books are defined in xml files in docs/en-US, for instance if we look at the Developers guide, its configuration file contains:</para>
+    <programlisting>
+        xml_lang: en-US
+        type: Book
+        docname: Developers_Guide
+        brand: cloudstack
+        chunk_first: 1
+        chunk_section_depth: 1
+    </programlisting>
+    <para>The <emphasis>docname</emphasis> key gives you the basename of the DocBook file located in the en-US directory that contains the description of the book.</para>
+    <para>Looking closely at Developers_Guide.xml we see that it contains <emphasis>book</emphasis> tags and several references to other xml files. These are the chapters of the book, currently they are:</para>
+    <programlisting>
+    <![CDATA[
+        <xi:include href="concepts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="building-with-maven.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="developer-introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="whats-new.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="api-calls.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="working-with-usage-data.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="working-with-documentation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="tools.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="event-types.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="alerts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="time-zones.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+    ]]>
+    </programlisting>
+    <para>All these xml files are written in DocBook format.</para>
+    <note>
+        <para>DocBook format is well <ulink url="http://www.docbook.org/tdg5/en/html/docbook.html">documented</ulink>, refer to the documentation for any questions about DocBook tags</para>
+    </note>
+    <para>When writing documentation, you therefore need to located the book,chapter and section of the content you want to write/correct.
+    Or create a new book,chapter,section.</para>
+    <para>You will then learn much more about DocBook tagging. In order to write this chapter about documentation, I added the <emphasis>working-with-documentation.xml</emphasis>file describing a chapter in the Developer book and I created several sections within that chapter like so:</para>
+    <programlisting>
+    <![CDATA[
+        <chapter id="working-with-documentation">
+            <title>Preparing and Building &PRODUCT; Documentation</title>
+            <para>This chapter describes how to install publican, how to write new documentation and build a guide as well as how to build a translated version of the documentation using transifex</para>
+            <xi:include href="installing-publican.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+            <xi:include href="building-documentation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+            <xi:include href="writing-new-documentation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+            <xi:include href="building-translation.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+        </chapter>
+    ]]>
+    </programlisting>
+
+    <para>Note the id witin the chapter tag, it represents the basename of the xml file describing the chapter.</para>
+    <para>For translation purposes it is important that this basename be less than 50 characters long.</para>
+
+    <para>This chapter also refers to xml files which contains each section. While you could embed the sections directly in the chapter file and as a matter of fact also write the chapters within a single book file. Breaking things up in smaller files at the granularity of the section, allows us to re-use any section to build different books.</para>
+    <para>For completeness here is an example of a section:</para>
+    <programlisting>
+    <![CDATA[
+        <section id="building-documentation">
+            <title>Building &PRODUCT; Documentation</title>
+            <para>To build a specific guide, go to the source tree of the documentation in /docs and identify the guide you want to build.</para>
+            <para>Currently there are four guides plus the release notes, all defined in publican configuration files:</para>
+            <programlisting>
+               publican-adminguide.cfg
+               publican-devguide.cfg
+               publican-installation.cfg
+               publican-plugin-niciranvp.cfg
+               publican-release-notes.cfg
+            </programlisting>
+            <para>To build the Developer guide for example, do the following:</para>
+            <programlisting>publican build --config=publican-devguide.cfg --formats=pdf --langs=en-US</programlisting>
+            <para>A pdf file will be created in tmp/en-US/pdf, you may choose to build the guide in a different format like html. In that case just replace the format value.</para>
+        </section>
+    ]]>
+    </programlisting>
+    <para>Happy Publicating and DocBooking.</para>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/xenserver-maintenance-mode.xml
----------------------------------------------------------------------
diff --git a/en-US/xenserver-maintenance-mode.xml b/en-US/xenserver-maintenance-mode.xml
new file mode 100644
index 0000000..b947278
--- /dev/null
+++ b/en-US/xenserver-maintenance-mode.xml
@@ -0,0 +1,51 @@
+<?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="xenserver-maintenance-mode">
+    <title>XenServer and Maintenance Mode</title>
+    <para>For XenServer, you can take a server offline temporarily by using the Maintenance Mode feature in XenCenter. When you place a server into Maintenance Mode, all running VMs are automatically migrated from it to another host in the same pool. If the server is the pool master, a new master will also be selected for the pool. While a server is Maintenance Mode, you cannot create or start any VMs on it.</para>
+    <para><emphasis role="bold">To place a server in Maintenance Mode:</emphasis></para>
+    <orderedlist>
+        <listitem><para>In the Resources pane, select the server, then do one of the following:</para>
+        <itemizedlist>
+            <listitem><para>Right-click, then click Enter Maintenance Mode on the shortcut menu.</para>
+            </listitem>
+            <listitem><para>On the Server menu, click Enter Maintenance Mode.</para>
+           </listitem>
+        </itemizedlist></listitem> 
+        <listitem><para>Click Enter Maintenance Mode.</para></listitem>        
+    </orderedlist>
+    <para>The server's status in the Resources pane shows when all running VMs have been successfully migrated off the server.</para>
+    <para><emphasis role="bold">To take a server out of Maintenance Mode:</emphasis></para>
+    <orderedlist>
+        <listitem><para>In the Resources pane, select the server, then do one of the following:</para>
+            <itemizedlist>
+                <listitem><para>Right-click, then click Exit Maintenance Mode on the shortcut menu.</para>
+                </listitem>
+                <listitem><para>On the Server menu, click Exit Maintenance Mode.</para>
+                </listitem>
+            </itemizedlist></listitem> 
+        <listitem><para>Click Exit Maintenance Mode.</para></listitem>        
+    </orderedlist>
+    
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/xenserver-topology-req.xml
----------------------------------------------------------------------
diff --git a/en-US/xenserver-topology-req.xml b/en-US/xenserver-topology-req.xml
new file mode 100644
index 0000000..12b9b07
--- /dev/null
+++ b/en-US/xenserver-topology-req.xml
@@ -0,0 +1,24 @@
+<?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="xenserver-topology-req">
+  <title>XenServer Topology Requirements</title>
+  <para>The Management Servers communicate with XenServer hosts on ports 22 (ssh), 80 (HTTP), and 443 (HTTPs).</para>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/zone-add.xml
----------------------------------------------------------------------
diff --git a/en-US/zone-add.xml b/en-US/zone-add.xml
new file mode 100644
index 0000000..4137b67
--- /dev/null
+++ b/en-US/zone-add.xml
@@ -0,0 +1,48 @@
+<?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="zone-add">
+    <title>Adding a Zone</title>
+    <para>When you add a new zone, you will be prompted to configure the zone’s physical network and add the first pod, cluster, host, primary storage, and secondary storage.</para>
+    <orderedlist>
+        <listitem><para>Log in to the &PRODUCT; UI as the root administrator. See <xref linkend="log-in" />.</para></listitem>
+        <listitem><para>In the left navigation, choose Infrastructure.</para></listitem>
+        <listitem><para>On Zones, click View More.</para></listitem>
+        <listitem><para>Click Add Zone. The zone creation wizard will appear.</para></listitem>
+        <listitem><para>Choose one of the following network types:</para>
+            <itemizedlist>
+                <listitem><para><emphasis role="bold">Basic.</emphasis> For AWS-style networking. Provides a single network where each VM instance is assigned an IP directly from the network. Guest isolation can be provided through layer-3 means such as security groups (IP address source filtering).</para></listitem>
+                <listitem><para><emphasis role="bold">Advanced.</emphasis> For more sophisticated network topologies. This network model provides the most flexibility in defining guest networks and providing custom network offerings such as firewall, VPN, or load balancer support.</para></listitem>
+            </itemizedlist>
+        </listitem>
+        <listitem><para>The rest of the steps differ depending on whether you chose Basic or Advanced. Continue with the steps that apply to you:</para>
+            <itemizedlist>
+                <listitem><para><xref linkend="basic-zone-configuration" /></para></listitem>
+                <listitem><para><xref linkend="advanced-zone-configuration" /></para></listitem>
+            </itemizedlist>
+        </listitem>
+    </orderedlist>
+    <xi:include href="basic-zone-configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="advanced-zone-configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/Admin_Guide.pot
----------------------------------------------------------------------
diff --git a/pot/Admin_Guide.pot b/pot/Admin_Guide.pot
new file mode 100644
index 0000000..d3acd9b
--- /dev/null
+++ b/pot/Admin_Guide.pot
@@ -0,0 +1,40 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "&PRODUCT; Administrator's Guide"
+msgstr ""
+
+#. Tag: productname
+#, no-c-format
+msgid "Apache CloudStack"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Administration Guide for &PRODUCT;."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/Author_Group.pot
----------------------------------------------------------------------
diff --git a/pot/Author_Group.pot b/pot/Author_Group.pot
new file mode 100644
index 0000000..7e9c48f
--- /dev/null
+++ b/pot/Author_Group.pot
@@ -0,0 +1,35 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: firstname
+#, no-c-format
+msgid "Apache"
+msgstr ""
+
+#. Tag: surname
+#, no-c-format
+msgid "CloudStack"
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/Book_Info.pot
----------------------------------------------------------------------
diff --git a/pot/Book_Info.pot b/pot/Book_Info.pot
new file mode 100644
index 0000000..a2f0795
--- /dev/null
+++ b/pot/Book_Info.pot
@@ -0,0 +1,45 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "&PRODUCT; Guide"
+msgstr ""
+
+#. Tag: subtitle
+#, no-c-format
+msgid "Revised August 9, 2012 10:48 pm Pacific"
+msgstr ""
+
+#. Tag: productname
+#, no-c-format
+msgid "Apache CloudStack"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Complete technical documentation of &PRODUCT;."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/Book_Info_Release_Notes_4-0.pot
----------------------------------------------------------------------
diff --git a/pot/Book_Info_Release_Notes_4-0.pot b/pot/Book_Info_Release_Notes_4-0.pot
new file mode 100644
index 0000000..ea3ff8b
--- /dev/null
+++ b/pot/Book_Info_Release_Notes_4-0.pot
@@ -0,0 +1,45 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Version 4.0.0-incubating Release Notes"
+msgstr ""
+
+#. Tag: subtitle
+#, no-c-format
+msgid "Revised October 17, 2012 19:49 UTC"
+msgstr ""
+
+#. Tag: productname
+#, no-c-format
+msgid "Apache CloudStack"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Release notes for the Apache CloudStack 4.0.0-incubating release."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/CloudStack_Nicira_NVP_Guide.pot
----------------------------------------------------------------------
diff --git a/pot/CloudStack_Nicira_NVP_Guide.pot b/pot/CloudStack_Nicira_NVP_Guide.pot
new file mode 100644
index 0000000..5320c4b
--- /dev/null
+++ b/pot/CloudStack_Nicira_NVP_Guide.pot
@@ -0,0 +1,40 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "&PRODUCT; Plugin Guide for the Nicira NVP Plugin"
+msgstr ""
+
+#. Tag: productname
+#, no-c-format
+msgid "Apache CloudStack"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Plugin Guide for the Nicira NVP Plugin."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/Common_Content/Legal_Notice.pot
----------------------------------------------------------------------
diff --git a/pot/Common_Content/Legal_Notice.pot b/pot/Common_Content/Legal_Notice.pot
new file mode 100644
index 0000000..f059a2b
--- /dev/null
+++ b/pot/Common_Content/Legal_Notice.pot
@@ -0,0 +1,50 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: para
+#, no-c-format
+msgid "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"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "http://www.apache.org/licenses/LICENSE-2.0"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "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."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Apache CloudStack is an effort undergoing incubation at The Apache Software Foundation (ASF)."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/Developers_Guide.pot
----------------------------------------------------------------------
diff --git a/pot/Developers_Guide.pot b/pot/Developers_Guide.pot
new file mode 100644
index 0000000..c5706c2
--- /dev/null
+++ b/pot/Developers_Guide.pot
@@ -0,0 +1,40 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "&PRODUCT; Developer's Guide"
+msgstr ""
+
+#. Tag: productname
+#, no-c-format
+msgid "Apache CloudStack"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "This guide shows how to develop &PRODUCT;, use the API for operation and integration, access the usage data and use &PRODUCT; specific tools to ease development, testing and integration."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/Installation_Guide.pot
----------------------------------------------------------------------
diff --git a/pot/Installation_Guide.pot b/pot/Installation_Guide.pot
new file mode 100644
index 0000000..ee6bb9d
--- /dev/null
+++ b/pot/Installation_Guide.pot
@@ -0,0 +1,40 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "&PRODUCT; Installation Guide"
+msgstr ""
+
+#. Tag: productname
+#, no-c-format
+msgid "Apache CloudStack"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Installation Guide for &PRODUCT;."
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/LDAPserver-for-user-authentication.pot
----------------------------------------------------------------------
diff --git a/pot/LDAPserver-for-user-authentication.pot b/pot/LDAPserver-for-user-authentication.pot
new file mode 100644
index 0000000..fbac556
--- /dev/null
+++ b/pot/LDAPserver-for-user-authentication.pot
@@ -0,0 +1,60 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Using an LDAP Server for User Authentication"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "You can use an external LDAP server such as Microsoft Active Directory or ApacheDS to authenticate &PRODUCT; end-users. Just map &PRODUCT; accounts to the corresponding LDAP accounts using a query filter. The query filter is written using the query syntax of the particular LDAP server, and can include special wildcard characters provided by &PRODUCT; for matching common values such as the user’s email address and name. &PRODUCT; will search the external LDAP directory tree starting at a specified base directory and return the distinguished name (DN) and password of the matching user. This information along with the given password is used to authenticate the user.."
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "To set up LDAP authentication in &PRODUCT;, call the &PRODUCT; API command ldapConfig and provide the following:"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Hostname or IP address and listening port of the LDAP server"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Base directory and query filter"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "Search user DN credentials, which give &PRODUCT; permission to search on the LDAP server"
+msgstr ""
+
+#. Tag: para
+#, no-c-format
+msgid "SSL keystore and password, if SSL is used"
+msgstr ""
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/pot/Preface.pot
----------------------------------------------------------------------
diff --git a/pot/Preface.pot b/pot/Preface.pot
new file mode 100644
index 0000000..0684f6c
--- /dev/null
+++ b/pot/Preface.pot
@@ -0,0 +1,30 @@
+#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.
+msgid ""
+msgstr ""
+"Project-Id-Version: 0\n"
+"POT-Creation-Date: 2013-02-02T20:11:55\n"
+"PO-Revision-Date: 2013-02-02T20:11:55\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: None\n"
+"MIME-Version: 1.0\n"
+"Content-Type: application/x-publican; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. Tag: title
+#, no-c-format
+msgid "Preface"
+msgstr ""
+


Mime
View raw message