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
[17/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/enable-disable-static-nat-vpc.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/enable-disable-static-nat-vpc.xml b/docs/tmp/en-US/xml/enable-disable-static-nat-vpc.xml
new file mode 100644
index 0000000..ba9102f
--- /dev/null
+++ b/docs/tmp/en-US/xml/enable-disable-static-nat-vpc.xml
@@ -0,0 +1,154 @@
+<?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="enable-disable-static-nat-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>Enabling or Disabling Static NAT on a VPC</title>
+ <para>
+ A static NAT rule maps a public IP address to the private IP address of a VM in a VPC to allow Internet traffic to it. This section tells how to enable or disable static NAT for a particular IP address in a VPC.
+ </para>
+ <para>
+ If port forwarding rules are already in effect for an IP address, you cannot enable static NAT to that IP.
+ </para>
+ <para>
+ If a guest VM is part of more than one network, static NAT rules will function only if they are defined on the default network.
+ </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 VPCs that you have created for the account is listed in the page.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Configure button of the VPC to which you want to deploy the VMs.
+ </para>
+ <para>
+ The VPC page is displayed where all the tiers you created are listed in a diagram.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Settings icon.
+ </para>
+ <para>
+ The following options are displayed.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ IP Addresses
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Gateways
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Site-to-Site VPN
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Network ACLs
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ Select IP Addresses.
+ </para>
+ <para>
+ The IP Addresses page is displayed.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the IP you want to work with.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the Details tab,click the Static NAT button.
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/enable-disable.png" />
+ </imageobject>
+ <textobject>
+ <phrase>enable-disable.png: button to enable Statid NAT.</phrase>
+ </textobject>
+
+ </inlinemediaobject>
+ The button toggles between Enable and Disable, depending on whether static NAT is currently enabled for the IP address.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ If you are enabling static NAT, a dialog appears as follows:
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/select-vm-staticnat-vpc.png" width="444" />
+ </imageobject>
+ <textobject>
+ <phrase>select-vmstatic-nat.png: selecting a tier to apply staticNAT.</phrase>
+ </textobject>
+
+ </mediaobject>
+
+ </listitem>
+ <listitem>
+ <para>
+ Select the tier and the destination VM, then click Apply.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/enable-disable-static-nat.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/enable-disable-static-nat.xml b/docs/tmp/en-US/xml/enable-disable-static-nat.xml
new file mode 100644
index 0000000..0dd301b
--- /dev/null
+++ b/docs/tmp/en-US/xml/enable-disable-static-nat.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="enable-disable-static-nat" 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>Enabling or Disabling Static NAT</title>
+ <para>
+ If port forwarding rules are already in effect for an IP address, you cannot enable static NAT to that IP.
+ </para>
+ <para>
+ If a guest VM is part of more than one network, static NAT rules will function only if they are defined on the default network.
+ </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>
+ Click the name of the network where you want to work with.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click View IP Addresses.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the IP address you want to work with.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Static NAT button.
+ <inlinemediaobject>
+ <imageobject>
+ <imagedata fileref="./images/release-ip-icon.png" />
+ </imageobject>
+ <textobject>
+ <phrase>ReleaseIPButton.png: button to release an IP</phrase>
+ </textobject>
+
+ </inlinemediaobject>
+ The button toggles between Enable and Disable, depending on whether static NAT is currently enabled for the IP address.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If you are enabling static NAT, a dialog appears where you can choose the destination VM and click Apply
+ </para>
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/enable-security-groups.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/enable-security-groups.xml b/docs/tmp/en-US/xml/enable-security-groups.xml
new file mode 100644
index 0000000..4506fed
--- /dev/null
+++ b/docs/tmp/en-US/xml/enable-security-groups.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="enable-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>Enabling Security Groups</title>
+ <para>
+ In order for security groups to function in a zone, the security groups feature must first be enabled for the zone. The administrator can do this when creating a new zone, by selecting a network offering that includes security groups. The procedure is described in Basic Zone Configuration in the Advanced Installation Guide.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/enabling-api-call-expiration.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/enabling-api-call-expiration.xml b/docs/tmp/en-US/xml/enabling-api-call-expiration.xml
new file mode 100644
index 0000000..f8abea4
--- /dev/null
+++ b/docs/tmp/en-US/xml/enabling-api-call-expiration.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="enabling-api-call-expiration" 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>Enabling API Call Expiration</title>
+ <para>
+ You can set an expiry timestamp on API calls to prevent replay attacks over non-secure channels, such as HTTP. The server tracks the expiry timestamp you have specified and rejects all the subsequent API requests that come in after this validity period.
+ </para>
+ <para>
+ To enable this feature, add the following parameters to the API request:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ signatureVersion=3: If the signatureVersion parameter is missing or is not equal to 3, the expires parameter is ignored in the API request.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ expires=YYYY-MM-DDThh:mm:ssZ: Specifies the date and time at which the signature included in the request is expired. The timestamp is expressed in the YYYY-MM-DDThh:mm:ssZ format, as specified in the ISO 8601 standard.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ <para>
+ For example:
+ </para>
+
+<programlisting>expires=2011-10-10T12:00:00+0530</programlisting>
+ <para>
+ A sample API request with expiration is given below:
+ </para>
+
+<programlisting>http://<IPAddress>:8080/client/api?command=listZones&signatureVersion=3&expires=2011-10-10T12:00:00+0530&apiKey=miVr6X7u6bN_sdahOBpjNejPgEsT35eXq-jB8CG20YI3yaxXcgpyuaIRmFI_EJTVwZ0nUkkJbPmY3y2bciKwFQ&signature=Lxx1DM40AjcXU%2FcaiK8RAP0O1hU%3D</programlisting>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/enabling-port-8096.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/enabling-port-8096.xml b/docs/tmp/en-US/xml/enabling-port-8096.xml
new file mode 100644
index 0000000..3ae6a5b
--- /dev/null
+++ b/docs/tmp/en-US/xml/enabling-port-8096.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="enabling-port-8096" 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>Enabling Port 8096</title>
+ <para>
+ Port 8096, which allows API calls without authentication, is closed and disabled by default on any fresh 3.0.1 installations. You can enable 8096 (or another port) for this purpose as follows:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Ensure that the first Management Server is installed and running.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Set the global configuration parameter integration.api.port to the desired port.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Restart the Management Server.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On the Management Server host machine, create an iptables rule allowing access to that port.
+ </para>
+ </listitem>
+
+ </orderedlist>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/end-user-ui-overview.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/end-user-ui-overview.xml b/docs/tmp/en-US/xml/end-user-ui-overview.xml
new file mode 100644
index 0000000..e0d2c08
--- /dev/null
+++ b/docs/tmp/en-US/xml/end-user-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="end-user-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>End User's UI Overview</title>
+ <para>
+ The &PRODUCT; UI helps users of cloud infrastructure to view and use their cloud resources, including virtual machines, templates and ISOs, data volumes and snapshots, guest networks, and IP addresses. If the user is a member or administrator of one or more &PRODUCT; projects, the UI can provide a project-oriented view.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/error-handling.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/error-handling.xml b/docs/tmp/en-US/xml/error-handling.xml
new file mode 100644
index 0000000..5c39a90
--- /dev/null
+++ b/docs/tmp/en-US/xml/error-handling.xml
@@ -0,0 +1,33 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="error-handling" 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>Error Handling</title>
+ <para>
+ If an error occurs while processing an API request, the appropriate response in the format specified is returned. Each error response consists of an error code and an error text describing what possibly can go wrong. For an example error response, see page 12.
+ </para>
+ <para>
+ An HTTP error code of 401 is always returned if API request was rejected due to bad signatures, missing API Keys, or the user simply did not have the permissions to execute the command.
+ </para>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/event-log-queries.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/event-log-queries.xml b/docs/tmp/en-US/xml/event-log-queries.xml
new file mode 100644
index 0000000..459e85d
--- /dev/null
+++ b/docs/tmp/en-US/xml/event-log-queries.xml
@@ -0,0 +1,64 @@
+<?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="event-log-queries" 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>Event Log Queries</title>
+ <para>
+ Database logs can be queried from the user interface. The list of events captured by the system includes:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Virtual machine creation, deletion, and on-going management operations
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Virtual router creation, deletion, and on-going management operations
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Template creation and deletion
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Network/load balancer rules creation and deletion
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Storage volume creation and deletion
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ User login and logout
+ </para>
+ </listitem>
+
+ </itemizedlist>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/event-types.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/event-types.xml b/docs/tmp/en-US/xml/event-types.xml
new file mode 100644
index 0000000..5cdf390
--- /dev/null
+++ b/docs/tmp/en-US/xml/event-types.xml
@@ -0,0 +1,701 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE appendix 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;
+]>
+<appendix id="event-types" 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>Event Types</title>
+ <informaltable frame="all">
+ <tgroup align="left" cols="3" colsep="1" rowsep="1">
+ <colspec colname="c1"></colspec>
+ <colspec colname="c2"></colspec>
+ <tbody>
+ <row>
+ <entry>
+ <para>
+ VM.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TEMPLATE.EXTRACT
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SG.REVOKE.INGRESS
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ VM.DESTROY
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TEMPLATE.UPLOAD
+ </para>
+ </entry>
+ <entry>
+ <para>
+ HOST.RECONNECT
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ VM.START
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TEMPLATE.CLEANUP
+ </para>
+ </entry>
+ <entry>
+ <para>
+ MAINT.CANCEL
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ VM.STOP
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VOLUME.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ MAINT.CANCEL.PS
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ VM.REBOOT
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VOLUME.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ MAINT.PREPARE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ VM.UPGRADE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VOLUME.ATTACH
+ </para>
+ </entry>
+ <entry>
+ <para>
+ MAINT.PREPARE.PS
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ VM.RESETPASSWORD
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VOLUME.DETACH
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VPN.REMOTE.ACCESS.CREATE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ROUTER.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VOLUME.UPLOAD
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VPN.USER.ADD
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ROUTER.DESTROY
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SERVICEOFFERING.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VPN.USER.REMOVE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ROUTER.START
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SERVICEOFFERING.UPDATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ NETWORK.RESTART
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ROUTER.STOP
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SERVICEOFFERING.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ UPLOAD.CUSTOM.CERTIFICATE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ROUTER.REBOOT
+ </para>
+ </entry>
+ <entry>
+ <para>
+ DOMAIN.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ UPLOAD.CUSTOM.CERTIFICATE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ROUTER.HA
+ </para>
+ </entry>
+ <entry>
+ <para>
+ DOMAIN.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ STATICNAT.DISABLE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ PROXY.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ DOMAIN.UPDATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SSVM.CREATE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ PROXY.DESTROY
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SNAPSHOT.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SSVM.DESTROY
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ PROXY.START
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SNAPSHOT.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SSVM.START
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ PROXY.STOP
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SNAPSHOTPOLICY.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SSVM.STOP
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ PROXY.REBOOT
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SNAPSHOTPOLICY.UPDATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SSVM.REBOOT
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ PROXY.HA
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SNAPSHOTPOLICY.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SSVM.H
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ VNC.CONNECT
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VNC.DISCONNECT
+ </para>
+ </entry>
+ <entry>
+ <para>
+ NET.IPASSIGN
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ NET.IPRELEASE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ NET.RULEADD
+ </para>
+ </entry>
+ <entry>
+ <para>
+ NET.RULEDELETE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ NET.RULEMODIFY
+ </para>
+ </entry>
+ <entry>
+ <para>
+ NETWORK.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ NETWORK.DELETE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ LB.ASSIGN.TO.RULE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ LB.REMOVE.FROM.RULE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ LB.CREATE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ LB.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ LB.UPDATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ USER.LOGIN
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ USER.LOGOUT
+ </para>
+ </entry>
+ <entry>
+ <para>
+ USER.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ USER.DELETE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ USER.UPDATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ USER.DISABLE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TEMPLATE.CREATE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ TEMPLATE.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TEMPLATE.UPDATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TEMPLATE.COPY
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ TEMPLATE.DOWNLOAD.START
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TEMPLATE.DOWNLOAD.SUCCESS
+ </para>
+ </entry>
+ <entry>
+ <para>
+ TEMPLATE.DOWNLOAD.FAILED
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ISO.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ ISO.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ ISO.COPY
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ISO.ATTACH
+ </para>
+ </entry>
+ <entry>
+ <para>
+ ISO.DETACH
+ </para>
+ </entry>
+ <entry>
+ <para>
+ ISO.EXTRACT
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ISO.UPLOAD
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SERVICE.OFFERING.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SERVICE.OFFERING.EDIT
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ SERVICE.OFFERING.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ DISK.OFFERING.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ DISK.OFFERING.EDIT
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ DISK.OFFERING.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ NETWORK.OFFERING.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ NETWORK.OFFERING.EDIT
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ NETWORK.OFFERING.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ POD.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ POD.EDIT
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ POD.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ ZONE.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ ZONE.EDIT
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ ZONE.DELETE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VLAN.IP.RANGE.CREATE
+ </para>
+ </entry>
+ <entry>
+ <para>
+ VLAN.IP.RANGE.DELETE
+ </para>
+ </entry>
+
+ </row>
+ <row>
+ <entry>
+ <para>
+ CONFIGURATION.VALUE.EDIT
+ </para>
+ </entry>
+ <entry>
+ <para>
+ SG.AUTH.INGRESS
+ </para>
+ </entry>
+ <entry>
+ <para>
+ </para>
+ </entry>
+
+ </row>
+
+ </tbody>
+
+ </tgroup>
+
+ </informaltable>
+</appendix>
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/events-log.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/events-log.xml b/docs/tmp/en-US/xml/events-log.xml
new file mode 100644
index 0000000..f5f3964
--- /dev/null
+++ b/docs/tmp/en-US/xml/events-log.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="events-log" 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>Event Logs</title>
+ <para>
+ There are two types of events logged in the &PRODUCT; Event Log. Standard events log the success or failure of an event and can be used to identify jobs or processes that have failed. There are also long running job events. Events for asynchronous jobs log when a job is scheduled, when it starts, and when it completes. Other long running synchronous jobs log when a job starts, and when it completes. Long running synchronous and asynchronous event logs can be used to gain more information on the status of a pending job or can be used to identify a job that is hanging or has not started. The following sections provide more information on these events..
+ </para>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/events.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/events.xml b/docs/tmp/en-US/xml/events.xml
new file mode 100644
index 0000000..c546026
--- /dev/null
+++ b/docs/tmp/en-US/xml/events.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="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>Events</title>
+ <xi:include href="events-log.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="standard-events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="long-running-job-events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <xi:include href="event-log-queries.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/example-LDAP-configuration-commands.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/example-LDAP-configuration-commands.xml b/docs/tmp/en-US/xml/example-LDAP-configuration-commands.xml
new file mode 100644
index 0000000..e55ad86
--- /dev/null
+++ b/docs/tmp/en-US/xml/example-LDAP-configuration-commands.xml
@@ -0,0 +1,59 @@
+<?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="example-LDAP-configuration-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>Example LDAP Configuration Commands</title>
+ <para>
+ To understand the examples in this section, you need to know the basic concepts behind calling the &PRODUCT; API, which are explained in the Developer’s Guide.
+ </para>
+ <para>
+ The following shows an example invocation of ldapConfig with an ApacheDS LDAP server
+ </para>
+
+<programlisting>http://127.0.0.1:8080/client/api?command=ldapConfig&hostname=127.0.0.1&searchbase=ou%3Dtesting%2Co%3Dproject&queryfilter=%28%26%28uid%3D%25u%29%29&binddn=cn%3DJohn+Singh%2Cou%3Dtesting%2Co%project&bindpass=secret&port=10389&ssl=true&truststore=C%3A%2Fcompany%2Finfo%2Ftrusted.ks&truststorepass=secret&response=json&apiKey=YourAPIKey&signature=YourSignatureHash</programlisting>
+ <para>
+ The command must be URL-encoded. Here is the same example without the URL encoding:
+ </para>
+
+<programlisting>http://127.0.0.1:8080/client/api?command=ldapConfig
+&hostname=127.0.0.1
+&searchbase=ou=testing,o=project
+&queryfilter=(&(%uid=%u))
+&binddn=cn=John+Singh,ou=testing,o=project
+&bindpass=secret
+&port=10389
+&ssl=true
+&truststore=C:/company/info/trusted.ks
+&truststorepass=secret
+&response=json
+&apiKey=YourAPIKey&signature=YourSignatureHash
+</programlisting>
+ <para>
+ The following shows a similar command for Active Directory. Here, the search base is the testing group within a company, and the users are matched up based on email address.
+ </para>
+
+<programlisting>http://10.147.29.101:8080/client/api?command=ldapConfig&hostname=10.147.28.250&searchbase=OU%3Dtesting%2CDC%3Dcompany&queryfilter=%28%26%28mail%3D%25e%29%29 &binddn=CN%3DAdministrator%2COU%3Dtesting%2CDC%3Dcompany&bindpass=1111_aaaa&port=389&response=json&apiKey=YourAPIKey&signature=YourSignatureHash</programlisting>
+ <para>
+ The next few sections explain some of the concepts you will need to know when filling out the ldapConfig parameters.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/example-response-from-listUsageRecords.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/example-response-from-listUsageRecords.xml b/docs/tmp/en-US/xml/example-response-from-listUsageRecords.xml
new file mode 100644
index 0000000..aa05d4d
--- /dev/null
+++ b/docs/tmp/en-US/xml/example-response-from-listUsageRecords.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="example-response-from-listUsageRecords" 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>Example response from listUsageRecords</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>
+
+<programlisting>
+ <listusagerecordsresponse>
+ <count>1816</count>
+ <usagerecord>
+ <account>user5</account>
+ <accountid>10004</accountid>
+ <domainid>1</domainid>
+ <zoneid>1</zoneid>
+ <description>i-3-4-WC running time (ServiceOffering: 1) (Template: 3)</description>
+ <usage>2.95288 Hrs</usage>
+ <usagetype>1</usagetype>
+ <rawusage>2.95288</rawusage>
+ <virtualmachineid>4</virtualmachineid>
+ <name>i-3-4-WC</name>
+ <offeringid>1</offeringid>
+ <templateid>3</templateid>
+ <usageid>245554</usageid>
+ <type>XenServer</type>
+ <startdate>2009-09-15T00:00:00-0700</startdate>
+ <enddate>2009-09-18T16:14:26-0700</enddate>
+ </usagerecord>
+
+ … (1,815 more usage records)
+ </listusagerecordsresponse>
+</programlisting>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/export-template.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/export-template.xml b/docs/tmp/en-US/xml/export-template.xml
new file mode 100644
index 0000000..385780a
--- /dev/null
+++ b/docs/tmp/en-US/xml/export-template.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="export-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>Exporting Templates</title>
+ <para>
+ End users and Administrators may export templates from the &PRODUCT;. Navigate to the template in the UI and choose the Download function from the Actions menu.
+ </para>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/external-firewalls-and-load-balancers.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/external-firewalls-and-load-balancers.xml b/docs/tmp/en-US/xml/external-firewalls-and-load-balancers.xml
new file mode 100644
index 0000000..5e691dd
--- /dev/null
+++ b/docs/tmp/en-US/xml/external-firewalls-and-load-balancers.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="external-firewalls-and-load-balancers" 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>External Firewalls and Load Balancers</title>
+ <para>
+ &PRODUCT; is capable of replacing its Virtual Router with an external Juniper SRX device and an optional external NetScaler or F5 load balancer for gateway and load balancing services. In this case, the VMs use the SRX as their gateway.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/external-fw-topology-req.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/external-fw-topology-req.xml b/docs/tmp/en-US/xml/external-fw-topology-req.xml
new file mode 100644
index 0000000..41a0c18
--- /dev/null
+++ b/docs/tmp/en-US/xml/external-fw-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="external-fw-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>External Firewall Topology Requirements</title>
+ <para>
+ When external firewall integration is in place, the public IP VLAN must still be trunked to the Hosts. This is required to support the Secondary Storage VM and Console Proxy VM.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/external-guest-firewall-integration.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/external-guest-firewall-integration.xml b/docs/tmp/en-US/xml/external-guest-firewall-integration.xml
new file mode 100644
index 0000000..4d738d8
--- /dev/null
+++ b/docs/tmp/en-US/xml/external-guest-firewall-integration.xml
@@ -0,0 +1,287 @@
+<?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="external-guest-firewall-integration" 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>External Guest Firewall Integration for Juniper SRX (Optional)</title>
+ <note>
+ <para>
+ Available only for guests using advanced networking.
+ </para>
+
+ </note>
+ <para>
+ &PRODUCT; provides for direct management of the Juniper SRX series of firewalls. This enables &PRODUCT; to establish static NAT mappings from public IPs to guest VMs, and to use the Juniper device in place of the virtual router for firewall services. You can have one or more Juniper SRX per zone. This feature is optional. If Juniper integration is not provisioned, &PRODUCT; will use the virtual router for these services.
+ </para>
+ <para>
+ The Juniper SRX can optionally be used in conjunction with an external load balancer. External Network elements can be deployed in a side-by-side or inline configuration.
+ </para>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="./images/parallel-mode.png" width="444" />
+ </imageobject>
+ <textobject>
+ <phrase>parallel-mode.png: adding a firewall and load balancer in parallel mode.</phrase>
+ </textobject>
+
+ </mediaobject>
+ <para>
+ &PRODUCT; requires the Juniper to be configured as follows:
+ </para>
+ <note>
+ <para>
+ Supported SRX software version is 10.3 or higher.
+ </para>
+
+ </note>
+ <orderedlist>
+ <listitem>
+ <para>
+ Install your SRX appliance according to the vendor's instructions.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Connect one interface to the management network and one interface to the public network. Alternatively, you can connect the same interface to both networks and a use a VLAN for the public network.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Make sure "vlan-tagging" is enabled on the private interface.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Record the public and private interface names. If you used a VLAN for the public interface, add a ".[VLAN TAG]" after the interface name. For example, if you are using ge-0/0/3 for your public interface and VLAN tag 301, your public interface name would be "ge-0/0/3.301". Your private interface name should always be untagged because the &PRODUCT; software automatically creates tagged logical interfaces.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Create a public security zone and a private security zone. By default, these will already exist and will be called "untrust" and "trust". Add the public interface to the public zone and the private interface to the private zone. Note down the security zone names.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Make sure there is a security policy from the private zone to the public zone that allows all traffic.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Note the username and password of the account you want the &PRODUCT; software to log in to when it is programming rules.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Make sure the "ssh" and "xnm-clear-text" system services are enabled.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ If traffic metering is desired:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ a. Create an incoming firewall filter and an outgoing firewall filter. These filters should be the same names as your public security zone name and private security zone name respectively. The filters should be set to be "interface-specific". For example, here is the configuration where the public zone is "untrust" and the private zone is "trust":
+ </para>
+
+<programlisting>root@cloud-srx# show firewall
+filter trust {
+ interface-specific;
+}
+filter untrust {
+ interface-specific;
+}</programlisting>
+
+ </listitem>
+ <listitem>
+ <para>
+ Add the firewall filters to your public interface. For example, a sample configuration output (for public interface ge-0/0/3.0, public security zone untrust, and private security zone trust) is:
+ </para>
+
+<programlisting>ge-0/0/3 {
+ unit 0 {
+ family inet {
+ filter {
+ input untrust;
+ output trust;
+ }
+ address 172.25.0.252/16;
+ }
+ }
+}</programlisting>
+
+ </listitem>
+
+ </orderedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ Make sure all VLANs are brought to the private interface of the SRX.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ After the &PRODUCT; Management Server is installed, log in to the &PRODUCT; UI as administrator.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation bar, click Infrastructure.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In Zones, click View More.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Choose the zone you want to work with.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Network tab.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the Network Service Providers node of the diagram, click Configure. (You might have to scroll down to see this.)
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click SRX.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Add New SRX button (+) and provide the following:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ IP Address: The IP address of the SRX.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Username: The user name of the account on the SRX that &PRODUCT; should use.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Password: The password of the account.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Public Interface. The name of the public interface on the SRX. For example, ge-0/0/2. A ".x" at the end of the interface indicates the VLAN that is in use.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Private Interface: The name of the private interface on the SRX. For example, ge-0/0/1.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Usage Interface: (Optional) Typically, the public interface is used to meter traffic. If you want to use a different interface, specify its name here
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Number of Retries: The number of times to attempt a command on the SRX before failing. The default value is 2.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Timeout (seconds): The time to wait for a command on the SRX before considering it failed. Default is 300 seconds.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Public Network: The name of the public network on the SRX. For example, trust.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Private Network: The name of the private network on the SRX. For example, untrust.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Capacity: The number of networks the device can handle
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Dedicated: When marked as dedicated, this device will be dedicated to a single account. When Dedicated is checked, the value in the Capacity field has no significance implicitly, its value is 1
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click OK.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click Global Settings. Set the parameter external.network.stats.interval to indicate how often you want &PRODUCT; to fetch network usage statistics from the Juniper SRX. If you are not using the SRX to gather network usage statistics, set to 0.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/external-guest-lb-integration.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/external-guest-lb-integration.xml b/docs/tmp/en-US/xml/external-guest-lb-integration.xml
new file mode 100644
index 0000000..c90d453
--- /dev/null
+++ b/docs/tmp/en-US/xml/external-guest-lb-integration.xml
@@ -0,0 +1,168 @@
+<?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="external-guest-lb-integration" 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>External Guest Load Balancer Integration (Optional)</title>
+ <para>
+ &PRODUCT; can optionally use a Citrix NetScaler or BigIP F5 load balancer to provide load balancing services to guests. If this is not enabled, &PRODUCT; will use the software load balancer in the virtual router.
+ </para>
+ <para>
+ To install and enable an external load balancer for &PRODUCT; management:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Set up the appliance according to the vendor's directions.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Connect it to the networks carrying public traffic and management traffic (these could be the same network).
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Record the IP address, username, password, public interface name, and private interface name. The interface names will be something like "1.1" or "1.2".
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Make sure that the VLANs are trunked to the management network interface.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ After the &PRODUCT; Management Server is installed, log in as administrator to the &PRODUCT; UI.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation bar, click Infrastructure.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In Zones, click View More.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Choose the zone you want to work with.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Network tab.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the Network Service Providers node of the diagram, click Configure. (You might have to scroll down to see this.)
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click NetScaler or F5.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Add button (+) and provide the following:
+ </para>
+ <para>
+ For NetScaler:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ IP Address: The IP address of the SRX.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Username/Password: The authentication credentials to access the device. &PRODUCT; uses these credentials to access the device.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Type: The type of device that is being added. It could be F5 Big Ip Load Balancer, NetScaler VPX, NetScaler MPX, or NetScaler SDX. For a comparison of the NetScaler types, see the &PRODUCT; Administration Guide.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Public interface: Interface of device that is configured to be part of the public network.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Private interface: Interface of device that is configured to be part of the private network.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Number of retries. Number of times to attempt a command on the device before considering the operation failed. Default is 2.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Capacity: The number of networks the device can handle.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Dedicated: When marked as dedicated, this device will be dedicated to a single account. When Dedicated is checked, the value in the Capacity field has no significance implicitly, its value is 1.
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click OK.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+ <para>
+ The installation and provisioning of the external load balancer is finished. You can proceed to add VMs and NAT or load balancing rules.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/extracting-source.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/extracting-source.xml b/docs/tmp/en-US/xml/extracting-source.xml
new file mode 100644
index 0000000..fb726ec
--- /dev/null
+++ b/docs/tmp/en-US/xml/extracting-source.xml
@@ -0,0 +1,36 @@
+<?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="sect-source-extract" 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>Extracting source</title>
+ <para>
+ Extracting the &PRODUCT; release is relatively simple and can be done with a single command as follows:
+<programlisting><prompt>$</prompt> <command>tar</command> -jxvf apache-cloudstack-4.0.1-incubating-src.tar.bz2</programlisting>
+
+ </para>
+ <para>
+ You can now move into the directory:
+<programlisting><prompt>$</prompt> <command>cd</command> ./apache-cloudstack-4.0.1-incubating-src</programlisting>
+
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/feature-overview.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/feature-overview.xml b/docs/tmp/en-US/xml/feature-overview.xml
new file mode 100644
index 0000000..8a5557b
--- /dev/null
+++ b/docs/tmp/en-US/xml/feature-overview.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="feature-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>What Can &PRODUCT; Do?</title>
+ <para>
+ <emphasis role="bold">Multiple Hypervisor Support</emphasis>
+ </para>
+ <para>
+ &PRODUCT; works with a variety of hypervisors, and a single cloud deployment can contain multiple hypervisor implementations. The current release of &PRODUCT; supports pre-packaged enterprise solutions like Citrix XenServer and VMware vSphere, as well as KVM or Xen running on Ubuntu or CentOS.
+ </para>
+ <para>
+ <emphasis role="bold">Massively Scalable Infrastructure Management</emphasis>
+ </para>
+ <para>
+ &PRODUCT; can manage tens of thousands of servers installed in multiple geographically distributed datacenters. The centralized management server scales linearly, eliminating the need for intermediate cluster-level management servers. No single component failure can cause cloud-wide outage. Periodic maintenance of the management server can be performed without affecting the functioning of virtual machines running in the cloud.
+ </para>
+ <para>
+ <emphasis role="bold">Automatic Configuration Management</emphasis>
+ </para>
+ <para>
+ &PRODUCT; automatically configures each guest virtual machine’s networking and storage settings.
+ </para>
+ <para>
+ &PRODUCT; internally manages a pool of virtual appliances to support the cloud itself. These appliances offer services such as firewalling, routing, DHCP, VPN access, console proxy, storage access, and storage replication. The extensive use of virtual appliances simplifies the installation, configuration, and ongoing management of a cloud deployment.
+ </para>
+ <para>
+ <emphasis role="bold">Graphical User Interface</emphasis>
+ </para>
+ <para>
+ &PRODUCT; offers an administrator's Web interface, used for provisioning and managing the cloud, as well as an end-user's Web interface, used for running VMs and managing VM templates. The UI can be customized to reflect the desired service provider or enterprise look and feel.
+ </para>
+ <para>
+ <emphasis role="bold">API and Extensibility</emphasis>
+ </para>
+ <para>
+ &PRODUCT; provides an API that gives programmatic access to all the management features available in the UI. The API is maintained and documented. This API enables the creation of command line tools and new user interfaces to suit particular needs. See the Developer’s Guide and API Reference, both available at <ulink url="http://incubator.apache.org/cloudstack/docs">Apache CloudStack Guides</ulink> and <ulink url="http://incubator.apache.org/cloudstack/docs/api">Apache CloudStack API Reference</ulink> respectively.
+ </para>
+ <para>
+ The &PRODUCT; pluggable allocation architecture allows the creation of new types of allocators for the selection of storage and Hosts. See the Allocator Implementation Guide (<ulink url="http://docs.cloudstack.org/CloudStack_Documentation/Allocator_Implementation_Guide">http://docs.cloudstack.org/CloudStack_Documentation/Allocator_Implementation_Guide</ulink>).
+ </para>
+ <para>
+ <emphasis role="bold">High Availability</emphasis>
+ </para>
+ <para>
+ &PRODUCT; has a number of features to increase the availability of the system. The Management Server itself may be deployed in a multi-node installation where the servers are load balanced. MySQL may be configured to use replication to provide for a manual failover in the event of database loss. For the hosts, &PRODUCT; supports NIC bonding and the use of separate networks for storage as well as iSCSI Multipath.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/firewall-rules.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/firewall-rules.xml b/docs/tmp/en-US/xml/firewall-rules.xml
new file mode 100644
index 0000000..56fd1c6
--- /dev/null
+++ b/docs/tmp/en-US/xml/firewall-rules.xml
@@ -0,0 +1,100 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="firewall-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>Firewall Rules</title>
+ <para>
+ By default, all incoming traffic to the public IP address is rejected by the firewall. To allow external traffic, you can open firewall ports by specifying firewall rules. You can optionally specify one or more CIDRs to filter the source IPs. This is useful when you want to allow only incoming requests from certain IP addresses.
+ </para>
+ <para>
+ You cannot use firewall rules to open ports for an elastic IP address. When elastic IP is used, outside access is instead controlled through the use of security groups. See <xref linkend="add-security-group" />.
+ </para>
+ <para>
+ Firewall rules can be created using the Firewall tab in the Management Server UI. This tab is not displayed by default when &PRODUCT; is installed. To display the Firewall tab, the &PRODUCT; administrator must set the global configuration parameter firewall.rule.ui.enabled to "true."
+ </para>
+ <para>
+ To create a firewall rule:
+ </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>
+ Click the name of the network where you want to work with.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click View IP Addresses.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Click the IP address you want to work with.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Configuration tab and fill in the following values.
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <emphasis role="bold">Source CIDR</emphasis>. (Optional) To accept only traffic from IP addresses within a particular address block, enter a CIDR or a comma-separated list of CIDRs. Example: 192.168.0.0/22. Leave empty to allow all CIDRs.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">Protocol</emphasis>. The communication protocol in use on the opened port(s).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">Start Port and End Port</emphasis>. The port(s) you want to open on the firewall. If you are opening a single port, use the same number in both fields
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">ICMP Type and ICMP Code</emphasis>. Used only if Protocol is set to ICMP. Provide the type and code required by the ICMP protocol to fill out the ICMP header. Refer to ICMP documentation for more details if you are not sure what to enter
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>
+ Click Add
+ </para>
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/first_ms_node_install.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/first_ms_node_install.xml b/docs/tmp/en-US/xml/first_ms_node_install.xml
new file mode 100644
index 0000000..6a66d35
--- /dev/null
+++ b/docs/tmp/en-US/xml/first_ms_node_install.xml
@@ -0,0 +1,58 @@
+<?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="first_ms_node_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 First Management Server</title>
+ <orderedlist>
+ <listitem>
+ <para>
+ Ensure you have configured your machine according to <xref linkend="sect-source-buildrpm-repo2" /> or <xref linkend="sect-source-builddebs-repo2" /> as appropriate for your platform.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Install the &PRODUCT; management server packages by issuing one of the following commands as appropriate:
+<programlisting><prompt>#</prompt> <command>yum</command> install cloud-client</programlisting>
+
+<programlisting><prompt>#</prompt> <command>apt-get</command> install cloud-client</programlisting>
+
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ (RPM-based distributions) When the installation is finished, run the following commands to start essential services:
+ </para>
+
+<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>
+
+ </listitem>
+
+ </orderedlist>
+
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/generic-firewall-provisions.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/generic-firewall-provisions.xml b/docs/tmp/en-US/xml/generic-firewall-provisions.xml
new file mode 100644
index 0000000..fff2773
--- /dev/null
+++ b/docs/tmp/en-US/xml/generic-firewall-provisions.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="generic-firewall-provisions" 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>Generic Firewall Provisions</title>
+ <para>
+ The hardware firewall is required to serve two purposes:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Protect the Management Servers. NAT and port forwarding should be configured to direct traffic from the public Internet to the Management Servers.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Route management network traffic between multiple zones. Site-to-site VPN should be configured between multiple zones.
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+ <para>
+ To achieve the above purposes you must set up fixed configurations for the firewall. Firewall rules and policies need not change as users are provisioned into the cloud. Any brand of hardware firewall that supports NAT and site-to-site VPN can be used.
+ </para>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/getting-release.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/getting-release.xml b/docs/tmp/en-US/xml/getting-release.xml
new file mode 100644
index 0000000..72ba53f
--- /dev/null
+++ b/docs/tmp/en-US/xml/getting-release.xml
@@ -0,0 +1,59 @@
+<?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="sect-source-gettingrelease" 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>Getting the release</title>
+ <para>
+ You can download the latest &PRODUCT; release from the <ulink url="http://incubator.apache.org/cloudstack/downloads.html"> Apache CloudStack project download page</ulink>.
+ </para>
+ <para>
+ You'll notice several links under the 'Latest release' section.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ <ulink url="http://www.apache.org/dyn/closer.cgi/dist/incubator/cloudstack/releases/4.0.1-incubating/apache-cloudstack-4.0.1-incubating-src.tar.bz2"> apache-cloudstack-4.0.1-incubating-src.tar.bz2</ulink> - This is the link to the release itself.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.apache.org/dist/incubator/cloudstack/releases/4.0.1-incubating/apache-cloudstack-4.0.1-incubating-src.tar.bz2.asc">PGP</ulink> - This is a detached cryptographic signature that can be used to help verify the authenticity of the release.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.apache.org/dist/incubator/cloudstack/releases/4.0.1-incubating/apache-cloudstack-4.0.1-incubating-src.tar.bz2.md5">MD5</ulink> - An MD5 hash of the release to aid in verify the validity of the release download.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ <ulink url="http://www.apache.org/dist/incubator/cloudstack/releases/4.0.1-incubating/apache-cloudstack-4.0.1-incubating-src.tar.bz2.sha">SHA512</ulink> - A SHA512 hash of the release to aid in verify the validity of the release download.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</section>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cloudstack/blob/92d4b214/docs/tmp/en-US/xml/global-config.xml
----------------------------------------------------------------------
diff --git a/docs/tmp/en-US/xml/global-config.xml b/docs/tmp/en-US/xml/global-config.xml
new file mode 100644
index 0000000..3909a9d
--- /dev/null
+++ b/docs/tmp/en-US/xml/global-config.xml
@@ -0,0 +1,74 @@
+<?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="global-config" 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 Global Configuration Parameters</title>
+ <para>
+ &PRODUCT; provides parameters that you can set to control many aspects of the cloud. When &PRODUCT; is first installed, and periodically thereafter, you might need to modify these settings.
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Log in to the UI as administrator.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In the left navigation bar, click Global Settings.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ In Select View, choose one of the following:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Global Settings. This displays a list of the parameters with brief descriptions and current values.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Hypervisor Capabilities. This displays a list of hypervisor versions with the maximum number of guests supported for each.
+ </para>
+
+ </listitem>
+
+ </itemizedlist>
+
+ </listitem>
+ <listitem>
+ <para>
+ Use the search box to narrow down the list to those you are interested in.
+ </para>
+
+ </listitem>
+ <listitem>
+ <para>
+ Click the Edit icon to modify a value. If you are viewing Hypervisor Capabilities, you must click the name of the hypervisor first to display the editing screen.
+ </para>
+
+ </listitem>
+
+ </orderedlist>
+</chapter>
+