July 2015 - Kimchi-devel - oVirt List Archives

[PATCH] Force qcow2 when creating a VM based on backing image
by Jose Ricardo Ziviani 04 Aug '15

04 Aug '15

- When using a backing image as template the target must be a qcow2 image. Signed-off-by: Jose Ricardo Ziviani <joserz(a)linux.vnet.ibm.com> --- src/kimchi/vmtemplate.py | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/src/kimchi/vmtemplate.py b/src/kimchi/vmtemplate.py index 2646573..a165a5d 100644 --- a/src/kimchi/vmtemplate.py +++ b/src/kimchi/vmtemplate.py @@ -232,12 +232,18 @@ class VMTemplate(object): v_tree = E.volume(E.name(info['name'])) v_tree.append(E.allocation(str(info['allocation']), unit='G')) v_tree.append(E.capacity(str(info['capacity']), unit='G')) - target = E.target( - E.format(type=info['format']), E.path(info['path'])) + + target_fmt = info['format'] if 'base' in d: + # target must be qcow2 in order to use a backing file + target_fmt = 'qcow2' + v_tree.append(E.backingStore( E.path(info['base']['path']), E.format(type=info['base']['format']))) + + target = E.target( + E.format(type=target_fmt), E.path(info['path'])) v_tree.append(target) info['xml'] = etree.tostring(v_tree) ret.append(info) -- 1.9.1

3 3

[PATCH] PCI Node filtering
by Socorro Stoppler 04 Aug '15

04 Aug '15

