en-US/dynamic-compute-offerings.xml

<?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. Use this offering to
    deploy VM by specifying custom values for the 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 in the UI.
    If the Custom field is checked, the user will be able to create a custom Compute Offering.
    During VM deployment you can specify desired values for number of CPU, CPU speed, and memory.
    See <xref linkend="creating-compute-offerings"/> for more information on this.</para>
  <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, and upon changing the compute offering of a stopped or running VM. The values of the
    parameters, such as CPU, speed, RAM are recorded. </para>
</section>