Bug 1120955
Summary: | [Docs][PRD3.5][3.5Beta][Change] Changes to running virtual machines are now applied when the machine shuts down | |||
---|---|---|---|---|
Product: | Red Hat Enterprise Virtualization Manager | Reporter: | Andrew Dahms <adahms> | |
Component: | Documentation | Assignee: | Tahlia Richardson <trichard> | |
Status: | CLOSED CURRENTRELEASE | QA Contact: | Julie <juwu> | |
Severity: | unspecified | Docs Contact: | ||
Priority: | high | |||
Version: | 3.5.0 | CC: | ecohen, gklein, istein, juwu, mavital, ofrenkel, rbalakri, trichard, yeylon | |
Target Milestone: | --- | |||
Target Release: | 3.5.0 | |||
Hardware: | Unspecified | |||
OS: | Unspecified | |||
Whiteboard: | ||||
Fixed In Version: | Doc Type: | Bug Fix | ||
Doc Text: | Story Points: | --- | ||
Clone Of: | ||||
: | 1131735 (view as bug list) | Environment: | ||
Last Closed: | 2015-02-15 23:59:07 UTC | Type: | Bug | |
Regression: | --- | Mount Type: | --- | |
Documentation: | --- | CRM: | ||
Verified Versions: | Category: | --- | ||
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | ||
Cloudforms Team: | --- | Target Upstream Version: | ||
Embargoed: |
Description
Andrew Dahms
2014-07-18 03:39:18 UTC
Hi Omer, Can you please confirm whether I've understood this correctly, or if I've missed something? To my understanding, all properties can now be edited while the VM is running, and all changes will be applied when the VM is shut down/restarted. So, the changes that need to be made to the documentation[1] are: 1. Remove mentions of the VM needing to be powered off in order to edit some settings. 2. Remove the list of fields that can be editing while the VM is running (since it is now all of them). [1] https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/Administration_Guide/index.html#Editing_Virtual_Machine_Properties1 Thanks, Tahlia 1. dont know if i'd remove it, it would make sense to explain vms can be edited while running, but only some of the properties will be applied imeediately, and some would be applied on the next run. 2. maybe we can change the list to describe the fields that apply immediately, does this make sense? 1. Ah, I see. I'll do that. Thanks! 2. Yes, that makes sense. Is the list of fields that apply immediately the same as the list already in the doc, or does it need updating? Revised text, pending confirmation of the list of changes that will apply immediately: "Summary Changes to storage, operating system, or networking parameters can adversely affect the virtual machine. Ensure that you have the correct details before attempting to make any changes. Virtual machines can be editing while running, but must be restarted or shut down before some changes will be applied. This procedure explains how to edit a virtual machine. It is necessary to edit a virtual machine in order to change its settings. Procedure 9.9. Editing a virtual machine: 1. Select the virtual machine to be edited. 2. Click the Edit button to open the Edit Virtual Machine window. 3. Change the General, System, Initial Run, Console, Host, High Availability, Resource Allocation, Boot Options, and Custom Options fields as required. Changes to the following fields will be applied immediately: <list> To apply changes to all other settings, the virtual machine must restarted or shut down. 4. If the Next Restart Configuration pop-up window appears, click OK. 5. Click OK to save your changes. Changes from the list in Step 3 will be applied immediately. All other changes will be applied once you restart your virtual machine. Result You have changed the settings of a virtual machine by editing it." list of fields that can be applied immediately: name, description, comment, vm-type (desktop/server), priority, HA, delete-protection, disable strict user checking (allow-console-reconnect), tunnel-migration (editable with rest-api), custom migration downtime, quota, network interfaces Thanks Omer, I'll update the doc now. Updated topic [12677-699896] Admin guide rev history [34613-699899] User Guide rev history [34617-699900] Flipping to POST for tech review. Meital, can you please check the technical accuracy of this section (Editing Virtual Machine Properties): http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/Administration_Guide/index.html#Editing_Virtual_Machine_Properties1 Build: Red_Hat_Enterprise_Virtualization-Administration_Guide-3.5-Beta-web-en-US-3.5-7.el6eng Note: User Guide is still awaiting rebuild, but contains the same topic so review of the Admin Guide will suffice for tech review. Ilanit - please review the part of edit running VM I've reviewed the 'edit running VM' section. Seems OK to me. As cpu is only if using hot plug, and only for supported versions, it should be documented somewhere in this doc, but I didn't find it. I think there is a separate bug for that? (In reply to Ilanit Stein from comment #10) > I've reviewed the 'edit running VM' section. > Seems OK to me. > > As cpu is only if using hot plug, and only for supported versions, it should > be documented somewhere in this doc, but I didn't find it. I think there is > a separate bug for that? Hi Ilanit, Tahlia is currently on leave. Let me have a look at this and get back to you. Cheers, Julie I found BZ#1075466 about hot-plugging cpus, so this bug should be okay to move onto QA. Documentation Link ------------------------------ Admin: https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/Administration_Guide/index.html#Editing_Virtual_Machine_Properties1 User: https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/User_Guide/index.html#Editing_Virtual_Machine_Properties1 What Changed ------------------------------ Editing Virtual Machine Properties [12677-699896] Removed mentions of the VM having to be shut down for some changes to be made, and replaced with mentions that some changes will be applied immediately while some require restart. Changed the list of fields from a list of those that can be edited while the machine is running, to a list of those that will be applied immediately. Updated revision history: Admin guide [34613-699899] User Guide [34617-699900] NVR ------------------------------ Admin: Red_Hat_Enterprise_Virtualization-Administration_Guide-3.5-Beta-web-en-US-3.5-13.el6eng User: Red_Hat_Enterprise_Virtualization-User_Guide-3.5-Beta-web-en-US-3.5-9.el6eng Moving to ON_QA Verified. Cheers, Julie |