/* Copyright (c) Citrix Systems Inc. * All rights reserved. * * Redistribution and use in source and binary forms, * with or without modification, are permitted provided * that the following conditions are met: * * * Redistributions of source code must retain the above * copyright notice, this list of conditions and the * following disclaimer. * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the * following disclaimer in the documentation and/or other * materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. */ using System; using XenAPI; namespace XenAdmin.Actions { /// /// This action installs the PV tools on a selected windows VM. /// public class InstallPVToolsAction : AsyncAction { private static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); private readonly Action _xsToolsNotFound; private readonly bool _searchHiddenIsOs; // The 'well known' name of the ISO containing our PV tools. public const string ISONameOld = "xswindrivers.iso"; public const string ISONameNew = "xs-tools.iso"; public InstallPVToolsAction(VM vm, Action xsToolsNotfound, bool searchHiddenISOs) : base(vm.Connection, string.Format(Messages.INSTALLTOOLS_TITLE, vm.Name)) { VM = vm; _xsToolsNotFound = xsToolsNotfound; _searchHiddenIsOs = searchHiddenISOs; #region RBAC Dependencies foreach (SR sr in VM.Connection.Cache.SRs) { if (sr.IsToolsSR && sr.IsBroken()) { ApiMethodsToRoleCheck.Add("pbd.plug"); ApiMethodsToRoleCheck.Add("pbd.create"); break; } } ApiMethodsToRoleCheck.Add("vbd.eject"); ApiMethodsToRoleCheck.Add("vbd.insert"); ApiMethodsToRoleCheck.AddRange(Role.CommonSessionApiList); #endregion } protected override void Run() { // check the xstools sr is present, if not try and repair it foreach(SR sr in VM.Connection.Cache.SRs) { if (sr.IsToolsSR && sr.IsBroken()) { try { SrRepairAction action = new SrRepairAction(sr.Connection, sr,false); action.RunExternal(Session); } catch (Failure) { _xsToolsNotFound(); } } } // Check the version (if any) of the PV tools already on this host... VM_guest_metrics guestMetrics = Connection.Resolve(VM.guest_metrics); if (guestMetrics != null && !VM.HasNewVirtualisationStates && guestMetrics.PV_drivers_up_to_date) { this.Description = Messages.INSTALLTOOLS_EXIST; return; } // Check that the VM has a cd-rom... XenAPI.VBD cdrom = VM.FindVMCDROM(); if (cdrom == null) { Description = Messages.INSTALLTOOLS_COULDNOTFIND_CD; return; } // Find the tools ISO... XenAPI.VDI winIso = findWinISO(_searchHiddenIsOs); if (winIso == null) { // Could not find the windows PV drivers ISO. Description = Messages.INSTALLTOOLS_COULDNOTFIND_WIN; return; } Description = Messages.INSTALLTOOLS_STARTING; // Eject anything that's currently in the cd-rom... if (!cdrom.empty) { XenAPI.VBD.eject(Session, cdrom.opaque_ref); } // Insert the tools ISO... XenAPI.VBD.insert(Session, cdrom.opaque_ref, winIso.opaque_ref); // done(ish)... Description = Messages.INSTALLTOOLS_DONE; } // Find the windows ISO disc by scanning the SRs - will return // null if the disc could not be found... private XenAPI.VDI findWinISO(bool searchHiddenISOs) { foreach (SR sr in Connection.Cache.SRs) { if (XenAPI.SR.SRTypes.iso.ToString() == sr.content_type) { foreach (VDI vdi in Connection.ResolveAllShownXenModelObjects(sr.VDIs, searchHiddenISOs)) { if (ISONameOld.Equals(vdi.name_label) || ISONameNew.Equals(vdi.name_label)) { return vdi; } } } } return null; } } }