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
[11/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/remove-member-from-project.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/remove-member-from-project.xml b/docs/tmp/en-US/xml/remove-member-from-project.xml
new file mode 100644
index 0000000..ed11864
--- /dev/null
+++ b/docs/tmp/en-US/xml/remove-member-from-project.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="remove-member-from-project" 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>Removing a Member From a Project</title>
+ <para>
+ When a member is removed from a project, the member’s resources continue to be owned by the project. The former project member cannot create any new resources within the project or use any of the project’s existing resources.
+ </para>
+ <para>
+ A member of a project can be removed by the project administrator, the domain administrator of the domain the project belongs to or of its parent domain, or the &PRODUCT; root administrator.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in to the &PRODUCT; UI.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation, click Projects.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ In Select View, choose Projects.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the name of the project.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the Accounts tab.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the name of the member.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the Delete button.
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/delete-button.png" />
+ </imageobject>
+ <textobject>
+ <phrase>deletebutton.png: Removes a member</phrase>
+ </textobject>
+
+ </inlinemediaobject>
+ </para>
+ </listitem>
+
+ </orderedlist>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/remove-tier.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/remove-tier.xml b/docs/tmp/en-US/xml/remove-tier.xml
new file mode 100644
index 0000000..6c108e7
--- /dev/null
+++ b/docs/tmp/en-US/xml/remove-tier.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="remove-tier" 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>Removing Tiers</title>
+ <para>
+ You can remove a tier from a VPC. A removed tier cannot be revoked. When a tier is removed, only the resources of the tier are expunged. All the network rules (port forwarding, load balancing and staticNAT) and the IP addresses associated to the tier are removed. The IP address still be belonging to the same VPC.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in to the &PRODUCT; UI as an administrator or end user.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation, choose Network.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the Select view, select VPC.
+ </para>
+ <para>
+ All the VPC that you have created for the account is listed in the page.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Configure button of the VPC for which you want to set up tiers.
+ </para>
+ <para>
+ The Configure VPC page is displayed. Locate the tier you want to work with.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Remove VPC button:
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/remove-tier.png" />
+ </imageobject>
+ <textobject>
+ <phrase>remove-tier.png: removing a tier from a vpc.</phrase>
+ </textobject>
+
+ </mediaobject>
+ <para>
+ Wait for some time for the tier to be removed.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/remove-vpc.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/remove-vpc.xml b/docs/tmp/en-US/xml/remove-vpc.xml
new file mode 100644
index 0000000..021480d
--- /dev/null
+++ b/docs/tmp/en-US/xml/remove-vpc.xml
@@ -0,0 +1,99 @@
+<?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="remove-vpc" 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>Editing, Restarting, and Removing a Virtual Private Cloud</title>
+ <note>
+ <para>
+ Ensure that all the tiers are removed before you remove a VPC.
+ </para>
+
+ </note>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in to the &PRODUCT; UI as an administrator or end user.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation, choose Network.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the Select view, select VPC.
+ </para>
+ <para>
+ All the VPCs that you have created for the account is listed in the page.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Select the VPC you want to work with.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ To remove, click the Remove VPC button
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/remove-vpc.png" />
+ </imageobject>
+ <textobject>
+ <phrase>remove-vpc.png: button to remove a VPC</phrase>
+ </textobject>
+
+ </inlinemediaobject>
+ </para>
+ <para>
+ You can edit the name and description of a VPC. To do that, select the VPC, then click the Edit button.
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/edit-icon.png" />
+ </imageobject>
+ <textobject>
+ <phrase>edit-icon.png: button to edit a VPC</phrase>
+ </textobject>
+
+ </inlinemediaobject>
+ </para>
+ <para>
+ To restart a VPC, select the VPC, then click the Restart button.
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/restart-vpc.png" />
+ </imageobject>
+ <textobject>
+ <phrase>restart-vpc.png: button to restart a VPC</phrase>
+ </textobject>
+
+ </inlinemediaobject>
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/removed-API-commands.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/removed-API-commands.xml b/docs/tmp/en-US/xml/removed-API-commands.xml
new file mode 100644
index 0000000..6c9cb0e
--- /dev/null
+++ b/docs/tmp/en-US/xml/removed-API-commands.xml
@@ -0,0 +1,40 @@
+<?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="removed-API-commands" 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>Removed API commands</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ createConfiguration (Adds configuration value)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ configureSimulator (Configures simulator)
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/removing-hosts.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/removing-hosts.xml b/docs/tmp/en-US/xml/removing-hosts.xml
new file mode 100644
index 0000000..c03f6179
--- /dev/null
+++ b/docs/tmp/en-US/xml/removing-hosts.xml
@@ -0,0 +1,31 @@
+<?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="removing-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>Removing Hosts</title>
+ <para>
+ Hosts can be removed from the cloud as needed. The procedure to remove a host depends on the hypervisor type.
+ </para>
+ <xi:include href="removing-xenserver-kvm-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="removing-vsphere-hosts.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/removing-vsphere-hosts.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/removing-vsphere-hosts.xml b/docs/tmp/en-US/xml/removing-vsphere-hosts.xml
new file mode 100644
index 0000000..252ef21
--- /dev/null
+++ b/docs/tmp/en-US/xml/removing-vsphere-hosts.xml
@@ -0,0 +1,29 @@
+<?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="removing-vsphere-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>Removing vSphere Hosts</title>
+ <para>
+ To remove this type of host, first place it in maintenance mode, as described in <xref linkend="scheduled-maintenance-maintenance-mode-hosts" />. Then use &PRODUCT; to remove the host. &PRODUCT; will not direct commands to a host that has been removed using &PRODUCT;. However, the host may still exist in the vCenter cluster.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/removing-xenserver-kvm-hosts.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/removing-xenserver-kvm-hosts.xml b/docs/tmp/en-US/xml/removing-xenserver-kvm-hosts.xml
new file mode 100644
index 0000000..5c5ad0c
--- /dev/null
+++ b/docs/tmp/en-US/xml/removing-xenserver-kvm-hosts.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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="removing-xenserver-kvm-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>Removing XenServer and KVM Hosts</title>
+ <para>
+ A node cannot be removed from a cluster until it has been placed in maintenance mode. This will ensure that all of the VMs on it have been migrated to other Hosts. To remove a Host from the cloud:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Place the node in maintenance mode.
+ </para>
+ <para>
+ See <xref linkend="scheduled-maintenance-maintenance-mode-hosts" />.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ For KVM, stop the cloud-agent service.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Use the UI option to remove the node.
+ </para>
+ <para>
+ Then you may power down the Host, re-use its IP address, re-install it, etc
+ </para>
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/requirements-templates.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/requirements-templates.xml b/docs/tmp/en-US/xml/requirements-templates.xml
new file mode 100644
index 0000000..78572e4
--- /dev/null
+++ b/docs/tmp/en-US/xml/requirements-templates.xml
@@ -0,0 +1,38 @@
+<?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="requirements-templates" 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>Requirements for Templates</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ For XenServer, install PV drivers / Xen tools on each template that you create. This will enable live migration and clean guest shutdown.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ For vSphere, install VMware Tools on each template that you create. This will enable console view to work properly.
+ </para>
+ </listitem>
+ </itemizedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/resizing-volumes.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/resizing-volumes.xml b/docs/tmp/en-US/xml/resizing-volumes.xml
new file mode 100644
index 0000000..8a89eff
--- /dev/null
+++ b/docs/tmp/en-US/xml/resizing-volumes.xml
@@ -0,0 +1,65 @@
+<?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="resizing-volumes" 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>Resizing Volumes</title>
+ <para>
+ &PRODUCT; does not provide the ability to resize root disks or data disks; the disk size is fixed based on the template used to create the VM. However, the tool <ulink url="http://vmtoolkit.com/files/folders/converters/entry87.aspx/"> VHD Resizer</ulink>), while not officially supported by Cloud.com or Citrix, might provide a workaround. To increase disk size with VHD Resizer:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Get the VHD from the secondary storage.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Import it into VHD Resizer.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Resize the VHD.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Upload the new VHD.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Create a new VM.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Take a snapshot, then create a new template from that snapshot.
+ </para>
+ <para>
+ For more information, see <ulink url="http://support.citrix.com/article/CTX118608/"> How to Resize a Provisioning Server 5 Virtual Disk </ulink> at the Citrix Knowledge Center
+ </para>
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/response-formats.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/response-formats.xml b/docs/tmp/en-US/xml/response-formats.xml
new file mode 100644
index 0000000..803da8d
--- /dev/null
+++ b/docs/tmp/en-US/xml/response-formats.xml
@@ -0,0 +1,63 @@
+<?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="response-formats" 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>Response Formats: XML and JSON</title>
+ <para>
+ CloudStack supports two formats as the response to an API call. The default response is XML. If you would like the response to be in JSON, add &response=json to the Command String.
+ </para>
+ <para>
+ Sample XML Response:
+ </para>
+
+<programlisting>
+ <listipaddressesresponse>
+ <allocatedipaddress>
+ <ipaddress>192.168.10.141</ipaddress>
+ <allocated>2009-09-18T13:16:10-0700</allocated>
+ <zoneid>4</zoneid>
+ <zonename>WC</zonename>
+ <issourcenat>true</issourcenat>
+ </allocatedipaddress>
+ </listipaddressesresponse>
+</programlisting>
+ <para>
+ Sample JSON Response:
+ </para>
+
+<programlisting>
+ { "listipaddressesresponse" :
+ { "allocatedipaddress" :
+ [
+ {
+ "ipaddress" : "192.168.10.141",
+ "allocated" : "2009-09-18T13:16:10-0700",
+ "zoneid" : "4",
+ "zonename" : "WC",
+ "issourcenat" : "true"
+ }
+ ]
+ }
+ }
+</programlisting>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/responses.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/responses.xml b/docs/tmp/en-US/xml/responses.xml
new file mode 100644
index 0000000..e7cdf13
--- /dev/null
+++ b/docs/tmp/en-US/xml/responses.xml
@@ -0,0 +1,29 @@
+<?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="responses" 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>Responses</title>
+ <xi:include href="response-formats.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="max-result-page-returned.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="error-handling.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/roles.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/roles.xml b/docs/tmp/en-US/xml/roles.xml
new file mode 100644
index 0000000..66ad6f6
--- /dev/null
+++ b/docs/tmp/en-US/xml/roles.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="roles" 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>Roles</title>
+ <para>
+ The &PRODUCT; API supports three access roles:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Root Admin. Access to all features of the cloud, including both virtual and physical resource management.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Domain Admin. Access to only the virtual resources of the clouds that belong to the administrator’s domain.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ User. Access to only the features that allow management of the user’s virtual instances, storage, and network.
+ </para>
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/root-admin-ui-overview.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/root-admin-ui-overview.xml b/docs/tmp/en-US/xml/root-admin-ui-overview.xml
new file mode 100644
index 0000000..d974b32
--- /dev/null
+++ b/docs/tmp/en-US/xml/root-admin-ui-overview.xml
@@ -0,0 +1,29 @@
+<?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="root-admin-ui-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>Root Administrator's UI Overview</title>
+ <para>
+ The &PRODUCT; UI helps the &PRODUCT; administrator provision, view, and manage the cloud infrastructure, domains, user accounts, projects, and configuration settings. The first time you start the UI after a fresh Management Server installation, you can choose to follow a guided tour to provision your cloud infrastructure. On subsequent logins, the dashboard of the logged-in user appears. The various links in this screen and the navigation bar on the left provide access to a variety of administrative functions. The root administrator can also use the UI to perform all the same tasks that are present in the end-user’s UI.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/runtime-allocation-virtual-network-resources.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/runtime-allocation-virtual-network-resources.xml b/docs/tmp/en-US/xml/runtime-allocation-virtual-network-resources.xml
new file mode 100644
index 0000000..35fd23b
--- /dev/null
+++ b/docs/tmp/en-US/xml/runtime-allocation-virtual-network-resources.xml
@@ -0,0 +1,29 @@
+<?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="runtime-allocation-virtual-network-resources" 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>Runtime Allocation of Virtual Network Resources</title>
+ <para>
+ When you define a new virtual network, all your settings for that network are stored in &PRODUCT;. The actual network resources are activated only when the first virtual machine starts in the network. When all virtual machines have left the virtual network, the network resources are garbage collected so they can be allocated again. This helps to conserve network resources..
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/runtime-behavior-of-primary-storage.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/runtime-behavior-of-primary-storage.xml b/docs/tmp/en-US/xml/runtime-behavior-of-primary-storage.xml
new file mode 100644
index 0000000..3122b38
--- /dev/null
+++ b/docs/tmp/en-US/xml/runtime-behavior-of-primary-storage.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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="runtime-behavior-of-primary-storage" 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>Runtime Behavior of Primary Storage</title>
+ <para>
+ Root volumes are created automatically when a virtual machine is created. Root volumes are deleted when the VM is destroyed. Data volumes can be created and dynamically attached to VMs. <!-- (although, when the Oracle VM hypervisor is used, the VM must be stopped before an additional volume can be attached) --> Data volumes are not deleted when VMs are destroyed.
+ </para>
+ <para>
+ Administrators should monitor the capacity of primary storage devices and add additional primary storage as needed. See the Advanced Installation Guide.
+ </para>
+ <para>
+ Administrators add primary storage to the system by creating a &PRODUCT; storage pool. Each storage pool is associated with a cluster.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/runtime-internal-comm-req.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/runtime-internal-comm-req.xml b/docs/tmp/en-US/xml/runtime-internal-comm-req.xml
new file mode 100644
index 0000000..d37a6c1
--- /dev/null
+++ b/docs/tmp/en-US/xml/runtime-internal-comm-req.xml
@@ -0,0 +1,45 @@
+<?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="runtime-internal-comm-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>Runtime Internal Communications Requirements</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ The Management Servers communicate with each other to coordinate tasks. This communication uses TCP on ports 8250 and 9090.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ The console proxy VMs connect to all hosts in the zone over the management traffic network. Therefore the management traffic network of any given pod in the zone must have connectivity to the management traffic network of all other pods in the zone.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ The secondary storage VMs and console proxy VMs connect to the Management Server on port 8250. If you are using multiple Management Servers, the load balanced IP address of the Management Servers on port 8250 must be reachable.
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/scheduled-maintenance-maintenance-mode-hosts.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/scheduled-maintenance-maintenance-mode-hosts.xml b/docs/tmp/en-US/xml/scheduled-maintenance-maintenance-mode-hosts.xml
new file mode 100644
index 0000000..ef639a7
--- /dev/null
+++ b/docs/tmp/en-US/xml/scheduled-maintenance-maintenance-mode-hosts.xml
@@ -0,0 +1,29 @@
+<?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="scheduled-maintenance-maintenance-mode-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>Scheduled Maintenance and Maintenance Mode for Hosts</title>
+ <para>
+ You can place a host into maintenance mode. When maintenance mode is activated, the host becomes unavailable to receive new guest VMs, and the guest VMs already running on the host are seamlessly migrated to another host not in maintenance mode. This migration uses live migration technology and does not interrupt the execution of the guest.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/search-base.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/search-base.xml b/docs/tmp/en-US/xml/search-base.xml
new file mode 100644
index 0000000..f86fbc9
--- /dev/null
+++ b/docs/tmp/en-US/xml/search-base.xml
@@ -0,0 +1,81 @@
+<?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="search-base" 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>Search Base</title>
+ <para>
+ An LDAP query is relative to a given node of the LDAP directory tree, called the search base. The search base is the distinguished name (DN) of a level of the directory tree below which all users can be found. The users can be in the immediate base directory or in some subdirectory. The search base may be equivalent to the organization, group, or domain name. The syntax for writing a DN varies depending on which LDAP server you are using. A full discussion of distinguished names is outside the scope of our documentation. The following table shows some examples of search bases to find users in the testing department..
+ </para>
+ <informaltable>
+ <tgroup align="left" cols="2" colsep="1" rowsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>
+ LDAP Server
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Example Search Base DN
+ </para>
+ </entry>
+
+ </row>
+
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>
+ ApacheDS
+ </para>
+ </entry>
+ <entry>
+ <para>
+ ou=testing,o=project
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ Active Directory
+ </para>
+ </entry>
+ <entry>
+ <para>
+ OU=testing, DC=company
+ </para>
+ </entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+
+ </informaltable>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/search-user-bind-dn.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/search-user-bind-dn.xml b/docs/tmp/en-US/xml/search-user-bind-dn.xml
new file mode 100644
index 0000000..4faf760
--- /dev/null
+++ b/docs/tmp/en-US/xml/search-user-bind-dn.xml
@@ -0,0 +1,79 @@
+<?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="search-user-bind-dn" 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>Search User Bind DN</title>
+ <para>
+ The bind DN is the user on the external LDAP server permitted to search the LDAP directory within the defined search base. When the DN is returned, the DN and passed password are used to authenticate the &PRODUCT; user with an LDAP bind. A full discussion of bind DNs is outside the scope of our documentation. The following table shows some examples of bind DNs.
+ </para>
+ <informaltable>
+ <tgroup align="left" cols="2" colsep="1" rowsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>
+ LDAP Server
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Example Bind DN
+ </para>
+ </entry>
+
+ </row>
+
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>
+ ApacheDS
+ </para>
+ </entry>
+ <entry>
+ <para>
+ cn=Administrator,dc=testing,ou=project,ou=org
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ Active Directory
+ </para>
+ </entry>
+ <entry>
+ <para>
+ CN=Administrator, OU=testing, DC=company, DC=com
+ </para>
+ </entry>
+ </row>
+
+ </tbody>
+
+ </tgroup>
+
+ </informaltable>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/secondary-storage-add.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/secondary-storage-add.xml b/docs/tmp/en-US/xml/secondary-storage-add.xml
new file mode 100644
index 0000000..cf0f89d
--- /dev/null
+++ b/docs/tmp/en-US/xml/secondary-storage-add.xml
@@ -0,0 +1,95 @@
+<?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="secondary-storage-add" 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>Add Secondary Storage</title>
+ <section id="sys-require-secondary-storage">
+ <title>System Requirements for Secondary Storage</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ NFS storage appliance or Linux NFS server
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ (Optional) OpenStack Object Storage (Swift) (see http://swift.openstack.org)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ 100GB minimum capacity
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ A secondary storage device must be located in the same zone as the guest VMs it serves.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Each Secondary Storage server must be available to all hosts in the zone.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+ </section>
+
+ <section id="adding-secondary-storage">
+ <title>Adding Secondary Storage</title>
+ <para>
+ When you create a new zone, the first secondary storage is added as part of that procedure. You can add secondary storage servers at any time to add more servers to an existing zone.
+ </para>
+ <warning>
+ <para>
+ Be sure there is nothing stored on the server. Adding the server to &PRODUCT; will destroy any existing data.
+ </para>
+ </warning>
+ <orderedlist>
+ <listitem>
+ <para>
+ If you are going to use Swift for cloud-wide secondary storage, you must add the Swift storage to &PRODUCT; before you add the local zone secondary storage servers. See <xref linkend="zone-add" />.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ To prepare for local zone secondary storage, you should have created and mounted an NFS share during Management Server installation. <phrase condition="install">See <xref linkend="prepare-nfs-shares" />.</phrase>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Make sure you prepared the system VM template during Management Server installation. <phrase condition="install">See <xref linkend="prepare-system-vm-template" />.</phrase>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Now that the secondary storage server for per-zone storage is prepared, add it to &PRODUCT;. Secondary storage is added as part of the procedure for adding a new zone. See <xref linkend="zone-add" />.
+ </para>
+ </listitem>
+
+ </orderedlist>
+
+ </section>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/secondary-storage-outage-and-data-loss.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/secondary-storage-outage-and-data-loss.xml b/docs/tmp/en-US/xml/secondary-storage-outage-and-data-loss.xml
new file mode 100644
index 0000000..0261421
--- /dev/null
+++ b/docs/tmp/en-US/xml/secondary-storage-outage-and-data-loss.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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="secondary-storage-outage-and-data-loss" 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>Secondary Storage Outage and Data Loss</title>
+ <para>
+ For a Zone that has only one secondary storage server, a secondary storage outage will have feature level impact to the system but will not impact running guest VMs. It may become impossible to create a VM with the selected template for a user. A user may also not be able to save snapshots or examine/restore saved snapshots. These features will automatically be available when the secondary storage comes back online.
+ </para>
+ <para>
+ Secondary storage data loss will impact recently added user data including templates, snapshots, and ISO images. Secondary storage should be backed up periodically. Multiple secondary storage servers can be provisioned within each zone to increase the scalability of the system.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/secondary-storage-vm.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/secondary-storage-vm.xml b/docs/tmp/en-US/xml/secondary-storage-vm.xml
new file mode 100644
index 0000000..73e6bfd
--- /dev/null
+++ b/docs/tmp/en-US/xml/secondary-storage-vm.xml
@@ -0,0 +1,38 @@
+<?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="secondary-storage-vm" 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>Secondary Storage VM</title>
+ <para>
+ In addition to the hosts, &PRODUCT;’s Secondary Storage VM mounts and writes to secondary storage.
+ </para>
+ <para>
+ Submissions to secondary storage go through the Secondary Storage VM. The Secondary Storage VM can retrieve templates and ISO images from URLs using a variety of protocols.
+ </para>
+ <para>
+ The secondary storage VM provides a background task that takes care of a variety of secondary storage activities: downloading a new template to a Zone, copying templates between Zones, and snapshot backups.
+ </para>
+ <para>
+ The administrator can log in to the secondary storage VM if needed.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/secondary-storage.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/secondary-storage.xml b/docs/tmp/en-US/xml/secondary-storage.xml
new file mode 100644
index 0000000..182b91b
--- /dev/null
+++ b/docs/tmp/en-US/xml/secondary-storage.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 "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="secondary-storage" 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>Secondary Storage</title>
+ <para>
+ This section gives concepts and technical details about &PRODUCT; secondary storage. For information about how to install and configure secondary storage through the &PRODUCT; UI, see the Advanced Installation Guide.
+ </para>
+ <para>
+ <xref linkend="about-secondary-storage" />
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/security-groups.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/security-groups.xml b/docs/tmp/en-US/xml/security-groups.xml
new file mode 100644
index 0000000..4b2b604
--- /dev/null
+++ b/docs/tmp/en-US/xml/security-groups.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="security-groups" 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>Security Groups</title>
+ <xi:include href="about-security-groups.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="add-security-group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="enable-security-groups.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="add-ingress-egress-rules.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/security-req.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/security-req.xml b/docs/tmp/en-US/xml/security-req.xml
new file mode 100644
index 0000000..e4a727b
--- /dev/null
+++ b/docs/tmp/en-US/xml/security-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="security-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>Security Requirements</title>
+ <para>
+ The public Internet must not be able to access port 8096 or port 8250 on the Management Server.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/send-projects-membership-invitation.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/send-projects-membership-invitation.xml b/docs/tmp/en-US/xml/send-projects-membership-invitation.xml
new file mode 100644
index 0000000..675a51a
--- /dev/null
+++ b/docs/tmp/en-US/xml/send-projects-membership-invitation.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="send-projects-membership-invitation" 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>Sending Project Membership Invitations</title>
+ <para>
+ Use these steps to add a new member to a project if the invitations feature is enabled in the cloud as described in <xref linkend="set-up-invitations" />. If the invitations feature is not turned on, use the procedure in Adding Project Members From the UI.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in to the &PRODUCT; UI.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation, click Projects.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ In Select View, choose Projects.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the name of the project you want to work with.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the Invitations tab.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ In Add by, select one of the following:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Account – The invitation will appear in the user’s Invitations tab in the Project View. See Using the Project View.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Email – The invitation will be sent to the user’s email address. Each emailed invitation includes a unique code called a token which the recipient will provide back to &PRODUCT; when accepting the invitation. Email invitations will work only if the global parameters related to the SMTP server have been set. See <xref linkend="set-up-invitations" />.
+ </para>
+ </listitem>
+
+ </orderedlist>
+ </listitem>
+ <listitem>
+ <para>
+ Type the user name or email address of the new member you want to add, and click Invite. Type the &PRODUCT; user name if you chose Account in the previous step. If you chose Email, type the email address. You can invite only people who have an account in this cloud within the same domain as the project. However, you can send the invitation to any email address.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ To view and manage the invitations you have sent, return to this tab. When an invitation is accepted, the new member will appear in the project’s Accounts tab.
+ </para>
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/separate_storage_network.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/separate_storage_network.xml b/docs/tmp/en-US/xml/separate_storage_network.xml
new file mode 100644
index 0000000..3b5103a
--- /dev/null
+++ b/docs/tmp/en-US/xml/separate_storage_network.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="separate_storage_network" 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>Separate Storage Network</title>
+ <para>
+ In the large-scale redundant setup described in the previous section, storage traffic can overload the management network. A separate storage network is optional for deployments. Storage protocols such as iSCSI are sensitive to network delays. A separate storage network ensures guest network traffic contention does not impact storage performance.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/service-offerings.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/service-offerings.xml b/docs/tmp/en-US/xml/service-offerings.xml
new file mode 100644
index 0000000..2ba538b
--- /dev/null
+++ b/docs/tmp/en-US/xml/service-offerings.xml
@@ -0,0 +1,38 @@
+<?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="service-offerings" 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>Service Offerings</title>
+ <para>
+ <xref linkend="set-up-network-for-users" />vCenter Maintenance Mode
+ </para>
+ <para>
+ <xref linkend="about-virtual-networks" />XenServer and Maintenance Mode
+ </para>
+ <para>
+ <xref linkend="customizing-dns" />vCenter Maintenance Mode
+ </para>
+ <para>
+ <xref linkend="stop-start-management-server" />XenServer and Maintenance Mode
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/set-database-buffer-pool-size.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/set-database-buffer-pool-size.xml b/docs/tmp/en-US/xml/set-database-buffer-pool-size.xml
new file mode 100644
index 0000000..91a263d
--- /dev/null
+++ b/docs/tmp/en-US/xml/set-database-buffer-pool-size.xml
@@ -0,0 +1,56 @@
+<?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="set-database-buffer-pool-size" 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>Set Database Buffer Pool Size</title>
+ <para>
+ It is important to provide enough memory space for the MySQL database to cache data and indexes:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Edit the Tomcat configuration file:
+ </para>
+
+<programlisting>/etc/my.cnf</programlisting>
+ </listitem>
+ <listitem>
+ <para>
+ Insert the following line in the [mysqld] section, below the datadir line. Use a value that is appropriate for your situation. We recommend setting the buffer pool at 40% of RAM if MySQL is on the same server as the management server or 70% of RAM if MySQL has a dedicated server. The following example assumes a dedicated server with 1024M of RAM.
+ </para>
+
+<programlisting>innodb_buffer_pool_size=700M</programlisting>
+ </listitem>
+ <listitem>
+ <para>
+ Restart the MySQL service.
+ </para>
+
+<programlisting># service mysqld restart</programlisting>
+ </listitem>
+
+ </orderedlist>
+ <para>
+ For more information about the buffer pool, see "The InnoDB Buffer Pool" at <ulink url="http://dev.mysql.com/doc/refman/5.5/en/innodb-buffer-pool.html">MySQL Reference Manual</ulink>.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/set-global-project-resource-limits.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/set-global-project-resource-limits.xml b/docs/tmp/en-US/xml/set-global-project-resource-limits.xml
new file mode 100644
index 0000000..fcec205
--- /dev/null
+++ b/docs/tmp/en-US/xml/set-global-project-resource-limits.xml
@@ -0,0 +1,142 @@
+<?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="set-global-project-resource-limits" 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 the Global Project Resource Limits</title>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in as administrator to the &PRODUCT; UI.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation, click Global Settings.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the search box, type max.projects and click the search button.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the search results, you will see the parameters you can use to set per-project maximum resource amounts that apply to all projects in the cloud. No project can have more resources, but an individual project can have lower limits. Click the edit button to set each parameter.
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/edit-icon.png" />
+ </imageobject>
+ <textobject>
+ <phrase>editbutton.png: Edits parameters</phrase>
+ </textobject>
+
+ </inlinemediaobject>
+ </para>
+ <informaltable>
+ <tgroup align="left" cols="2" colsep="1" rowsep="1">
+ <tbody>
+ <row>
+ <entry>
+ <para>
+ max.project.public.ips
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Maximum number of public IP addresses that can be owned by any project in the cloud. See About Public IP Addresses.
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ max.project.snapshots
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Maximum number of snapshots that can be owned by any project in the cloud. See Working with Snapshots.
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ max.project.templates
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Maximum number of templates that can be owned by any project in the cloud. See Working with Templates.
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ max.project.uservms
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Maximum number of guest virtual machines that can be owned by any project in the cloud. See Working With Virtual Machines.
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ max.project.volumes
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Maximum number of data volumes that can be owned by any project in the cloud. See Working with Volumes.
+ </para>
+ </entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+
+ </informaltable>
+
+ </listitem>
+ <listitem>
+ <para>
+ Restart the Management Server.
+ </para>
+
+<programlisting># service cloud-management restart</programlisting>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/set-monitor-total-vm-limits-per-host.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/set-monitor-total-vm-limits-per-host.xml b/docs/tmp/en-US/xml/set-monitor-total-vm-limits-per-host.xml
new file mode 100644
index 0000000..12f2323
--- /dev/null
+++ b/docs/tmp/en-US/xml/set-monitor-total-vm-limits-per-host.xml
@@ -0,0 +1,29 @@
+<?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="set-monitor-total-vm-limits-per-host" 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>Set and Monitor Total VM Limits per Host</title>
+ <para>
+ The &PRODUCT; administrator should monitor the total number of VM instances in each cluster, and disable allocation to the cluster if the total is approaching the maximum that the hypervisor can handle. Be sure to leave a safety margin to allow for the possibility of one or more hosts failing, which would increase the VM load on the other hosts as the VMs are automatically redeployed. Consult the documentation for your chosen hypervisor to find the maximum permitted number of VMs per host, then use &PRODUCT; global configuration settings to set this as the default limit. Monitor the VM activity in each cluster at all times. Keep the total number of VMs below a safe level that allows for the occasional host failure. For example, if there are N hosts in the cluster, and you want to allow for one host in the cluster to be down at any given time, the total number of VM instances you can permit in the cluster is at most (N-1) * (per-host-limit). Once a cluster reaches this number of VM
s, use the &PRODUCT; UI to disable allocation of more VMs to the cluster.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/set-per-project-resource-limits.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/set-per-project-resource-limits.xml b/docs/tmp/en-US/xml/set-per-project-resource-limits.xml
new file mode 100644
index 0000000..1282f3a
--- /dev/null
+++ b/docs/tmp/en-US/xml/set-per-project-resource-limits.xml
@@ -0,0 +1,75 @@
+<?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="set-per-project-resource-limits" 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 Per-Project Resource Limits</title>
+ <para>
+ The &PRODUCT; root administrator or the domain administrator of the domain where the project resides can set new resource limits for an individual project. The project owner can set resource limits only if the owner is also a domain or root administrator.
+ </para>
+ <para>
+ The new limits must be below the global default limits set by the &PRODUCT; administrator (as described in <xref linkend="set-resource-limits-for-projects" />). If the project already owns more of a given type of resource than the new maximum, the resources are not affected; however, the project can not add any new resources of that type until the total drops below the new limit.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in as administrator to the &PRODUCT; UI.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation, click Projects.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In Select View, choose Projects.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the name of the project you want to work with.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Resources tab. This tab lists the current maximum amount that the project is allowed to own for each type of resource.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Type new values for one or more resources.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click Apply.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/set-projects-creator-permissions.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/set-projects-creator-permissions.xml b/docs/tmp/en-US/xml/set-projects-creator-permissions.xml
new file mode 100644
index 0000000..1832558
--- /dev/null
+++ b/docs/tmp/en-US/xml/set-projects-creator-permissions.xml
@@ -0,0 +1,93 @@
+<?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="set-projects-creator-permissions" 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 Project Creator Permissions</title>
+ <para>
+ You can configure &PRODUCT; to allow any user to create a new project, or you can restrict that ability to just &PRODUCT; administrators.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in as administrator to the &PRODUCT; UI.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation, click Global Settings.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the search box, type allow.user.create.projects.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the edit button to set the parameter.
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/edit-icon.png" />
+ </imageobject>
+ <textobject>
+ <phrase>editbutton.png: Edits parameters</phrase>
+ </textobject>
+
+ </inlinemediaobject>
+ </para>
+ <informaltable>
+ <tgroup align="left" cols="2" colsep="1" rowsep="1">
+ <tbody>
+ <row>
+ <entry>
+ <para>
+ allow.user.create.projects
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Set to true to allow end users to create projects. Set to false if you want only the &PRODUCT; root administrator and domain administrators to create projects.
+ </para>
+ </entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+
+ </informaltable>
+
+ </listitem>
+ <listitem>
+ <para>
+ Restart the Management Server.
+ </para>
+
+<programlisting># service cloud-management restart</programlisting>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/set-resource-limits-for-projects.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/set-resource-limits-for-projects.xml b/docs/tmp/en-US/xml/set-resource-limits-for-projects.xml
new file mode 100644
index 0000000..181d4e9
--- /dev/null
+++ b/docs/tmp/en-US/xml/set-resource-limits-for-projects.xml
@@ -0,0 +1,29 @@
+<?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="set-resource-limits-for-projects" 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 Resource Limits for Projects</title>
+ <para>
+ The &PRODUCT; administrator can set global default limits to control the amount of resources that can be owned by each project in the cloud. This serves to prevent uncontrolled usage of resources such as snapshots, IP addresses, and virtual machine instances. Domain administrators can override these resource limits for individual projects with their domains, as long as the new limits are below the global defaults set by the &PRODUCT; root administrator. The root administrator can also set lower resource limits for any project in the cloud
+ </para>
+ <xi:include href="set-per-project-resource-limits.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="set-global-project-resource-limits.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</section>
+
+