http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-acl.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-acl.xml b/en-US/configure-acl.xml deleted file mode 100644 index 3ac2b74..0000000 --- a/en-US/configure-acl.xml +++ /dev/null @@ -1,287 +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="configure-acl"> - <title>Configuring Network Access Control List</title> - <para>Define Network Access Control List (ACL) on the VPC virtual router to control incoming - (ingress) and outgoing (egress) traffic between the VPC tiers, and the tiers and Internet. By - default, all incoming traffic to the guest networks is blocked and all outgoing traffic from - guest networks is allowed, once you add an ACL rule for outgoing traffic, then only outgoing - traffic specified in this ACL rule is allowed, the rest is blocked. To open the ports, you must - create a new network ACL. The network ACLs can be created for the tiers only if the NetworkACL - service is supported.</para> - <section id="network-acl"> - <title>About Network ACL Lists</title> - <para>In &PRODUCT; terminology, Network ACL is a group of Network ACL items. Network ACL items - are nothing but numbered rules that are evaluated in order, starting with the lowest numbered - rule. These rules determine whether traffic is allowed in or out of any tier associated with - the network ACL. You need to add the Network ACL items to the Network ACL, then associate the - Network ACL with a tier. Network ACL is associated with a VPC and can be assigned to multiple - VPC tiers within a VPC. A Tier is associated with a Network ACL at all the times. Each tier - can be associated with only one ACL.</para> - <para>The default Network ACL is used when no ACL is associated. Default behavior is all the - incoming traffic is blocked and outgoing traffic is allowed from the tiers. Default network - ACL cannot be removed or modified. Contents of the default Network ACL is:</para> - <informaltable> - <tgroup cols="5" align="left" colsep="1" rowsep="1"> - <colspec colnum="1" colname="c1" colwidth="31.5pt"/> - <colspec colnum="2" colname="c2" colwidth="58.5pt"/> - <colspec colnum="3" colname="c3" colwidth="66.0pt"/> - <colspec colnum="4" colname="c4" colwidth="48.0pt"/> - <colspec colnum="5" colname="c5" colwidth="58.5pt"/> - <thead> - <row> - <entry><para>Rule</para></entry> - <entry><para>Protocol</para></entry> - <entry><para>Traffic type</para></entry> - <entry><para>Action</para></entry> - <entry><para>CIDR</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>1</para></entry> - <entry><para>All</para></entry> - <entry><para>Ingress</para></entry> - <entry><para>Deny</para></entry> - <entry><para>0.0.0.0/0</para></entry> - </row> - <row> - <entry><para>2</para></entry> - <entry><para>All</para></entry> - <entry><para>Egress</para></entry> - <entry><para>Deny</para></entry> - <entry><para>0.0.0.0/0</para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - </section> - <section id="acl-list"> - <title>Creating ACL Lists</title> - <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.</para> - <para>For each tier, the following options are displayed:</para> - <itemizedlist> - <listitem> - <para>Internal LB</para> - </listitem> - <listitem> - <para>Public LB IP</para> - </listitem> - <listitem> - <para>Static NAT</para> - </listitem> - <listitem> - <para>Virtual Machines</para> - </listitem> - <listitem> - <para>CIDR</para> - </listitem> - </itemizedlist> - <para>The following router information is displayed:</para> - <itemizedlist> - <listitem> - <para>Private Gateways</para> - </listitem> - <listitem> - <para>Public IP Addresses</para> - </listitem> - <listitem> - <para>Site-to-Site VPNs</para> - </listitem> - <listitem> - <para>Network ACL Lists</para> - </listitem> - </itemizedlist> - </listitem> - <listitem> - <para>Select Network ACL Lists.</para> - <para>The following default rules are displayed in the Network ACLs page: default_allow, - default_deny.</para> - </listitem> - <listitem> - <para>Click Add ACL Lists, and specify the following:</para> - <itemizedlist> - <listitem> - <para><emphasis role="bold">ACL List Name</emphasis>: A name for the ACL list.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Description</emphasis>: A short description of the ACL list - that can be displayed to users.</para> - </listitem> - </itemizedlist> - </listitem> - </orderedlist> - </section> - <section id="add-acl-rule"> - <title>Creating an ACL Rule</title> - <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.</para> - </listitem> - <listitem> - <para>Select Network ACL Lists.</para> - <para>In addition to the custom ACL lists you have created, the following default rules are - displayed in the Network ACLs page: default_allow, default_deny.</para> - </listitem> - <listitem> - <para>Select the desired ACL list.</para> - </listitem> - <listitem> - <para>Select the ACL List Rules tab.</para> - <para>To add an ACL rule, fill in the following fields to specify what kind of network - traffic is allowed in the VPC. </para> - <itemizedlist> - <listitem> - <para><emphasis role="bold">Rule Number</emphasis>: The order in which the rules are - evaluated.</para> - </listitem> - <listitem> - <para><emphasis role="bold">CIDR</emphasis>: The CIDR acts as the Source CIDR for the - Ingress rules, and Destination CIDR for the Egress rules. To accept traffic only from - or to the IP addresses within a particular address block, enter a CIDR or a - comma-separated list of CIDRs. The CIDR is the base IP address of the incoming - traffic. For example, 192.168.0.0/22. To allow all CIDRs, set to 0.0.0.0/0.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Action</emphasis>: What action to be taken. Allow traffic or - block.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Protocol</emphasis>: The networking protocol that sources - use to send traffic to the tier. The TCP and UDP protocols are typically used for data - exchange and end-user communications. The ICMP protocol is typically used to send - error messages or network monitoring data. All supports all the traffic. Other option - is Protocol Number.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Start Port</emphasis>, <emphasis role="bold">End - Port</emphasis> (TCP, UDP only): A range of listening ports that are the destination - for the incoming traffic. If you are opening a single port, use the same number in - both fields.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Protocol Number</emphasis>: The protocol number associated - with IPv4 or IPv6. For more information, see <ulink - url="http://www.iana.org/assignments/protocol-numbers/protocol-numbers.xml";>Protocol - Numbers</ulink>.</para> - </listitem> - <listitem> - <para><emphasis role="bold">ICMP Type</emphasis>, <emphasis role="bold">ICMP - Code</emphasis> (ICMP only): The type of message and error code that will be - sent.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Traffic Type</emphasis>: The type of traffic: Incoming or - outgoing.</para> - </listitem> - </itemizedlist> - </listitem> - <listitem> - <para>Click Add. The ACL rule is added.</para> - <para>You can edit the tags assigned to the ACL rules and delete the ACL rules you have - created. Click the appropriate button in the Details tab.</para> - </listitem> - </orderedlist> - </section> - <section id="create-acl-tier"> - <title>Creating a Tier with Custom ACL List</title> - <orderedlist> - <listitem> - <para>Create a VPC.</para> - </listitem> - <listitem> - <para>Create a custom ACL list.</para> - </listitem> - <listitem> - <para>Add ACL rules to the ACL list.</para> - </listitem> - <listitem> - <para>Create a tier in the VPC.</para> - <para>Select the desired ACL list while creating a tier.</para> - </listitem> - <listitem> - <para>Click OK.</para> - </listitem> - </orderedlist> - </section> - <section id="assign-acl-tier"> - <title>Assigning a Custom ACL List to a Tier</title> - <orderedlist> - <listitem> - <para>Create a VPC.</para> - </listitem> - <listitem> - <para>Create a tier in the VPC.</para> - </listitem> - <listitem> - <para>Associate the tier with the default ACL rule.</para> - </listitem> - <listitem> - <para>Create a custom ACL list.</para> - </listitem> - <listitem> - <para>Add ACL rules to the ACL list.</para> - </listitem> - <listitem> - <para>Select the tier for which you want to assign the custom ACL.</para> - </listitem> - <listitem> - <para>Click the Replace ACL List icon.<inlinemediaobject> - <imageobject> - <imagedata fileref="./images/replace-acl-icon.png"/> - </imageobject> - <textobject> - <phrase>replace-acl-icon.png: button to replace an ACL list</phrase> - </textobject> - </inlinemediaobject></para> - <para>The Replace ACL List dialog is displayed.</para> - </listitem> - <listitem> - <para>Select the desired ACL list.</para> - </listitem> - <listitem> - <para>Click OK.</para> - </listitem> - </orderedlist> - </section> -</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-guest-traffic-in-advanced-zone.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-guest-traffic-in-advanced-zone.xml b/en-US/configure-guest-traffic-in-advanced-zone.xml deleted file mode 100644 index fb66850..0000000 --- a/en-US/configure-guest-traffic-in-advanced-zone.xml +++ /dev/null @@ -1,79 +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="configure-guest-traffic-in-advanced-zone"> - <title>Configure Guest Traffic in an Advanced Zone</title> - <para>These steps assume you have already logged in to the &PRODUCT; UI. To configure the base - guest network:</para> - <orderedlist> - <listitem> - <para>In the left navigation, choose Infrastructure. On Zones, click View More, then click the - zone to which you want to add a network.</para> - </listitem> - <listitem> - <para>Click the Network tab.</para> - </listitem> - <listitem> - <para>Click Add guest network.</para> - <para>The Add guest network window is displayed:</para> - <mediaobject> - <imageobject> - <imagedata fileref="./images/add-guest-network.png"/> - </imageobject> - <textobject> - <phrase>networksetupzone.png: Depicts network setup in a single zone</phrase> - </textobject> - </mediaobject> - </listitem> - <listitem> - <para>Provide the following information:</para> - <itemizedlist> - <listitem> - <para><emphasis role="bold">Name</emphasis>. The name of the network. This will be - user-visible</para> - </listitem> - <listitem> - <para><emphasis role="bold">Display Text</emphasis>: The description of the network. This - will be user-visible</para> - </listitem> - <listitem> - <para><emphasis role="bold">Zone</emphasis>: The zone in which you are configuring the - guest network.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Network offering</emphasis>: If the administrator has - configured multiple network offerings, select the one you want to use for this - network</para> - </listitem> - <listitem> - <para><emphasis role="bold">Guest Gateway</emphasis>: The gateway that the guests should - use</para> - </listitem> - <listitem> - <para><emphasis role="bold">Guest Netmask</emphasis>: The netmask in use on the subnet the - guests will use</para> - </listitem> - </itemizedlist> - </listitem> - <listitem> - <para>Click OK.</para> - </listitem> - </orderedlist> -</section> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-package-repository.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-package-repository.xml b/en-US/configure-package-repository.xml deleted file mode 100644 index bf4ac47..0000000 --- a/en-US/configure-package-repository.xml +++ /dev/null @@ -1,69 +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="configure-package-repository"> - <title>Configure package repository</title> - <para>&PRODUCT; is only distributed from source from the official mirrors. - However, members of the CloudStack community may build convenience binaries - so that users can install Apache CloudStack without needing to build from - source. - </para> - <para> - If you didn't follow the steps to build your own packages from source - in the sections for <xref linkend="sect-source-buildrpm" /> or - <xref linkend="sect-source-builddebs" /> you may find pre-built - DEB and RPM packages for your convenience linked from the - <ulink url="http://cloudstack.apache.org/downloads.html";>downloads</ulink> - page. - </para> - <note> - <para>These repositories contain both the Management Server and KVM Hypervisor packages.</para> - </note> - <section id="configure-package-repository-deb"> - <title>DEB package repository</title> - <para>You can add a DEB package repository to your apt sources with the following commands. Please note that only packages for Ubuntu 12.04 LTS (precise) are being built at this time.</para> - <para>Use your preferred editor and open (or create) <filename>/etc/apt/sources.list.d/cloudstack.list</filename>. Add the community provided repository to the file:</para> -<programlisting>deb http://cloudstack.apt-get.eu/ubuntu precise 4.2</programlisting> - <para>We now have to add the public key to the trusted keys.</para> - <programlisting language="Bash"><prompt>$</prompt> <command>wget</command> -O - http://cloudstack.apt-get.eu/release.asc|apt-key add -</programlisting> - <para>Now update your local apt cache.</para> - <programlisting language="Bash"><prompt>$</prompt> <command>apt-get</command> update</programlisting> - <para>Your DEB package repository should now be configured and ready for use.</para> - </section> - <section id="configure-package-repository-rpm"> - <title>RPM package repository</title> - <para>There is a RPM package repository for &PRODUCT; so you can easily install on RHEL based platforms.</para> - <para>If you're using an RPM-based system, you'll want to add the Yum repository so that you can install &PRODUCT; with Yum.</para> - <para>Yum repository information is found under <filename>/etc/yum.repos.d</filename>. You'll see several <filename>.repo</filename> files in this directory, each one denoting a specific repository.</para> - <para>To add the &PRODUCT; repository, create <filename>/etc/yum.repos.d/cloudstack.repo</filename> and insert the following information.</para> - <programlisting> -[cloudstack] -name=cloudstack -baseurl=<replaceable>http://cloudstack.apt-get.eu/rhel/4.2/</replaceable> -enabled=1 -gpgcheck=0 - </programlisting> - <para>Now you should be able to install CloudStack using Yum.</para> - </section> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-public-traffic-in-an-advanced-zone.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-public-traffic-in-an-advanced-zone.xml b/en-US/configure-public-traffic-in-an-advanced-zone.xml deleted file mode 100644 index 7a61cd3..0000000 --- a/en-US/configure-public-traffic-in-an-advanced-zone.xml +++ /dev/null @@ -1,25 +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="configure-public-traffic-in-an-advanced-zone"> - <title>Configure Public Traffic in an Advanced Zone</title> - <para>In a zone that uses advanced networking, you need to configure at least one range of IP - addresses for Internet traffic.</para> -</section> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-snmp-rhel.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-snmp-rhel.xml b/en-US/configure-snmp-rhel.xml deleted file mode 100644 index bd227ff..0000000 --- a/en-US/configure-snmp-rhel.xml +++ /dev/null @@ -1,86 +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="configure-snmp-rhel"> - <title>Configuring SNMP Community String on a RHEL Server</title> - <para>The SNMP Community string is similar to a user id or password that provides access to a - network device, such as router. This string is sent along with all SNMP requests. If the - community string is correct, the device responds with the requested information. If the - community string is incorrect, the device discards the request and does not respond.</para> - <para>The NetScaler device uses SNMP to communicate with the VMs. You must install SNMP and - configure SNMP Community string for a secure communication between the NetScaler device and the - RHEL machine.</para> - <orderedlist> - <listitem> - <para>Ensure that you installed SNMP on RedHat. If not, run the following command:</para> - <screen>yum install net-snmp-utils</screen> - </listitem> - <listitem> - <para>Edit the /etc/snmp/snmpd.conf file to allow the SNMP polling from the NetScaler - device.</para> - <orderedlist> - <listitem> - <para>Map the community name into a security name (local and mynetwork, depending on where - the request is coming from):</para> - <note> - <para>Use a strong password instead of public when you edit the following table.</para> - </note> - <screen># sec.name source community -com2sec local localhost public -com2sec mynetwork 0.0.0.0 public</screen> - <note> - <para>Setting to 0.0.0.0 allows all IPs to poll the NetScaler server.</para> - </note> - </listitem> - <listitem> - <para>Map the security names into group names: </para> - <screen># group.name sec.model sec.name -group MyRWGroup v1 local -group MyRWGroup v2c local -group MyROGroup v1 mynetwork -group MyROGroup v2c mynetwork</screen> - </listitem> - <listitem> - <para>Create a view to allow the groups to have the permission to:</para> - <screen>incl/excl subtree mask view all included .1 </screen> - </listitem> - <listitem> - <para>Grant access with different write permissions to the two groups to the view you - created.</para> - <screen># context sec.model sec.level prefix read write notif - access MyROGroup "" any noauth exact all none none - access MyRWGroup "" any noauth exact all all all </screen> - </listitem> - </orderedlist> - </listitem> - <listitem> - <para>Unblock SNMP in iptables.</para> - <screen>iptables -A INPUT -p udp --dport 161 -j ACCEPT</screen> - </listitem> - <listitem> - <para>Start the SNMP service:</para> - <screen>service snmpd start</screen> - </listitem> - <listitem> - <para>Ensure that the SNMP service is started automatically during the system startup:</para> - <screen>chkconfig snmpd on</screen> - </listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-usage-server.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-usage-server.xml b/en-US/configure-usage-server.xml deleted file mode 100644 index 83bed07..0000000 --- a/en-US/configure-usage-server.xml +++ /dev/null @@ -1,104 +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="configure-usage-server"> - <title>Configuring the Usage Server</title> - <para>To configure the usage server:</para> - <orderedlist> - <listitem><para>Be sure the Usage Server has been installed. This requires extra steps beyond just installing the &PRODUCT; software. See Installing the Usage Server (Optional) in the Advanced Installation Guide.</para></listitem> - <listitem><para>Log in to the &PRODUCT; UI as administrator.</para></listitem> - <listitem><para>Click Global Settings.</para></listitem> - <listitem><para>In Search, type usage. Find the configuration parameter that controls the behavior you want to set. See the table below for a description of the available parameters.</para></listitem> - <listitem><para>In Actions, click the Edit icon.</para></listitem> - <listitem><para>Type the desired value and click the Save icon.</para></listitem> - <listitem><para>Restart the Management Server (as usual with any global configuration change) and also the Usage Server:</para> - <programlisting language="Bash"># service cloudstack-management restart -# service cloudstack-usage restart -</programlisting></listitem> - </orderedlist> - <para>The following table shows the global configuration settings that control the behavior of the Usage Server.</para> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <thead> - <row> - <entry><para>Parameter Name</para></entry> - <entry><para>Description</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>enable.usage.server</para></entry> - <entry><para>Whether the Usage Server is active.</para></entry> - </row> - <row> - <entry><para>usage.aggregation.timezone</para></entry> - <entry><para>Time zone of usage records. Set this if the usage records and daily job execution are in different time zones. For example, with the following settings, the usage job will run at PST 00:15 and generate usage records for the 24 hours from 00:00:00 GMT to 23:59:59 GMT:</para> - <programlisting>usage.stats.job.exec.time = 00:15 -usage.execution.timezone = PST -usage.aggregation.timezone = GMT - </programlisting> - <para>Valid values for the time zone are specified in <xref linkend="time-zones"/></para> - <para>Default: GMT</para> - </entry> - </row> - <row> - <entry><para>usage.execution.timezone</para></entry> - <entry><para>The time zone of usage.stats.job.exec.time. Valid values for the time zone are specified in <xref linkend="time-zones"/></para> - <para>Default: The time zone of the management server.</para> - </entry> - </row> - <row> - <entry><para>usage.sanity.check.interval</para></entry> - <entry><para>The number of days between sanity checks. Set this in order to periodically search for records with erroneous data before issuing customer invoices. For example, this checks for VM usage records created after the VM was destroyed, and similar checks for templates, volumes, and so on. It also checks for usage times longer than the aggregation range. If any issue is found, the alert ALERT_TYPE_USAGE_SANITY_RESULT = 21 is sent.</para></entry> - </row> - <row> - <entry><para>usage.stats.job.aggregation.range</para></entry> - <entry><para>The time period in minutes between Usage Server processing jobs. For example, if you set it to 1440, the Usage Server will run once per day. If you set it to 600, it will run every ten hours. In general, when a Usage Server job runs, it processes all events generated since usage was last run.</para> - <para>There is special handling for the case of 1440 (once per day). In this case the Usage Server does not necessarily process all records since Usage was last run. &PRODUCT; assumes that you require processing once per day for the previous, complete dayâs records. For example, if the current day is October 7, then it is assumed you would like to process records for October 6, from midnight to midnight. &PRODUCT; assumes this âmidnight to midnightâ is relative to the usage.execution.timezone.</para> - <para>Default: 1440</para> - </entry> - </row> - <row> - <entry><para>usage.stats.job.exec.time</para></entry> - <entry><para>The time when the Usage Server processing will start. It is specified in 24-hour format (HH:MM) in the time zone of the server, which should be GMT. For example, to start the Usage job at 10:30 GMT, enter â10:30â.</para> - <para>If usage.stats.job.aggregation.range is also set, and its value is not 1440, then its value will be added to usage.stats.job.exec.time to get the time to run the Usage Server job again. This is repeated until 24 hours have elapsed, and the next day's processing begins again at usage.stats.job.exec.time.</para> - <para>Default: 00:15.</para> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para>For example, suppose that your server is in GMT, your user population is predominantly in the East Coast of the United States, and you would like to process usage records every night at 2 AM local (EST) time. Choose these settings:</para> - <itemizedlist> - <listitem><para>enable.usage.server = true</para></listitem> - <listitem><para>usage.execution.timezone = America/New_York</para></listitem> - <listitem><para>usage.stats.job.exec.time = 07:00. This will run the Usage job at 2:00 AM EST. Note that this will shift by an hour as the East Coast of the U.S. enters and exits Daylight Savings Time.</para></listitem> - <listitem><para>usage.stats.job.aggregation.range = 1440</para></listitem> - </itemizedlist> - <para>With this configuration, the Usage job will run every night at 2 AM EST and will process records for the previous dayâs midnight-midnight as defined by the EST (America/New_York) time zone.</para> - <note><para>Because the special value 1440 has been used for usage.stats.job.aggregation.range, the Usage - Server will ignore the data between midnight and 2 AM. That data will be included in the - next day's run.</para> - </note> - <para></para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-virtual-router.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-virtual-router.xml b/en-US/configure-virtual-router.xml deleted file mode 100644 index 8740c0c..0000000 --- a/en-US/configure-virtual-router.xml +++ /dev/null @@ -1,36 +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="configure-virtual-router"> - <title>Configuring the Virtual Router</title> - <para>You can set the following:</para> - <itemizedlist> - <listitem><para>IP range</para></listitem> - <listitem><para>Supported network services</para></listitem> - <listitem><para>Default domain name for the network serviced by the virtual router</para></listitem> - <listitem><para>Gateway IP address</para></listitem> - <listitem><para>How often &PRODUCT; fetches network usage statistics from &PRODUCT; virtual routers. If you want to collect traffic metering data from the virtual router, set the global configuration parameter router.stats.interval. If you are not using the virtual router to gather network usage statistics, set it to 0.</para></listitem> - </itemizedlist> - -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-vpc.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-vpc.xml b/en-US/configure-vpc.xml deleted file mode 100644 index e0e2ee9..0000000 --- a/en-US/configure-vpc.xml +++ /dev/null @@ -1,37 +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="configure-vpc"> - <title>Configuring a Virtual Private Cloud</title> - <xi:include href="vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="add-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="add-tier.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="configure-acl.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="add-gateway-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="add-vm-to-tier.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="add-vm-tier-sharednw.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="acquire-new-ip-for-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="release-ip-for-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="enable-disable-static-nat-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="add-loadbalancer-rule-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="add-portforward-rule-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="remove-tier.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> - <xi:include href="remove-vpc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-vpn-vpc.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-vpn-vpc.xml b/en-US/configure-vpn-vpc.xml deleted file mode 100644 index fecb5b5..0000000 --- a/en-US/configure-vpn-vpc.xml +++ /dev/null @@ -1,156 +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="configure-vpn-vpc"> - <title>Configuring Remote Access VPN in VPC</title> - <para>On enabling Remote Access VPN on a VPC, any VPN client present outside the VPC can access - VMs present in the VPC by using the Remote VPN connection. The VPN client can be present - anywhere except inside the VPC on which the user enabled the Remote Access VPN service. </para> - <section id="enable-vpn-vpc"> - <title>Enabling or Disabling Remote Access VPN for a VPC</title> - <orderedlist> - <listitem> - <para>Log in as a user or administrator to the &PRODUCT; UI.</para> - </listitem> - <listitem> - <para>In the left navigation, click 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.</para> - <para>For each tier, the following options are displayed:</para> - <itemizedlist> - <listitem> - <para>Internal LB</para> - </listitem> - <listitem> - <para>Public LB IP</para> - </listitem> - <listitem> - <para>Static NAT</para> - </listitem> - <listitem> - <para>Virtual Machines</para> - </listitem> - <listitem> - <para>CIDR</para> - </listitem> - </itemizedlist> - <para>The following router information is displayed:</para> - <itemizedlist> - <listitem> - <para>Private Gateways</para> - </listitem> - <listitem> - <para>Public IP Addresses</para> - </listitem> - <listitem> - <para>Site-to-Site VPNs</para> - </listitem> - <listitem> - <para>Network ACL Lists</para> - </listitem> - </itemizedlist> - </listitem> - <listitem> - <para>In the Router node, select Public IP Addresses.</para> - <para>The IP Addresses page is displayed.</para> - </listitem> - <listitem> - <para>Click Source NAT IP address.</para> - </listitem> - <listitem> - <para>Click the Enable VPN button. <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/vpn-icon.png"/> - </imageobject> - <textobject> - <phrase>vpn-icon.png: button to enable VPN</phrase> - </textobject> - </inlinemediaobject></para> - <para>Click OK to confirm. The IPsec key is displayed in a pop-up window.</para> - <para>To disable, click the Disable VPN button.<inlinemediaobject> - <imageobject> - <imagedata fileref="./images/disable-vpnvpc.png"/> - </imageobject> - <textobject> - <phrase>disable-vpnvp.png: button to disable VPN</phrase> - </textobject> - </inlinemediaobject></para> - </listitem> - <listitem> - <para>Now, continue with <xref linkend="add-vpc-vpnuser"/>.</para> - </listitem> - </orderedlist> - </section> - <section id="add-vpc-vpnuser"> - <title>Adding Remote Access VPN Users</title> - <orderedlist> - <listitem> - <para>Click the Source NAT IP.</para> - </listitem> - <listitem> - <para>Select the VPN tab.</para> - </listitem> - <listitem> - <para>Add the username and the corresponding password of the user you wanted to add.</para> - </listitem> - <listitem> - <para>Click Add.</para> - </listitem> - <listitem> - <para>Repeat the same steps to add the VPN users.</para> - </listitem> - </orderedlist> - </section> - <section id="disable-vpc-vpn"> - <title>Removing Remote Access VPN Users</title> - <orderedlist> - <listitem> - <para>Click the Source NAT IP.</para> - </listitem> - <listitem> - <para>Select the VPN tab.</para> - </listitem> - <listitem> - <para>Locate the user you want to remove.</para> - </listitem> - <listitem> - <para>Click Delete User.<inlinemediaobject> - <imageobject> - <imagedata fileref="./images/remove-user.png"/> - </imageobject> - <textobject> - <phrase>remove-user.png: button to remove a VPN user</phrase> - </textobject> - </inlinemediaobject></para> - </listitem> - <listitem> - <para>Repeat the same steps to remove the VPN users.</para> - </listitem> - </orderedlist> - </section> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-vpn.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-vpn.xml b/en-US/configure-vpn.xml deleted file mode 100644 index f389f30..0000000 --- a/en-US/configure-vpn.xml +++ /dev/null @@ -1,53 +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="configure-vpn"> - <title>Configuring Remote Access VPN</title> - <para>To set up VPN for the cloud:</para> - <orderedlist> - <listitem><para>Log in to the &PRODUCT; UI as an administrator or end user. </para></listitem> - <listitem><para>In the left navigation, click Global Settings.</para></listitem> - <listitem><para>Set the following global configuration parameters.</para> - <itemizedlist> - <listitem><para>remote.access.vpn.client.ip.range â The range of IP addresses to be allocated to remote access VPN clients. The first IP in the range is used by the VPN server.</para></listitem> - <listitem><para>remote.access.vpn.psk.length â Length of the IPSec key.</para></listitem> - <listitem><para>remote.access.vpn.user.limit â Maximum number of VPN users per account.</para></listitem> - </itemizedlist></listitem></orderedlist> - <para>To enable VPN for a particular network:</para> - <orderedlist> - <listitem><para>Log in as a user or administrator to the &PRODUCT; UI.</para></listitem> - <listitem><para>In the left navigation, click Network.</para></listitem> - <listitem><para>Click the name of the network you want to work with.</para></listitem> - <listitem><para>Click View IP Addresses.</para></listitem> - <listitem><para>Click one of the displayed IP address names.</para></listitem> - <listitem><para>Click the Enable VPN button. <inlinemediaobject> - <imageobject> - <imagedata fileref="./images/vpn-icon.png"/> - </imageobject> - <textobject> - <phrase>AttachDiskButton.png: button to attach a volume</phrase> - </textobject> - </inlinemediaobject></para> - <para>The IPsec key is displayed in a popup window.</para></listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configure-xenserver-dom0-memory.xml ---------------------------------------------------------------------- diff --git a/en-US/configure-xenserver-dom0-memory.xml b/en-US/configure-xenserver-dom0-memory.xml deleted file mode 100644 index 0a02d3e..0000000 --- a/en-US/configure-xenserver-dom0-memory.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="configure-xenserver-dom0-memory"> - <title>Configure XenServer dom0 Memory</title> - <para>Configure the XenServer dom0 settings to allocate more memory to dom0. This can enable XenServer to handle larger numbers of virtual machines. We recommend 2940 MB of RAM for XenServer dom0. For instructions on how to do this, see <ulink url="http://support.citrix.com/article/CTX126531";>Citrix Knowledgebase Article</ulink>.The article refers to XenServer 5.6, but the same information applies to XenServer 6</para> -</section> - http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/configuring-projects.xml ---------------------------------------------------------------------- diff --git a/en-US/configuring-projects.xml b/en-US/configuring-projects.xml deleted file mode 100644 index af1fc53..0000000 --- a/en-US/configuring-projects.xml +++ /dev/null @@ -1,32 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!-- 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. ---> -<!DOCTYPE section 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; -]> -<section id="configuring-projects"> - <title>Configuring Projects</title> - <para>Before &PRODUCT; users start using projects, the &PRODUCT; administrator must set - up various systems to support them, including membership invitations, limits on project - resources, and controls on who can create projects.</para> - <xi:include href="set-up-invitations.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="set-resource-limits-for-projects.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - <xi:include href="set-projects-creator-permissions.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> -</section> - http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/console-proxy.xml ---------------------------------------------------------------------- diff --git a/en-US/console-proxy.xml b/en-US/console-proxy.xml deleted file mode 100644 index b7aa2c9..0000000 --- a/en-US/console-proxy.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="console-proxy"> - <title>Console Proxy</title> - <para>The Console Proxy is a type of System Virtual Machine that has a role in presenting a - console view via the web UI. It connects the userâs browser to the VNC port made available via - the hypervisor for the console of the guest. Both the administrator and end user web UIs offer a - console connection.</para> - <para>Clicking on a console icon brings up a new window. The AJAX code downloaded into that window - refers to the public IP address of a console proxy VM. There is exactly one public IP address - allocated per console proxy VM. The AJAX application connects to this IP. The console proxy then - proxies the connection to the VNC port for the requested VM on the Host hosting the guest. - .</para> - <note> - <para>The hypervisors will have many ports assigned to VNC usage so that multiple VNC sessions - can occur simultaneously.</para> - </note> - <para/> - <para>The VNC traffic never goes through the guest virtual IP, and there is no need to enable VNC - within the guest.</para> - <para>The console proxy VM will periodically report its active session count to the Management - Server. The default reporting interval is five seconds. This can be changed through standard - Management Server configuration with the parameter consoleproxy.loadscan.interval.</para> - <para>Assignment of guest VM to console proxy is determined by first determining if the guest VM - has a previous session associated with a console proxy. If it does, the Management Server will - assign the guest VM to the target Console Proxy VM regardless of the load on the proxy VM. - Failing that, the first available running Console Proxy VM that has the capacity to handle new - sessions is used.</para> - <para>Console proxies can be restarted by administrators but this will interrupt existing console - sessions for users.</para> - <para>Prior to &PRODUCT; version 4.3, the console viewing functionality used a dynamic DNS service - under the domain name realhostip.com. This domain name assists in providing SSL security to - console sessions. A public IP address is assigned to the console proxy. To avoid browser - warnings for mismatched SSL certificates, the URL for the new console window was set to the form - of https://aaa-bbb-ccc-ddd.realhostip.com. Customers viewed this URL during the console session - creation. &PRODUCT; included the realhostip.com SSL certificate in the console proxy VM. Because - &PRODUCT; cannot know the DNS records of customers' public IPs prior to shipping the software, a - dynamic DNS server is run that is authoritative for the realhostip.com domain. It mapped the - aaa-bbb-ccc-ddd part of the DNS name to the IP address aaa.bbb.ccc.ddd on lookups. This allowed - the browser to correctly connect to the console proxy's public IP, where it then expects and - receives a SSL certificate for realhostip.com, and SSL is set up without browser - warnings.</para> - <para>The realhostip.com domain has now been depreciated. As an alternate, &PRODUCT; provides a - new mechanism based on global settings to help administrators set up secure connections across - various deployment environments. See <xref linkend="realip-changes"/> for information on setting - up own domain, then customize the URL of your console session to reflect your own domain - name.</para> - <xi:include href="change-console-proxy-ssl-certificate-domain.xml" - xmlns:xi="http://www.w3.org/2001/XInclude"/> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/convert-hyperv-vm-to-template.xml ---------------------------------------------------------------------- diff --git a/en-US/convert-hyperv-vm-to-template.xml b/en-US/convert-hyperv-vm-to-template.xml deleted file mode 100644 index df38823..0000000 --- a/en-US/convert-hyperv-vm-to-template.xml +++ /dev/null @@ -1,69 +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="convert-hyperv-vm-to-template"> - <title>Converting a Hyper-V VM to a Template</title> - <para>To convert a Hyper-V VM to a XenServer-compatible &PRODUCT; template, you will need a standalone XenServer host with an attached NFS VHD SR. Use whatever XenServer version you are using with &PRODUCT;, but use XenCenter 5.6 FP1 or SP2 (it is backwards compatible to 5.6). Additionally, it may help to have an attached NFS ISO SR.</para> - <para>For Linux VMs, you may need to do some preparation in Hyper-V before trying to get the VM to work in XenServer. Clone the VM and work on the clone if you still want to use the VM in Hyper-V. Uninstall Hyper-V Integration Components and check for any references to device names in /etc/fstab:</para> - <orderedlist> - <listitem><para>From the linux_ic/drivers/dist directory, run make uninstall (where "linux_ic" is the path to the copied Hyper-V Integration Components files).</para></listitem> - <listitem><para>Restore the original initrd from backup in /boot/ (the backup is named *.backup0).</para></listitem> - <listitem><para>Remove the "hdX=noprobe" entries from /boot/grub/menu.lst.</para></listitem> - <listitem><para>Check /etc/fstab for any partitions mounted by device name. Change those entries (if any) to - mount by LABEL or UUID. You can get that information with the blkid command.</para></listitem> - </orderedlist> - <para>The next step is make sure the VM is not running in Hyper-V, then get the VHD into XenServer. There are two options for doing this.</para> - <para>Option one:</para> - <orderedlist> - <listitem><para>Import the VHD using XenCenter. In XenCenter, go to Tools>Virtual Appliance Tools>Disk Image Import.</para></listitem> - <listitem><para>Choose the VHD, then click Next.</para></listitem> - <listitem><para>Name the VM, choose the NFS VHD SR under Storage, enable "Run Operating System Fixups" and choose the NFS ISO SR.</para></listitem> - <listitem><para>Click Next, then Finish. A VM should be created.</para></listitem> - </orderedlist> - <para>Option two:</para> - <orderedlist> - <listitem><para>Run XenConvert, under From choose VHD, under To choose XenServer. Click Next.</para></listitem> - <listitem><para>Choose the VHD, then click Next.</para></listitem> - <listitem><para>Input the XenServer host info, then click Next.</para></listitem> - <listitem><para>Name the VM, then click Next, then Convert. A VM should be created.</para></listitem> - </orderedlist> - <para>Once you have a VM created from the Hyper-V VHD, prepare it using the following steps:</para> - <orderedlist> - <listitem><para>Boot the VM, uninstall Hyper-V Integration Services, and reboot.</para></listitem> - <listitem><para>Install XenServer Tools, then reboot.</para></listitem> - <listitem><para>Prepare the VM as desired. For example, run sysprep on Windows VMs. See <xref linkend="create-windows-template"/>.</para></listitem> - </orderedlist> - <para>Either option above will create a VM in HVM mode. This is fine for Windows VMs, but Linux VMs may not perform optimally. Converting a Linux VM to PV mode will require additional steps and will vary by distribution.</para> - <orderedlist> - <listitem><para>Shut down the VM and copy the VHD from the NFS storage to a web server; for example, mount the NFS share on the web server and copy it, or from the XenServer host use sftp or scp to upload it to the web server.</para></listitem> - <listitem><para>In &PRODUCT;, create a new template using the following values:</para> - <itemizedlist> - <listitem><para>URL. Give the URL for the VHD</para></listitem> - <listitem><para>OS Type. Use the appropriate OS. For PV mode on CentOS, choose Other PV (32-bit) or Other PV (64-bit). This choice is available only for XenServer.</para></listitem> - <listitem><para>Hypervisor. XenServer</para></listitem> - <listitem><para>Format. VHD</para></listitem> - </itemizedlist></listitem> - - </orderedlist> - <para>The template will be created, and you can create instances from it.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/cpu-sockets.xml ---------------------------------------------------------------------- diff --git a/en-US/cpu-sockets.xml b/en-US/cpu-sockets.xml deleted file mode 100644 index 2fd592d..0000000 --- a/en-US/cpu-sockets.xml +++ /dev/null @@ -1,51 +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="cpu-sockets"> - <title>Reporting CPU Sockets</title> - <para>&PRODUCT; manages different types of hosts that contains one or more physical CPU sockets. - CPU socket is considered as a unit of measure used for licensing and billing cloud - infrastructure. &PRODUCT; provides both UI and API support to collect the CPU socket statistics - for billing purpose. The Infrastructure tab has a new tab for CPU sockets. You can view the - statistics for CPU sockets managed by &PRODUCT;, which in turn reflects the size of the cloud. - The CPU Socket page will give you the number of hosts and sockets used for each hypervisor - type.</para> - <orderedlist> - <listitem> - <para>Log in to the &PRODUCT; UI.</para> - </listitem> - <listitem> - <para>In the left navigation bar, click Infrastructure.</para> - </listitem> - <listitem> - <para>On CPU Sockets, click View all.</para> - <para>The CPU Socket page is displayed. The page shows the number of hosts and CPU sockets - based on hypervisor types.</para> - <para>CPU sockets are displayed for XenServer version 6.2 and beyond, KVM, Hyper-V and VMware - hypervisors.</para> - <para>This feature is not available for XenServer versions prior to 6.2 as they don't support - retrieving CPU socket information. Additionally, this feature is not supported for - Baremetal.</para> - </listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/create-bare-metal-template.xml ---------------------------------------------------------------------- diff --git a/en-US/create-bare-metal-template.xml b/en-US/create-bare-metal-template.xml deleted file mode 100644 index 0ee4c11..0000000 --- a/en-US/create-bare-metal-template.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="create-bare-metal-template"> - <title>Creating a Bare Metal Template</title> - <para>Before you can create a bare metal template, you must have performed several other installation and setup steps to create a bare metal cluster and environment. See Bare Metal Installation in the Installation Guide. It is assumed you already have a directory named "win7_64bit" on your CIFS server, containing the image for the bare metal instance. This directory and image are set up as part of the Bare Metal Installation procedure.</para> - <orderedlist> - <listitem><para>Log in to the &PRODUCT; UI as an administrator or end user.</para></listitem> - <listitem><para>In the left navigation bar, click Templates.</para></listitem> - <listitem><para>Click Create Template.</para></listitem> - <listitem><para>In the dialog box, enter the following values.</para> - <itemizedlist> - <listitem><para><emphasis role="bold">Name</emphasis>. Short name for the template.</para></listitem> - <listitem><para><emphasis role="bold">Display Text</emphasis>. Description of the template.</para></listitem> - <listitem><para><emphasis role="bold">URL</emphasis>. The directory name which contains image file on your CIFS server. For example, win7_64bit.</para></listitem> - <listitem><para><emphasis role="bold">Zone</emphasis>. All Zones.</para></listitem> - <listitem><para><emphasis role="bold">OS Type</emphasis>. Select the OS type of the ISO image. Choose other if the OS Type of the ISO is not listed or if the ISO is not bootable.</para></listitem> - <listitem><para><emphasis role="bold">Hypervisor</emphasis>. BareMetal.</para></listitem> - <listitem><para><emphasis role="bold">Format</emphasis>. BareMetal.</para></listitem> - <listitem><para><emphasis role="bold">Password Enabled</emphasis>. No.</para></listitem> - <listitem><para><emphasis role="bold">Public</emphasis>. No.</para></listitem> - <listitem><para><emphasis role="bold">Featured</emphasis>. Choose Yes if you would like this template to be more prominent for users to select. Only administrators may make templates featured.</para></listitem> - </itemizedlist></listitem></orderedlist> - </section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/create-linux-template.xml ---------------------------------------------------------------------- diff --git a/en-US/create-linux-template.xml b/en-US/create-linux-template.xml deleted file mode 100755 index 156a0ac..0000000 --- a/en-US/create-linux-template.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. ---> - -<!-- Please keep the doctype and license declarations above intact in each doc file. --> -<!-- Make your modifications below this line. --> - -<section id="create-linux-template"> - <title>Creating a Linux Template</title> - <para>Linux templates should be prepared using this documentation in order to prepare your linux VMs for template deployment. For ease of documentation, the VM which you are configuring the template on will be referred to as "Template Master". This guide currently covers legacy setups which do not take advantage of UserData and cloud-init and assumes openssh-server is installed during installation. - </para> - - <para>An overview of the procedure is as follow:</para> - <orderedlist> - <listitem><para>Upload your Linux ISO.</para> <para>For more information, see <xref linkend="add-iso"/>.</para></listitem> - <listitem><para>Create a VM Instance with this ISO.</para><para> For more information, see <xref linkend="creating-vms"/>.</para></listitem> - <listitem><para>Prepare the Linux VM</para></listitem> - <listitem><para>Create a template from the VM.</para><para> For more information, see <xref linkend="create-template-from-existing-vm"/>.</para></listitem> - </orderedlist> - - <xi:include href="prepare-linux-template.xml" xmlns:xi="http://www.w3.org/2001/XInclude"; /> - </section> - http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/create-new-projects.xml ---------------------------------------------------------------------- diff --git a/en-US/create-new-projects.xml b/en-US/create-new-projects.xml deleted file mode 100644 index 7696c9e..0000000 --- a/en-US/create-new-projects.xml +++ /dev/null @@ -1,37 +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="create-new-projects"> - <title>Creating a New Project</title> - <para>&PRODUCT; administrators and domain administrators can create projects. If the global configuration parameter allow.user.create.projects is set to true, end users can also create projects.</para> - <orderedlist> - <listitem><para>Log in as administrator to the &PRODUCT; UI.</para></listitem> - <listitem><para>In the left navigation, click Projects.</para></listitem> - <listitem><para>In Select view, click Projects.</para></listitem> - <listitem><para>Click New Project.</para></listitem> - <listitem><para>Give the project a name and description for display to users, then click Create Project.</para></listitem> - <listitem><para>A screen appears where you can immediately add more members to the project. This is optional. Click Next when you are ready to move on.</para></listitem> - <listitem><para>Click Save.</para></listitem> - </orderedlist> - </section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/create-passive-vpn-vpc.xml ---------------------------------------------------------------------- diff --git a/en-US/create-passive-vpn-vpc.xml b/en-US/create-passive-vpn-vpc.xml deleted file mode 100644 index 3c1646e..0000000 --- a/en-US/create-passive-vpn-vpc.xml +++ /dev/null @@ -1,56 +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="create-passive-vpn-vpc"> - <title>Site-to-Site VPN Connection Between VPC Networks</title> - <para>&PRODUCT; provides you with the ability to establish a site-to-site VPN connection between - &PRODUCT; virtual routers. To achieve that, add a passive mode Site-to-Site VPN. With this - functionality, users can deploy applications in multiple Availability Zones or VPCs, which can - communicate with each other by using a secure Site-to-Site VPN Tunnel.</para> - <para>This feature is supported on all the hypervisors.</para> - <orderedlist> - <listitem> - <para>Create two VPCs. For example, VPC A and VPC B.</para> - <para>For more information, see <xref linkend="configure-vpc"/>.</para> - </listitem> - <listitem> - <para>Create VPN gateways on both the VPCs you created.</para> - <para>For more information, see <xref linkend="create-vpn-gateway-for-vpc"/>.</para> - </listitem> - <listitem> - <para>Create VPN customer gateway for both the VPCs.</para> - <para>For more information, see <xref linkend="create-vpn-customer-gateway"/>.</para> - </listitem> - <listitem> - <para>Enable a VPN connection on VPC A in passive mode. </para> - <para>For more information, see <xref linkend="create-vpn-connection-vpc"/>.</para> - <para>Ensure that the customer gateway is pointed to VPC B. The VPN connection is shown in the - Disconnected state.</para> - </listitem> - <listitem> - <para>Enable a VPN connection on VPC B. </para> - <para>Ensure that the customer gateway is pointed to VPC A. Because virtual router of VPC A, - in this case, is in passive mode and is waiting for the virtual router of VPC B to initiate - the connection, VPC B virtual router should not be in passive mode. </para> - <para>The VPN connection is shown in the Disconnected state. </para> - <para>Creating VPN connection on both the VPCs initiates a VPN connection. Wait for few seconds. The default is 30 seconds for both the VPN connections to show the Connected state.</para> - </listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/create-template-from-existing-vm.xml ---------------------------------------------------------------------- diff --git a/en-US/create-template-from-existing-vm.xml b/en-US/create-template-from-existing-vm.xml deleted file mode 100644 index 35788fd..0000000 --- a/en-US/create-template-from-existing-vm.xml +++ /dev/null @@ -1,56 +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="create-template-from-existing-vm"> - <title>Creating a Template from an Existing Virtual Machine</title> - <para>Once you have at least one VM set up in the way you want, you can use it as the prototype for other VMs.</para> - <orderedlist> - <listitem><para>Create and start a virtual machine using any of the techniques given in <xref linkend="creating-vms"/>.</para></listitem> - <listitem><para>Make any desired configuration changes on the running VM, then click Stop.</para></listitem> - <listitem><para>Wait for the VM to stop. When the status shows Stopped, go to the next step.</para></listitem> - <listitem><para>Click Create Template and provide the following:</para> - <itemizedlist> - <listitem><para><emphasis role="bold">Name and Display Text</emphasis>. These will be shown in the UI, so - choose something descriptive.</para></listitem> - <listitem><para><emphasis role="bold">OS Type</emphasis>. This helps &PRODUCT; and the hypervisor perform - certain operations and make assumptions that improve the performance of the - guest. Select one of the following.</para> - <itemizedlist> - <listitem><para>If the operating system of the stopped VM is listed, choose it.</para></listitem> - <listitem><para>If the OS type of the stopped VM is not listed, choose Other.</para></listitem> - <listitem><para>If you want to boot from this template in PV mode, choose Other PV (32-bit) or Other PV (64-bit). This choice is available only for XenServere:</para> - <note><para>Note: Generally you should not choose an older version of the OS than the version in the image. For example, choosing CentOS 5.4 to support a CentOS 6.2 image will in general not work. In those cases you should choose Other.</para></note></listitem> - </itemizedlist> - </listitem> - <listitem><para><emphasis role="bold">Public</emphasis>. Choose Yes to make this template accessible to all - users of this &PRODUCT; installation. The template will appear in the - Community Templates list. See <xref linkend="private-public-template" - />.</para></listitem> - <listitem><para><emphasis role="bold">Password Enabled</emphasis>. Choose Yes if your template has the - &PRODUCT; password change script installed. See <xref linkend="add-password-management-to-templates"/>.</para></listitem> - </itemizedlist></listitem> - <listitem><para>Click Add.</para></listitem> - </orderedlist> - <para>The new template will be visible in the Templates section when the template creation process - has been completed. The template is then available when creating a new VM.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/create-template-from-snapshot.xml ---------------------------------------------------------------------- diff --git a/en-US/create-template-from-snapshot.xml b/en-US/create-template-from-snapshot.xml deleted file mode 100644 index d968422..0000000 --- a/en-US/create-template-from-snapshot.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="create-template-from-snapshot"> - <title>Creating a Template from a Snapshot</title> - <!-- <note><para>Not supported by Oracle VM</para></note> --> - <para>If you do not want to stop the VM in order to use the Create Template menu item (as described in <xref linkend="create-template-from-existing-vm"/>), you can create a template directly from any snapshot through the &PRODUCT; UI.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/create-templates-overview.xml ---------------------------------------------------------------------- diff --git a/en-US/create-templates-overview.xml b/en-US/create-templates-overview.xml deleted file mode 100644 index 900165f..0000000 --- a/en-US/create-templates-overview.xml +++ /dev/null @@ -1,37 +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="create-templates-overview"> - <title>Creating Templates: Overview</title> - <para>&PRODUCT; ships with a default template for the CentOS operating system. There are a variety of ways to add more templates. Administrators and end users can add templates. The typical sequence of events is:</para> - <orderedlist> - <listitem><para>Launch a VM instance that has the operating system you want. Make any other desired configuration changes to the VM.</para></listitem> - <listitem><para>Stop the VM.</para></listitem> - <listitem><para>Convert the volume into a template.</para></listitem> - </orderedlist> - <para>There are other ways to add templates to &PRODUCT;. For example, you can take a snapshot - of the VM's volume and create a template from the snapshot, or import a VHD from another - system into &PRODUCT;.</para> - <para>The various techniques for creating templates are described in the next few sections.</para> - -</section>
