http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/source-build.xml ---------------------------------------------------------------------- diff --git a/en-US/source-build.xml b/en-US/source-build.xml deleted file mode 100644 index a56d304..0000000 --- a/en-US/source-build.xml +++ /dev/null @@ -1,49 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="source-build"> - <title>Building &PRODUCT; from Source</title> - <note> - <para>Prior to the 4.0.0 incubating release, Ant was used to build &PRODUCT;. A migration to Maven started in the 4.0.0 cycle, and has completed in 4.1.0.</para> - <para>The website and the wiki contain up to date information on the build procedure at:</para> - <itemizedlist> - <listitem><para><ulink url="https://cwiki.apache.org/confluence/display/CLOUDSTACK/How+to+build+on+master+branch";>https://cwiki.apache.org/confluence/display/CLOUDSTACK/How+to+build+on+master+branch</ulink></para></listitem> - <listitem><para><ulink url="https://cwiki.apache.org/confluence/display/CLOUDSTACK/Setting+up+CloudStack+Development+Environment";>https://cwiki.apache.org/confluence/display/CLOUDSTACK/Setting+up+CloudStack+Development+Environment</ulink></para></listitem> - </itemizedlist> - </note> - <para>The overarching steps to build &PRODUCT; are:.</para> - <itemizedlist> - <listitem><para>Install the prerequisites and setup your environment</para></listitem> - <listitem><para>Understand that various Maven profiles and build targets</para></listitem> - <listitem><para>Deploy and test your build </para></listitem> - <listitem><para>If needed, learn how to build binaries</para></listitem> - </itemizedlist> - - <note> - <para>Learning Maven is outside the scope of this documentation.</para> - <para>Go to the Maven website at <ulink url="http://maven.apache.org/guides/getting-started/index.html";>http://maven.apache.org/guides/getting-started/index.html</ulink></para> - </note> - -</section> -
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/source-prereqs.xml ---------------------------------------------------------------------- diff --git a/en-US/source-prereqs.xml b/en-US/source-prereqs.xml deleted file mode 100644 index 2e40a58..0000000 --- a/en-US/source-prereqs.xml +++ /dev/null @@ -1,45 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="sect-source-prereq"> - <title>Prerequisites for building Apache CloudStack</title> - <para> - There are a number of prerequisites needed to build &PRODUCT;. This - document assumes compilation on a Linux system that uses RPMs or DEBs - for package management. - </para> - <para> - You will need, at a minimum, the following to compile &PRODUCT;: - <orderedlist> - <listitem><para>Maven (version 3)</para></listitem> - <listitem><para>Java (OpenJDK 1.6 or Java 7/OpenJDK 1.7)</para></listitem> - <listitem><para>Apache Web Services Common Utilities (ws-commons-util)</para></listitem> - <listitem><para>MySQL</para></listitem> - <listitem><para>MySQLdb (provides Python database API)</para></listitem> - <listitem><para>Tomcat 6 (not 6.0.35)</para></listitem> - <listitem><para>genisoimage</para></listitem> - <listitem><para>rpmbuild or dpkg-dev</para></listitem> - </orderedlist> - </para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/source.xml ---------------------------------------------------------------------- diff --git a/en-US/source.xml b/en-US/source.xml deleted file mode 100644 index ea30000..0000000 --- a/en-US/source.xml +++ /dev/null @@ -1,38 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<chapter id="sect-source"> - <title>Building from Source</title> - <para>The official &PRODUCT; release is always in source code form. You will likely be able to find "convenience binaries," the source is the canonical release. In this section, we'll cover acquiring the source release and building that so that you can deploy it using Maven or create Debian packages or RPMs.</para> - <para>Note that building and deploying directly from source is typically not the most efficient way to deploy an IaaS. However, we will cover that method as well as building RPMs or Debian packages for deploying &PRODUCT;.</para> - <para>The instructions here are likely version-specific. That is, the method for building from source for the 4.0.x series is different from the 4.1.x series.</para> - <para>If you are working with a unreleased version of &PRODUCT;, see the INSTALL.md file in the top-level directory of the release.</para> - <xi:include href="getting-release.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="verifying-source.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="source-prereqs.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="extracting-source.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="build-deb.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="build-rpm.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="build-nonoss.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> -</chapter> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/ssl.xml ---------------------------------------------------------------------- diff --git a/en-US/ssl.xml b/en-US/ssl.xml deleted file mode 100644 index 9aeb2f9..0000000 --- a/en-US/ssl.xml +++ /dev/null @@ -1,29 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="ssl"> - <title>SSL (Optional)</title> - <para>&PRODUCT; provides HTTP access in its default installation. There are a number of technologies and sites which choose to implement SSL. As a result, we have left &PRODUCT; to expose HTTP under the assumption that a site will implement its typical practice.</para> - <para>&PRODUCT; uses Tomcat as its servlet container. For sites that would like &PRODUCT; to terminate the SSL session, Tomcatâs SSL access may be enabled. Tomcat SSL configuration is described at http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/standard-events.xml ---------------------------------------------------------------------- diff --git a/en-US/standard-events.xml b/en-US/standard-events.xml deleted file mode 100644 index 9c10f87..0000000 --- a/en-US/standard-events.xml +++ /dev/null @@ -1,40 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="standard-events"> - <title>Standard Events</title> - <para>The events log records three types of standard events.</para> - <itemizedlist> - <listitem><para>INFO. This event is generated when an operation has been successfully performed.</para></listitem> - <listitem><para>WARN. This event is generated in the following circumstances.</para> - <itemizedlist> - <listitem><para>When a network is disconnected while monitoring a template download.</para></listitem> - <listitem><para>When a template download is abandoned.</para></listitem> - <listitem><para>When an issue on the storage server causes the volumes to fail over to the mirror storage server.</para></listitem> - </itemizedlist> - </listitem> - <listitem><para>ERROR. This event is generated when an operation has not been successfully performed</para></listitem> - </itemizedlist> - - </section> - http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/static-nat.xml ---------------------------------------------------------------------- diff --git a/en-US/static-nat.xml b/en-US/static-nat.xml deleted file mode 100644 index 4225d6e..0000000 --- a/en-US/static-nat.xml +++ /dev/null @@ -1,28 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="static-nat"> - <title>Static NAT</title> - <para>A static NAT rule maps a public IP address to the private IP address of a VM in order to allow Internet traffic into the VM. The public IP address always remains the same, which is why it is called âstaticâ NAT. This section tells how to enable or disable static NAT for a particular IP address.</para> - <xi:include href="enable-disable-static-nat.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/sticky-session-policies-for-lb-rules.xml ---------------------------------------------------------------------- diff --git a/en-US/sticky-session-policies-for-lb-rules.xml b/en-US/sticky-session-policies-for-lb-rules.xml deleted file mode 100644 index 0978085..0000000 --- a/en-US/sticky-session-policies-for-lb-rules.xml +++ /dev/null @@ -1,41 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="sticky-session-policies-for-lb-rules"> - <title>Sticky Session Policies for Load Balancer Rules</title> - <para>Sticky sessions are used in Web-based applications to ensure continued availability of - information across the multiple requests in a user's session. For example, if a shopper is - filling a cart, you need to remember what has been purchased so far. The concept of "stickiness" - is also referred to as persistence or maintaining state.</para> - <para>Any load balancer rule defined in &PRODUCT; can have a stickiness policy. The policy - consists of a name, stickiness method, and parameters. The parameters are name-value pairs or - flags, which are defined by the load balancer vendor. The stickiness method could be load - balancer-generated cookie, application-generated cookie, or source-based. In the source-based - method, the source IP address is used to identify the user and locate the userâs stored data. In - the other methods, cookies are used. The cookie generated by the load balancer or application is - included in request and response URLs to create persistence. The cookie name can be specified by - the administrator or automatically generated. A variety of options are provided to control the - exact behavior of cookies, such as how they are generated and whether they are cached.</para> - <para>For the most up to date list of available stickiness methods, see the &PRODUCT; UI or call - listNetworks and check the SupportedStickinessMethods capability.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/stop-restart-management-server.xml ---------------------------------------------------------------------- diff --git a/en-US/stop-restart-management-server.xml b/en-US/stop-restart-management-server.xml deleted file mode 100644 index 74a687c..0000000 --- a/en-US/stop-restart-management-server.xml +++ /dev/null @@ -1,34 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="stop-restart-management-server"> - <title>Stopping and Restarting the Management Server</title> - <para>The root administrator will need to stop and restart the Management Server from time to time.</para> - <para>For example, after changing a global configuration parameter, a restart is required. If you have multiple Management Server nodes, restart all of them to put the new parameter value into effect consistently throughout the cloud..</para> - <para>To stop the Management Server, issue the following command at the operating system prompt on the Management Server node:</para> - <programlisting># service cloudstack-management stop</programlisting> - <para>To start the Management Server:</para> - <programlisting># service cloudstack-management start</programlisting> - <para>To stop the Management Server:</para> - <programlisting># service cloudstack-management stop</programlisting> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/stopped-vm.xml ---------------------------------------------------------------------- diff --git a/en-US/stopped-vm.xml b/en-US/stopped-vm.xml deleted file mode 100644 index 7024be7..0000000 --- a/en-US/stopped-vm.xml +++ /dev/null @@ -1,35 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="stopped-vm"> - <title>Stopped VM</title> - <para>&PRODUCT; now supports creating a VM without starting it. You can determine whether the VM needs to be started as part of the VM deployment. A VM can now be deployed in two ways: create and start a VM (the default method); or create a VM and leave it in the stopped state.</para> - <para>A new request parameter, startVM, is introduced in the deployVm API to support the stopped VM feature.</para> - <para>The possible values are:</para> - <itemizedlist> - <listitem><para>true - The VM starts as a part of the VM deployment.</para></listitem> - <listitem><para>false - The VM is left in the stopped state at the end of the VM deployment.</para></listitem> - </itemizedlist> - <para>The default value is true.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/stopping-and-starting-vms.xml ---------------------------------------------------------------------- diff --git a/en-US/stopping-and-starting-vms.xml b/en-US/stopping-and-starting-vms.xml deleted file mode 100644 index 25c1f49..0000000 --- a/en-US/stopping-and-starting-vms.xml +++ /dev/null @@ -1,29 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="stopping-and-starting-vms"> - <title>Stopping and Starting VMs</title> - <para>Once a VM instance is created, you can stop, restart, or delete it as needed. In the &PRODUCT; UI, click Instances, select the VM, and use the Stop, Start, Reboot, and Destroy buttons.</para> -</section> - http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/storage-nw-topology-req.xml ---------------------------------------------------------------------- diff --git a/en-US/storage-nw-topology-req.xml b/en-US/storage-nw-topology-req.xml deleted file mode 100644 index a594bab..0000000 --- a/en-US/storage-nw-topology-req.xml +++ /dev/null @@ -1,28 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="storage-nw-topology-req"> - <title>Storage Network Topology Requirements</title> - <para>The secondary storage NFS export is mounted by the secondary storage VM. Secondary storage - traffic goes over the management traffic network, even if there is a separate storage network. - Primary storage traffic goes over the storage network, if available. If you choose to place - secondary storage NFS servers on the storage network, you must make sure there is a route from - the management traffic network to the storage network.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/storage-overview.xml ---------------------------------------------------------------------- diff --git a/en-US/storage-overview.xml b/en-US/storage-overview.xml deleted file mode 100644 index bebf441..0000000 --- a/en-US/storage-overview.xml +++ /dev/null @@ -1,27 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="storage-overview"> - <title>Storage Overview</title> - <para>&PRODUCT; defines two types of storage: primary and secondary. Primary storage can be - accessed by either iSCSI or NFS. Additionally, direct attached storage may be used for primary - storage. Secondary storage is always accessed using NFS.</para> - <para>There is no ephemeral storage in &PRODUCT;. All volumes on all nodes are persistent.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/storage-plugins.xml ---------------------------------------------------------------------- diff --git a/en-US/storage-plugins.xml b/en-US/storage-plugins.xml deleted file mode 100644 index 49f3036..0000000 --- a/en-US/storage-plugins.xml +++ /dev/null @@ -1,294 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "file:///C:/Program%20Files%20(x86)/Publican/DocBook_DTD/docbookx.dtd" [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<chapter id="storage-plugins"> - <title>Writing a Storage Plugin</title> - <para>This section gives an outline of how to implement a plugin - to integrate a third-party storage provider. - For details and an example, you will need to read the code.</para> - <note> - <para>Example code is available at: - plugins/storage/volume/sample</para> - </note> - <para/> - <para>Third party storage providers can integrate with &PRODUCT; to provide - either primary storage or secondary storage. - For example, &PRODUCT; provides plugins for - Amazon Simple Storage Service (S3) or OpenStack - Object Storage (Swift). The S3 plugin can be used for any object storage - that supports the Amazon S3 interface.</para> - <para>Additional third party object storages that - do not support the S3 interface can be integrated with &PRODUCT; - by writing plugin software that uses the object storage plugin framework. - Several new interfaces are available so that - storage providers can develop vendor-specific plugins based on well-defined - contracts that can be seamlessly managed by &PRODUCT;.</para> - <para>Artifacts such as templates, ISOs and snapshots are kept in storage which &PRODUCT; - refers to as secondary storage. To improve scalability and performance, as when a number - of hosts access secondary storage concurrently, object storage can be used for secondary - storage. Object storage can also provide built-in high availability capability. When using - object storage, access to secondary storage data can be made available across multiple - zones in a region. This is a huge benefit, as it is no longer necessary to copy templates, - snapshots etc. across zones as would be needed in an environment - using only zone-based NFS storage.</para> - <para>The user enables a storage plugin through the UI. - A new dialog box choice is offered to select the storage - provider. Depending on which provider is selected, additional input fields may appear so that - the user can provide the additional details required by that provider, such as a user name and - password for a third-party storage account. - </para> - <section id="storage-plugin-steps"> - <title>Overview of How to Write a Storage Plugin</title> - <para>To add a third-party storage option to &PRODUCT;, follow these general steps (explained in more detail - later in this section):</para> - <orderedlist> - <listitem><para>Implement the following interfaces in Java:</para> - <itemizedlist> - <listitem><para>DataStoreDriver</para></listitem> - <listitem><para>DataStoreLifecycle</para></listitem> - <listitem><para>DataStoreProvider</para></listitem> - <listitem><para>VMSnapshotStrategy (if you want to customize the VM snapshot functionality)</para></listitem> - </itemizedlist></listitem> - <listitem><para>Hardcode your plugin's required additional - input fields into the code for the Add Secondary Storage - or Add Primary Storage dialog box.</para></listitem> - <listitem><para>Place your .jar file in plugins/storage/volume/ or plugins/storage/image/.</para></listitem> - <listitem><para>Edit /client/tomcatconf/componentContext.xml.in.</para></listitem> - <listitem><para>Edit client/pom.xml.</para></listitem> - </orderedlist> - </section> - <section id="datastoredriver"> - <title>Implementing DataStoreDriver</title> - <para>DataStoreDriver contains the code that &PRODUCT; will use to provision the object store, when needed.</para> - <para>You must implement the following methods:</para> - <itemizedlist> - <listitem><para>getTO()</para></listitem> - <listitem><para>getStoreTO()</para></listitem> - <listitem><para>createAsync()</para></listitem> - <listitem><para>deleteAsync()</para></listitem> - </itemizedlist> - <para>The following methods are optional:</para> - <itemizedlist> - <listitem><para>resize()</para></listitem> - <listitem><para>canCopy() is optional. If you set it to true, then you must implement copyAsync().</para></listitem> - </itemizedlist> - </section> - <section id="datastorelifecycle"> - <title>Implementing DataStoreLifecycle</title> - <para>DataStoreLifecycle contains the code to manage the storage operations for ongoing use of the storage. - Several operations are needed, like create, maintenance mode, delete, etc.</para> - <para>You must implement the following methods:</para> - <itemizedlist> - <listitem><para>initialize()</para></listitem> - <listitem><para>maintain()</para></listitem> - <listitem><para>cancelMaintain()</para></listitem> - <listitem><para>deleteDataStore()</para></listitem> - <listitem><para>Implement one of the attach*() methods depending on what scope you want the storage to have: attachHost(), attachCluster(), or attachZone().</para></listitem> - </itemizedlist> - </section> - <section id="datastoreprovider"> - <title>Implementing DataStoreProvider</title> - <para>DataStoreProvider contains the main code of the data store.</para> - <para>You must implement the following methods:</para> - <itemizedlist> - <listitem><para>getDatastoreLifeCycle()</para></listitem> - <listitem><para>getDataStoreDriver()</para></listitem> - <listitem><para>getTypes(). Returns one or more types of storage for which this data store provider can be used. - For secondary object storage, return IMAGE, and for a Secondary Staging Store, return ImageCache.</para></listitem> - <listitem><para>configure(). First initialize the lifecycle implementation and the driver implementation, - then call registerDriver() to register the new object store provider instance with &PRODUCT;.</para></listitem> - <listitem><para>getName(). Returns the unique name of your provider; for example, - this can be used to get the name to display in the UI.</para></listitem> - </itemizedlist> - <para>The following methods are optional:</para> - <itemizedlist> - <listitem><para>getHostListener() is optional; it's for monitoring the status of the host.</para></listitem> - </itemizedlist> - </section> - <section id="implement-vmsnapshotstrategy"> - <title>Implementing VMSnapshotStrategy</title> - <para>VMSnapshotStrategy has the following methods:</para> - <itemizedlist> - <listitem><para>takeVMSnapshot()</para></listitem> - <listitem><para>deleteVMSnapshot()</para></listitem> - <listitem><para>revertVMSnapshot()</para></listitem> - <listitem><para>canHandle(). For a given VM snapshot, - tells whether this implementation of VMSnapshotStrategy can handle it.</para></listitem> - </itemizedlist> - </section> - <section id="storage-plugin-code-location"> - <title>Place the .jar File in the Right Directory</title> - <para>For a secondary storage plugin, place your .jar file here:</para> - <programlisting>plugins/storage/image/</programlisting> - <para>For a primary storage plugin, place your .jar file here:</para> - <programlisting>plugins/storage/volume/</programlisting> - </section> - <section id="storage-plugin-componentcontext-xml"> - <title>Edit Configuration Files</title> - <para>First, edit the following file tell &PRODUCT; to include your .jar file. - Add a line to this file to tell the &PRODUCT; Management Server that it now has a dependency on your code:</para> - <programlisting>client/pom.xml</programlisting> - <para>Place some facts about your code in the following file so &PRODUCT; can run it:</para> - <programlisting>/client/tomcatconf/componentContext.xml.in</programlisting> - <para>In the section âDeployment configurations of various adapters,â add this:</para> - <programlisting><bean>id=âsome unique IDâ class=âpackage name of your implementation of DataStoreProviderâ</bean></programlisting> - <para>In the section âStorage Providers,â add this:</para> - <programlisting><property name=âprovidersâ> - <ref local=âsame ID from the bean tag's id attributeâ> -</property></programlisting> - </section> - <section> - <title>Minimum Required Interfaces</title> - <para>The classes, interfaces, and methods used by &PRODUCT; from the Amazon Web Services (AWS) Java SDK - are listed in this section. - An object storage that supports the S3 interface - is minimally required to support the below in order to be compatible with &PRODUCT;.</para> - <section> - <title>Interface AmazonS3</title> - <para><ulink url="http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/AmazonS3.html";>http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/AmazonS3.html</ulink></para> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="3.35*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>Modifier and Type</para></entry> - <entry><para>Method and Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>Bucket</para></entry> - <entry><para>createBucket(String bucketName)</para> - <para>Creates a new Amazon S3 bucket with the specified name in the default (US) region, Region.US_Standard.</para> - </entry> - </row> - <row> - <entry><para>void</para></entry> - <entry><para>deleteObject(String bucketName, String key)</para> - <para>Deletes the specified object in the specified bucket.</para> - </entry> - </row> - <row> - <entry><para>ObjectMetadata</para></entry> - <entry><para>getObject(GetObjectRequest getObjectRequest, File destinationFile)</para> - <para>Gets the object metadata for the object stored in Amazon S3 - under the specified bucket and key, and saves the object contents to the specified file.</para> - </entry> - </row> - <row> - <entry><para>S3Object</para></entry> - <entry><para>getObject(String bucketName, String key)</para> - <para>Gets the object stored in Amazon S3 under the specified bucket and key.</para> - </entry> - </row> - <row> - <entry><para>URL</para></entry> - <entry><para>generatePresignedUrl(String bucketName, String key, Date expiration, HttpMethod method)</para> - <para>Returns a pre-signed URL for accessing an Amazon S3 resource.</para> - </entry> - </row> - <row> - <entry><para>void</para></entry> - <entry><para>deleteBucket(String bucketName)</para> - <para>Deletes the specified bucket.</para> - </entry> - </row> - <row> - <entry><para>List<Bucket></para></entry> - <entry><para>listBuckets()</para> - <para>Returns a list of all Amazon S3 buckets that the authenticated sender of the request owns.</para> - </entry> - </row> - <row> - <entry><para>ObjectListing</para></entry> - <entry><para>listObjects(String bucketName, String prefix)</para> - <para>Returns a list of summary information about the objects in the specified bucket.</para> - </entry> - </row> - <row> - <entry><para>PutObjectResult</para></entry> - <entry><para>putObject(PutObjectRequest putObjectRequest)</para> - <para>Uploads a new object to the specified Amazon S3 bucket.</para> - </entry> - </row> - <row> - <entry><para>PutObjectResult</para></entry> - <entry><para>putObject(String bucketName, String key, File file)</para> - <para>Uploads the specified file to Amazon S3 under the specified bucket and key name.</para> - </entry> - </row> - <row> - <entry><para>PutObjectResult</para></entry> - <entry><para>putObject(String bucketName, String key, InputStream input, ObjectMetadata metadata)</para> - <para>Uploads the specified input stream and object metadata to Amazon S3 under the specified bucket and key name.</para> - </entry> - </row> - <row> - <entry><para>void</para></entry> - <entry><para>setEndpoint(String endpoint)</para> - <para>Overrides the default endpoint for this client.</para> - </entry> - </row> - <row> - <entry><para>void</para></entry> - <entry><para>setObjectAcl(String bucketName, String key, CannedAccessControlList acl)</para> - <para>Sets the CannedAccessControlList for the specified object in Amazon S3 using one of the pre-configured CannedAccessControlLists.</para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> - <section> - <title>Class TransferManager</title> - <para><ulink url="http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/transfer/TransferManager.html";>http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/transfer/TransferManager.html</ulink></para> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="3.35*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>Modifier and Type</para></entry> - <entry><para>Method and Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>Upload</para></entry> - <entry><para>upload(PutObjectRequest putObjectRequest)</para> - <para>Schedules a new transfer to upload data to Amazon S3.</para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> - <section> - <title>Class PutObjectRequest</title> - <para><ulink url="http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/model/PutObjectRequest.html";>http://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/s3/model/PutObjectRequest.html</ulink></para> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="3.35*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>Modifier and Type</para></entry> - <entry><para>Method and Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>Upload</para></entry> - <entry><para>upload(PutObjectRequest putObjectRequest)</para> - <para>Schedules a new transfer to upload data to Amazon S3.</para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> -</section> -</chapter> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/storage-setup.xml ---------------------------------------------------------------------- diff --git a/en-US/storage-setup.xml b/en-US/storage-setup.xml deleted file mode 100644 index 669fc0d..0000000 --- a/en-US/storage-setup.xml +++ /dev/null @@ -1,192 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<chapter id="storage-setup"> - <title>Storage Setup</title> - <para>&PRODUCT; is designed to work with a wide variety of commodity and enterprise-grade storage. Local disk may be used as well, if supported by the selected hypervisor. Storage type support for guest virtual disks differs based on hypervisor selection.</para> - <informaltable> - <tgroup cols="4" align="left" colsep="1" rowsep="1"> - <thead> - <row> - <entry><para></para></entry> - <entry><para>XenServer</para></entry> - <entry><para>vSphere</para></entry> - <entry><para>KVM</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>NFS</para></entry> - <entry><para>Supported</para></entry> - <entry><para>Supported</para></entry> - <entry><para>Supported</para></entry> - </row> - <row> - <entry><para>iSCSI</para></entry> - <entry><para>Supported</para></entry> - <entry><para>Supported via VMFS</para></entry> - <entry><para>Supported via Clustered Filesystems</para></entry> - </row> - <row> - <entry><para>Fiber Channel</para></entry> - <entry><para>Supported via Pre-existing SR</para></entry> - <entry><para>Supported</para></entry> - <entry><para>Supported via Clustered Filesystems</para></entry> - </row> - <row> - <entry><para>Local Disk</para></entry> - <entry><para>Supported</para></entry> - <entry><para>Supported</para></entry> - <entry><para>Supported</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para>The use of the Cluster Logical Volume Manager (CLVM) for KVM is not officially supported with &PRODUCT;.</para> - <section id="storage-set-small-scale"> - <title>Small-Scale Setup</title> - <para>In a small-scale setup, a single NFS server can function as both primary and secondary storage. The NFS server just needs to export two separate shares, one for primary storage and the other for secondary storage.</para> - </section> - <section id="storage-set-secondary"> - <title>Secondary Storage</title> - <para>&PRODUCT; is designed to work with any scalable secondary storage system. The only requirement is the secondary storage system supports the NFS protocol.</para> - <note> - <para>The storage server should be a machine with a large number of disks. The disks should ideally be managed by a hardware RAID controller. Modern hardware RAID controllers support hot plug functionality independent of the operating system so you can replace faulty disks without impacting the running operating system.</para> - </note> - </section> - <section id="storage-set-example-config"> - <title>Example Configurations</title> - <para>In this section we go through a few examples of how to set up storage to work properly on a few types of NFS and iSCSI storage systems.</para> - <section id="storage-set-example-config-local-das"> - <title>Linux NFS on Local Disks and DAS</title> - <para>This section describes how to configure an NFS export on a standard Linux installation. The exact commands might vary depending on the operating system version.</para> - <orderedlist> - <listitem><para>Install the RHEL/CentOS distribution on the storage server.</para></listitem> - <listitem><para>If the root volume is more than 2 TB in size, create a smaller boot volume to install RHEL/CentOS. A root volume of 20 GB should be sufficient.</para></listitem> - <listitem><para>After the system is installed, create a directory called /export. This can each be a directory in the root partition itself or a mount point for a large disk volume.</para></listitem> - <listitem><para>If you have more than 16TB of storage on one host, create multiple EXT3 file systems and multiple NFS exports. Individual EXT3 file systems cannot exceed 16TB.</para></listitem> - <listitem> - <para>After /export directory is created, run the following command to configure it as an NFS export.</para> - <programlisting># echo "/export <CIDR>(rw,async,no_root_squash,no_subtree_check)" >> /etc/exports</programlisting> - <para>Adjust the above command to suit your deployment needs.</para> - <itemizedlist> - <listitem> - <para><emphasis role="bold">Limiting NFS export.</emphasis> It is highly recommended that you limit the NFS export to a particular subnet by specifying a subnet mask (e.g.,â192.168.1.0/24â). By allowing access from only within the expected cluster, you avoid having non-pool member mount the storage. The limit you place must include the management network(s) and the storage network(s). If the two are the same network then one CIDR is sufficient. If you have a separate storage network you must provide separate CIDRâs for both or one CIDR that is broad enough to span both.</para> - <para>The following is an example with separate CIDRs:</para> - <programlisting>/export 192.168.1.0/24(rw,async,no_root_squash,no_subtree_check) 10.50.1.0/24(rw,async,no_root_squash,no_subtree_check)</programlisting> - </listitem> - <listitem> - <para><emphasis role="bold">Removing the async flag.</emphasis> The async flag improves performance by allowing the NFS server to respond before writes are committed to the disk. Remove the async flag in your mission critical production deployment.</para> - </listitem> - </itemizedlist> - </listitem> - <listitem> - <para>Run the following command to enable NFS service.</para> - <programlisting># chkconfig nfs on</programlisting> - </listitem> - <listitem> - <para>Edit the /etc/sysconfig/nfs file and uncomment the following lines.</para> - <programlisting>LOCKD_TCPPORT=32803 -LOCKD_UDPPORT=32769 -MOUNTD_PORT=892 -RQUOTAD_PORT=875 -STATD_PORT=662 -STATD_OUTGOING_PORT=2020</programlisting> - </listitem> - <listitem> - <para>Edit the /etc/sysconfig/iptables file and add the following lines at the beginning of the INPUT chain.</para> - <programlisting> --A INPUT -m state --state NEW -p udp --dport 111 -j ACCEPT --A INPUT -m state --state NEW -p tcp --dport 111 -j ACCEPT --A INPUT -m state --state NEW -p tcp --dport 2049 -j ACCEPT --A INPUT -m state --state NEW -p tcp --dport 32803 -j ACCEPT --A INPUT -m state --state NEW -p udp --dport 32769 -j ACCEPT --A INPUT -m state --state NEW -p tcp --dport 892 -j ACCEPT --A INPUT -m state --state NEW -p udp --dport 892 -j ACCEPT --A INPUT -m state --state NEW -p tcp --dport 875 -j ACCEPT --A INPUT -m state --state NEW -p udp --dport 875 -j ACCEPT --A INPUT -m state --state NEW -p tcp --dport 662 -j ACCEPT --A INPUT -m state --state NEW -p udp --dport 662 -j ACCEPT - </programlisting> - </listitem> - <listitem> - <para>Reboot the server.</para> - <para>An NFS share called /export is now set up.</para> - </listitem> - </orderedlist> - <note><para>When copying and pasting a command, be sure the command has pasted as a single line before executing. Some document viewers may introduce unwanted line breaks in copied text.</para></note> - </section> - <section id="storage-set-example-config-iscsi"> - <title>Linux NFS on iSCSI</title> - <para>Use the following steps to set up a Linux NFS server export on an iSCSI volume. These steps apply to RHEL/CentOS 5 distributions.</para> - <orderedlist> - <listitem> - <para>Install iscsiadm.</para> - <programlisting> -# yum install iscsi-initiator-utils -# service iscsi start -# chkconfig --add iscsi -# chkconfig iscsi on - </programlisting> - </listitem> - <listitem> - <para>Discover the iSCSI target.</para> - <programlisting># iscsiadm -m discovery -t st -p <iSCSI Server IP address>:3260</programlisting> - <para>For example:</para> - <programlisting># iscsiadm -m discovery -t st -p 172.23.10.240:3260 - 172.23.10.240:3260,1 iqn.2001-05.com.equallogic:0-8a0906-83bcb3401-16e0002fd0a46f3d-rhel5-test </programlisting> - </listitem> - <listitem> - <para>Log in.</para> - <programlisting># iscsiadm -m node -T <Complete Target Name> -l -p <Group IP>:3260</programlisting> - <para>For example:</para> - <programlisting># iscsiadm -m node -l -T iqn.2001-05.com.equallogic:83bcb3401-16e0002fd0a46f3d-rhel5-test -p 172.23.10.240:3260 </programlisting> - </listitem> - <listitem> - <para>Discover the SCSI disk. For example:</para> - <programlisting> -# iscsiadm -m session -P3 | grep Attached -Attached scsi disk sdb State: running - </programlisting> - </listitem> - <listitem> - <para>Format the disk as ext3 and mount the volume.</para> - <programlisting># mkfs.ext3 /dev/sdb -# mkdir -p /export -# mount /dev/sdb /export - </programlisting> - </listitem> - <listitem> - <para>Add the disk to /etc/fstab to make sure it gets mounted on boot.</para> - <programlisting>/dev/sdb /export ext3 _netdev 0 0</programlisting> - </listitem> - </orderedlist> - <para>Now you can set up /export as an NFS share.</para> - <itemizedlist> - <listitem> - <para><emphasis role="bold">Limiting NFS export.</emphasis> In order to avoid data loss, it is highly recommended that you limit the NFS export to a particular subnet by specifying a subnet mask (e.g.,â192.168.1.0/24â). By allowing access from only within the expected cluster, you avoid having non-pool member mount the storage and inadvertently delete all its data. The limit you place must include the management network(s) and the storage network(s). If the two are the same network then one CIDR is sufficient. If you have a separate storage network you must provide separate CIDRs for both or one CIDR that is broad enough to span both. </para> - <para>The following is an example with separate CIDRs:</para> - <programlisting>/export 192.168.1.0/24(rw,async,no_root_squash,no_subtree_check) 10.50.1.0/24(rw,async,no_root_squash,no_subtree_check)</programlisting> - </listitem> - <listitem><para><emphasis role="bold">Removing the async flag.</emphasis> The async flag improves performance by allowing the NFS server to respond before writes are committed to the disk. Remove the async flag in your mission critical production deployment.</para></listitem> - </itemizedlist> - </section> - </section> - </chapter> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/storage-tags.xml ---------------------------------------------------------------------- diff --git a/en-US/storage-tags.xml b/en-US/storage-tags.xml deleted file mode 100644 index 39b55a6..0000000 --- a/en-US/storage-tags.xml +++ /dev/null @@ -1,29 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="storage-tags"> - <title>Storage Tags</title> - <para>Storage may be "tagged". A tag is a text string attribute associated with primary storage, a Disk Offering, or a Service Offering. Tags allow administrators to provide additional information about the storage. For example, that is a "SSD" or it is "slow". Tags are not interpreted by &PRODUCT;. They are matched against tags placed on service and disk offerings. &PRODUCT; requires all tags on service and disk offerings to exist on the primary storage before it allocates root or data disks on the primary storage. Service and disk offering tags are used to identify the requirements of the storage that those offerings have. For example, the high end service offering may require "fast" for its root disk volume.</para> - <para>The interaction between tags, allocation, and volume copying across clusters and pods can be complex. To simplify the situation, use the same set of tags on the primary storage for all clusters in a pod. Even if different devices are used to present those tags, the set of exposed tags can be the same.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/storage.xml ---------------------------------------------------------------------- diff --git a/en-US/storage.xml b/en-US/storage.xml deleted file mode 100644 index 3ef7324..0000000 --- a/en-US/storage.xml +++ /dev/null @@ -1,31 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<chapter id="storage"> - <title>Working With Storage</title> - <xi:include href="storage-overview.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="primary-storage.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="secondary-storage.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="working-with-volumes.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="working-with-snapshots.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> -</chapter> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/suspend-project.xml ---------------------------------------------------------------------- diff --git a/en-US/suspend-project.xml b/en-US/suspend-project.xml deleted file mode 100644 index b4f821b..0000000 --- a/en-US/suspend-project.xml +++ /dev/null @@ -1,52 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="suspend-project"> - <title>Suspending or Deleting a Project</title> - <para>When a project is suspended, it retains the resources it owns, but they can no longer be used. No new resources or members can be added to a suspended project.</para> - <para>When a project is deleted, its resources are destroyed, and member accounts are removed from the project. The projectâs status is shown as Disabled pending final deletion.</para> - <para>A project can be suspended or deleted 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 one of the buttons:</para><para>To delete, use <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/delete-button.png" /> - </imageobject> - <textobject> - <phrase>deletebutton.png: Removes a project</phrase> - </textobject> - </inlinemediaobject></para> - <para>To suspend, use<inlinemediaobject> - <imageobject> - <imagedata fileref="./images/suspend-icon.png" /> - </imageobject> - <textobject> - <phrase>deletebutton.png: suspends a project</phrase> - </textobject> - </inlinemediaobject></para></listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/sys-offering-sysvm.xml ---------------------------------------------------------------------- diff --git a/en-US/sys-offering-sysvm.xml b/en-US/sys-offering-sysvm.xml deleted file mode 100644 index 563dd6f..0000000 --- a/en-US/sys-offering-sysvm.xml +++ /dev/null @@ -1,75 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="sys-offering-sysvm"> - <title>Changing the Default System Offering for System VMs</title> - <para>You can manually change the system offering for a particular System VM. Additionally, as a - &PRODUCT; administrator, you can also change the default system offering used for System - VMs.</para> - <orderedlist> - <listitem> - <para>Create a new system offering.</para> - <para>For more information, see <phrase condition="install"><xref - linkend="creating-system-service-offerings"/></phrase> - <phrase condition="admin">Creating a New System Service Offering</phrase>. </para> - </listitem> - <listitem> - <para>Back up the database:</para> - <programlisting>mysqldump -u root -p cloud | bzip2 > cloud_backup.sql.bz2</programlisting> - </listitem> - <listitem> - <para>Open an MySQL prompt:</para> - <programlisting>mysql -u cloud -p cloud</programlisting> - </listitem> - <listitem> - <para>Run the following queries on the cloud database.</para> - <orderedlist numeration="loweralpha"> - <listitem> - <para>In the disk_offering table, identify the original default offering and the new - offering you want to use by default. </para> - <para>Take a note of the ID of the new offering.</para> - <programlisting>select id,name,unique_name,type from disk_offering;</programlisting> - </listitem> - <listitem> - <para>For the original default offering, set the value of unique_name to NULL.</para> - <programlisting># update disk_offering set unique_name = NULL where id = 10;</programlisting> - <para>Ensure that you use the correct value for the ID.</para> - </listitem> - <listitem> - <para>For the new offering that you want to use by default, set the value of unique_name - as follows:</para> - <para>For the default Console Proxy VM (CPVM) offering,set unique_name to - 'Cloud.com-ConsoleProxy'. For the default Secondary Storage VM (SSVM) offering, set - unique_name to 'Cloud.com-SecondaryStorage'. For example:</para> - <programlisting>update disk_offering set unique_name = 'Cloud.com-ConsoleProxy' where id = 16;</programlisting> - </listitem> - </orderedlist> - </listitem> - <listitem> - <para>Restart &PRODUCT; Management Server. Restarting is required because the default - offerings are loaded into the memory at startup.</para> - <programlisting>service cloudstack-management restart</programlisting> - </listitem> - <listitem> - <para>Destroy the existing CPVM or SSVM offerings and wait for them to be recreated. The new - CPVM or SSVM are configured with the new offering. </para> - </listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/sys-reliability-and-ha.xml ---------------------------------------------------------------------- diff --git a/en-US/sys-reliability-and-ha.xml b/en-US/sys-reliability-and-ha.xml deleted file mode 100644 index b54744f..0000000 --- a/en-US/sys-reliability-and-ha.xml +++ /dev/null @@ -1,34 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<chapter id="sys-reliability-and-ha"> - <title>System Reliability and High Availability</title> - <xi:include href="ha-management-server.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="ha-enabled-vm.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="dedicated-ha-hosts.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="primary-storage-outage-and-data-loss.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="secondary-storage-outage-and-data-loss.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="db-ha.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="api-throttling.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> -</chapter> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/sysprep-for-windows-server-2003R2.xml ---------------------------------------------------------------------- diff --git a/en-US/sysprep-for-windows-server-2003R2.xml b/en-US/sysprep-for-windows-server-2003R2.xml deleted file mode 100644 index 5f8a389..0000000 --- a/en-US/sysprep-for-windows-server-2003R2.xml +++ /dev/null @@ -1,57 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="sysprep-for-windows-server-2003R2"> - <title>System Preparation for Windows Server 2003 R2</title> - <para>Earlier versions of Windows have a different sysprep tool. Follow these steps for Windows Server 2003 R2.</para> - <orderedlist> - <listitem><para>Extract the content of \support\tools\deploy.cab on the Windows installation CD into a directory called c:\sysprep on the Windows 2003 R2 VM.</para></listitem> - <listitem><para>Run c:\sysprep\setupmgr.exe to create the sysprep.inf file.</para> - <orderedlist numeration="loweralpha"> - <listitem><para>Select Create New to create a new Answer File.</para></listitem> - <listitem><para>Enter âSysprep setupâ for the Type of Setup.</para></listitem> - <listitem><para>Select the appropriate OS version and edition.</para></listitem> - <listitem><para>On the License Agreement screen, select âYes fully automate the installationâ.</para></listitem> - <listitem><para>Provide your name and organization.</para></listitem> - <listitem><para>Leave display settings at default.</para></listitem> - <listitem><para>Set the appropriate time zone.</para></listitem> - <listitem><para>Provide your product key.</para></listitem> - <listitem><para>Select an appropriate license mode for your deployment</para></listitem> - <listitem><para>Select âAutomatically generate computer nameâ.</para></listitem> - <listitem><para>Type a default administrator password. If you enable the password reset feature, the users will not actually use this password. This password will be reset by the instance manager after the guest boots up.</para></listitem> - <listitem><para>Leave Network Components at âTypical Settingsâ.</para></listitem> - <listitem><para>Select the âWORKGROUPâ option.</para></listitem> - <listitem><para>Leave Telephony options at default.</para></listitem> - <listitem><para>Select appropriate Regional Settings.</para></listitem> - <listitem><para>Select appropriate language settings.</para></listitem> - <listitem><para>Do not install printers.</para></listitem> - <listitem><para>Do not specify âRun Once commandsâ.</para></listitem> - <listitem><para>You need not specify an identification string.</para></listitem> - <listitem><para>Save the Answer File as c:\sysprep\sysprep.inf.</para></listitem> - - </orderedlist> - </listitem> - <listitem><para>Run the following command to sysprep the image:</para><programlisting>c:\sysprep\sysprep.exe -reseal -mini -activated</programlisting> - <para>After this step the machine will automatically shut down</para></listitem> - </orderedlist> - </section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/sysprep-windows-server-2008R2.xml ---------------------------------------------------------------------- diff --git a/en-US/sysprep-windows-server-2008R2.xml b/en-US/sysprep-windows-server-2008R2.xml deleted file mode 100644 index 49e7477..0000000 --- a/en-US/sysprep-windows-server-2008R2.xml +++ /dev/null @@ -1,71 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="sysprep-windows-server-2008R2"> - <title>System Preparation for Windows Server 2008 R2</title> - <para>For Windows 2008 R2, you run Windows System Image Manager to create a custom sysprep response XML file. Windows System Image Manager is installed as part of the Windows Automated Installation Kit (AIK). Windows AIK can be downloaded from <ulink url="http://www.microsoft.com/en-us/download/details.aspx?id=9085";>Microsoft Download Center</ulink>.</para> - <para>Use the following steps to run sysprep for Windows 2008 R2:</para><note><para>The steps outlined here are derived from the excellent guide by Charity Shelbourne, originally published at <ulink url="http://blogs.technet.com/askcore/archive/2008/10/31/automating-the-oobe-process-during-windows-server-2008-sysprep-mini-setup.aspx";>Windows Server 2008 Sysprep Mini-Setup.</ulink></para> - </note> - <para></para> - <orderedlist> - <listitem><para>Download and install the Windows AIK</para><note><para>Windows AIK should not be installed on the Windows 2008 R2 VM you just created. Windows AIK should not be part of the template you create. It is only used to create the sysprep answer file.</para></note></listitem> - <listitem><para>Copy the install.wim file in the \sources directory of the Windows 2008 R2 installation DVD to the hard disk. This is a very large file and may take a long time to copy. Windows AIK requires the WIM file to be writable.</para></listitem> - <listitem><para>Start the Windows System Image Manager, which is part of the Windows AIK.</para></listitem> - <listitem><para>In the Windows Image pane, right click the Select a Windows image or catalog file option to - load the install.wim file you just copied.</para></listitem> - <listitem><para>Select the Windows 2008 R2 Edition.</para><para>You may be prompted with a warning that the catalog file cannot be opened. Click Yes to create a new catalog file.</para></listitem> - <listitem><para>In the Answer File pane, right click to create a new answer file.</para></listitem> - <listitem><para>Generate the answer file from the Windows System Image Manager using the following steps:</para> - <orderedlist numeration="loweralpha"> - <listitem><para>The first page you need to automate is the Language and Country or Region Selection page. To automate this, expand Components in your Windows Image pane, right-click and add the Microsoft-Windows-International-Core setting to Pass 7 oobeSystem. In your Answer File pane, configure the InputLocale, SystemLocale, UILanguage, and UserLocale with the appropriate settings for your language and country or region. Should you have a question about any of these settings, you can right-click on the specific setting and select Help. This will open the appropriate CHM help file with more information, including examples on the setting you are attempting to configure.</para> - <mediaobject> - <imageobject> - <imagedata fileref="./images/sysmanager.png" /> - </imageobject> - <textobject><phrase>sysmanager.png: System Image Manager</phrase></textobject> - </mediaobject></listitem> - <listitem><para>You need to automate the Software License Terms Selection page, otherwise known as the End-User License Agreement (EULA). To do this, expand the Microsoft-Windows-Shell-Setup component. High-light the OOBE setting, and add the setting to the Pass 7 oobeSystem. In Settings, set HideEULAPage true.</para> <mediaobject> - <imageobject> - <imagedata fileref="./images/software-license.png" /> - </imageobject> - <textobject><phrase>software-license.png: Depicts hiding the EULA page.</phrase></textobject> - </mediaobject></listitem> - <listitem><para>Make sure the license key is properly set. If you use MAK key, you can just enter the MAK key on the Windows 2008 R2 VM. You need not input the MAK into the Windows System Image Manager. If you use KMS host for activation you need not enter the Product Key. Details of Windows Volume Activation can be found at <ulink url="http://technet.microsoft.com/en-us/library/bb892849.aspx";></ulink></para></listitem> - <listitem><para>You need to automate is the Change Administrator Password page. Expand the Microsoft-Windows-Shell-Setup component (if it is not still expanded), expand UserAccounts, right-click on AdministratorPassword, and add the setting to the Pass 7 oobeSystem configuration pass of your answer file. Under Settings, specify a password next to Value.</para> - <mediaobject> - <imageobject> - <imagedata fileref="./images/change-admin-password.png" /> - </imageobject> - <textobject><phrase>change-admin-password.png: Depicts changing the administrator password</phrase></textobject> - </mediaobject><para>You may read the AIK documentation and set many more options that suit your deployment. The steps above are the minimum needed to make Windows unattended setup work.</para></listitem></orderedlist></listitem> - <listitem><para>Save the answer file as unattend.xml. You can ignore the warning messages that appear in the validation window.</para></listitem> - <listitem><para>Copy the unattend.xml file into the c:\windows\system32\sysprep directory of the Windows 2008 R2 Virtual Machine</para></listitem> - <listitem><para>Once you place the unattend.xml file in c:\windows\system32\sysprep directory, you run the sysprep tool as follows:</para> - <programlisting>cd c:\Windows\System32\sysprep -sysprep.exe /oobe /generalize /shutdown -</programlisting><para>The Windows 2008 R2 VM will automatically shut down after sysprep is complete.</para></listitem> - - - </orderedlist> - -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/system-reserved-ip-addresses.xml ---------------------------------------------------------------------- diff --git a/en-US/system-reserved-ip-addresses.xml b/en-US/system-reserved-ip-addresses.xml deleted file mode 100644 index e2588ed..0000000 --- a/en-US/system-reserved-ip-addresses.xml +++ /dev/null @@ -1,41 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> -<section id="system-reserved-ip-addresses"> - <title>System Reserved IP Addresses</title> - <para>In each zone, you need to configure a range of reserved IP addresses for the management network. This network carries communication between the &PRODUCT; Management Server and various system VMs, such as Secondary Storage VMs, Console Proxy VMs, and DHCP. </para> - <para>The reserved IP addresses must be unique across the cloud. You cannot, for example, have a host in one zone which has the same private IP address as a host in another zone.</para> - <para>The hosts in a pod are assigned private IP addresses. These are typically RFC1918 addresses. The Console Proxy and Secondary Storage system VMs are also allocated private IP addresses in the CIDR of the pod that they are created in.</para> - <para>Make sure computing servers and Management Servers use IP addresses outside of the System Reserved IP range. For example, suppose the System Reserved IP range starts at 192.168.154.2 and ends at 192.168.154.7. &PRODUCT; can use .2 to .7 for System VMs. This leaves the rest of the pod CIDR, from .8 to .254, for the Management Server and hypervisor hosts.</para> - <para><emphasis role="bold">In all zones:</emphasis></para> - <para>Provide private IPs for the system in each pod and provision them in &PRODUCT;.</para> - <para>For KVM and XenServer, the recommended number of private IPs per pod is one per host. If you expect a pod to grow, add enough private IPs now to accommodate the growth.</para> - <para><emphasis role="bold">In a zone that uses advanced networking:</emphasis></para> - <para>For zones with advanced networking, we recommend provisioning enough private IPs for your total number of customers, plus enough for the required &PRODUCT; System VMs. Typically, about 10 additional IPs are required for the System VMs. For more information about System VMs, see the section on working with SystemVMs in the Administrator's Guide.</para> - <para>When advanced networking is being used, the number of private IP addresses available in each pod varies depending on which hypervisor is running on the nodes in that pod. Citrix XenServer and KVM use link-local addresses, which in theory provide more than 65,000 private IP addresses within the address block. As the pod grows over time, this should be more than enough for any reasonable number of hosts as well as IP addresses for guest virtual routers. VMWare ESXi, by contrast uses any administrator-specified subnetting scheme, and the typical administrator provides only 255 IPs per pod. Since these are shared by physical machines, the guest virtual router, and other entities, it is possible to run out of private IPs when scaling up a pod whose nodes are running ESXi.</para> - <para>To ensure adequate headroom to scale private IP space in an ESXi pod that uses advanced networking, use one or both of the following techniques:</para> - <itemizedlist> - <listitem><para>Specify a larger CIDR block for the subnet. A subnet mask with a /20 suffix will provide more than 4,000 IP addresses.</para></listitem> - <listitem><para>Create multiple pods, each with its own subnet. For example, if you create 10 pods and each pod has 255 IPs, this will provide 2,550 IP addresses.</para></listitem> - </itemizedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/system-service-offerings.xml ---------------------------------------------------------------------- diff --git a/en-US/system-service-offerings.xml b/en-US/system-service-offerings.xml deleted file mode 100644 index 84d5f7a..0000000 --- a/en-US/system-service-offerings.xml +++ /dev/null @@ -1,30 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"; [ -<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent"> -%BOOK_ENTITIES; -]> - -<!-- Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<section id="system-service-offerings"> - <title>System Service Offerings</title> - <para>System service offerings provide a choice of CPU speed, number of CPUs, tags, and RAM size, just as other service offerings do. But rather than being used for virtual machine instances and exposed to users, system service offerings are used to change the default properties of virtual routers, console proxies, and other system VMs. System service offerings are visible only to the &PRODUCT; root administrator. &PRODUCT; provides default system service offerings. The &PRODUCT; root administrator can create additional custom system service offerings.</para> - <para>When &PRODUCT; creates a virtual router for a guest network, it uses default settings which are defined in the system service offering associated with the network offering. You can upgrade the capabilities of the virtual router by applying a new network offering that contains a different system service offering. All virtual routers in that network will begin using the settings from the new service offering.</para> - <xi:include href="creating-system-service-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> -</section>
