mirror of
https://github.com/apache/cloudstack.git
synced 2025-10-26 08:42:29 +01:00
format changes to the file
This commit is contained in:
radhikap
parent
95e4b7afa8
commit
3077c992f4
@ -22,125 +22,169 @@
|
|||||||
under the License.
|
under the License.
|
||||||
-->
|
-->
|
||||||
<section id="changing-service-offering-for-vm">
|
<section id="changing-service-offering-for-vm">
|
||||||
<title>Changing the Service Offering for a VM</title>
|
<title>Changing the Service Offering for a VM</title>
|
||||||
<para>To upgrade or downgrade the level of compute resources available to a virtual machine, you can change the VM's compute offering.</para>
|
<para>To upgrade or downgrade the level of compute resources available to a virtual machine, you
|
||||||
<orderedlist>
|
can change the VM's compute offering.</para>
|
||||||
<listitem><para>Log in to the &PRODUCT; UI as a user or admin.</para></listitem>
|
<orderedlist>
|
||||||
<listitem><para>In the left navigation, click Instances.</para></listitem>
|
<listitem>
|
||||||
<listitem><para>Choose the VM that you want to work with.</para></listitem>
|
<para>Log in to the &PRODUCT; UI as a user or admin.</para>
|
||||||
<listitem><para>(Skip this step if you have enabled dynamic VM scaling; see <xref linkend="change-cpu-ram-for-vm"/>.)</para>
|
</listitem>
|
||||||
<para>Click the Stop button to stop the VM.
|
<listitem>
|
||||||
<inlinemediaobject>
|
<para>In the left navigation, click Instances.</para>
|
||||||
<imageobject>
|
</listitem>
|
||||||
<imagedata fileref="./images/stop-instance-icon.png"/>
|
<listitem>
|
||||||
</imageobject>
|
<para>Choose the VM that you want to work with.</para>
|
||||||
<textobject>
|
</listitem>
|
||||||
<phrase>StopButton.png: button to stop a VM</phrase>
|
<listitem>
|
||||||
</textobject>
|
<para>(Skip this step if you have enabled dynamic VM scaling; see <xref
|
||||||
</inlinemediaobject>
|
linkend="change-cpu-ram-for-vm"/>.)</para>
|
||||||
</para></listitem>
|
<para>Click the Stop button to stop the VM. <inlinemediaobject>
|
||||||
<listitem><para>Click the Change Service button.<inlinemediaobject>
|
<imageobject>
|
||||||
<imageobject>
|
<imagedata fileref="./images/stop-instance-icon.png"/>
|
||||||
<imagedata fileref="./images/change-service-icon.png"/>
|
</imageobject>
|
||||||
</imageobject>
|
<textobject>
|
||||||
<textobject>
|
<phrase>StopButton.png: button to stop a VM</phrase>
|
||||||
<phrase>ChangeServiceButton.png: button to change the service of a
|
</textobject>
|
||||||
VM</phrase>
|
</inlinemediaobject>
|
||||||
</textobject>
|
</para>
|
||||||
</inlinemediaobject></para>
|
</listitem>
|
||||||
<para>The Change service dialog box is displayed.</para></listitem>
|
<listitem>
|
||||||
<listitem><para>Select the offering you want to apply to the selected VM.</para></listitem>
|
<para>Click the Change Service button.<inlinemediaobject>
|
||||||
<listitem><para>Click OK.</para></listitem>
|
<imageobject>
|
||||||
</orderedlist>
|
<imagedata fileref="./images/change-service-icon.png"/>
|
||||||
<section id="change-cpu-ram-for-vm">
|
</imageobject>
|
||||||
<!-- CS-17394 -->
|
<textobject>
|
||||||
<title>CPU and Memory Scaling for Running VMs</title>
|
<phrase>ChangeServiceButton.png: button to change the service of a VM</phrase>
|
||||||
<para>(Supported on VMware and XenServer)</para>
|
</textobject>
|
||||||
<para>It is not always possible to accurately predict the CPU and RAM requirements
|
</inlinemediaobject></para>
|
||||||
when you first deploy a VM.
|
<para>The Change service dialog box is displayed.</para>
|
||||||
You might need to increase these resources at any time during the life of a VM.
|
</listitem>
|
||||||
You can dynamically modify CPU and RAM levels to
|
<listitem>
|
||||||
scale up these resources for a running VM without incurring any downtime.</para>
|
<para>Select the offering you want to apply to the selected VM.</para>
|
||||||
<para>Dynamic CPU and RAM scaling can be used in the following cases:</para>
|
</listitem>
|
||||||
<itemizedlist>
|
<listitem>
|
||||||
<listitem><para>User VMs on hosts running VMware and XenServer.</para></listitem>
|
<para>Click OK.</para>
|
||||||
<listitem><para>System VMs on VMware.</para></listitem>
|
</listitem>
|
||||||
<listitem><para>VMware Tools or XenServer Tools must be installed on the virtual machine.</para></listitem>
|
</orderedlist>
|
||||||
<listitem><para>The new requested CPU and RAM values must be within the constraints allowed by the hypervisor
|
<section id="change-cpu-ram-for-vm">
|
||||||
and the VM operating system.</para></listitem>
|
<!-- CS-17394 -->
|
||||||
<listitem><para>New VMs that are created
|
<title>CPU and Memory Scaling for Running VMs</title>
|
||||||
after the installation of &PRODUCT; 4.2
|
<para>(Supported on VMware and XenServer)</para>
|
||||||
can use the dynamic scaling feature.
|
<para>It is not always possible to accurately predict the CPU and RAM requirements when you
|
||||||
If you are upgrading from a previous version of &PRODUCT;,
|
first deploy a VM. You might need to increase these resources at any time during the life of a
|
||||||
your existing VMs created with previous versions
|
VM. You can dynamically modify CPU and RAM levels to scale up these resources for a running VM
|
||||||
will not have the dynamic scaling capability
|
without incurring any downtime.</para>
|
||||||
unless you update them using the following procedure.</para>
|
<para>Dynamic CPU and RAM scaling can be used in the following cases:</para>
|
||||||
</listitem>
|
<itemizedlist>
|
||||||
</itemizedlist>
|
<listitem>
|
||||||
</section>
|
<para>User VMs on hosts running VMware and XenServer.</para>
|
||||||
<section id="update-vms">
|
</listitem>
|
||||||
<title>Updating Existing VMs</title>
|
<listitem>
|
||||||
<para>If you are upgrading from a previous version of &PRODUCT;,
|
<para>System VMs on VMware.</para>
|
||||||
and you want your existing VMs created with previous versions
|
</listitem>
|
||||||
to have the dynamic scaling capability,
|
<listitem>
|
||||||
update the VMs using the following steps:</para>
|
<para>VMware Tools or XenServer Tools must be installed on the virtual machine.</para>
|
||||||
<orderedlist>
|
</listitem>
|
||||||
<listitem><para>Make sure the zone-level setting enable.dynamic.scale.vm is set to true.
|
<listitem>
|
||||||
In the left navigation bar of the &PRODUCT; UI, click Infrastructure, then click Zones, click the zone you want, and click the Settings tab.</para></listitem>
|
<para>The new requested CPU and RAM values must be within the constraints allowed by the
|
||||||
<listitem><para>Install Xen tools (for XenServer hosts) or VMware Tools (for VMware hosts) on each VM
|
hypervisor and the VM operating system.</para>
|
||||||
if they are not already installed.</para></listitem>
|
</listitem>
|
||||||
<listitem><para>Stop the VM.</para></listitem>
|
<listitem>
|
||||||
<listitem><para>Click the Edit button.</para></listitem>
|
<para>New VMs that are created after the installation of &PRODUCT; 4.2 can use the dynamic
|
||||||
<listitem><para>Click the Dynamically Scalable checkbox.</para></listitem>
|
scaling feature. If you are upgrading from a previous version of &PRODUCT;, your existing
|
||||||
<listitem><para>Click Apply.</para></listitem>
|
VMs created with previous versions will not have the dynamic scaling capability unless you
|
||||||
<listitem><para>Restart the VM.</para></listitem>
|
update them using the following procedure.</para>
|
||||||
</orderedlist>
|
</listitem>
|
||||||
</section>
|
</itemizedlist>
|
||||||
<section id="configure-dynamic-scaling">
|
</section>
|
||||||
<title>Configuring Dynamic CPU and RAM Scaling</title>
|
<section id="update-vms">
|
||||||
<para>To configure this feature, use the following new global configuration variables:</para>
|
<title>Updating Existing VMs</title>
|
||||||
<itemizedlist>
|
<para>If you are upgrading from a previous version of &PRODUCT;, and you want your existing VMs
|
||||||
<listitem><para>enable.dynamic.scale.vm: Set to True to enable the feature. By default, the feature is turned off.</para></listitem>
|
created with previous versions to have the dynamic scaling capability, update the VMs using
|
||||||
<listitem><para>scale.retry: How many times to attempt the scaling operation. Default = 2.</para></listitem>
|
the following steps:</para>
|
||||||
</itemizedlist>
|
<orderedlist>
|
||||||
</section>
|
<listitem>
|
||||||
<section id="dynamic-scaling-howto">
|
<para>Make sure the zone-level setting enable.dynamic.scale.vm is set to true. In the left
|
||||||
<title>How to Dynamically Scale CPU and RAM</title>
|
navigation bar of the &PRODUCT; UI, click Infrastructure, then click Zones, click the zone
|
||||||
<para>To modify the CPU and/or RAM capacity of a virtual machine,
|
you want, and click the Settings tab.</para>
|
||||||
you need to change
|
</listitem>
|
||||||
the compute offering of the VM to a new compute offering that has the
|
<listitem>
|
||||||
desired CPU and RAM values. You can use the same steps
|
<para>Install Xen tools (for XenServer hosts) or VMware Tools (for VMware hosts) on each VM
|
||||||
described above in <xref linkend="changing-service-offering-for-vm"/>, but skip the step where you
|
if they are not already installed.</para>
|
||||||
stop the virtual machine. Of course, you might have to create a new compute offering first.</para>
|
</listitem>
|
||||||
<para>When you submit a dynamic scaling request,
|
<listitem>
|
||||||
the resources will be scaled up on the current host if possible.
|
<para>Stop the VM.</para>
|
||||||
If the host does not have enough resources, the VM will be live migrated
|
</listitem>
|
||||||
to another host in the same cluster.
|
<listitem>
|
||||||
If there is no host in the cluster that can fulfill the requested level of CPU and RAM,
|
<para>Click the Edit button.</para>
|
||||||
the scaling operation will fail.
|
</listitem>
|
||||||
The VM will continue to run as it was before.</para>
|
<listitem>
|
||||||
</section>
|
<para>Click the Dynamically Scalable checkbox.</para>
|
||||||
<section id="dynamic-scaling-limitations">
|
</listitem>
|
||||||
<title>Limitations</title>
|
<listitem>
|
||||||
<itemizedlist>
|
<para>Click Apply.</para>
|
||||||
<listitem><para>You can not do dynamic scaling for system VMs on XenServer.</para></listitem>
|
</listitem>
|
||||||
<listitem><para>&PRODUCT; will not check to be sure that the new CPU and RAM levels are compatible
|
<listitem>
|
||||||
with the OS running on the VM.</para></listitem>
|
<para>Restart the VM.</para>
|
||||||
<listitem><para>When scaling memory or CPU for a Linux VM on VMware, you might
|
</listitem>
|
||||||
need to run scripts in addition to the other steps mentioned above.
|
</orderedlist>
|
||||||
For more information, see
|
</section>
|
||||||
<ulink url="http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1012764">Hot adding memory in Linux (1012764)</ulink>
|
<section id="configure-dynamic-scaling">
|
||||||
in the VMware Knowledge Base.</para></listitem>
|
<title>Configuring Dynamic CPU and RAM Scaling</title>
|
||||||
<listitem><para>(VMware) If resources are not available on the current host,
|
<para>To configure this feature, use the following new global configuration variables:</para>
|
||||||
scaling up will fail on VMware because of a known issue where &PRODUCT; and vCenter calculate the available capacity differently.
|
<itemizedlist>
|
||||||
For more information, see
|
<listitem>
|
||||||
<ulink url="https://issues.apache.org/jira/browse/CLOUDSTACK-1809">https://issues.apache.org/jira/browse/CLOUDSTACK-1809</ulink>.</para></listitem>
|
<para>enable.dynamic.scale.vm: Set to True to enable the feature. By default, the feature is
|
||||||
<listitem><para>On VMs running Linux 64-bit and Windows 7 32-bit operating systems,
|
turned off.</para>
|
||||||
if the VM is initially assigned a RAM of less than 3 GB,
|
</listitem>
|
||||||
it can be dynamically scaled up to 3 GB, but not more.
|
<listitem>
|
||||||
This is due to a known issue with these operating systems, which will freeze
|
<para>scale.retry: How many times to attempt the scaling operation. Default = 2.</para>
|
||||||
if an attempt is made to dynamically scale from less than 3 GB to more than 3 GB.
|
</listitem>
|
||||||
</para></listitem>
|
</itemizedlist>
|
||||||
</itemizedlist>
|
</section>
|
||||||
</section>
|
<section id="dynamic-scaling-howto">
|
||||||
|
<title>How to Dynamically Scale CPU and RAM</title>
|
||||||
|
<para>To modify the CPU and/or RAM capacity of a virtual machine, you need to change the compute
|
||||||
|
offering of the VM to a new compute offering that has the desired CPU and RAM values. You can
|
||||||
|
use the same steps described above in <xref linkend="changing-service-offering-for-vm"/>, but
|
||||||
|
skip the step where you stop the virtual machine. Of course, you might have to create a new
|
||||||
|
compute offering first.</para>
|
||||||
|
<para>When you submit a dynamic scaling request, the resources will be scaled up on the current
|
||||||
|
host if possible. If the host does not have enough resources, the VM will be live migrated to
|
||||||
|
another host in the same cluster. If there is no host in the cluster that can fulfill the
|
||||||
|
requested level of CPU and RAM, the scaling operation will fail. The VM will continue to run
|
||||||
|
as it was before.</para>
|
||||||
|
</section>
|
||||||
|
<section id="dynamic-scaling-limitations">
|
||||||
|
<title>Limitations</title>
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>You can not do dynamic scaling for system VMs on XenServer.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>&PRODUCT; will not check to be sure that the new CPU and RAM levels are compatible
|
||||||
|
with the OS running on the VM.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>When scaling memory or CPU for a Linux VM on VMware, you might need to run scripts in
|
||||||
|
addition to the other steps mentioned above. For more information, see <ulink
|
||||||
|
url="http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1012764"
|
||||||
|
>Hot adding memory in Linux (1012764)</ulink> in the VMware Knowledge Base.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>(VMware) If resources are not available on the current host, scaling up will fail on
|
||||||
|
VMware because of a known issue where &PRODUCT; and vCenter calculate the available
|
||||||
|
capacity differently. For more information, see <ulink
|
||||||
|
url="https://issues.apache.org/jira/browse/CLOUDSTACK-1809"
|
||||||
|
>https://issues.apache.org/jira/browse/CLOUDSTACK-1809</ulink>.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>On VMs running Linux 64-bit and Windows 7 32-bit operating systems, if the VM is
|
||||||
|
initially assigned a RAM of less than 3 GB, it can be dynamically scaled up to 3 GB, but
|
||||||
|
not more. This is due to a known issue with these operating systems, which will freeze if
|
||||||
|
an attempt is made to dynamically scale from less than 3 GB to more than 3 GB. </para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</section>
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user