You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by jz...@apache.org on 2013/01/11 22:02:58 UTC
[14/52] [partial] CLOUDSTACK-961: Added dependencies for building
RPMs.
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/isolated-networks.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/isolated-networks.xml b/docs/tmp/en-US/xml/isolated-networks.xml
new file mode 100644
index 0000000..044a84b
--- /dev/null
+++ b/docs/tmp/en-US/xml/isolated-networks.xml
@@ -0,0 +1,47 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="isolated-networks" lang="en-US">
+ <!-- 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.
+ --> <title>Isolated Networks</title>
+ <para>
+ An isolated network can be accessed only by virtual machines of a single account. Isolated networks have the following properties.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Resources such as VLAN are allocated and garbage collected dynamically
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ There is one network offering for the entire network
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The network offering can be upgraded or downgraded but it is for the entire network
+ </para>
+ </listitem>
+
+ </itemizedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/job-status.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/job-status.xml b/docs/tmp/en-US/xml/job-status.xml
new file mode 100644
index 0000000..31562f2
--- /dev/null
+++ b/docs/tmp/en-US/xml/job-status.xml
@@ -0,0 +1,47 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="job-status" lang="en-US">
+ <!-- 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.
+ --> <title>Job Status</title>
+ <para>
+ The key to using an asynchronous command is the job ID that is returned immediately once the command has been executed. With the job ID, you can periodically check the job status by making calls to queryAsyncJobResult command. The command will return three possible job status integer values:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ 0 - Job is still in progress. Continue to periodically poll for any status changes.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 1 - Job has successfully completed. The job will return any successful response values associated with command that was originally executed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 2 - Job has failed to complete. Please check the "jobresultcode" tag for failure reason code and "jobresult" for the failure reason.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/kvm-topology-req.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/kvm-topology-req.xml b/docs/tmp/en-US/xml/kvm-topology-req.xml
new file mode 100644
index 0000000..3c32d34
--- /dev/null
+++ b/docs/tmp/en-US/xml/kvm-topology-req.xml
@@ -0,0 +1,27 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="kvm-topology-req" lang="en-US">
+ <!-- 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.
+ --> <title>KVM Topology Requirements</title>
+ <para>
+ The Management Servers communicate with KVM hosts on port 22 (ssh).
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/large_scale_redundant_setup.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/large_scale_redundant_setup.xml b/docs/tmp/en-US/xml/large_scale_redundant_setup.xml
new file mode 100644
index 0000000..07d8cd2
--- /dev/null
+++ b/docs/tmp/en-US/xml/large_scale_redundant_setup.xml
@@ -0,0 +1,78 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="large_scale_redundant_setup" lang="en-US">
+ <!-- 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.
+ --> <title>Large-Scale Redundant Setup</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/large-scale-redundant-setup.png" width="444" />
+ </imageobject>
+ <textobject>
+ <phrase>Large-Scale Redundant Setup</phrase>
+ </textobject>
+
+ </mediaobject>
+ <para>
+ This diagram illustrates the network architecture of a large-scale &PRODUCT; deployment.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ A layer-3 switching layer is at the core of the data center. A router redundancy protocol like VRRP should be deployed. Typically high-end core switches also include firewall modules. Separate firewall appliances may also be used if the layer-3 switch does not have integrated firewall capabilities. The firewalls are configured in NAT mode. The firewalls provide the following functions:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Forwards HTTP requests and API calls from the Internet to the Management Server. The Management Server resides on the management network.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When the cloud spans multiple zones, the firewalls should enable site-to-site VPN such that servers in different zones can directly reach each other.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ A layer-2 access switch layer is established for each pod. Multiple switches can be stacked to increase port count. In either case, redundant pairs of layer-2 switches should be deployed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The Management Server cluster (including front-end load balancers, Management Server nodes, and the MySQL database) is connected to the management network through a pair of load balancers.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Secondary storage servers are connected to the management network.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Each pod contains storage and computing servers. Each storage and computing server should have redundant NICs connected to separate layer-2 access switches.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/layer2-switch.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/layer2-switch.xml b/docs/tmp/en-US/xml/layer2-switch.xml
new file mode 100644
index 0000000..79fb0ea
--- /dev/null
+++ b/docs/tmp/en-US/xml/layer2-switch.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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="layer2-switch" lang="en-US">
+ <!-- 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.
+ --> <title>Layer-2 Switch</title>
+ <para>
+ The layer-2 switch is the access switching layer inside the pod.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ It should trunk all VLANs into every computing host.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ It should switch traffic for the management network containing computing and storage hosts. The layer-3 switch will serve as the gateway for the management network.
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+ <formalpara>
+ <title>Example Configurations</title>
+ <para>
+ This section contains example configurations for specific switch models for pod-level layer-2 switching. It assumes VLAN management protocols such as VTP or GVRP have been disabled. The scripts must be changed appropriately if you choose to use VTP or GVRP.
+ </para>
+
+ </formalpara>
+ <xi:include href="dell62xx-layer2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="cisco3750-layer2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/lb-policy-pfwd-rule-usage-record-format.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/lb-policy-pfwd-rule-usage-record-format.xml b/docs/tmp/en-US/xml/lb-policy-pfwd-rule-usage-record-format.xml
new file mode 100644
index 0000000..1c8855b
--- /dev/null
+++ b/docs/tmp/en-US/xml/lb-policy-pfwd-rule-usage-record-format.xml
@@ -0,0 +1,84 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="loadbalancer-policy-port-forwarding-rule-usage-record-format" lang="en-US">
+ <!-- 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.
+ --> <title>Load Balancer Policy or Port Forwarding Rule Usage Record Format</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ account - name of the account
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ accountid - ID of the account
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ domainid - ID of the domain in which this account resides
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ zoneid - Zone where the usage occurred
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ description - A string describing what the usage record is tracking
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ usage - String representation of the usage, including the units of usage (e.g. 'Hrs' for hours)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ usagetype - A number representing the usage type (see Usage Types)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ rawusage - A number representing the actual usage in hours
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ usageid - ID of the load balancer policy or port forwarding rule
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ usagetype - A number representing the usage type (see Usage Types)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ startdate, enddate - The range of time for which the usage is aggregated; see Dates in the Usage Record
+ </para>
+ </listitem>
+
+ </itemizedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/linux-installation.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/linux-installation.xml b/docs/tmp/en-US/xml/linux-installation.xml
new file mode 100644
index 0000000..bb1b0b3
--- /dev/null
+++ b/docs/tmp/en-US/xml/linux-installation.xml
@@ -0,0 +1,80 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="linux-installation" lang="en-US">
+ <!-- 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.
+ --> <title>Linux OS Installation</title>
+ <para>
+ Use the following steps to begin the Linux OS installation:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Download the script file cloud-set-guest-password:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Linux: <ulink url="http://cloudstack.org/dl/cloud-set-guest-password" />
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Windows: <ulink url="http://sourceforge.net/projects/cloudstack/files/Password%20Management%20Scripts/CloudInstanceManager.msi/download" />
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ Copy this file to /etc/init.d.
+ </para>
+ <para>
+ On some Linux distributions, copy the file to /etc/rc.d/init.d.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Run the following command to make the script executable:
+ </para>
+
+<programlisting>chmod +x /etc/init.d/cloud-set-guest-password</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Depending on the Linux distribution, continue with the appropriate step.
+ </para>
+ <para>
+ On Fedora, CentOS/RHEL, and Debian, run:
+ </para>
+
+<programlisting>chkconfig --add cloud-set-guest-password</programlisting>
+
+ </listitem>
+
+ </orderedlist>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/load-balancer-rules.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/load-balancer-rules.xml b/docs/tmp/en-US/xml/load-balancer-rules.xml
new file mode 100644
index 0000000..0cac87a
--- /dev/null
+++ b/docs/tmp/en-US/xml/load-balancer-rules.xml
@@ -0,0 +1,34 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="load-balancer-rules" lang="en-US">
+ <!-- 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.
+ --> <title>Load Balancer Rules</title>
+ <para>
+ A &PRODUCT; user or administrator may create load balancing rules that balance traffic received at a public IP to one or more VMs. A user creates a rule, specifies an algorithm, and assigns the rule to a set of VMs.
+ </para>
+ <note>
+ <para>
+ If you create load balancing rules while using a network service offering that includes an external load balancer device such as NetScaler, and later change the network service offering to one that uses the &PRODUCT; virtual router, you must create a firewall rule on the virtual router for each of your existing load balancing rules so that they continue to function.
+ </para>
+ </note>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/log-in-root-admin.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/log-in-root-admin.xml b/docs/tmp/en-US/xml/log-in-root-admin.xml
new file mode 100644
index 0000000..b2a2daa
--- /dev/null
+++ b/docs/tmp/en-US/xml/log-in-root-admin.xml
@@ -0,0 +1,80 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="log-in-root-admin" lang="en-US">
+ <!-- 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.
+ --> <title>Logging In as the Root Administrator</title>
+ <para>
+ After the Management Server software is installed and running, you can run the &PRODUCT; user interface. This UI is there to help you provision, view, and manage your cloud infrastructure.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Open your favorite Web browser and go to this URL. Substitute the IP address of your own Management Server:
+ </para>
+
+<programlisting>http://<management-server-ip-address>:8080/client</programlisting>
+ <para>
+ On a fresh Management Server installation, a guided tour splash screen appears. On later visits, you’ll see a login screen where you can enter a user ID and password and proceed to your Dashboard.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ If you see the first-time splash screen, choose one of the following.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <emphasis role="bold">Continue with basic setup.</emphasis> Choose this if you're just trying &PRODUCT;, and you want a guided walkthrough of the simplest possible configuration so that you can get started right away. We'll help you set up a cloud with the following features: a single machine that runs &PRODUCT; software and uses NFS to provide storage; a single machine running VMs under the XenServer or KVM hypervisor; and a shared public network.
+ </para>
+ <para>
+ The prompts in this guided tour should give you all the information you need, but if you want just a bit more detail, you can follow along in the Trial Installation Guide.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">I have used &PRODUCT; before.</emphasis> Choose this if you have already gone through a design phase and planned a more sophisticated deployment, or you are ready to start scaling up a trial cloud that you set up earlier with the basic setup screens. In the Administrator UI, 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>
+ <para>
+ The root administrator Dashboard appears.
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ You should set a new root administrator password. If you chose basic setup, you’ll be prompted to create a new password right away. If you chose experienced user, use the steps in <xref linkend="changing-root-password" />.
+ </para>
+ </listitem>
+
+ </orderedlist>
+ <warning>
+ <para>
+ You are logging in as the root administrator. This account manages the &PRODUCT; deployment, including physical infrastructure. The root administrator can modify configuration settings to change basic functionality, create or delete user accounts, and take many actions that should be performed only by an authorized person. Please change the default password to a new, unique password.
+ </para>
+ </warning>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/log-in.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/log-in.xml b/docs/tmp/en-US/xml/log-in.xml
new file mode 100644
index 0000000..bbcfc03
--- /dev/null
+++ b/docs/tmp/en-US/xml/log-in.xml
@@ -0,0 +1,68 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="log-in" lang="en-US">
+ <!-- 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.
+ --> <title>Log In to the UI</title>
+ <para>
+ &PRODUCT; provides a web-based UI that can be used by both administrators and end users. The appropriate version of the UI is displayed depending on the credentials used to log in. The UI is available in popular browsers including IE7, IE8, IE9, Firefox 3.5+, Firefox 4, Safari 4, and Safari 5. The URL is: (substitute your own management server IP address)
+ </para>
+
+<programlisting>http://<management-server-ip-address>:8080/client</programlisting>
+ <para>
+ On a fresh Management Server installation, a guided tour splash screen appears. On later visits, you’ll see a login screen where you specify the following to proceed to your Dashboard:
+ </para>
+ <formalpara>
+ <title>Username</title>
+ <para>
+ The user ID of your account. The default username is admin.
+ </para>
+
+ </formalpara>
+ <formalpara>
+ <title>Password</title>
+ <para>
+ The password associated with the user ID. The password for the default username is password.
+ </para>
+
+ </formalpara>
+ <formalpara>
+ <title>Domain</title>
+ <para>
+ If you are a root user, leave this field blank.
+ </para>
+
+ </formalpara>
+ <para>
+ If you are a user in the sub-domains, enter the full path to the domain, excluding the root domain.
+ </para>
+ <para>
+ For example, suppose multiple levels are created under the root domain, such as Comp1/hr. The users in the Comp1 domain should enter Comp1 in the Domain field, whereas the users in the Comp1/sales domain should enter Comp1/sales.
+ </para>
+ <para>
+ For more guidance about the choices that appear when you log in to this UI, see Logging In as the Root Administrator.
+ </para>
+ <xi:include href="end-user-ui-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="root-admin-ui-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="log-in-root-admin.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="changing-root-password.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/long-running-job-events.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/long-running-job-events.xml b/docs/tmp/en-US/xml/long-running-job-events.xml
new file mode 100644
index 0000000..227beba
--- /dev/null
+++ b/docs/tmp/en-US/xml/long-running-job-events.xml
@@ -0,0 +1,67 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="long-running-job-events" lang="en-US">
+ <!-- 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.
+ --> <title>Long Running Job Events</title>
+ <para>
+ The events log records three types of standard events.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ INFO. This event is generated when an operation has been successfully performed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ WARN. This event is generated in the following circumstances.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ When a network is disconnected while monitoring a template download.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When a template download is abandoned.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When an issue on the storage server causes the volumes to fail over to the mirror storage server.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ ERROR. This event is generated when an operation has not been successfully performed
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/maintain-hypervisors-on-hosts.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/maintain-hypervisors-on-hosts.xml b/docs/tmp/en-US/xml/maintain-hypervisors-on-hosts.xml
new file mode 100644
index 0000000..8227b1e
--- /dev/null
+++ b/docs/tmp/en-US/xml/maintain-hypervisors-on-hosts.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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="maintain-hypervisors-on-hosts" lang="en-US">
+ <!-- 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.
+ --> <title>Maintaining Hypervisors on Hosts</title>
+ <para>
+ When running hypervisor software on hosts, be sure all the hotfixes provided by the hypervisor vendor are applied. Track the release of hypervisor patches through your hypervisor vendor’s support channel, and apply patches as soon as possible after they are released. &PRODUCT; will not track or notify you of required hypervisor patches. It is essential that your hosts are completely up to date with the provided hypervisor patches. The hypervisor vendor is likely to refuse to support any system that is not up to date with patches.
+ </para>
+ <note>
+ <para>
+ The lack of up-do-date hotfixes can lead to data corruption and lost VMs.
+ </para>
+ </note>
+ <para>
+ (XenServer) For more information, see <ulink url="http://docs.cloudstack.org/Knowledge_Base/Possible_VM_corruption_if_XenServer_Hotfix_is_not_Applied/Highly_Recommended_Hotfixes_for_XenServer_5.6_SP2">Highly Recommended Hotfixes for XenServer in the &PRODUCT; Knowledge Base</ulink>
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/maintenance-mode-for-primary-storage.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/maintenance-mode-for-primary-storage.xml b/docs/tmp/en-US/xml/maintenance-mode-for-primary-storage.xml
new file mode 100644
index 0000000..c8571bb
--- /dev/null
+++ b/docs/tmp/en-US/xml/maintenance-mode-for-primary-storage.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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="maintenance-mode-for-primary-storage.xml" lang="en-US">
+ <!-- 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.
+ --> <title>Maintenance Mode for Primary Storage</title>
+ <para>
+ Primary storage may be placed into maintenance mode. This is useful, for example, to replace faulty RAM in a storage device. Maintenance mode for a storage device will first stop any new guests from being provisioned on the storage device. Then it will stop all guests that have any volume on that storage device. When all such guests are stopped the storage device is in maintenance mode and may be shut down. When the storage device is online again you may cancel maintenance mode for the device. The &PRODUCT; will bring the device back online and attempt to start all guests that were running at the time of the entry into maintenance mode.
+ </para>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/making-api-request.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/making-api-request.xml b/docs/tmp/en-US/xml/making-api-request.xml
new file mode 100644
index 0000000..5084c2d
--- /dev/null
+++ b/docs/tmp/en-US/xml/making-api-request.xml
@@ -0,0 +1,83 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="making-api-request" lang="en-US">
+ <!-- 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.
+ --> <title>Making API Requests</title>
+ <para>
+ All &PRODUCT; API requests are submitted in the form of a HTTP GET/POST with an associated command and any parameters. A request is composed of the following whether in HTTP or HTTPS:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ &PRODUCT; API URL: This is the web services API entry point(for example, http://www.cloud.com:8080/client/api)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Command: The web services command you wish to execute, such as start a virtual machine or create a disk volume
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Parameters: Any additional required or optional parameters for the command
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ <para>
+ A sample API GET request looks like the following:
+ </para>
+
+<programlisting>http://localhost:8080/client/api?command=deployVirtualMachine&serviceOfferingId=1&diskOfferingId=1&templateId=2&zoneId=4&apiKey=miVr6X7u6bN_sdahOBpjNejPgEsT35eXq-jB8CG20YI3yaxXcgpyuaIRmFI_EJTVwZ0nUkkJbPmY3y2bciKwFQ&signature=Lxx1DM40AjcXU%2FcaiK8RAP0O1hU%3D
+</programlisting>
+ <para>
+ Or in a more readable format:
+ </para>
+
+<programlisting>
+1. http://localhost:8080/client/api
+2. ?command=deployVirtualMachine
+3. &serviceOfferingId=1
+4. &diskOfferingId=1
+5. &templateId=2
+6. &zoneId=4
+7. &apiKey=miVr6X7u6bN_sdahOBpjNejPgEsT35eXqjB8CG20YI3yaxXcgpyuaIRmFI_EJTVwZ0nUkkJbPmY3y2bciKwFQ
+8. &signature=Lxx1DM40AjcXU%2FcaiK8RAP0O1hU%3D
+</programlisting>
+ <para>
+ The first line is the &PRODUCT; API URL. This is the Cloud instance you wish to interact with.
+ </para>
+ <para>
+ The second line refers to the command you wish to execute. In our example, we are attempting to deploy a fresh new virtual machine. It is preceded by a (?) to separate itself from the &PRODUCT; API URL.
+ </para>
+ <para>
+ Lines 3-6 are the parameters for this given command. To see the command and its request parameters, please refer to the appropriate section in the &PRODUCT; API documentation. Each parameter field-value pair (field=value) is preceded by an ampersand character (&).
+ </para>
+ <para>
+ Line 7 is the user API Key that uniquely identifies the account. See Signing API Requests on page 7.
+ </para>
+ <para>
+ Line 8 is the signature hash created to authenticate the user account executing the API command. See Signing API Requests on page 7.
+ </para>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/manage-cloud.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/manage-cloud.xml b/docs/tmp/en-US/xml/manage-cloud.xml
new file mode 100644
index 0000000..d55040b
--- /dev/null
+++ b/docs/tmp/en-US/xml/manage-cloud.xml
@@ -0,0 +1,30 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="manage-cloud" lang="en-US">
+ <!-- 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.
+ --> <title>Managing the Cloud</title>
+ <xi:include href="tagging-resources.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="change-database-config.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="admin-alerts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="customizing-dns.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="stop-restart-management-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</chapter>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-client.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-client.xml b/docs/tmp/en-US/xml/management-server-install-client.xml
new file mode 100644
index 0000000..16b2509
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-client.xml
@@ -0,0 +1,69 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="management-server-install" lang="en-US">
+ <!-- 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.
+ --> <title>Install the Management Server on the First Host</title>
+ <para>
+ The first step in installation, whether you are installing the Management Server on one host or many, is to install the software on a single node.
+ </para>
+ <note>
+ <para>
+ If you are planning to install the Management Server on multiple nodes for high availability, do not proceed to the additional nodes yet. That step will come later.
+ </para>
+
+ </note>
+ <para>
+ The &PRODUCT; Management server can be installed using either RPM or DEB packages. These packages will depend on everything you need to run the Management server.
+ </para>
+ <section id="vhd-util">
+ <title>Downloading vhd-util</title>
+ <para>
+ Before setting up the Management Server, download vhd-util from <ulink url="http://download.cloud.com.s3.amazonaws.com/tools/vhd-util">vhd-util</ulink>
+ </para>
+ <para>
+ If the Management Server is RHEL or CentOS, copy vhd-util to /usr/lib64/cloud/common/scripts/vm/hypervisor/xenserver.
+ </para>
+ <para>
+ If the Management Server is Ubuntu, copy vhd-util to /usr/lib/cloud/common/scripts/vm/hypervisor/xenserver/vhd-util.
+ </para>
+
+ </section>
+
+ <section id="management-server-install-rhel">
+ <title>Install on CentOS/RHEL</title>
+ <para>
+ We start by installing the required packages:
+ </para>
+
+<programlisting language="Bash">yum install cloud-client</programlisting>
+
+ </section>
+
+ <section id="management-server-install-ubuntu">
+ <title>Install on Ubuntu</title>
+
+<programlisting language="Bash">apt-get install cloud-client</programlisting>
+
+ </section>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-complete.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-complete.xml b/docs/tmp/en-US/xml/management-server-install-complete.xml
new file mode 100644
index 0000000..ac3bf4d
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-complete.xml
@@ -0,0 +1,54 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="installation-complete" lang="en-US">
+ <!-- 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.
+ --> <title>Installation Complete! Next Steps</title>
+ <para>
+ Congratulations! You have now installed &PRODUCT; Management Server and the database it uses to persist system data.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/installation-complete.png" width="444" />
+ </imageobject>
+ <textobject>
+ <phrase>installation-complete.png: Finished installs with single Management Server and multiple Management Servers</phrase>
+ </textobject>
+
+ </mediaobject>
+ <para>
+ What should you do next?
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Even without adding any cloud infrastructure, you can run the UI to get a feel for what's offered and how you will interact with &PRODUCT; on an ongoing basis. See Log In to the UI.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When you're ready, add the cloud infrastructure and try running some virtual machines on it, so you can watch how &PRODUCT; manages the infrastructure. See Provision Your Cloud Infrastructure.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-db-external.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-db-external.xml b/docs/tmp/en-US/xml/management-server-install-db-external.xml
new file mode 100644
index 0000000..27e4f3d
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-db-external.xml
@@ -0,0 +1,185 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="management-server-install-db-external" lang="en-US">
+ <!-- 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.
+ --> <title>Install the Database on a Separate Node</title>
+ <para>
+ This section describes how to install MySQL on a standalone machine, separate from the Management Server. This technique is intended for a deployment that includes several Management Server nodes. If you have a single-node Management Server deployment, you will typically use the same node for MySQL. See <xref linkend="management-server-install-db-local" />.
+ </para>
+ <note>
+ <para>
+ The management server doesn't require a specific distribution for the MySQL node. You can use a distribution or Operating System of your choice. Using the same distribution as the management server is recommended, but not required. See <xref linkend="management-server-system-requirements" />.
+ </para>
+
+ </note>
+ <orderedlist>
+ <listitem>
+ <para>
+ Install MySQL from the package repository from your distribution:
+ </para>
+
+<programlisting language="Bash">yum install mysql-server</programlisting>
+
+<programlisting language="Bash">apt-get install mysql-server</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Edit the MySQL configuration (/etc/my.cnf or /etc/mysql/my.cnf, depending on your OS) and insert the following lines in the [mysqld] section. You can put these lines below the datadir line. The max_connections parameter should be set to 350 multiplied by the number of Management Servers you are deploying. This example assumes two Management Servers.
+ </para>
+ <note>
+ <para>
+ On Ubuntu you can also create a file /etc/mysql/conf.d/cloudstack.cnf and add these directives there. Don't forget to add [mysqld] on the first line of the file.
+ </para>
+
+ </note>
+
+<programlisting>
+innodb_rollback_on_timeout=1
+innodb_lock_wait_timeout=600
+max_connections=700
+log-bin=mysql-bin
+binlog-format = 'ROW'
+bind-address = 0.0.0.0
+</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ On RHEL/CentOS MySQL doesn't start after installation, start it manually.
+ </para>
+
+<programlisting language="Bash">service mysqld start</programlisting>
+
+ </listitem>
+ <listitem>
+ <warning>
+ <para>
+ On RHEL and CentOS, MySQL does not set a root password by default. It is very strongly recommended that you set a root password as a security precaution. Run the following commands, and substitute your own desired root password. This step is not required on Ubuntu as it asks for a root password during installation.
+ </para>
+
+ </warning>
+ <para>
+ Run this command to secure your installation. You can answer "Y" to all questions except to "Disallow root login remotely?". This is required to set up the databases.
+ </para>
+
+<programlisting>mysql_secure_installation</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ If a firewall is present on the system, open TCP port 3306 so external MySQL connections can be established.
+ </para>
+ <orderedlist numeration="loweralpha">
+ <listitem>
+ <para>
+ On RHEL/CentOS:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Edit the /etc/sysconfig/iptables file and add the following line at the beginning of the INPUT chain.
+ </para>
+
+<programlisting>-A INPUT -p tcp --dport 3306 -j ACCEPT</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Now reload the iptables rules.
+ </para>
+
+<programlisting language="Bash">service iptables restart</programlisting>
+
+ </listitem>
+
+ </orderedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ On Ubuntu:
+ </para>
+ <para>
+ UFW is the default firewall on Ubuntu, open the port with this command:
+ </para>
+
+<programlisting language="Bash">ufw allow mysql</programlisting>
+
+ </listitem>
+
+ </orderedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ Set up the database. The following command creates the cloud user on the database.
+ </para>
+ <note>
+ <para>
+ This command should be run on the first Management server node!
+ </para>
+
+ </note>
+ <itemizedlist>
+ <listitem>
+ <para>
+ In dbpassword, specify the password to be assigned to the cloud user. You can choose to provide no password.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ In deploy-as, specify the username and password of the user deploying the database. In the following command, it is assumed the root user is deploying the database and creating the cloud user.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ (Optional) For encryption_type, use file or web to indicate the technique used to pass in the database encryption password. Default: file. See About Password and Key Encryption.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ (Optional) For management_server_key, substitute the default key that is used to encrypt confidential parameters in the &PRODUCT; properties file. Default: password. It is highly recommended that you replace this with a more secure value. See About Password and Key Encryption.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ (Optional) For database_key, substitute the default key that is used to encrypt confidential parameters in the &PRODUCT; database. Default: password. It is highly recommended that you replace this with a more secure value. See About Password and Key Encryption.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+<programlisting language="Bash">cloud-setup-databases cloud:<dbpassword>@<ip address mysql server> \
+ --deploy-as=root:<password> \
+ -e <encryption_type> \
+ -m <management_server_key> \
+ -k <database_key></programlisting>
+ <para>
+ When this script is finished, you should see a message like “Successfully initialized the database.”
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-db-local.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-db-local.xml b/docs/tmp/en-US/xml/management-server-install-db-local.xml
new file mode 100644
index 0000000..831bc88
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-db-local.xml
@@ -0,0 +1,127 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="management-server-install-db-local" lang="en-US">
+ <!-- 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.
+ --> <title>Install the Database on the Management Server Node</title>
+ <para>
+ This section describes how to install MySQL on the same machine with the Management Server. This technique is intended for a simple deployment that has a single Management Server node. If you have a multi-node Management Server deployment, you will typically use a separate node for MySQL. See <xref linkend="management-server-install-db-external" />.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Install MySQL from the package repository from your distribution:
+ </para>
+
+<programlisting language="Bash">yum install mysql-server</programlisting>
+
+<programlisting language="Bash">apt-get install mysql-server</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Edit the MySQL configuration (/etc/my.cnf or /etc/mysql/my.cnf, depending on your OS) and insert the following lines in the [mysqld] section. You can put these lines below the datadir line. The max_connections parameter should be set to 350 multiplied by the number of Management Servers you are deploying. This example assumes one Management Server.
+ </para>
+ <note>
+ <para>
+ On Ubuntu you can also create a file /etc/mysql/conf.d/cloudstack.cnf and add these directives there. Don't forget to add [mysqld] on the first line of the file.
+ </para>
+
+ </note>
+
+<programlisting>
+innodb_rollback_on_timeout=1
+innodb_lock_wait_timeout=600
+max_connections=350
+log-bin=mysql-bin
+binlog-format = 'ROW'
+</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ On RHEL/CentOS MySQL doesn't start after installation, start it manually.
+ </para>
+
+<programlisting language="Bash">service mysqld start</programlisting>
+
+ </listitem>
+ <listitem>
+ <warning>
+ <para>
+ On RHEL and CentOS, MySQL does not set a root password by default. It is very strongly recommended that you set a root password as a security precaution. Run the following commands, and substitute your own desired root password. This step is not required on Ubuntu as it asks for a root password during installation.
+ </para>
+
+ </warning>
+ <para>
+ Run this command to secure your installation. Since we are running MySQL locally you can answer "Y" to all questions.
+ </para>
+
+<programlisting>mysql_secure_installation</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Set up the database. The following command creates the "cloud" user on the database.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ In dbpassword, specify the password to be assigned to the "cloud" user. You can choose to provide no password although that is not recommended.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ In deploy-as, specify the username and password of the user deploying the database. In the following command, it is assumed the root user is deploying the database and creating the "cloud" user.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ (Optional) For encryption_type, use file or web to indicate the technique used to pass in the database encryption password. Default: file. See About Password and Key Encryption.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ (Optional) For management_server_key, substitute the default key that is used to encrypt confidential parameters in the &PRODUCT; properties file. Default: password. It is highly recommended that you replace this with a more secure value. See About Password and Key Encryption.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ (Optional) For database_key, substitute the default key that is used to encrypt confidential parameters in the &PRODUCT; database. Default: password. It is highly recommended that you replace this with a more secure value. See About Password and Key Encryption.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+<programlisting language="Bash">cloud-setup-databases cloud:<dbpassword>@localhost \
+ --deploy-as=root:<password> \
+ -e <encryption_type> \
+ -m <management_server_key> \
+ -k <database_key></programlisting>
+ <para>
+ When this script is finished, you should see a message like “Successfully initialized the database.”
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-db.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-db.xml b/docs/tmp/en-US/xml/management-server-install-db.xml
new file mode 100644
index 0000000..af01355
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-db.xml
@@ -0,0 +1,34 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="management-server-install-db" lang="en-US">
+ <!-- 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.
+ --> <title>Install the database server</title>
+ <para>
+ The &PRODUCT; management server uses a MySQL database server to store it's data. When you are installing the management server on a single node you can install the MySQL server locally. When using a multi-node installation the MySQL database has to run on an external node.
+ </para>
+ <para>
+ &PRODUCT; has been tested with MySQL 5.1 and 5.5, both should work fine. These versions are included in RHEL/CentOS and Ubuntu.
+ </para>
+ <xi:include href="management-server-install-db-local.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-db-external.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-flow.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-flow.xml b/docs/tmp/en-US/xml/management-server-install-flow.xml
new file mode 100644
index 0000000..b9799e2
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-flow.xml
@@ -0,0 +1,34 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="management-server-install-flow" lang="en-US">
+ <!-- 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.
+ --> <title>Management Server Installation</title>
+ <xi:include href="management-server-install-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-prepare-os.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-client.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-db.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-nfs-shares.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-multi-node.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-systemvm.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="management-server-install-complete.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-multi-node.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-multi-node.xml b/docs/tmp/en-US/xml/management-server-install-multi-node.xml
new file mode 100644
index 0000000..319f84e
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-multi-node.xml
@@ -0,0 +1,92 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="install-management-server-multi-nodes" lang="en-US">
+ <!-- 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.
+ --> <title>Prepare and Start Additional Management Servers</title>
+ <para>
+ For your second and subsequent Management Servers, you will install the Management Server software, connect it to the database, and set up the OS for the Management Server.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Perform the steps in <xref linkend="prepare-os" /> and <xref linkend="sect-source-buildrpm" /> or <xref linkend="sect-source-builddebs" /> as appropriate.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Download vhd-util from <ulink url="http://download.cloud.com.s3.amazonaws.com/tools/vhd-util">vhd-util</ulink>
+ </para>
+ <para>
+ If the Management Server is RHEL or CentOS, copy vhd-util to /usr/lib64/cloud/common/scripts/vm/hypervisor/xenserver.
+ </para>
+ <para>
+ If the Management Server is Ubuntu, copy vhd-util to /usr/lib/cloud/common/scripts/vm/hypervisor/xenserver/vhd-util.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Ensure that necessary services are started and set to start on boot.
+<programlisting><prompt>#</prompt> <command>service</command> rpcbind start
+<prompt>#</prompt> <command>service</command> nfs start
+<prompt>#</prompt> <command>chkconfig</command> nfs on
+<prompt>#</prompt> <command>chkconfig</command> rpcbind on</programlisting>
+
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Configure the database client. Note the absence of the --deploy-as argument in this case. (For more details about the arguments to this command, see <xref linkend="management-server-install-db-external" />.)
+ </para>
+
+<programlisting><prompt>#</prompt> <command>cloud-setup-databases</command> cloud:<replaceable>dbpassword</replaceable>@<replaceable>dbhost</replaceable> -e <replaceable>encryption_type</replaceable> -m <replaceable>management_server_key</replaceable> -k <replaceable>database_key</replaceable></programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Configure the OS and start the Management Server:
+ </para>
+
+<programlisting><prompt>#</prompt> <command>cloud-setup-management</command></programlisting>
+ <para>
+ The Management Server on this node should now be running.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Repeat these steps on each additional Management Server.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Be sure to configure a load balancer for the Management Servers. See Management Server Load Balancing.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-nfs-shares.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-nfs-shares.xml b/docs/tmp/en-US/xml/management-server-install-nfs-shares.xml
new file mode 100644
index 0000000..d87eb64
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-nfs-shares.xml
@@ -0,0 +1,60 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="prepare-nfs-shares" lang="en-US">
+ <!-- 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.
+ --> <title>Prepare NFS Shares</title>
+ <para>
+ &PRODUCT; needs a place to keep primary and secondary storage (see Cloud Infrastructure Overview). Both of these can be NFS shares. This section tells how to set up the NFS shares before adding the storage to &PRODUCT;.
+ </para>
+ <note>
+ <title>Alternative Storage</title>
+ <para>
+ NFS is not the only option for primary or secondary storage. For example, you may use a Ceph RDB cluster, GlusterFS, iSCSI, and otthers.
+ </para>
+
+ </note>
+ <para>
+ The requirements for primary and secondary storage are described in:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <xref linkend="about-primary-storage" />
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <xref linkend="about-secondary-storage" />
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ <para>
+ A production installation typically uses a separate NFS server. See <xref linkend="nfs-shares-on-separate-server" />.
+ </para>
+ <para>
+ You can also use the Management Server node as the NFS server. This is more typical of a trial installation, but is technically possible in a larger deployment. See <xref linkend="nfs-shares-on-management-server" />.
+ </para>
+ <xi:include href="nfs-shares-on-separate-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="nfs-shares-on-management-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-overview.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-overview.xml b/docs/tmp/en-US/xml/management-server-install-overview.xml
new file mode 100644
index 0000000..f0c7c35
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-overview.xml
@@ -0,0 +1,94 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="management-server-installation-overview" lang="en-US">
+ <!-- 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.
+ --> <title>Management Server Installation Overview</title>
+ <para>
+ This section describes installing the Management Server. There are two slightly different installation flows, depending on how many Management Server nodes will be in your cloud:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ A single Management Server node, with MySQL on the same node.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Multiple Management Server nodes, with MySQL on a node separate from the Management Servers.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ <para>
+ In either case, each machine must meet the system requirements described in System Requirements.
+ </para>
+ <warning>
+ <para>
+ For the sake of security, be sure the public Internet can not access port 8096 or port 8250 on the Management Server.
+ </para>
+ </warning>
+ <para>
+ The procedure for installing the Management Server is:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Prepare the Operating System
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Download and install vhd-util.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Install the First Management Server
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Install and Configure the MySQL database
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Prepare NFS Shares
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Prepare and Start Additional Management Servers (optional)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Prepare the System VM Template
+ </para>
+ </listitem>
+
+ </orderedlist>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-prepare-os.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-prepare-os.xml b/docs/tmp/en-US/xml/management-server-install-prepare-os.xml
new file mode 100644
index 0000000..52e1860
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-prepare-os.xml
@@ -0,0 +1,85 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="prepare-os" lang="en-US">
+ <!-- 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.
+ --> <title>Prepare the Operating System</title>
+ <para>
+ The OS must be prepared to host the Management Server using the following steps. These steps must be performed on each Management Server node.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in to your OS as root.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Check for a fully qualified hostname.
+ </para>
+
+<programlisting language="Bash">hostname --fqdn</programlisting>
+ <para>
+ This should return a fully qualified hostname such as "managament1.lab.example.org". If it does not, edit /etc/hosts so that it does.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Make sure that the machine can reach the Internet.
+ </para>
+
+<programlisting language="Bash">ping www.cloudstack.org</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Turn on NTP for time synchronization.
+ </para>
+ <note>
+ <para>
+ NTP is required to synchronize the clocks of the servers in your cloud.
+ </para>
+ </note>
+ <orderedlist numeration="loweralpha">
+ <listitem>
+ <para>
+ Install NTP.
+ </para>
+
+<programlisting language="Bash">yum install ntp</programlisting>
+
+<programlisting language="Bash">apt-get install openntpd</programlisting>
+
+ </listitem>
+
+ </orderedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ Repeat all of these steps on every host where the Management Server will be installed.
+ </para>
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-install-systemvm.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-install-systemvm.xml b/docs/tmp/en-US/xml/management-server-install-systemvm.xml
new file mode 100644
index 0000000..b83eacb
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-install-systemvm.xml
@@ -0,0 +1,98 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="prepare-system-vm-template" lang="en-US">
+ <!-- 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.
+ --> <title>Prepare the System VM Template</title>
+ <para>
+ Secondary storage must be seeded with a template that is used for &PRODUCT; system VMs.
+ </para>
+ <note>
+ <para>
+ When copying and pasting a command, be sure the command has pasted as a single line before executing. Some document viewers may introduce unwanted line breaks in copied text.
+ </para>
+
+ </note>
+ <orderedlist>
+ <listitem>
+ <para>
+ On the Management Server, run one or more of the following cloud-install-sys-tmplt commands to retrieve and decompress the system VM template. Run the command for each hypervisor type that you expect end users to run in this Zone.
+ </para>
+ <para>
+ If your secondary storage mount point is not named /mnt/secondary, substitute your own mount point name.
+ </para>
+ <para>
+ If you set the &PRODUCT; database encryption type to "web" when you set up the database, you must now add the parameter -s <management-server-secret-key>. See About Password and Key Encryption.
+ </para>
+ <para>
+ This process will require approximately 5 GB of free space on the local file system and up to 30 minutes each time it runs.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ For XenServer:
+ </para>
+
+<programlisting># /usr/lib64/cloud/common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.vhd.bz2 -h xenserver -s <optional-management-server-secret-key> -F</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ For vSphere:
+ </para>
+
+<programlisting># /usr/lib64/cloud/common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/burbank/burbank-systemvm-08012012.ova -h vmware -s <optional-management-server-secret-key> -F</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ For KVM:
+ </para>
+
+<programlisting># /usr/lib64/cloud/common/scripts/storage/secondary/cloud-install-sys-tmplt -m /mnt/secondary -u http://download.cloud.com/templates/acton/acton-systemvm-02062012.qcow2.bz2 -h kvm -s <optional-management-server-secret-key> -F</programlisting>
+
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ If you are using a separate NFS server, perform this step. If you are using the Management Server as the NFS server, you MUST NOT perform this step.
+ </para>
+ <para>
+ When the script has finished, unmount secondary storage and remove the created directory.
+ </para>
+
+<programlisting># umount /mnt/secondary
+# rmdir /mnt/secondary</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Repeat these steps for each secondary storage server.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/management-server-lb.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/management-server-lb.xml b/docs/tmp/en-US/xml/management-server-lb.xml
new file mode 100644
index 0000000..dec371a
--- /dev/null
+++ b/docs/tmp/en-US/xml/management-server-lb.xml
@@ -0,0 +1,134 @@
+<?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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="management-server-lb" lang="en-US">
+ <!-- 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.
+ --> <title>Setting Zone VLAN and Running VM Maximums</title>
+ <para>
+ &PRODUCT; can use a load balancer to provide a virtual IP for multiple Management Servers. The administrator is responsible for creating the load balancer rules for the Management Servers. The application requires persistence or stickiness across multiple sessions. The following chart lists the ports that should be load balanced and whether or not persistence is required.
+ </para>
+ <para>
+ Even if persistence is not required, enabling it is permitted.
+ </para>
+ <informaltable>
+ <tgroup align="left" cols="4" colsep="1" rowsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>
+ Source Port
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Destination Port
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Protocol
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Persistence Required?
+ </para>
+ </entry>
+
+ </row>
+
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>
+ 80 or 443
+ </para>
+ </entry>
+ <entry>
+ <para>
+ 8080 (or 20400 with AJP)
+ </para>
+ </entry>
+ <entry>
+ <para>
+ HTTP (or AJP)
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Yes
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ 8250
+ </para>
+ </entry>
+ <entry>
+ <para>
+ 8250
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TCP
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Yes
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ 8096
+ </para>
+ </entry>
+ <entry>
+ <para>
+ 8096
+ </para>
+ </entry>
+ <entry>
+ <para>
+ HTTP
+ </para>
+ </entry>
+ <entry>
+ <para>
+ No
+ </para>
+ </entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+
+ </informaltable>
+</section>
+
+