/* 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;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
namespace XenAdmin.Actions
{
public enum SnapshotType { DISK, DISK_AND_MEMORY, QUIESCED_DISK };
public class VMSnapshotCreateAction : AsyncAction
{
public const string VNC_SNAPSHOT = "XenCenter.VNCSnapshot";
private readonly string _newName;
private readonly string _newDescription;
private readonly SnapshotType _type;
///
/// 3 parameters: vm, username, password (username and password can be null)
///
private readonly Func _screenShotProvider;
public VMSnapshotCreateAction(VM vm, string newName, string newDescription,
SnapshotType type, Func screenShotProvider)
: base(vm.Connection, string.Format(Messages.ACTION_VM_SNAPSHOT_TITLE, vm.Name()))
{
VM = vm;
_newName = newName;
_newDescription = newDescription;
_type = type;
_screenShotProvider = screenShotProvider;
switch (type)
{
case SnapshotType.QUIESCED_DISK:
ApiMethodsToRoleCheck.Add("vm.snapshot_with_quiesce");
break;
case SnapshotType.DISK_AND_MEMORY:
ApiMethodsToRoleCheck.Add("vm.checkpoint");
break;
case SnapshotType.DISK:
ApiMethodsToRoleCheck.Add("vm.snapshot");
break;
}
ApiMethodsToRoleCheck.Add("vm.set_name_description", "vm.create_new_blob");
}
protected override void Run()
{
Description = Messages.SNAPSHOTTING;
// Take screenshot before snapshot begins, to avoid possible console switching (CA-211369)
Image screenshot = null;
try
{
if (VM.power_state == vm_power_state.Running && _type == SnapshotType.DISK_AND_MEMORY)
{
// use the sudo credentials for the screenshot (can be null) (CA-91132)
screenshot = _screenShotProvider(VM, sudoUsername, sudoPassword);
}
}
catch
{
//Ignore; the screenshot is optional, we will do without it (CA-37095/CA-37103)
}
switch (_type)
{
case SnapshotType.QUIESCED_DISK:
RelatedTask = VM.async_snapshot_with_quiesce(Session, VM.opaque_ref, _newName);
break;
case SnapshotType.DISK_AND_MEMORY:
RelatedTask = VM.async_checkpoint(Session, VM.opaque_ref, _newName);
break;
default:
RelatedTask = VM.async_snapshot(Session, VM.opaque_ref, _newName);
break;
}
PollToCompletion();
if (string.IsNullOrEmpty(Result))
return;
VM.set_name_description(Session, Result, _newDescription);
SaveImageInBlob(Result, screenshot);
Description = Messages.SNAPSHOTTED;
}
private void SaveImageInBlob(string newVmRef, Image image)
{
if (image == null)
return;
XenRef blobRef = VM.create_new_blob(Session, newVmRef, VNC_SNAPSHOT, "image/jpeg", false);
Blob blob = Connection.WaitForCache(blobRef);
if (blob == null)
return;
using (MemoryStream saveStream = new MemoryStream())
{
image.Save(saveStream, ImageFormat.Jpeg);
saveStream.Position = 0;
blob.Save(saveStream, Session);
}
}
}
}