You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ra...@apache.org on 2014/01/28 07:13:00 UTC
git commit: root volume metering CLOUDSTACK-5590 and dynamic service
offering CLOUDSTACK-5604
Updated Branches:
refs/heads/master 48be3a8de -> 6c01c6dda
root volume metering CLOUDSTACK-5590 and dynamic service offering CLOUDSTACK-5604
Project: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/commit/6c01c6dd
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/tree/6c01c6dd
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs/diff/6c01c6dd
Branch: refs/heads/master
Commit: 6c01c6dda7b16a84ec148fd23380cffc7338ef8f
Parents: 48be3a8
Author: Radhika PC <ra...@citrix.com>
Authored: Tue Jan 28 11:42:32 2014 +0530
Committer: Radhika PC <ra...@citrix.com>
Committed: Tue Jan 28 11:42:32 2014 +0530
----------------------------------------------------------------------
en-US/compute-disk-service-offerings.xml | 88 +++++++++++++++++++--------
en-US/dynamic-compute-offerings.xml | 46 ++++++++++++++
release-notes/en-US/Release_Notes.xml | 7 ++-
3 files changed, 113 insertions(+), 28 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/6c01c6dd/en-US/compute-disk-service-offerings.xml
----------------------------------------------------------------------
diff --git a/en-US/compute-disk-service-offerings.xml b/en-US/compute-disk-service-offerings.xml
index 1fd2a91..0800517 100644
--- a/en-US/compute-disk-service-offerings.xml
+++ b/en-US/compute-disk-service-offerings.xml
@@ -22,29 +22,67 @@
under the License.
-->
<section id="compute-disk-service-offerings">
- <title>Compute and Disk Service Offerings</title>
- <para>A service offering is a set of virtual hardware features such as CPU core count and speed, memory, and disk size. The &PRODUCT; administrator can set up various offerings, and then end users choose from the available offerings when they create a new VM. A service offering includes the following elements:</para>
- <itemizedlist>
- <listitem><para>CPU, memory, and network resource guarantees</para></listitem>
- <listitem><para>How resources are metered</para></listitem>
- <listitem><para>How the resource usage is charged</para></listitem>
- <listitem><para>How often the charges are generated</para></listitem>
- </itemizedlist>
- <para>For example, one service offering might allow users to create a virtual machine instance that is equivalent to a 1 GHz Intel® Core™ 2 CPU, with 1 GB memory at $0.20/hour, with network traffic metered at $0.10/GB. Based on the user’s selected offering, &PRODUCT; emits usage records that can be integrated with billing systems. &PRODUCT; separates service offerings into compute offerings and disk offerings. The computing service offering specifies:</para>
- <itemizedlist>
- <listitem><para>Guest CPU</para></listitem>
- <listitem><para>Guest RAM</para></listitem>
- <listitem><para>Guest Networking type (virtual or direct)</para></listitem>
- <listitem><para>Tags on the root disk</para></listitem>
- </itemizedlist>
- <para>The disk offering specifies:</para>
- <itemizedlist>
- <listitem><para>Disk size (optional). An offering without a disk size will allow users to pick their own</para></listitem>
- <listitem><para>Tags on the data disk</para></listitem>
- </itemizedlist>
- <xi:include href="creating-compute-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="creating-disk-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="modify-delete-service-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <title>Compute and Disk Service Offerings</title>
+ <para>A service offering is a set of virtual hardware features such as CPU core count and speed,
+ memory, and disk size. The &PRODUCT; administrator can set up various offerings, and then end
+ users choose from the available offerings when they create a new VM. Based on the user’s
+ selected offering, &PRODUCT; emits usage records that can be integrated with billing
+ systems.</para>
+ <para>Some characteristics of service offerings must be defined by the &PRODUCT; administrator,
+ and others can be left undefined so that the end-user can enter their own desired values. This
+ is useful to reduce the number of offerings the &PRODUCT; administrator has to define. Instead
+ of defining a compute offering for every imaginable combination of values that a user might
+ want, the administrator can define offerings that provide some flexibility to the users and can
+ serve as the basis for several different VM configurations.</para>
+ <para>A service offering includes the following elements:</para>
+ <itemizedlist>
+ <listitem>
+ <para>CPU, memory, and network resource guarantees</para>
+ </listitem>
+ <listitem>
+ <para>How resources are metered</para>
+ </listitem>
+ <listitem>
+ <para>How the resource usage is charged</para>
+ </listitem>
+ <listitem>
+ <para>How often the charges are generated</para>
+ </listitem>
+ </itemizedlist>
+ <para>For example, one service offering might allow users to create a virtual machine instance
+ that is equivalent to a 1 GHz Intel® Core™ 2 CPU, with 1 GB memory at $0.20/hour, with network
+ traffic metered at $0.10/GB.</para>
+ <para>&PRODUCT; separates service offerings into compute offerings and disk offerings. The compute
+ service offering specifies:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Guest CPU (optional). If not defined by the &PRODUCT; administrator, users can pick the
+ CPU attributes.</para>
+ </listitem>
+ <listitem>
+ <para>Guest RAM (optional). If not defined by the &PRODUCT; administrator, users can pick the
+ RAM.</para>
+ </listitem>
+ <listitem>
+ <para>Guest Networking type (virtual or direct)</para>
+ </listitem>
+ <listitem>
+ <para>Tags on the root disk</para>
+ </listitem>
+ </itemizedlist>
+ <para>The disk offering specifies:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Disk size (optional). If not defined by the &PRODUCT; administrator, users can pick the
+ disk size.</para>
+ </listitem>
+ <listitem>
+ <para>Tags on the data disk</para>
+ </listitem>
+ </itemizedlist>
+ <xi:include href="dynamic-compute-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="creating-compute-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="creating-disk-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <xi:include href="modify-delete-service-offerings.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
+ />
</section>
-
-
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/6c01c6dd/en-US/dynamic-compute-offerings.xml
----------------------------------------------------------------------
diff --git a/en-US/dynamic-compute-offerings.xml b/en-US/dynamic-compute-offerings.xml
new file mode 100644
index 0000000..c96173f
--- /dev/null
+++ b/en-US/dynamic-compute-offerings.xml
@@ -0,0 +1,46 @@
+<?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="dynamic-compute-offerings">
+ <title>Custom Compute Offering</title>
+ <para>&PRODUCT; provides you the flexibility to specify the desired values for the number of CPU,
+ CPU speed, and memory while deploying a VM. As an admin, you create a Compute Offering by
+ marking it as custom, and the users will be able to customize this dynamic Compute Offering by
+ specifying the memory, and CPU at the time of VM creation or upgrade. Custom Compute Offering is
+ same as the normal Compute Offering except that the values of the dynamic parameters will be set
+ to zeros in the given set of templates. Use this offering to deploy VM by specifying custom
+ values for the dynamic parameters. Memory, CPU and number of CPUs are considered as dynamic
+ parameters. </para>
+ <para>Dynamic Compute Offerings can be used in following cases: deploying a VM, changing the
+ compute offering of a stopped VM and running VMs, which is nothing but scaling up. To support
+ this feature a new field, Custom, has been added to the Create Compute Offering page. If the
+ Custom field is checked, the user will be able to create a custom Compute Offering by filling in
+ the desired values for number of CPU, CPU speed, and memory. See <xref
+ linkend="creating-compute-offerings"/> for more information on this.</para>
+ <formalpara>
+ <title>Recording Usage Events for Dynamically Assigned Resources</title>
+ <para>To support this feature, usage events has been enhanced to register events for dynamically
+ assigned resources. Usage events are registered when a VM is created from a custom compute
+ offering. The values of the parameters, such as CPU, speed, RAM are recorded. </para>
+ </formalpara>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/6c01c6dd/release-notes/en-US/Release_Notes.xml
----------------------------------------------------------------------
diff --git a/release-notes/en-US/Release_Notes.xml b/release-notes/en-US/Release_Notes.xml
index 7f08f8c..4133025 100644
--- a/release-notes/en-US/Release_Notes.xml
+++ b/release-notes/en-US/Release_Notes.xml
@@ -550,9 +550,10 @@ under the License.
<section id="root-volume-metering">
<title>Root Volume Metering</title>
<para>&PRODUCT; supports recording usage events as per the dynamically assigned resources.
- Records usage events when a VM is created from dynamic service offering, and record the
- values of parameters, such as CPU, speed, RAM. If VM is deployed by using template and
- dynamic root disk size is mentioned, the same value is recorded in the usage event.</para>
+ Usage events are registered when a VM is created from dynamic service offering, and the
+ values of parameters, such as CPU, speed, RAM are recorded. If VM is deployed by using
+ template and dynamic root disk size is mentioned, the same value is recorded in the usage
+ event.</para>
</section>
<section id="ssl-termination">
<title>Support for SSL Termination</title>