Allow to only be able to add PCI device that is not attached to a VM All filter now shows only those PCI devices that are available to be added and ones that are already attached to a VM. Signed-off-by: Socorro Stoppler <socorro(a)linux.vnet.ibm.com> --- ui/js/src/kimchi.guest_edit_main.js | 166 +++++++++++++++++++----------------- 1 file changed, 88 insertions(+), 78 deletions(-) diff --git a/ui/js/src/kimchi.guest_edit_main.js b/ui/js/src/kimchi.guest_edit_main.js index 7671e43..a07f938 100644 --- a/ui/js/src/kimchi.guest_edit_main.js +++ b/ui/js/src/kimchi.guest_edit_main.js @@ -429,81 +429,7 @@ kimchi.guest_edit_main = function() { filterNodes("", $("#permission-avail-groups")); }); } - var setupPCIDevice = function(){ - kimchi.getHostPCIDevices(function(hostPCIs){ - kimchi.getVMPCIDevices(kimchi.selectedGuest, function(vmPCIs){ - var pciEnabled = kimchi.capabilities.kernel_vfio; - for(var i=0; i<hostPCIs.length; i++){ - var itemNode = $.parseHTML(kimchi.substitute($('#pci-tmpl').html(),{ - name: hostPCIs[i].name, - product: hostPCIs[i].product.description, - vendor: hostPCIs[i].vendor.description - })); - $(".body", "#form-guest-edit-pci").append(itemNode); - var iconClass = "ui-icon-plus"; - for(var j=0; j<vmPCIs.length; j++){ - if(hostPCIs[i].name==vmPCIs[j].name){ - iconClass = "ui-icon-minus"; - break; - } - } - pciEnabled || $("button", itemNode).remove(); - $("button", itemNode).button({ - icons: { primary: iconClass }, - text: false - }).click(function(){ - var obj = $(this); - if(obj.button("option", "icons").primary == "ui-icon-minus"){ - kimchi.removeVMPCIDevice(kimchi.selectedGuest, obj.parent().prop("id"), function(){ - kimchi.getVMPCIDevices(kimchi.selectedGuest, function(vmPCIs1){ - for(var k=0; k<hostPCIs.length; k++) { - $("button", "#" + hostPCIs[k].name).button("option", "icons", {primary: "ui-icon-plus"}); - } - for(var k=0; k<vmPCIs1.length; k++) { - $("button", "#" + vmPCIs1[k].name).button("option", "icons", {primary: "ui-icon-minus"}); - } - }); - filterNodes($("select", "#form-guest-edit-pci").val(), $("input", "#form-guest-edit-pci").val()); - }); - } else { - kimchi.addVMPCIDevice(kimchi.selectedGuest, { name: obj.parent().prop("id") }, function(){ - kimchi.getVMPCIDevices(kimchi.selectedGuest, function(vmPCIs1){ - for(var k=0; k<vmPCIs1.length; k++) { - $("button", "#" + vmPCIs1[k].name).button("option", "icons", {primary: "ui-icon-minus"}); - } - }); - filterNodes($("select", "#form-guest-edit-pci").val(), $("input", "#form-guest-edit-pci").val()); - }); - } - }); - kimchi.getPCIDeviceCompanions(hostPCIs[i].name, function(infoData) { - var pciTitle = i18n["KCHVMED6007M"] + "\n"; - var haveCompanions = false; - for(var p=0; p<infoData.length; p++) { - if(infoData[p].device_type === "net") { - haveCompanions = true; - pciTitle += " " + infoData[p].name + "\n"; - pciTitle += " " + i18n["KCHVMED6001M"] + " " + infoData[p].interface; - pciTitle += ", " + i18n["KCHVMED6002M"] + " " + infoData[p].address; - pciTitle += ", " + i18n["KCHVMED6003M"] + " " + infoData[p].link_type + "\n"; - } else if(infoData[p].device_type === "storage") { - haveCompanions = true; - pciTitle += " " + infoData[p].name + "\n"; - pciTitle += " " + i18n["KCHVMED6004M"] + " " + infoData[p].block; - pciTitle += ", " + i18n["KCHVMED6005M"] + " " + infoData[p].drive_type; - pciTitle += ", " + i18n["KCHVMED6006M"] + " " + infoData[p].model + "\n"; - } - } - for(var q=0; q<infoData.length; q++) { - haveCompanions && $(".name", "#" + infoData[q].parent).attr("title", pciTitle); - haveCompanions && $(".product", "#" + infoData[q].parent).attr("title", pciTitle); - haveCompanions && $(".vendor", "#" + infoData[q].parent).attr("title", pciTitle); - } - }); - } - }); - }); - var filterNodes = function(group, text){ + var filterPCINodes = function(group, text){ text = text.toLowerCase(); $(".body", "#form-guest-edit-pci").children().each(function(){ var textFilter = $(".name", this).text().toLowerCase().indexOf(text)!=-1; @@ -522,15 +448,99 @@ kimchi.guest_edit_main = function() { } $(this).css("display", display); }); - }; + } + var setupPCIDevice = function(){ + kimchi.getAvailableHostPCIDevices(function(hostPCIs){ + kimchi.getVMPCIDevices(kimchi.selectedGuest, function(vmPCIs){ + setupNode(hostPCIs, "ui-icon-plus"); + setupNode(vmPCIs, "ui-icon-minus"); + }); + }); $("select", "#form-guest-edit-pci").change(function(){ - filterNodes($(this).val(), $("input", "#form-guest-edit-pci").val()); + filterPCINodes($(this).val(), $("input", "#form-guest-edit-pci").val()); }); $("input", "#form-guest-edit-pci").on("keyup", function() { - filterNodes($("select", "#form-guest-edit-pci").val(), $(this).val()); + filterPCINodes($("select", "#form-guest-edit-pci").val(), $(this).val()); }); }; + var setupNode = function(arrPCIDevices, iconClass) { + var pciEnabled = kimchi.capabilities.kernel_vfio; + var pciDeviceName, pciDeviceProduct, pciDeviceProductDesc, pciDeviceVendor, pciDeviceVendorDesc; + for(var i=0; i<arrPCIDevices.length; i++){ + pciDeviceName = arrPCIDevices[i].name; + pciDeviceProduct = arrPCIDevices[i].product; + pciDeviceVendor = arrPCIDevices[i].vendor; + if(pciDeviceProduct!=null) { + pciDeviceProductDesc = pciDeviceProduct.description; + } + if(pciDeviceVendor!=null) { + pciDeviceVendorDesc = pciDeviceVendor.description; + } + var itemNode = $.parseHTML(kimchi.substitute($('#pci-tmpl').html(),{ + name: pciDeviceName, + product: pciDeviceProductDesc, + vendor: pciDeviceVendorDesc + })); + $(".body", "#form-guest-edit-pci").append(itemNode); + pciEnabled || $("button", itemNode).remove(); + $("button", itemNode).button({ + icons: { primary: iconClass }, + text: false + }).click(function(){ + var obj = $(this); + if(obj.button("option", "icons").primary == "ui-icon-minus"){ + kimchi.removeVMPCIDevice(kimchi.selectedGuest, obj.parent().prop("id"), function(){ + kimchi.getAvailableHostPCIDevices(function(arrPCIDevices1){ + kimchi.getVMPCIDevices(kimchi.selectedGuest, function(vmPCIs1){ + for(var k=0; k<arrPCIDevices1.length; k++) { + $("button", "#" + arrPCIDevices1[k].name).button("option", "icons", {primary: "ui-icon-plus"}); + } + for(var k=0; k<vmPCIs1.length; k++) { + $("button", "#" + vmPCIs1[k].name).button("option", "icons", {primary: "ui-icon-minus"}); + } + }); + }); + filterPCINodes($("select", "#form-guest-edit-pci").val(), $("input", "#form-guest-edit-pci").val()); + }); + } else { + kimchi.addVMPCIDevice(kimchi.selectedGuest, { name: obj.parent().prop("id") }, function(){ + kimchi.getVMPCIDevices(kimchi.selectedGuest, function(vmPCIs1){ + for(var k=0; k<vmPCIs1.length; k++) { + $("button", "#" + vmPCIs1[k].name).button("option", "icons", {primary: "ui-icon-minus"}); + } + }); + filterPCINodes($("select", "#form-guest-edit-pci").val(), $("input", "#form-guest-edit-pci").val()); + }); + } + }); + kimchi.getPCIDeviceCompanions(pciDeviceName, function(infoData) { + var pciTitle = i18n["KCHVMED6007M"] + "\n"; + var haveCompanions = false; + for(var p=0; p<infoData.length; p++) { + if(infoData[p].device_type === "net") { + haveCompanions = true; + pciTitle += " " + infoData[p].name + "\n"; + pciTitle += " " + i18n["KCHVMED6001M"] + " " + infoData[p].interface; + pciTitle += ", " + i18n["KCHVMED6002M"] + " " + infoData[p].address; + pciTitle += ", " + i18n["KCHVMED6003M"] + " " + infoData[p].link_type + "\n"; + } else if(infoData[p].device_type === "storage") { + haveCompanions = true; + pciTitle += " " + infoData[p].name + "\n"; + pciTitle += " " + i18n["KCHVMED6004M"] + " " + infoData[p].block; + pciTitle += ", " + i18n["KCHVMED6005M"] + " " + infoData[p].drive_type; + pciTitle += ", " + i18n["KCHVMED6006M"] + " " + infoData[p].model + "\n"; + } + } + for(var q=0; q<infoData.length; q++) { + haveCompanions && $(".name", "#" + infoData[q].parent).attr("title", pciTitle); + haveCompanions && $(".product", "#" + infoData[q].parent).attr("title", pciTitle); + haveCompanions && $(".vendor", "#" + infoData[q].parent).attr("title", pciTitle); + } + }); + } + }; + var setupSnapshot = function() { var currentSnapshot; var setCurrentSnapshot = function(aSnapshot){ -- 1.8.3.1

4 3

[PATCH v3 0/4] Add usb xhci controller for hotplug on Power
by Jose Ricardo Ziviani 04 Aug '15

04 Aug '15

v3: - Changed test case to check if new VMs has a xhci controller; - Made have_xhci_usb_controller public to test it. v2: - Added a new test case. Power system requires an USB XHCI controller in order to allow PCI hotplug. This patch adds such controller by default when creating a new VM and inform the users if a VM currently doesn't have the controller. Jose Ricardo Ziviani (4): Add a new error code for pci hotplug Check for usb xhci controller in Power platform Define the USB xhci controller in the template for Power Systems Add a new test case for pci hotplug on Power src/kimchi/i18n.py | 1 + src/kimchi/model/vmhostdevs.py | 30 +++++++++++++++++++++++++++++- src/kimchi/vmtemplate.py | 17 +++++++++++++++++ tests/test_model.py | 27 +++++++++++++++++++++++++++ 4 files changed, 74 insertions(+), 1 deletion(-) -- 1.9.1

3 7

**Please force pull or re-clone branches of https://github.com/danielhb/kimchi**
by Daniel Henrique Barboza 17 Jul '15

17 Jul '15

Hello, A patchset sent to this ML was wrongly pushed to the temporary repo, branches 'master' and 'next'. The patchset "[PATCH v2 0/4] Add usb xhci controller for hotplug on Power" doesn't make sense to community Kimchi code. This is a temporary workaround to make the hotplug work in ibm_powerkvm distro running in Power. It does not apply for any other case. I've removed the patches from the master and next branch, but now your trees won't update gracefully, requiring a force pull or cloning the branches again. Sorry for the inconvenience, Daniel

1 0

[PATCH] Fix numerous errors in UI when host is shut down
by Socorro Stoppler 15 Jul '15

15 Jul '15

From: Socorro Stoppler <socorrob(a)us.ibm.com> Fix numerous errors in UI when host is shut down Socorro Stoppler (1): Fix displaying numerous error msgs when host is shut down ui/js/src/kimchi.main.js | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) -- 1.9.1

4 8

[DOUBT] PCI devices companions on UI
by Ramon Medeiros 09 Jul '15

09 Jul '15

Hi guys, i was looking at the code that parses host pci devices and found a loop, that i don't understand what it does. Looking at it, i see a string being created but do not understood which variable will be used on the code. Has someone experience with this part of the code? https://github.com/kimchi-project/kimchi/blob/master/ui/js/src/kimchi.guest… -- Ramon Nunes Medeiros Kimchi Developer Linux Technology Center Brazil IBM Systems & Technology Group Phone : +55 19 2132 7878 ramonn(a)br.ibm.com

2 1

[PATCH 0/3] Add usb xhci controller for hotplug on Power
by Jose Ricardo Ziviani 09 Jul '15

09 Jul '15

Power system requires an USB XHCI controller in order to allow PCI hotplug. This patch adds such controller by default when creating a new VM and inform the users if a VM currently doesn't have the controller. Jose Ricardo Ziviani (3): Add a new error code for pci hotplug Check for usb xhci controller in Power platform Define the USB xhci controller in the template for Power Systems src/kimchi/i18n.py | 1 + src/kimchi/model/vmhostdevs.py | 28 +++++++++++++++++++++++++++- src/kimchi/vmtemplate.py | 17 +++++++++++++++++ 3 files changed, 45 insertions(+), 1 deletion(-) -- 1.9.1

2 6

New branches upstream
by Aline Manera 03 Jul '15

03 Jul '15

Hi all, As we decided for a stabilization release after 1.5, I will create a new branch named 'next' to apply the patches not related to bug fixes. Once we get 1.5.1 released, the 'next' branch will be merged into 'master' I will also create the 'wok' branch to handle the wok framework and the new UI development. I want to use the 1.5.1 time frame to test as much as we can the wok framework and the new UI we can release all that right after 1.5.1 Summary: - master: current release development - next <https://github.com/kimchi-project/kimchi/tree/next>: new features - wok <https://github.com/kimchi-project/kimchi/tree/wok>: disruptive features (wok framework + new UI) The current 'wok' branch is a copy of the master branch. I am working with Lucio to get the new UI patches merged with the 'wok' patches so we can update the upstream branch accordingly. Regards, Aline Manera

1 1

[PATCH 2/2] Review changes for Kimchi
by Kersten 03 Jul '15

03 Jul '15

Made changes to 3 files per comments from Aline. Signed-off-by: Kersten <kersten(a)us.ibm.com> --- ui/pages/help/en_US/guests.dita | 30 +++++++++++++++--------------- ui/pages/help/en_US/storage.dita | 8 ++++---- ui/pages/help/en_US/templates.dita | 15 +++++++++------ 3 files changed, 28 insertions(+), 25 deletions(-) diff --git a/ui/pages/help/en_US/guests.dita b/ui/pages/help/en_US/guests.dita index 7d0d453..45cf7da 100644 --- a/ui/pages/help/en_US/guests.dita +++ b/ui/pages/help/en_US/guests.dita @@ -10,14 +10,14 @@ https://w3.opensource.ibm.com/projects/dita-cshelp/--> <cshelp id="kimhvirtm" xml:lang="en-us"> <title>Guests</title> <shortdesc>The <wintitle>Guests</wintitle> page lists the defined -guests or virtual machines.</shortdesc> +guests for your server.</shortdesc> <csbody> For each guest, the following information is displayed:<dl><dlentry> <dt>Name</dt> -<dd>Name of the virtual machine.</dd> +<dd>Name of the guest.</dd> </dlentry><dlentry> <dt>CPU</dt> -<dd>Percentage of processor utilization in the virtual machine.</dd> +<dd>Percentage of processor utilization in the guest.</dd> </dlentry><dlentry> <dt>Disk I/O</dt> <dd>Disk input/output transmission rate in KB per seconds.</dd> @@ -53,16 +53,16 @@ existing guest. Guests can be edited only while stopped.</li> <li>Select <uicontrol>Power Off</uicontrol> to force an immediate shut down of the guest.</li> <li>Select <uicontrol>Delete</uicontrol> to delete the guest.</li> -</ul>To create a guest, or virtual machine, click the <uicontrol>plus -(+)</uicontrol> icon on the page. +</ul>To create a guest, click the <uicontrol>plus (+)</uicontrol> icon +on the page. </csbody> <cshelp id="kimhvirtmcrt" xml:lang="en-us"> -<title>Create a guest (virtual machine)</title> +<title>Create a guest</title> <shortdesc>Create a guest by using an existing template.</shortdesc> <csbody> <ol> -<li>Type the name to be used to identify the virtual machine.</li> -<li rev="rev1">Select a template. <ul> +<li>Type the name to be used to identify the guest.</li> +<li>Select a template. <ul> <li>If templates exist, select from displayed templates.</li> <li>If no templates exist, click <uicontrol>Create a template</uicontrol> to create a template.</li> @@ -73,9 +73,9 @@ create a template.</li> </cshelp> <cshelp id="kimhvirtmedit" xml:lang="en-us"> <title>Edit guest</title> -<shortdesc>Edit the properties of an existing virtual machine. Some -properties can be edited only while guest is stopped. Others will -take effect in next boot.</shortdesc> +<shortdesc>Edit the properties of an existing guest. Some properties +can be edited only while guest is stopped. Others will take effect +in next boot.</shortdesc> <csbody> <dl><dlentry> <dt>General</dt> @@ -124,11 +124,11 @@ guest.</li> iSCSI volumes or if the target pool does not have enough space, the clone will be created on a default storage pool. </note></li> </ol> -A guest appears in your list with the label "cloning..." When the -process is complete, the cloned guest is available to use.<?Pub -Caret 54?> +A guest appears in your list with the label <uicontrol>Cloning...</uicontrol> When +the process is complete, the cloned guest is available to use.<?Pub +Caret 45?> </csbody> </cshelp> <?tm 1391540919 3?> </cshelp> -<?Pub *0000005359?> +<?Pub *0000005287?> diff --git a/ui/pages/help/en_US/storage.dita b/ui/pages/help/en_US/storage.dita index e6f995d..53d1404 100644 --- a/ui/pages/help/en_US/storage.dita +++ b/ui/pages/help/en_US/storage.dita @@ -94,16 +94,16 @@ pool is created, it will be created for you.</li> </cshelp> <cshelp id="kimhdefstor" xml:lang="en-us"> <title>Add volume</title> -<shortdesc>Adds volume to a storage pool.</shortdesc><?Pub Caret 0?> +<shortdesc>Adds volume to a storage pool.</shortdesc> <csbody> <dl><dlentry> <dt>Fetch from remote URL</dt> -<dd>Specifies a location to upload the volume from. For example: <filepath>https://my-server/fedora22.img</filepath>.</dd> +<dd>Specifies a location to download the volume from. For example: <filepath>https://my-server/fedora22.img</filepath>.</dd> </dlentry><dlentry> <dt>Upload a file</dt> <dd>Specifies a location on your local system.</dd> -</dlentry></dl> +</dlentry></dl><?Pub Caret 57?> </csbody> </cshelp> </cshelp> -<?Pub *0000004413?> +<?Pub *0000004416?> diff --git a/ui/pages/help/en_US/templates.dita b/ui/pages/help/en_US/templates.dita index 1c03016..ad3747c 100644 --- a/ui/pages/help/en_US/templates.dita +++ b/ui/pages/help/en_US/templates.dita @@ -55,7 +55,7 @@ You can select multiple networks.</dd> <dd>In the <uicontrol>CPU Number</uicontrol> field, specify the number of processors that are defined for the template.</dd> <dd>Select to Manually set CPU topology for each guest.</dd> -</dlentry></dl><?Pub Caret 322?> +</dlentry></dl> </csbody> </cshelp> <cshelp id="kimhaddtempl"> @@ -69,16 +69,19 @@ ISO image to 'ISO' storage pool for following discovery.</shortdesc> <dd>Select to scan storage pools for installation ISO images available on the system.</dd> </dlentry><dlentry> +<dt>Local Image File</dt> +<dd>Select to specify a path to the local image file.</dd> +</dlentry><dlentry> <dt>Remote ISO image</dt> <dd>Select to specify a remote location for an installation ISO image.</dd> </dlentry></dl> </csbody> </cshelp> <cshelp id="kimhaddloct"> -<title>Add template - local ISO image</title> -<shortdesc>Add a template from a local ISO image.</shortdesc> +<title>Add template - ISO image</title> +<shortdesc>Add a template from a ISO image.</shortdesc> <csbody> -The ISO images available on the system are displayed. +The ISO images available on the system ore remotely are displayed. <dl><dlentry> <dt>OS</dt> <dd>Name of the operating system or distribution.</dd> @@ -105,7 +108,7 @@ specify a path to the ISO image.</li> ISO images.</li> </ul></li> </ul> -</csbody> +</csbody><?Pub Caret -2?> </cshelp> </cshelp> -<?Pub *0000004089?> +<?Pub *0000004194?> -- 1.9.5.msysgit.1

2 2

[PATCH] Help updates for Kimchi
by Kersten 03 Jul '15

03 Jul '15

From: Kersten Richter <kersten(a)us.ibm.com> includes all of the dita files for kimchi. cleaned up coding a bit and simplified help. Also added new tasks and information (storage volume shutdown versus power off. Signed-off-by: unknown <kersten(a)ADMINIB-EI291RC.rchland.ibm.com> --- ui/pages/help/en_US/guests.dita | 124 ++++++++++++++++++------------------- ui/pages/help/en_US/host.dita | 22 +++---- ui/pages/help/en_US/network.dita | 7 +-- ui/pages/help/en_US/storage.dita | 50 +++++++++------ ui/pages/help/en_US/templates.dita | 86 +++++++++++-------------- 5 files changed, 141 insertions(+), 148 deletions(-) diff --git a/ui/pages/help/en_US/guests.dita b/ui/pages/help/en_US/guests.dita index 1bb437a..7d0d453 100644 --- a/ui/pages/help/en_US/guests.dita +++ b/ui/pages/help/en_US/guests.dita @@ -10,7 +10,7 @@ https://w3.opensource.ibm.com/projects/dita-cshelp/--> <cshelp id="kimhvirtm" xml:lang="en-us"> <title>Guests</title> <shortdesc>The <wintitle>Guests</wintitle> page lists the defined -KVM virtual machines.</shortdesc> +guests or virtual machines.</shortdesc> <csbody> For each guest, the following information is displayed:<dl><dlentry> <dt>Name</dt> @@ -19,12 +19,12 @@ KVM virtual machines.</shortdesc> <dt>CPU</dt> <dd>Percentage of processor utilization in the virtual machine.</dd> </dlentry><dlentry> -<dt>Network I/O</dt> -<dd>Network input/output transmission rate in KB per seconds.</dd> -</dlentry><dlentry> <dt>Disk I/O</dt> <dd>Disk input/output transmission rate in KB per seconds.</dd> </dlentry><dlentry> +<dt>Network I/O</dt> +<dd>Network input/output transmission rate in KB per seconds.</dd> +</dlentry><dlentry> <dt>Livetile</dt> <dd>State of guest operating system console, or an icon that represents the <tm tmtype="tm" trademark="Linux">Linux</tm> distribution if the @@ -42,18 +42,23 @@ the power is off; if the icon is green, the power is on.</dd> The following actions can be selected for each guest:<ul> <li>Select <uicontrol>Connect</uicontrol> to connect to the remote console for the guest operating system.</li> -<li>Select <uicontrol>Manage media</uicontrol> to change the path -to the installation media.</li> -<li>Select <uicontrol>Reset</uicontrol> to reset the guest.</li> +<li>Select <uicontrol>Clone</uicontrol> to copy an existing guest +definition to create a guest.</li> +<li>Select <uicontrol>Reset</uicontrol> to reset the guest. You can +only reset a guest that is started.</li> <li>Select <uicontrol>Edit</uicontrol> to edit the properties of an existing guest. Guests can be edited only while stopped.</li> +<li>Select <uicontrol>Start</uicontrol> to start a guest</li> +<li>Select <uicontrol>Shut Down</uicontrol> to shut down a guest gracefully.</li> +<li>Select <uicontrol>Power Off</uicontrol> to force an immediate +shut down of the guest.</li> <li>Select <uicontrol>Delete</uicontrol> to delete the guest.</li> </ul>To create a guest, or virtual machine, click the <uicontrol>plus -(+)</uicontrol> icon in the upper right of the page. +(+)</uicontrol> icon on the page. </csbody> <cshelp id="kimhvirtmcrt" xml:lang="en-us"> -<title>Create virtual machine</title> -<shortdesc>Create a virtual machine by using an existing template.</shortdesc> +<title>Create a guest (virtual machine)</title> +<shortdesc>Create a guest by using an existing template.</shortdesc> <csbody> <ol> <li>Type the name to be used to identify the virtual machine.</li> @@ -61,76 +66,69 @@ existing guest. Guests can be edited only while stopped.</li> <li>If templates exist, select from displayed templates.</li> <li>If no templates exist, click <uicontrol>Create a template</uicontrol> to create a template.</li> -</ul></li> +</ul>You can view information about a template by hovering over it.</li> <li>Click <uicontrol>Create</uicontrol>.</li> </ol> </csbody> </cshelp> <cshelp id="kimhvirtmedit" xml:lang="en-us"> <title>Edit guest</title> -<shortdesc>Edit the properties of an existing virtual machine. Some properties -can be edited only while guest is stopped. Others will take effect in next boot.</shortdesc> -<csprolog><csmetadata></csmetadata></csprolog> +<shortdesc>Edit the properties of an existing virtual machine. Some +properties can be edited only while guest is stopped. Others will +take effect in next boot.</shortdesc> <csbody> -For each guest, the following information is displayed on the <wintitle>General</wintitle> tab:<dl> -<dlentry> -<dt>Name</dt> -<dd>Name of the virtual machine. (can only be edited while guest is stopped)</dd> -</dlentry><dlentry> -<dt>CPUs</dt> -<dd>Number of processors. (if guest is running, new amount will take effect -in next boot)</dd> -</dlentry><dlentry> -<dt>Memory</dt> -<dd>Amount of memory in MB. (if guest is running, new amount will take effect -in next boot)</dd> -</dlentry><dlentry> -<dt>Icon</dt> -<dd>Graphic image representing the Linux distribution to be displayed -in place of current status (Livetile) when the guest is not active.</dd> -</dlentry></dl> -The following information is displayed on the <wintitle>Storage</wintitle> tab. <dl><dlentry> +<dt>General</dt> +<dd>Displays information about your guest, including name, CPUs, memory, +and icon to use for your guest. You can edit the name of a stopped +guest. Changing the CPUs and memory takes effect after the next boot.</dd> +</dlentry><dlentry> <dt>Storage</dt> -<dd>Displays the location of the ISO file used for installation.</dd> -</dlentry></dl><?Pub Caret -2?> +<dd>Displays the device and path for storage for the selected guest. +You can add, edit, and remove storage devices for your guest.</dd> +</dlentry></dl> +<dl><dlentry> +<dt>Interface</dt> +<dd>Displays network information for the guest, including name, type, +and MAC address. You can add, edit, and remove interfaces for your +guest.</dd> +</dlentry></dl> +<dl><dlentry> +<dt>Permission</dt> +<dd>Displays the users and groups that are authorized for the guest. </dd> +</dlentry></dl> +<dl><dlentry> +<dt>Host PCI Device</dt> +<dd>Displays a list of all PCI devices available on the host. </dd> +</dlentry></dl> +<dl><dlentry> +<dt>Snapshot</dt> +<dd>Displays snapshots of the guest. You can create, edit, or delete +a snapshot. By selecting a snapshot and selecting revert, the guest +is restored to a point in the past, determined by the snapshot data, +and discards any changes made beyond that point in time.</dd> +</dlentry></dl> Fields that are not disabled can be edited. After you edit a field, click <uicontrol>Save</uicontrol>. </csbody> </cshelp> -<cshelp id="kimstoragedevice" xml:lang="en-us"> -<title>Add, replace, or detach a storage device</title> -<shortdesc rev="rev1">You can add, replace, or detach a storage device -to your virtual machine. The only supported device is CDROM. To edit -your storage devices, follow these steps:</shortdesc> -<csbody> -<ol> -<li>On the <wintitle>Edit Guest</wintitle> window, select <wintitle>Storage</wintitle>.</li> -<li>To replace a storage device, click the first icon with the <uicontrol>orange -slash (/)</uicontrol>. Enter the ISO file path and click <uicontrol>Replace</uicontrol>.</li> -<li>To detach a storage device, click the second icon with the <uicontrol>red -dash (-)</uicontrol>. Confirm the deletion and click <uicontrol>OK</uicontrol>.</li> -<li>To add a storage device, click the third icon with the green <uicontrol>plus -sign (+)</uicontrol>. Enter a device name and ISO file path and click <uicontrol>Attach</uicontrol>.</li> -</ol> -</csbody> -</cshelp> -<cshelp id="kimreplacemedia" xml:lang="en-us"> -<title>Replace a CDROM of VM</title> -<shortdesc rev="rev1">You can replace the contents of the CDROM for -a virtual machine after the installation is complete.</shortdesc> +<cshelp id="kimhvirtmclone" xml:lang="en-us"> +<title>Cloning a guest</title> +<shortdesc>Cloning a guests allows you to create a copy of a guest.</shortdesc> <csbody> +To clone a guest: <ol> -<li>Ensure that the virtual machine is started.</li> -<li>From the Actions menu, select <uicontrol>Manage Media</uicontrol>.</li> -<li>To change what is currently loaded in the CDROM, click the <uicontrol>orange -slash (/)</uicontrol> icon next to the hdc field.</li> -<li>On the <wintitle>Replace a CDROM of VM</wintitle> page, enter -the ISO file path. The other two fields are read-only.</li> -<li>Click <uicontrol>Replace</uicontrol>.</li> +<li>Select <uicontrol>Clone</uicontrol> from the Action menu of a +guest.</li> +<li>Accept the warning. <note>When a target guest is using SCSI or +iSCSI volumes or if the target pool does not have enough space, the +clone will be created on a default storage pool. </note></li> </ol> +A guest appears in your list with the label "cloning..." When the +process is complete, the cloned guest is available to use.<?Pub +Caret 54?> </csbody> </cshelp> <?tm 1391540919 3?> </cshelp> -<?Pub *0000005541?> +<?Pub *0000005359?> diff --git a/ui/pages/help/en_US/host.dita b/ui/pages/help/en_US/host.dita index 0dcb670..4af3498 100644 --- a/ui/pages/help/en_US/host.dita +++ b/ui/pages/help/en_US/host.dita @@ -20,18 +20,16 @@ system.</li> <li>Select <uicontrol>Connect</uicontrol> to open a VNC connection to the host system, if it is not already connected.</li> </ul> -Click the following sections to display information about the host:<dl> -<dlentry> +Click the following sections to display information about the host: +<dl><dlentry> <dt>Basic information</dt> <dd>This section displays the host operating system distribution, -version, and code name, as well as the processor type, the number of -online CPUs and amount of memory in GB.</dd> +version, and code name, as well as the processor type, the number +of online CPUs and amount of memory in GB.</dd> </dlentry><dlentry> <dt>System statistics</dt> <dd>This section displays graphs to show statistics for CPU, memory, -disk I/O, and network I/O for the host. Select <uicontrol>Collecting -data after leaving this page</uicontrol> to continue collecting data -when the host tab is out of view.</dd> +disk I/O, and network I/O for the host. </dd> </dlentry><dlentry> <dt>Software Updates</dt> <dd>This section displays information for all of the packages that @@ -49,8 +47,8 @@ If your system is Ubuntu or Debian, then add <filepath>deb</filepath> repositori you are working with yum repositories, you can add a GPG check to verify that a package from this repository have not been corrupted. Select a repository and then <uicontrol>Edit</uicontrol>. Select <uicontrol>Yes</uicontrol> to -enable GPG Check and then enter a URL to the GPG key file for the -repository.<?Pub Caret 156?></dd> +enable <uicontrol>GPG Check</uicontrol> and then enter a URL to the +GPG key file for the repository.</dd> </dlentry><dlentry> <dt>Debug reports</dt> <dd>This section displays debug reports, including name and file path. @@ -63,8 +61,8 @@ configuration and diagnostic information, such as the running kernel version, loaded modules, and system and service configuration files. The command also runs external programs to collect further information and stores this output in the resulting archive. </dd> -</dlentry></dl> -</csbody> +</dlentry></dl> +</csbody><?Pub Caret -1?> <?tm 1392659967 1?> </cshelp> -<?Pub *0000003492?> +<?Pub *0000003410?> diff --git a/ui/pages/help/en_US/network.dita b/ui/pages/help/en_US/network.dita index 25c05ff..9f67070 100644 --- a/ui/pages/help/en_US/network.dita +++ b/ui/pages/help/en_US/network.dita @@ -35,8 +35,7 @@ connection.</li> <li>Select <uicontrol>Stop</uicontrol> to end the network connection.</li> <li>Select <uicontrol>Delete</uicontrol> to delete the connection information.</li> -</ul>To create a network, click the <uicontrol>plus (+)</uicontrol> icon -in the upper right of the display. +</ul>To create a network, click the <uicontrol>plus (+)</uicontrol> icon. </csbody> <cshelp id="kimhnetwcrt" xml:lang="en-us"> <title>Create a network</title> @@ -59,10 +58,10 @@ initiate communication to guests.</dd> be contacted by external systems as if they were physical systems on the network. For bridged mode, you must specify additional destination and VLAN information.</dd> -</dlentry></dl><?Pub Caret 224?></li> +</dlentry></dl></li><?Pub Caret -2?> <li>Click <uicontrol>Create</uicontrol>.</li> </ol> </csbody> </cshelp> </cshelp> -<?Pub *0000002571?> +<?Pub *0000002536?> diff --git a/ui/pages/help/en_US/storage.dita b/ui/pages/help/en_US/storage.dita index d9a32f9..e6f995d 100644 --- a/ui/pages/help/en_US/storage.dita +++ b/ui/pages/help/en_US/storage.dita @@ -10,13 +10,17 @@ https://w3.opensource.ibm.com/projects/dita-cshelp/--> <cshelp id="kimhstor" xml:lang="en-us"> <title>Storage</title> <shortdesc>The <wintitle>Storage</wintitle> page lists the available -storage pools, including the out of box 'default' and 'ISO' storage pool. -If you want to use your own ISO, please add it to 'ISO' storage pool path.</shortdesc> +storage pools, including the out of box 'default' and 'ISO' storage +pool. If you want to use your own ISO, please add it to 'ISO' storage +pool path.</shortdesc> <csbody> For each storage pool, the following information is displayed:<dl> <dlentry> <dt>Name</dt> -<dd>Name of the storage pool and percentage used.</dd> +<dd>Name of the storage pool.</dd> +</dlentry><dlentry> +<dt>% Used</dt> +<dd>Percentage of the storage pool that is being used.</dd> </dlentry><dlentry> <dt>State</dt> <dd>State of the storage pool, active (green) or inactive (red). </dd> @@ -38,25 +42,14 @@ If you want to use your own ISO, please add it to 'ISO' storage pool path.</shor pool so that it can be used.</li> <li>Select <uicontrol>Deactivate</uicontrol> to deactivate an active storage pool.</li> +<li>Select <uicontrol>Add Volume</uicontrol> to add more volume to +an active storage pool.</li> <li>Select <uicontrol>Undefine</uicontrol> to remove an inactive storage pool.</li> </ul> To display storage volume details for a storage pool, click the -arrow on the right side of the storage pool row. Details include -the following:<dl><dlentry> -<dt>Type</dt> -<dd>The type of volume, for example, <uicontrol>file</uicontrol>.</dd> -</dlentry><dlentry> -<dt>Format</dt> -<dd>The format, varying dependent on the type.</dd> -</dlentry><dlentry> -<dt>Capacity</dt> -<dd>Size of the storage volume.</dd> -</dlentry><dlentry> -<dt>Allocation</dt> -<dd>Amount of space that is already allocated in the storage pool.</dd> -</dlentry></dl>To define a storage pool, click the <uicontrol>plus -(+)</uicontrol> icon in the upper right of the display. +arrow on the right side of the storage pool row. To define a storage +pool, click the <uicontrol>plus (+)</uicontrol> icon. </csbody> <cshelp id="kimhdefstor" xml:lang="en-us"> <title>Define a storage pool</title> @@ -90,10 +83,27 @@ the device in <uicontrol>Device path</uicontrol>.</dd> <dt><uicontrol>SCSI Fibre Channel</uicontrol></dt> <dd>Specifies a pool based on an SCSI Fibre Channel. Select which SCSI adapter to use.</dd> -</dlentry></dl><?Pub Caret 0?></li> +</dlentry></dl></li> +<li>Specify a storage path for the storage pool. The storage path +is the location in the local file system that the pool is mapped to. +The path must be unique. If the directory does not exist when the +pool is created, it will be created for you.</li> <li>Click <uicontrol>Create</uicontrol>.</li> </ol> </csbody> </cshelp> +<cshelp id="kimhdefstor" xml:lang="en-us"> +<title>Add volume</title> +<shortdesc>Adds volume to a storage pool.</shortdesc><?Pub Caret 0?> +<csbody> +<dl><dlentry> +<dt>Fetch from remote URL</dt> +<dd>Specifies a location to upload the volume from. For example: <filepath>https://my-server/fedora22.img</filepath>.</dd> +</dlentry><dlentry> +<dt>Upload a file</dt> +<dd>Specifies a location on your local system.</dd> +</dlentry></dl> +</csbody> +</cshelp> </cshelp> -<?Pub *0000003914?> +<?Pub *0000004413?> diff --git a/ui/pages/help/en_US/templates.dita b/ui/pages/help/en_US/templates.dita index 57ee9b5..1c03016 100644 --- a/ui/pages/help/en_US/templates.dita +++ b/ui/pages/help/en_US/templates.dita @@ -12,8 +12,8 @@ https://w3.opensource.ibm.com/projects/dita-cshelp/--> <shortdesc>The <wintitle>Templates</wintitle> page shows the defined virtual machine templates that can be used to create KVM guests.</shortdesc> <csbody> -For each template, the following information is displayed:<dl> -<dlentry> +For each template, the following information is displayed: +<dl><dlentry> <dt>OS</dt> <dd>Name of the operating system or distribution.</dd> </dlentry><dlentry> @@ -25,74 +25,61 @@ virtual machine templates that can be used to create KVM guests.</shortdesc> </dlentry><dlentry> <dt>Memory</dt> <dd>Amount of random access memory to be allocated, in MB.</dd> -</dlentry></dl> -The following actions can be selected for each template:<ul> +</dlentry></dl> +The following actions can be selected for each template: +<ul> <li>Select <uicontrol>Edit</uicontrol> to edit the template.</li> +<li>Select <uicontrol>Clone</uicontrol> to copy a template.</li> <li>Select <uicontrol>Delete</uicontrol> to delete the template.</li> -</ul>To add a template, click the <uicontrol>plus (+)</uicontrol> icon -in the upper right of the display. +</ul> +To add a template, click the <uicontrol>plus (+)</uicontrol> icon. </csbody> <cshelp id="kimhedittempl" xml:lang="en-us"> <title>Edit template</title> <shortdesc>Edit an existing template.</shortdesc> <csbody> -For each template, the following information is displayed: <dl> -<dlentry> -<dt>Name</dt> -<dd>Name of the template.</dd> +For each template, the following information is displayed: +<dl><dlentry> +<dt>General</dt> +<dd>Displays the name, vendor distribution, version, memory, file +path to ISO file, and graphics preferences.</dd> </dlentry><dlentry> -<dt>Vendor</dt> -<dd>The name of the company that created the operating system or distribution -that the template is configured to use.</dd> +<dt>Storage</dt> +<dd>Specify the storage pool information for the template.</dd> </dlentry><dlentry> -<dt>Version</dt> -<dd>The version of the operating system or distribution that the template -is configured to use.</dd> -</dlentry><dlentry> -<dt>CPU number</dt> -<dd>Number of processors that are defined for the template.</dd> -</dlentry><dlentry> -<dt>Memory</dt> -<dd>Amount of memory in MB to be allocated to the virtual machine.</dd> -</dlentry><dlentry> -<dt>Disk</dt> -<dd>Disk size in GB.</dd> -</dlentry><dlentry> -<dt>CDROM</dt> -<dd>File path to the location of the ISO file used to install the -KVM guest.</dd> -</dlentry><dlentry> -<dt>Storage pool</dt> -<dd>Specific storage pool or the default storage pool.</dd> +<dt>Interface</dt> +<dd>Displays the default network interfaces available to the KVM guest. +You can select multiple networks.</dd> </dlentry><dlentry> -<dt>Network</dt> -<dd>Default network interfaces available to the KVM guest. You can -select multiple networks.</dd> -</dlentry></dl> Fields that are not disabled can be edited. After -you edit a field, click <uicontrol>Save</uicontrol>. +<dt>Processor</dt> +<dd>In the <uicontrol>CPU Number</uicontrol> field, specify the number +of processors that are defined for the template.</dd> +<dd>Select to Manually set CPU topology for each guest.</dd> +</dlentry></dl><?Pub Caret 322?> </csbody> </cshelp> <cshelp id="kimhaddtempl"> <title>Add template</title> -<shortdesc>Add a template from source media. -You can add your own ISO image to 'ISO' storage pool for following discovery.</shortdesc> +<shortdesc>Add a template from source media. You can add your own +ISO image to 'ISO' storage pool for following discovery.</shortdesc> <csbody> -Select the location of the source media from the following options:<dl> -<dlentry> +Select the location of the source media from the following options: +<dl><dlentry> <dt>Local ISO image</dt> <dd>Select to scan storage pools for installation ISO images available on the system.</dd> </dlentry><dlentry> <dt>Remote ISO image</dt> <dd>Select to specify a remote location for an installation ISO image.</dd> -</dlentry></dl> +</dlentry></dl> </csbody> </cshelp> <cshelp id="kimhaddloct"> <title>Add template - local ISO image</title> <shortdesc>Add a template from a local ISO image.</shortdesc> <csbody> -The ISO images available on the system are displayed.<dl><dlentry> +The ISO images available on the system are displayed. +<dl><dlentry> <dt>OS</dt> <dd>Name of the operating system or distribution.</dd> </dlentry><dlentry> @@ -101,13 +88,14 @@ on the system.</dd> </dlentry><dlentry> <dt>Size</dt> <dd>Size of the ISO image.</dd> -</dlentry></dl> +</dlentry></dl> To create a template from an ISO image, choose from the following -options:<ul> +options: +<ul> <li>Select an ISO image from which to create a template, then click <uicontrol>Create Templates from Selected ISO</uicontrol>.</li> <li>Select <uicontrol>All</uicontrol> to create a template from each - listed ISO image, then click <uicontrol>Create Templates from Selected +listed ISO image, then click <uicontrol>Create Templates from Selected ISO</uicontrol>.</li> <li>If the ISO image that you want to use does not appear in the scan results, you can select from the following options:<ul> @@ -115,9 +103,9 @@ results, you can select from the following options:<ul> specify a path to the ISO image.</li> <li>Click <uicontrol>Search more ISOs</uicontrol> to search for more ISO images.</li> -</ul></li><?Pub Caret 0?> -</ul> +</ul></li> +</ul> </csbody> </cshelp> </cshelp> -<?Pub *0000004433?> +<?Pub *0000004089?> -- 1.9.5.msysgit.1

2 2