use strict;
use warnings;
+use Cwd 'abs_path';
-use PVE::Cluster;
+use PVE::Cluster qw (cfs_read_file cfs_write_file);;
use PVE::SafeSyslog;
use PVE::Tools qw(extract_param);
use PVE::Exception qw(raise raise_param_exc);
use PVE::JSONSchema qw(get_standard_option);
use PVE::RESTHandler;
use PVE::QemuServer;
+use PVE::QemuMigrate;
use PVE::RPCEnvironment;
use PVE::AccessControl;
use PVE::INotify;
}
};
+
+my $check_storage_access = sub {
+ my ($rpcenv, $authuser, $storecfg, $vmid, $settings, $default_storage) = @_;
+
+ PVE::QemuServer::foreach_drive($settings, sub {
+ my ($ds, $drive) = @_;
+
+ my $isCDROM = PVE::QemuServer::drive_is_cdrom($drive);
+
+ my $volid = $drive->{file};
+
+ if (!$volid || $volid eq 'none') {
+ # nothing to check
+ } elsif ($isCDROM && ($volid eq 'cdrom')) {
+ $rpcenv->check($authuser, "/", ['Sys.Console']);
+ } elsif (!$isCDROM && ($volid =~ m/^(([^:\s]+):)?(\d+(\.\d+)?)$/)) {
+ my ($storeid, $size) = ($2 || $default_storage, $3);
+ die "no storage ID specified (and no default storage)\n" if !$storeid;
+ $rpcenv->check($authuser, "/storage/$storeid", ['Datastore.AllocateSpace']);
+ } else {
+ $rpcenv->check_volume_access($authuser, $storecfg, $vmid, $volid);
+ }
+ });
+};
+
+# Note: $pool is only needed when creating a VM, because pool permissions
+# are automatically inherited if VM already exists inside a pool.
+my $create_disks = sub {
+ my ($rpcenv, $authuser, $conf, $storecfg, $vmid, $pool, $settings, $default_storage) = @_;
+
+ my $vollist = [];
+
+ my $res = {};
+ PVE::QemuServer::foreach_drive($settings, sub {
+ my ($ds, $disk) = @_;
+
+ my $volid = $disk->{file};
+
+ if (!$volid || $volid eq 'none' || $volid eq 'cdrom') {
+ $res->{$ds} = $settings->{$ds};
+ } elsif ($volid =~ m/^(([^:\s]+):)?(\d+(\.\d+)?)$/) {
+ my ($storeid, $size) = ($2 || $default_storage, $3);
+ die "no storage ID specified (and no default storage)\n" if !$storeid;
+ my $defformat = PVE::Storage::storage_default_format($storecfg, $storeid);
+ my $fmt = $disk->{format} || $defformat;
+ my $volid = PVE::Storage::vdisk_alloc($storecfg, $storeid, $vmid,
+ $fmt, undef, $size*1024*1024);
+ $disk->{file} = $volid;
+ push @$vollist, $volid;
+ delete $disk->{format}; # no longer needed
+ $res->{$ds} = PVE::QemuServer::print_drive($vmid, $disk);
+ } else {
+
+ my $path = $rpcenv->check_volume_access($authuser, $storecfg, $vmid, $volid);
+
+ my ($storeid, $volname) = PVE::Storage::parse_volume_id($volid, 1);
+
+ my $foundvolid = undef;
+
+ if ($storeid) {
+ PVE::Storage::activate_volumes($storecfg, [ $volid ]);
+ my $dl = PVE::Storage::vdisk_list($storecfg, $storeid, undef);
+
+ PVE::Storage::foreach_volid($dl, sub {
+ my ($volumeid) = @_;
+ if($volumeid eq $volid) {
+ $foundvolid = 1;
+ return;
+ }
+ });
+ }
+
+ die "image '$path' does not exists\n" if (!(-f $path || -b $path || $foundvolid));
+ $res->{$ds} = $settings->{$ds};
+ }
+ });
+
+ # free allocated images on error
+ if (my $err = $@) {
+ syslog('err', "VM $vmid creating disks failed");
+ foreach my $volid (@$vollist) {
+ eval { PVE::Storage::vdisk_free($storecfg, $volid); };
+ warn $@ if $@;
+ }
+ die $err;
+ }
+
+ # modify vm config if everything went well
+ foreach my $ds (keys %$res) {
+ $conf->{$ds} = $res->{$ds};
+ }
+
+ return $vollist;
+};
+
+my $check_vm_modify_config_perm = sub {
+ my ($rpcenv, $authuser, $vmid, $pool, $key_list) = @_;
+
+ return 1 if $authuser eq 'root@pam';
+
+ foreach my $opt (@$key_list) {
+ # disk checks need to be done somewhere else
+ next if PVE::QemuServer::valid_drivename($opt);
+
+ if ($opt eq 'sockets' || $opt eq 'cores' ||
+ $opt eq 'cpu' || $opt eq 'smp' ||
+ $opt eq 'cpulimit' || $opt eq 'cpuunits') {
+ $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.CPU']);
+ } elsif ($opt eq 'boot' || $opt eq 'bootdisk') {
+ $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Disk']);
+ } elsif ($opt eq 'memory' || $opt eq 'balloon') {
+ $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Memory']);
+ } elsif ($opt eq 'args' || $opt eq 'lock') {
+ die "only root can set '$opt' config\n";
+ } elsif ($opt eq 'cpu' || $opt eq 'kvm' || $opt eq 'acpi' ||
+ $opt eq 'vga' || $opt eq 'watchdog' || $opt eq 'tablet') {
+ $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.HWType']);
+ } elsif ($opt =~ m/^net\d+$/) {
+ $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Network']);
+ } else {
+ $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Options']);
+ }
+ }
+
+ return 1;
+};
+
__PACKAGE__->register_method({
- name => 'vmlist',
- path => '',
+ name => 'vmlist',
+ path => '',
method => 'GET',
description => "Virtual machine index (per node).",
+ permissions => {
+ description => "Only list VMs where you have VM.Audit permissons on /vms/<vmid>.",
+ user => 'all',
+ },
proxyto => 'node',
protected => 1, # qemu pid files are only readable by root
parameters => {
code => sub {
my ($param) = @_;
+ my $rpcenv = PVE::RPCEnvironment::get();
+ my $authuser = $rpcenv->get_user();
+
my $vmstatus = PVE::QemuServer::vmstatus();
- return PVE::RESTHandler::hash_to_array($vmstatus, 'vmid');
+ my $res = [];
+ foreach my $vmid (keys %$vmstatus) {
+ next if !$rpcenv->check($authuser, "/vms/$vmid", [ 'VM.Audit' ], 1);
+
+ my $data = $vmstatus->{$vmid};
+ $data->{vmid} = $vmid;
+ push @$res, $data;
+ }
+ return $res;
}});
__PACKAGE__->register_method({
- name => 'create_vm',
- path => '',
+ name => 'create_vm',
+ path => '',
method => 'POST',
- description => "Create new virtual machine.",
+ description => "Create or restore a virtual machine.",
+ permissions => {
+ description => "You need 'VM.Allocate' permissions on /vms/{vmid} or on the VM pool /pool/{pool}. If you create disks you need 'Datastore.AllocateSpace' on any used storage.",
+ check => [ 'or',
+ [ 'perm', '/vms/{vmid}', ['VM.Allocate']],
+ [ 'perm', '/pool/{pool}', ['VM.Allocate'], require_param => 'pool'],
+ ],
+ },
protected => 1,
proxyto => 'node',
parameters => {
{
node => get_standard_option('pve-node'),
vmid => get_standard_option('pve-vmid'),
+ archive => {
+ description => "The backup file.",
+ type => 'string',
+ optional => 1,
+ maxLength => 255,
+ },
+ storage => get_standard_option('pve-storage-id', {
+ description => "Default storage.",
+ optional => 1,
+ }),
+ force => {
+ optional => 1,
+ type => 'boolean',
+ description => "Allow to overwrite existing VM.",
+ requires => 'archive',
+ },
+ unique => {
+ optional => 1,
+ type => 'boolean',
+ description => "Assign a unique random ethernet address.",
+ requires => 'archive',
+ },
+ pool => {
+ optional => 1,
+ type => 'string', format => 'pve-poolid',
+ description => "Add the VM to the specified pool.",
+ },
}),
},
- returns => { type => 'null'},
+ returns => {
+ type => 'string',
+ },
code => sub {
my ($param) = @_;
- my $node = extract_param($param, 'node');
+ my $rpcenv = PVE::RPCEnvironment::get();
+
+ my $authuser = $rpcenv->get_user();
- # fixme: fork worker?
+ my $node = extract_param($param, 'node');
my $vmid = extract_param($param, 'vmid');
- my $filename = PVE::QemuServer::config_file($vmid);
- # first test (befor locking)
- die "unable to create vm $vmid: config file already exists\n"
- if -f $filename;
+ my $archive = extract_param($param, 'archive');
+
+ my $storage = extract_param($param, 'storage');
+
+ my $force = extract_param($param, 'force');
+
+ my $unique = extract_param($param, 'unique');
- my $storecfg = PVE::Storage::config();
+ my $pool = extract_param($param, 'pool');
- &$resolve_cdrom_alias($param);
+ my $filename = PVE::QemuServer::config_file($vmid);
- foreach my $opt (keys %$param) {
- if (PVE::QemuServer::valid_drivename($opt)) {
- my $drive = PVE::QemuServer::parse_drive($opt, $param->{$opt});
- raise_param_exc({ $opt => "unable to parse drive options" }) if !$drive;
+ my $storecfg = PVE::Storage::config();
- PVE::QemuServer::cleanup_drive_path($opt, $storecfg, $drive);
- $param->{$opt} = PVE::QemuServer::print_drive($vmid, $drive);
- }
- }
+ PVE::Cluster::check_cfs_quorum();
- PVE::QemuServer::add_random_macs($param);
+ if (defined($pool)) {
+ $rpcenv->check_pool_exist($pool);
+ }
- #fixme: ? syslog ('info', "VM $vmid creating new virtual machine");
-
- my $vollist = [];
+ $rpcenv->check($authuser, "/storage/$storage", ['Datastore.AllocateSpace'])
+ if defined($storage);
- my $createfn = sub {
+ if (!$archive) {
+ &$resolve_cdrom_alias($param);
- # second test (after locking test is accurate)
- die "unable to create vm $vmid: config file already exists\n"
- if -f $filename;
+ &$check_storage_access($rpcenv, $authuser, $storecfg, $vmid, $param, $storage);
- $vollist = PVE::QemuServer::create_disks($storecfg, $vmid, $param);
+ &$check_vm_modify_config_perm($rpcenv, $authuser, $vmid, $pool, [ keys %$param]);
- # try to be smart about bootdisk
- my @disks = PVE::QemuServer::disknames();
- my $firstdisk;
- foreach my $ds (reverse @disks) {
- next if !$param->{$ds};
- my $disk = PVE::QemuServer::parse_drive($ds, $param->{$ds});
- next if PVE::QemuServer::drive_is_cdrom($disk);
- $firstdisk = $ds;
+ foreach my $opt (keys %$param) {
+ if (PVE::QemuServer::valid_drivename($opt)) {
+ my $drive = PVE::QemuServer::parse_drive($opt, $param->{$opt});
+ raise_param_exc({ $opt => "unable to parse drive options" }) if !$drive;
+
+ PVE::QemuServer::cleanup_drive_path($opt, $storecfg, $drive);
+ $param->{$opt} = PVE::QemuServer::print_drive($vmid, $drive);
+ }
}
- if (!$param->{bootdisk} && $firstdisk) {
- $param->{bootdisk} = $firstdisk;
+ PVE::QemuServer::add_random_macs($param);
+ } else {
+ my $keystr = join(' ', keys %$param);
+ raise_param_exc({ archive => "option conflicts with other options ($keystr)"}) if $keystr;
+
+ if ($archive eq '-') {
+ die "pipe requires cli environment\n"
+ if $rpcenv->{type} ne 'cli';
+ } else {
+ my $path = $rpcenv->check_volume_access($authuser, $storecfg, $vmid, $archive);
+
+ PVE::Storage::activate_volumes($storecfg, [ $archive ])
+ if PVE::Storage::parse_volume_id ($archive, 1);
+
+ die "can't find archive file '$archive'\n" if !($path && -f $path);
+ $archive = $path;
}
+ }
- PVE::QemuServer::create_conf_nolock($vmid, $param);
+ my $addVMtoPoolFn = sub {
+ my $usercfg = cfs_read_file("user.cfg");
+ if (my $data = $usercfg->{pools}->{$pool}) {
+ $data->{vms}->{$vmid} = 1;
+ $usercfg->{vms}->{$vmid} = $pool;
+ cfs_write_file("user.cfg", $usercfg);
+ }
};
- eval { PVE::QemuServer::lock_config($vmid, $createfn); };
- my $err = $@;
+ my $restorefn = sub {
- if ($err) {
- foreach my $volid (@$vollist) {
- eval { PVE::Storage::vdisk_free($storecfg, $volid); };
- warn $@ if $@;
+ if (-f $filename) {
+ die "unable to restore vm $vmid: config file already exists\n"
+ if !$force;
+
+ die "unable to restore vm $vmid: vm is running\n"
+ if PVE::QemuServer::check_running($vmid);
+
+ # destroy existing data - keep empty config
+ PVE::QemuServer::destroy_vm($storecfg, $vmid, 1);
}
- die "create failed - $err";
- }
- return undef;
+ my $realcmd = sub {
+ PVE::QemuServer::restore_archive($archive, $vmid, $authuser, {
+ storage => $storage,
+ pool => $pool,
+ unique => $unique });
+
+ PVE::AccessControl::lock_user_config($addVMtoPoolFn, "can't add VM to pool") if $pool;
+ };
+
+ return $rpcenv->fork_worker('qmrestore', $vmid, $authuser, $realcmd);
+ };
+
+ my $createfn = sub {
+
+ # test after locking
+ die "unable to create vm $vmid: config file already exists\n"
+ if -f $filename;
+
+ my $realcmd = sub {
+
+ my $vollist = [];
+
+ my $conf = $param;
+
+ eval {
+
+ $vollist = &$create_disks($rpcenv, $authuser, $conf, $storecfg, $vmid, $pool, $param, $storage);
+
+ # try to be smart about bootdisk
+ my @disks = PVE::QemuServer::disknames();
+ my $firstdisk;
+ foreach my $ds (reverse @disks) {
+ next if !$conf->{$ds};
+ my $disk = PVE::QemuServer::parse_drive($ds, $conf->{$ds});
+ next if PVE::QemuServer::drive_is_cdrom($disk);
+ $firstdisk = $ds;
+ }
+
+ if (!$conf->{bootdisk} && $firstdisk) {
+ $conf->{bootdisk} = $firstdisk;
+ }
+
+ PVE::QemuServer::update_config_nolock($vmid, $conf);
+
+ };
+ my $err = $@;
+
+ if ($err) {
+ foreach my $volid (@$vollist) {
+ eval { PVE::Storage::vdisk_free($storecfg, $volid); };
+ warn $@ if $@;
+ }
+ die "create failed - $err";
+ }
+
+ PVE::AccessControl::lock_user_config($addVMtoPoolFn, "can't add VM to pool") if $pool;
+ };
+
+ return $rpcenv->fork_worker('qmcreate', $vmid, $authuser, $realcmd);
+ };
+
+ return PVE::QemuServer::lock_config_full($vmid, 1, $archive ? $restorefn : $createfn);
}});
__PACKAGE__->register_method({
name => 'vmdiridx',
- path => '{vmid}',
+ path => '{vmid}',
method => 'GET',
proxyto => 'node',
description => "Directory index",
+ permissions => {
+ user => 'all',
+ },
parameters => {
additionalProperties => 0,
properties => {
{ subdir => 'status' },
{ subdir => 'unlink' },
{ subdir => 'vncproxy' },
+ { subdir => 'migrate' },
{ subdir => 'rrd' },
{ subdir => 'rrddata' },
+ { subdir => 'monitor' },
];
-
+
return $res;
}});
__PACKAGE__->register_method({
- name => 'rrd',
- path => '{vmid}/rrd',
+ name => 'rrd',
+ path => '{vmid}/rrd',
method => 'GET',
protected => 1, # fixme: can we avoid that?
permissions => {
- path => '/vms/{vmid}',
- privs => [ 'VM.Audit' ],
+ check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
},
description => "Read VM RRD statistics (returns PNG)",
parameters => {
my ($param) = @_;
return PVE::Cluster::create_rrd_graph(
- "pve2-vm/$param->{vmid}", $param->{timeframe},
+ "pve2-vm/$param->{vmid}", $param->{timeframe},
$param->{ds}, $param->{cf});
-
+
}});
__PACKAGE__->register_method({
- name => 'rrddata',
- path => '{vmid}/rrddata',
+ name => 'rrddata',
+ path => '{vmid}/rrddata',
method => 'GET',
protected => 1, # fixme: can we avoid that?
permissions => {
- path => '/vms/{vmid}',
- privs => [ 'VM.Audit' ],
+ check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
},
description => "Read VM RRD statistics",
parameters => {
__PACKAGE__->register_method({
- name => 'vm_config',
- path => '{vmid}/config',
+ name => 'vm_config',
+ path => '{vmid}/config',
method => 'GET',
proxyto => 'node',
description => "Get virtual machine configuration.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
+ },
parameters => {
additionalProperties => 0,
properties => {
vmid => get_standard_option('pve-vmid'),
},
},
- returns => {
+ returns => {
type => "object",
- properties => {},
+ properties => {
+ digest => {
+ type => 'string',
+ description => 'SHA1 digest of configuration file. This can be used to prevent concurrent modifications.',
+ }
+ },
},
code => sub {
my ($param) = @_;
return $conf;
}});
+my $vm_is_volid_owner = sub {
+ my ($storecfg, $vmid, $volid) =@_;
+
+ if ($volid !~ m|^/|) {
+ my ($path, $owner);
+ eval { ($path, $owner) = PVE::Storage::path($storecfg, $volid); };
+ if ($owner && ($owner == $vmid)) {
+ return 1;
+ }
+ }
+
+ return undef;
+};
+
+my $test_deallocate_drive = sub {
+ my ($storecfg, $vmid, $key, $drive, $force) = @_;
+
+ if (!PVE::QemuServer::drive_is_cdrom($drive)) {
+ my $volid = $drive->{file};
+ if (&$vm_is_volid_owner($storecfg, $vmid, $volid)) {
+ if ($force || $key =~ m/^unused/) {
+ my $sid = PVE::Storage::parse_volume_id($volid);
+ return $sid;
+ }
+ }
+ }
+
+ return undef;
+};
+
+my $delete_drive = sub {
+ my ($conf, $storecfg, $vmid, $key, $drive, $force) = @_;
+
+ if (!PVE::QemuServer::drive_is_cdrom($drive)) {
+ my $volid = $drive->{file};
+ if (&$vm_is_volid_owner($storecfg, $vmid, $volid)) {
+ if ($force || $key =~ m/^unused/) {
+ eval { PVE::Storage::vdisk_free($storecfg, $volid); };
+ die $@ if $@;
+ } else {
+ PVE::QemuServer::add_unused_volume($conf, $volid, $vmid);
+ }
+ }
+ }
+
+ delete $conf->{$key};
+};
+
+my $vmconfig_delete_option = sub {
+ my ($rpcenv, $authuser, $conf, $storecfg, $vmid, $opt, $force) = @_;
+
+ return if !defined($conf->{$opt});
+
+ my $isDisk = PVE::QemuServer::valid_drivename($opt)|| ($opt =~ m/^unused/);
+
+ if ($isDisk) {
+ $rpcenv->check_vm_perm($authuser, $vmid, undef, ['VM.Config.Disk']);
+
+ my $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
+ if (my $sid = &$test_deallocate_drive($storecfg, $vmid, $opt, $drive, $force)) {
+ $rpcenv->check($authuser, "/storage/$sid", ['Datastore.Allocate']);
+ }
+ }
+
+ die "error hot-unplug $opt" if !PVE::QemuServer::vm_deviceunplug($vmid, $conf, $opt);
+
+ if ($isDisk) {
+ my $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
+ &$delete_drive($conf, $storecfg, $vmid, $opt, $drive, $force);
+ } else {
+ delete $conf->{$opt};
+ }
+
+ PVE::QemuServer::update_config_nolock($vmid, $conf, 1);
+};
+
+my $vmconfig_update_disk = sub {
+ my ($rpcenv, $authuser, $conf, $storecfg, $vmid, $opt, $value, $force) = @_;
+
+ my $drive = PVE::QemuServer::parse_drive($opt, $value);
+
+ if (PVE::QemuServer::drive_is_cdrom($drive)) { #cdrom
+ $rpcenv->check_vm_perm($authuser, $vmid, undef, ['VM.Config.CDROM']);
+ } else {
+ $rpcenv->check_vm_perm($authuser, $vmid, undef, ['VM.Config.Disk']);
+ }
+
+ if ($conf->{$opt}) {
+
+ if (my $old_drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt})) {
+
+ my $media = $drive->{media} || 'disk';
+ my $oldmedia = $old_drive->{media} || 'disk';
+ die "unable to change media type\n" if $media ne $oldmedia;
+
+ if (!PVE::QemuServer::drive_is_cdrom($old_drive) &&
+ ($drive->{file} ne $old_drive->{file})) { # delete old disks
+
+ &$vmconfig_delete_option($rpcenv, $authuser, $conf, $storecfg, $vmid, $opt, $force);
+ $conf = PVE::QemuServer::load_config($vmid); # update/reload
+ }
+
+ if($drive->{bps} != $old_drive->{bps} ||
+ $drive->{bps_rd} != $old_drive->{bps_rd} ||
+ $drive->{bps_wr} != $old_drive->{bps_wr} ||
+ $drive->{iops} != $old_drive->{iops} ||
+ $drive->{iops_rd} != $old_drive->{iops_rd} ||
+ $drive->{iops_wr} != $old_drive->{iops_wr} ) {
+ PVE::QemuServer::qemu_block_set_io_throttle($vmid,"drive-$opt",$drive->{bps}, $drive->{bps_rd}, $drive->{bps_wr}, $drive->{iops}, $drive->{iops_rd}, $drive->{iops_wr}) if !PVE::QemuServer::drive_is_cdrom($drive);
+ }
+ }
+ }
+
+ &$create_disks($rpcenv, $authuser, $conf, $storecfg, $vmid, undef, {$opt => $value});
+ PVE::QemuServer::update_config_nolock($vmid, $conf, 1);
+
+ $conf = PVE::QemuServer::load_config($vmid); # update/reload
+ $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
+
+ if (PVE::QemuServer::drive_is_cdrom($drive)) { # cdrom
+
+ if (PVE::QemuServer::check_running($vmid)) {
+ if ($drive->{file} eq 'none') {
+ PVE::QemuServer::vm_mon_cmd($vmid, "eject",force => JSON::true,device => "drive-$opt");
+ } else {
+ my $path = PVE::QemuServer::get_iso_path($storecfg, $vmid, $drive->{file});
+ PVE::QemuServer::vm_mon_cmd($vmid, "eject",force => JSON::true,device => "drive-$opt"); #force eject if locked
+ PVE::QemuServer::vm_mon_cmd($vmid, "change",device => "drive-$opt",target => "$path") if $path;
+ }
+ }
+
+ } else { # hotplug new disks
+
+ die "error hotplug $opt" if !PVE::QemuServer::vm_deviceplug($storecfg, $conf, $vmid, $opt, $drive);
+ }
+};
+
+my $vmconfig_update_net = sub {
+ my ($rpcenv, $authuser, $conf, $storecfg, $vmid, $opt, $value) = @_;
+
+ if ($conf->{$opt}) {
+ #if online update, then unplug first
+ die "error hot-unplug $opt for update" if !PVE::QemuServer::vm_deviceunplug($vmid, $conf, $opt);
+ }
+
+ $conf->{$opt} = $value;
+ PVE::QemuServer::update_config_nolock($vmid, $conf, 1);
+ $conf = PVE::QemuServer::load_config($vmid); # update/reload
+
+ my $net = PVE::QemuServer::parse_net($conf->{$opt});
+
+ die "error hotplug $opt" if !PVE::QemuServer::vm_deviceplug($storecfg, $conf, $vmid, $opt, $net);
+};
+
+my $vm_config_perm_list = [
+ 'VM.Config.Disk',
+ 'VM.Config.CDROM',
+ 'VM.Config.CPU',
+ 'VM.Config.Memory',
+ 'VM.Config.Network',
+ 'VM.Config.HWType',
+ 'VM.Config.Options',
+ ];
+
__PACKAGE__->register_method({
- name => 'update_vm',
- path => '{vmid}/config',
+ name => 'update_vm',
+ path => '{vmid}/config',
method => 'PUT',
protected => 1,
proxyto => 'node',
description => "Set virtual machine options.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', $vm_config_perm_list, any => 1],
+ },
parameters => {
additionalProperties => 0,
properties => PVE::QemuServer::json_config_properties(
{
node => get_standard_option('pve-node'),
vmid => get_standard_option('pve-vmid'),
- skiplock => {
- description => "Ignore locks - only root is allowed to use this option.",
- type => 'boolean',
- optional => 1,
- },
+ skiplock => get_standard_option('skiplock'),
delete => {
type => 'string', format => 'pve-configid-list',
description => "A list of settings you want to delete.",
optional => 1,
requires => 'delete',
},
+ digest => {
+ type => 'string',
+ description => 'Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.',
+ maxLength => 40,
+ optional => 1,
+ }
}),
},
returns => { type => 'null'},
my $rpcenv = PVE::RPCEnvironment::get();
- my $user = $rpcenv->get_user();
+ my $authuser = $rpcenv->get_user();
my $node = extract_param($param, 'node');
- # fixme: fork worker?
-
my $vmid = extract_param($param, 'vmid');
+ my $digest = extract_param($param, 'digest');
+
+ my @paramarr = (); # used for log message
+ foreach my $key (keys %$param) {
+ push @paramarr, "-$key", $param->{$key};
+ }
+
my $skiplock = extract_param($param, 'skiplock');
- raise_param_exc({ skiplock => "Only root may use this option." }) if $user ne 'root@pam';
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
+
+ my $delete_str = extract_param($param, 'delete');
- my $delete = extract_param($param, 'delete');
my $force = extract_param($param, 'force');
- die "no options specified\n" if !$delete && !scalar(keys %$param);
+ die "no options specified\n" if !$delete_str && !scalar(keys %$param);
- my $storecfg = PVE::Storage::config();
+ my $storecfg = PVE::Storage::config();
&$resolve_cdrom_alias($param);
- my $eject = {};
- my $cdchange = {};
+ # now try to verify all parameters
+
+ my @delete = ();
+ foreach my $opt (PVE::Tools::split_list($delete_str)) {
+ $opt = 'ide2' if $opt eq 'cdrom';
+ raise_param_exc({ delete => "you can't use '-$opt' and " .
+ "-delete $opt' at the same time" })
+ if defined($param->{$opt});
+
+ if (!PVE::QemuServer::option_exists($opt)) {
+ raise_param_exc({ delete => "unknown option '$opt'" });
+ }
+
+ push @delete, $opt;
+ }
foreach my $opt (keys %$param) {
if (PVE::QemuServer::valid_drivename($opt)) {
+ # cleanup drive path
my $drive = PVE::QemuServer::parse_drive($opt, $param->{$opt});
- raise_param_exc({ $opt => "unable to parse drive options" }) if !$drive;
- if ($drive->{file} eq 'eject') {
- $eject->{$opt} = 1;
- delete $param->{$opt};
- next;
- }
-
PVE::QemuServer::cleanup_drive_path($opt, $storecfg, $drive);
$param->{$opt} = PVE::QemuServer::print_drive($vmid, $drive);
-
- if (PVE::QemuServer::drive_is_cdrom($drive)) {
- $cdchange->{$opt} = PVE::QemuServer::get_iso_path($storecfg, $vmid, $drive->{file});
- }
+ } elsif ($opt =~ m/^net(\d+)$/) {
+ # add macaddr
+ my $net = PVE::QemuServer::parse_net($param->{$opt});
+ $param->{$opt} = PVE::QemuServer::print_net($net);
}
}
- foreach my $opt (PVE::Tools::split_list($delete)) {
- $opt = 'ide2' if $opt eq 'cdrom';
- die "you can't use '-$opt' and '-delete $opt' at the same time\n"
- if defined($param->{$opt});
- }
+ &$check_vm_modify_config_perm($rpcenv, $authuser, $vmid, undef, [@delete]);
- PVE::QemuServer::add_random_macs($param);
+ &$check_vm_modify_config_perm($rpcenv, $authuser, $vmid, undef, [keys %$param]);
- my $vollist = [];
+ &$check_storage_access($rpcenv, $authuser, $storecfg, $vmid, $param);
my $updatefn = sub {
my $conf = PVE::QemuServer::load_config($vmid);
+ die "checksum missmatch (file change by other user?)\n"
+ if $digest && $digest ne $conf->{digest};
+
PVE::QemuServer::check_lock($conf) if !$skiplock;
- foreach my $opt (keys %$eject) {
- if ($conf->{$opt}) {
- my $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
- $cdchange->{$opt} = undef if PVE::QemuServer::drive_is_cdrom($drive);
- } else {
- raise_param_exc({ $opt => "eject failed - drive does not exist." });
- }
- }
+ PVE::Cluster::log_msg('info', $authuser, "update VM $vmid: " . join (' ', @paramarr));
- foreach my $opt (keys %$param) {
- next if !PVE::QemuServer::valid_drivename($opt);
- next if !$conf->{$opt};
- my $old_drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
- next if PVE::QemuServer::drive_is_cdrom($old_drive);
- my $new_drive = PVE::QemuServer::parse_drive($opt, $param->{$opt});
- if ($new_drive->{file} ne $old_drive->{file}) {
- my ($path, $owner);
- eval { ($path, $owner) = PVE::Storage::path($storecfg, $old_drive->{file}); };
- if ($owner && ($owner == $vmid)) {
- PVE::QemuServer::add_unused_volume($conf, $param, $old_drive->{file});
- }
- }
+ foreach my $opt (@delete) { # delete
+ $conf = PVE::QemuServer::load_config($vmid); # update/reload
+ &$vmconfig_delete_option($rpcenv, $authuser, $conf, $storecfg, $vmid, $opt, $force);
}
- my $unset = {};
+ foreach my $opt (keys %$param) { # add/change
- foreach my $opt (PVE::Tools::split_list($delete)) {
- $opt = 'ide2' if $opt eq 'cdrom';
- if (!PVE::QemuServer::option_exists($opt)) {
- raise_param_exc({ delete => "unknown option '$opt'" });
- }
- next if !defined($conf->{$opt});
- if (PVE::QemuServer::valid_drivename($opt)) {
- my $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
- if (PVE::QemuServer::drive_is_cdrom($drive)) {
- $cdchange->{$opt} = undef;
- } else {
- my $volid = $drive->{file};
-
- if ($volid !~ m|^/|) {
- my ($path, $owner);
- eval { ($path, $owner) = PVE::Storage::path($storecfg, $volid); };
- if ($owner && ($owner == $vmid)) {
- if ($force) {
- push @$vollist, $volid;
- } else {
- PVE::QemuServer::add_unused_volume($conf, $param, $volid);
- }
- }
- }
- }
- } elsif ($opt =~ m/^unused/) {
- push @$vollist, $conf->{$opt};
- }
+ $conf = PVE::QemuServer::load_config($vmid); # update/reload
- $unset->{$opt} = 1;
- }
+ next if $conf->{$opt} && ($param->{$opt} eq $conf->{$opt}); # skip if nothing changed
+
+ if (PVE::QemuServer::valid_drivename($opt)) {
- PVE::QemuServer::create_disks($storecfg, $vmid, $param);
+ &$vmconfig_update_disk($rpcenv, $authuser, $conf, $storecfg, $vmid,
+ $opt, $param->{$opt}, $force);
+
+ } elsif ($opt =~ m/^net(\d+)$/) { #nics
- PVE::QemuServer::change_config_nolock($vmid, $param, $unset, 1);
+ &$vmconfig_update_net($rpcenv, $authuser, $conf, $storecfg, $vmid,
+ $opt, $param->{$opt});
- return if !PVE::QemuServer::check_running($vmid);
+ } else {
- foreach my $opt (keys %$cdchange) {
- my $qdn = PVE::QemuServer::qemu_drive_name($opt, 'cdrom');
- my $path = $cdchange->{$opt};
- PVE::QemuServer::vm_monitor_command($vmid, "eject $qdn", 0);
- PVE::QemuServer::vm_monitor_command($vmid, "change $qdn \"$path\"", 0) if $path;
+ $conf->{$opt} = $param->{$opt};
+ PVE::QemuServer::update_config_nolock($vmid, $conf, 1);
+ }
}
};
PVE::QemuServer::lock_config($vmid, $updatefn);
- foreach my $volid (@$vollist) {
- eval { PVE::Storage::vdisk_free($storecfg, $volid); };
- # fixme: log ?
- warn $@ if $@;
- }
-
return undef;
}});
__PACKAGE__->register_method({
- name => 'destroy_vm',
- path => '{vmid}',
+ name => 'destroy_vm',
+ path => '{vmid}',
method => 'DELETE',
protected => 1,
proxyto => 'node',
description => "Destroy the vm (also delete all used/owned volumes).",
+ permissions => {
+ check => [ 'perm', '/vms/{vmid}', ['VM.Allocate']],
+ },
parameters => {
additionalProperties => 0,
properties => {
node => get_standard_option('pve-node'),
vmid => get_standard_option('pve-vmid'),
+ skiplock => get_standard_option('skiplock'),
},
},
- returns => { type => 'null' },
+ returns => {
+ type => 'string',
+ },
code => sub {
my ($param) = @_;
my $rpcenv = PVE::RPCEnvironment::get();
- my $user = $rpcenv->get_user();
+ my $authuser = $rpcenv->get_user();
my $vmid = $param->{vmid};
my $skiplock = $param->{skiplock};
- raise_param_exc({ skiplock => "Only root may use this option." })
- if $user ne 'root@pam';
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
- my $storecfg = PVE::Storage::config();
+ # test if VM exists
+ my $conf = PVE::QemuServer::load_config($vmid);
- PVE::QemuServer::vm_destroy($storecfg, $vmid, $skiplock);
+ my $storecfg = PVE::Storage::config();
- return undef;
- }});
+ my $delVMfromPoolFn = sub {
+ my $usercfg = cfs_read_file("user.cfg");
+ if (my $pool = $usercfg->{vms}->{$vmid}) {
+ if (my $data = $usercfg->{pools}->{$pool}) {
+ delete $data->{vms}->{$vmid};
+ delete $usercfg->{vms}->{$vmid};
+ cfs_write_file("user.cfg", $usercfg);
+ }
+ }
+ };
-__PACKAGE__->register_method({
- name => 'unlink',
- path => '{vmid}/unlink',
- method => 'PUT',
- protected => 1,
- proxyto => 'node',
- description => "Unlink/delete disk images.",
- parameters => {
+ my $realcmd = sub {
+ my $upid = shift;
+
+ syslog('info', "destroy VM $vmid: $upid\n");
+
+ PVE::QemuServer::vm_destroy($storecfg, $vmid, $skiplock);
+
+ PVE::AccessControl::lock_user_config($delVMfromPoolFn, "pool cleanup failed");
+ };
+
+ return $rpcenv->fork_worker('qmdestroy', $vmid, $authuser, $realcmd);
+ }});
+
+__PACKAGE__->register_method({
+ name => 'unlink',
+ path => '{vmid}/unlink',
+ method => 'PUT',
+ protected => 1,
+ proxyto => 'node',
+ description => "Unlink/delete disk images.",
+ permissions => {
+ check => [ 'perm', '/vms/{vmid}', ['VM.Config.Disk']],
+ },
+ parameters => {
additionalProperties => 0,
properties => {
node => get_standard_option('pve-node'),
my $sslcert;
__PACKAGE__->register_method({
- name => 'vncproxy',
- path => '{vmid}/vncproxy',
+ name => 'vncproxy',
+ path => '{vmid}/vncproxy',
method => 'POST',
protected => 1,
permissions => {
- path => '/vms/{vmid}',
- privs => [ 'VM.Console' ],
+ check => ['perm', '/vms/{vmid}', [ 'VM.Console' ]],
},
description => "Creates a TCP VNC proxy connections.",
parameters => {
vmid => get_standard_option('pve-vmid'),
},
},
- returns => {
+ returns => {
additionalProperties => 0,
properties => {
user => { type => 'string' },
my $rpcenv = PVE::RPCEnvironment::get();
- my $user = $rpcenv->get_user();
- my $ticket = PVE::AccessControl::assemble_ticket($user);
+ my $authuser = $rpcenv->get_user();
my $vmid = $param->{vmid};
my $node = $param->{node};
+ my $authpath = "/vms/$vmid";
+
+ my $ticket = PVE::AccessControl::assemble_vnc_ticket($authuser, $authpath);
+
$sslcert = PVE::Tools::file_get_contents("/etc/pve/pve-root-ca.pem", 8192)
if !$sslcert;
my $port = PVE::Tools::next_vnc_port();
my $remip;
-
- if ($node ne PVE::INotify::nodename()) {
+
+ if ($node ne 'localhost' && $node ne PVE::INotify::nodename()) {
$remip = PVE::Cluster::remote_node_ip($node);
}
my $remcmd = $remip ? ['/usr/bin/ssh', '-T', '-o', 'BatchMode=yes',
'-c', 'blowfish-cbc', $remip] : [];
- my $timeout = 10;
+ my $timeout = 10;
my $realcmd = sub {
my $upid = shift;
my $qmstr = join(' ', @$qmcmd);
# also redirect stderr (else we get RFB protocol errors)
- my @cmd = ('/bin/nc', '-l', '-p', $port, '-w', $timeout, '-c', "$qmstr 2>/dev/null");
-
- my $cmdstr = join(' ', @cmd);
- syslog('info', "CMD3: $cmdstr");
+ my $cmd = ['/bin/nc', '-l', '-p', $port, '-w', $timeout, '-c', "$qmstr 2>/dev/null"];
- if (system(@cmd) != 0) {
- my $msg = "VM $vmid vnc proxy failed - $?";
- syslog('err', $msg);
- return;
- }
+ PVE::Tools::run_command($cmd);
return;
};
- my $upid = $rpcenv->fork_worker('vncproxy', $vmid, $user, $realcmd);
+ my $upid = $rpcenv->fork_worker('vncproxy', $vmid, $authuser, $realcmd);
return {
- user => $user,
+ user => $authuser,
ticket => $ticket,
- port => $port,
- upid => $upid,
- cert => $sslcert,
+ port => $port,
+ upid => $upid,
+ cert => $sslcert,
};
}});
__PACKAGE__->register_method({
- name => 'vm_status',
+ name => 'vmcmdidx',
path => '{vmid}/status',
method => 'GET',
proxyto => 'node',
+ description => "Directory index",
+ permissions => {
+ user => 'all',
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ },
+ },
+ returns => {
+ type => 'array',
+ items => {
+ type => "object",
+ properties => {
+ subdir => { type => 'string' },
+ },
+ },
+ links => [ { rel => 'child', href => "{subdir}" } ],
+ },
+ code => sub {
+ my ($param) = @_;
+
+ # test if VM exists
+ my $conf = PVE::QemuServer::load_config($param->{vmid});
+
+ my $res = [
+ { subdir => 'current' },
+ { subdir => 'start' },
+ { subdir => 'stop' },
+ ];
+
+ return $res;
+ }});
+
+my $vm_is_ha_managed = sub {
+ my ($vmid) = @_;
+
+ my $cc = PVE::Cluster::cfs_read_file('cluster.conf');
+ if (PVE::Cluster::cluster_conf_lookup_pvevm($cc, 0, $vmid, 1)) {
+ return 1;
+ }
+ return 0;
+};
+
+__PACKAGE__->register_method({
+ name => 'vm_status',
+ path => '{vmid}/status/current',
+ method => 'GET',
+ proxyto => 'node',
protected => 1, # qemu pid files are only readable by root
description => "Get virtual machine status.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.Audit' ]],
+ },
parameters => {
additionalProperties => 0,
properties => {
# test if VM exists
my $conf = PVE::QemuServer::load_config($param->{vmid});
- my $vmstatus = PVE::QemuServer::vmstatus($param->{vmid});
+ my $vmstatus = PVE::QemuServer::vmstatus($param->{vmid}, 1);
+ my $status = $vmstatus->{$param->{vmid}};
+
+ $status->{ha} = &$vm_is_ha_managed($param->{vmid});
- return $vmstatus->{$param->{vmid}};
+ return $status;
}});
__PACKAGE__->register_method({
- name => 'vm_command',
- path => '{vmid}/status',
- method => 'PUT',
+ name => 'vm_start',
+ path => '{vmid}/status/start',
+ method => 'POST',
protected => 1,
proxyto => 'node',
- description => "Set virtual machine status.",
+ description => "Start virtual machine.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
+ },
parameters => {
additionalProperties => 0,
properties => {
node => get_standard_option('pve-node'),
vmid => get_standard_option('pve-vmid'),
- skiplock => {
- description => "Ignore locks - only root is allowed to use this option.",
- type => 'boolean',
+ skiplock => get_standard_option('skiplock'),
+ stateuri => get_standard_option('pve-qm-stateuri'),
+ },
+ },
+ returns => {
+ type => 'string',
+ },
+ code => sub {
+ my ($param) = @_;
+
+ my $rpcenv = PVE::RPCEnvironment::get();
+
+ my $authuser = $rpcenv->get_user();
+
+ my $node = extract_param($param, 'node');
+
+ my $vmid = extract_param($param, 'vmid');
+
+ my $stateuri = extract_param($param, 'stateuri');
+ raise_param_exc({ stateuri => "Only root may use this option." })
+ if $stateuri && $authuser ne 'root@pam';
+
+ my $skiplock = extract_param($param, 'skiplock');
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
+
+ my $storecfg = PVE::Storage::config();
+
+ if (&$vm_is_ha_managed($vmid) && !$stateuri &&
+ $rpcenv->{type} ne 'ha') {
+
+ my $hacmd = sub {
+ my $upid = shift;
+
+ my $service = "pvevm:$vmid";
+
+ my $cmd = ['clusvcadm', '-e', $service, '-m', $node];
+
+ print "Executing HA start for VM $vmid\n";
+
+ PVE::Tools::run_command($cmd);
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('hastart', $vmid, $authuser, $hacmd);
+
+ } else {
+
+ my $realcmd = sub {
+ my $upid = shift;
+
+ syslog('info', "start VM $vmid: $upid\n");
+
+ PVE::QemuServer::vm_start($storecfg, $vmid, $stateuri, $skiplock);
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('qmstart', $vmid, $authuser, $realcmd);
+ }
+ }});
+
+__PACKAGE__->register_method({
+ name => 'vm_stop',
+ path => '{vmid}/status/stop',
+ method => 'POST',
+ protected => 1,
+ proxyto => 'node',
+ description => "Stop virtual machine.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ skiplock => get_standard_option('skiplock'),
+ timeout => {
+ description => "Wait maximal timeout seconds.",
+ type => 'integer',
+ minimum => 0,
optional => 1,
},
- command => {
- type => 'string',
- enum => [qw(start stop reset shutdown cad suspend resume) ],
- },
+ keepActive => {
+ description => "Do not decativate storage volumes.",
+ type => 'boolean',
+ optional => 1,
+ default => 0,
+ }
},
},
- returns => { type => 'null'},
+ returns => {
+ type => 'string',
+ },
code => sub {
my ($param) = @_;
my $rpcenv = PVE::RPCEnvironment::get();
- my $user = $rpcenv->get_user();
+ my $authuser = $rpcenv->get_user();
my $node = extract_param($param, 'node');
- # fixme: proxy to correct node
- # fixme: fork worker?
+ my $vmid = extract_param($param, 'vmid');
+
+ my $skiplock = extract_param($param, 'skiplock');
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
+
+ my $keepActive = extract_param($param, 'keepActive');
+ raise_param_exc({ keepActive => "Only root may use this option." })
+ if $keepActive && $authuser ne 'root@pam';
+
+ my $storecfg = PVE::Storage::config();
+
+ if (&$vm_is_ha_managed($vmid) && $rpcenv->{type} ne 'ha') {
+
+ my $hacmd = sub {
+ my $upid = shift;
+
+ my $service = "pvevm:$vmid";
+
+ my $cmd = ['clusvcadm', '-d', $service];
+
+ print "Executing HA stop for VM $vmid\n";
+
+ PVE::Tools::run_command($cmd);
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('hastop', $vmid, $authuser, $hacmd);
+
+ } else {
+ my $realcmd = sub {
+ my $upid = shift;
+
+ syslog('info', "stop VM $vmid: $upid\n");
+
+ PVE::QemuServer::vm_stop($storecfg, $vmid, $skiplock, 0,
+ $param->{timeout}, 0, 1, $keepActive);
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('qmstop', $vmid, $authuser, $realcmd);
+ }
+ }});
+
+__PACKAGE__->register_method({
+ name => 'vm_reset',
+ path => '{vmid}/status/reset',
+ method => 'POST',
+ protected => 1,
+ proxyto => 'node',
+ description => "Reset virtual machine.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ skiplock => get_standard_option('skiplock'),
+ },
+ },
+ returns => {
+ type => 'string',
+ },
+ code => sub {
+ my ($param) = @_;
+
+ my $rpcenv = PVE::RPCEnvironment::get();
+
+ my $authuser = $rpcenv->get_user();
+
+ my $node = extract_param($param, 'node');
my $vmid = extract_param($param, 'vmid');
my $skiplock = extract_param($param, 'skiplock');
- raise_param_exc({ skiplock => "Only root may use this option." })
- if $user ne 'root@pam';
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
- my $command = $param->{command};
+ die "VM $vmid not running\n" if !PVE::QemuServer::check_running($vmid);
+
+ my $realcmd = sub {
+ my $upid = shift;
- my $storecfg = PVE::Storage::config();
-
- if ($command eq 'start') {
- my $statefile = undef; # fixme: --incoming parameter
- PVE::QemuServer::vm_start($storecfg, $vmid, $statefile, $skiplock);
- } elsif ($command eq 'stop') {
- PVE::QemuServer::vm_stop($vmid, $skiplock);
- } elsif ($command eq 'reset') {
PVE::QemuServer::vm_reset($vmid, $skiplock);
- } elsif ($command eq 'shutdown') {
- PVE::QemuServer::vm_shutdown($vmid, $skiplock);
- } elsif ($command eq 'suspend') {
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('qmreset', $vmid, $authuser, $realcmd);
+ }});
+
+__PACKAGE__->register_method({
+ name => 'vm_shutdown',
+ path => '{vmid}/status/shutdown',
+ method => 'POST',
+ protected => 1,
+ proxyto => 'node',
+ description => "Shutdown virtual machine.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ skiplock => get_standard_option('skiplock'),
+ timeout => {
+ description => "Wait maximal timeout seconds.",
+ type => 'integer',
+ minimum => 0,
+ optional => 1,
+ },
+ forceStop => {
+ description => "Make sure the VM stops.",
+ type => 'boolean',
+ optional => 1,
+ default => 0,
+ },
+ keepActive => {
+ description => "Do not decativate storage volumes.",
+ type => 'boolean',
+ optional => 1,
+ default => 0,
+ }
+ },
+ },
+ returns => {
+ type => 'string',
+ },
+ code => sub {
+ my ($param) = @_;
+
+ my $rpcenv = PVE::RPCEnvironment::get();
+
+ my $authuser = $rpcenv->get_user();
+
+ my $node = extract_param($param, 'node');
+
+ my $vmid = extract_param($param, 'vmid');
+
+ my $skiplock = extract_param($param, 'skiplock');
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
+
+ my $keepActive = extract_param($param, 'keepActive');
+ raise_param_exc({ keepActive => "Only root may use this option." })
+ if $keepActive && $authuser ne 'root@pam';
+
+ my $storecfg = PVE::Storage::config();
+
+ my $realcmd = sub {
+ my $upid = shift;
+
+ syslog('info', "shutdown VM $vmid: $upid\n");
+
+ PVE::QemuServer::vm_stop($storecfg, $vmid, $skiplock, 0, $param->{timeout},
+ 1, $param->{forceStop}, $keepActive);
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('qmshutdown', $vmid, $authuser, $realcmd);
+ }});
+
+__PACKAGE__->register_method({
+ name => 'vm_suspend',
+ path => '{vmid}/status/suspend',
+ method => 'POST',
+ protected => 1,
+ proxyto => 'node',
+ description => "Suspend virtual machine.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ skiplock => get_standard_option('skiplock'),
+ },
+ },
+ returns => {
+ type => 'string',
+ },
+ code => sub {
+ my ($param) = @_;
+
+ my $rpcenv = PVE::RPCEnvironment::get();
+
+ my $authuser = $rpcenv->get_user();
+
+ my $node = extract_param($param, 'node');
+
+ my $vmid = extract_param($param, 'vmid');
+
+ my $skiplock = extract_param($param, 'skiplock');
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
+
+ die "VM $vmid not running\n" if !PVE::QemuServer::check_running($vmid);
+
+ my $realcmd = sub {
+ my $upid = shift;
+
+ syslog('info', "suspend VM $vmid: $upid\n");
+
PVE::QemuServer::vm_suspend($vmid, $skiplock);
- } elsif ($command eq 'resume') {
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('qmsuspend', $vmid, $authuser, $realcmd);
+ }});
+
+__PACKAGE__->register_method({
+ name => 'vm_resume',
+ path => '{vmid}/status/resume',
+ method => 'POST',
+ protected => 1,
+ proxyto => 'node',
+ description => "Resume virtual machine.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.PowerMgmt' ]],
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ skiplock => get_standard_option('skiplock'),
+ },
+ },
+ returns => {
+ type => 'string',
+ },
+ code => sub {
+ my ($param) = @_;
+
+ my $rpcenv = PVE::RPCEnvironment::get();
+
+ my $authuser = $rpcenv->get_user();
+
+ my $node = extract_param($param, 'node');
+
+ my $vmid = extract_param($param, 'vmid');
+
+ my $skiplock = extract_param($param, 'skiplock');
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
+
+ die "VM $vmid not running\n" if !PVE::QemuServer::check_running($vmid);
+
+ my $realcmd = sub {
+ my $upid = shift;
+
+ syslog('info', "resume VM $vmid: $upid\n");
+
PVE::QemuServer::vm_resume($vmid, $skiplock);
- } elsif ($command eq 'cad') {
- PVE::QemuServer::vm_cad($vmid, $skiplock);
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('qmresume', $vmid, $authuser, $realcmd);
+ }});
+
+__PACKAGE__->register_method({
+ name => 'vm_sendkey',
+ path => '{vmid}/sendkey',
+ method => 'PUT',
+ protected => 1,
+ proxyto => 'node',
+ description => "Send key event to virtual machine.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.Console' ]],
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ skiplock => get_standard_option('skiplock'),
+ key => {
+ description => "The key (qemu monitor encoding).",
+ type => 'string'
+ }
+ },
+ },
+ returns => { type => 'null'},
+ code => sub {
+ my ($param) = @_;
+
+ my $rpcenv = PVE::RPCEnvironment::get();
+
+ my $authuser = $rpcenv->get_user();
+
+ my $node = extract_param($param, 'node');
+
+ my $vmid = extract_param($param, 'vmid');
+
+ my $skiplock = extract_param($param, 'skiplock');
+ raise_param_exc({ skiplock => "Only root may use this option." })
+ if $skiplock && $authuser ne 'root@pam';
+
+ PVE::QemuServer::vm_sendkey($vmid, $skiplock, $param->{key});
+
+ return;
+ }});
+
+__PACKAGE__->register_method({
+ name => 'migrate_vm',
+ path => '{vmid}/migrate',
+ method => 'POST',
+ protected => 1,
+ proxyto => 'node',
+ description => "Migrate virtual machine. Creates a new migration task.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.Migrate' ]],
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ target => get_standard_option('pve-node', { description => "Target node." }),
+ online => {
+ type => 'boolean',
+ description => "Use online/live migration.",
+ optional => 1,
+ },
+ force => {
+ type => 'boolean',
+ description => "Allow to migrate VMs which use local devices. Only root may use this option.",
+ optional => 1,
+ },
+ },
+ },
+ returns => {
+ type => 'string',
+ description => "the task ID.",
+ },
+ code => sub {
+ my ($param) = @_;
+
+ my $rpcenv = PVE::RPCEnvironment::get();
+
+ my $authuser = $rpcenv->get_user();
+
+ my $target = extract_param($param, 'target');
+
+ my $localnode = PVE::INotify::nodename();
+ raise_param_exc({ target => "target is local node."}) if $target eq $localnode;
+
+ PVE::Cluster::check_cfs_quorum();
+
+ PVE::Cluster::check_node_exists($target);
+
+ my $targetip = PVE::Cluster::remote_node_ip($target);
+
+ my $vmid = extract_param($param, 'vmid');
+
+ raise_param_exc({ force => "Only root may use this option." })
+ if $param->{force} && $authuser ne 'root@pam';
+
+ # test if VM exists
+ my $conf = PVE::QemuServer::load_config($vmid);
+
+ # try to detect errors early
+
+ PVE::QemuServer::check_lock($conf);
+
+ if (PVE::QemuServer::check_running($vmid)) {
+ die "cant migrate running VM without --online\n"
+ if !$param->{online};
+ }
+
+ my $storecfg = PVE::Storage::config();
+ PVE::QemuServer::check_storage_availability($storecfg, $conf, $target);
+
+ if (&$vm_is_ha_managed($vmid) && $rpcenv->{type} ne 'ha') {
+
+ my $hacmd = sub {
+ my $upid = shift;
+
+ my $service = "pvevm:$vmid";
+
+ my $cmd = ['clusvcadm', '-M', $service, '-m', $target];
+
+ print "Executing HA migrate for VM $vmid to node $target\n";
+
+ PVE::Tools::run_command($cmd);
+
+ return;
+ };
+
+ return $rpcenv->fork_worker('hamigrate', $vmid, $authuser, $hacmd);
+
} else {
- raise_param_exc({ command => "unknown command '$command'" })
+
+ my $realcmd = sub {
+ my $upid = shift;
+
+ PVE::QemuMigrate->migrate($target, $targetip, $vmid, $param);
+ };
+
+ return $rpcenv->fork_worker('qmigrate', $vmid, $authuser, $realcmd);
}
- return undef;
}});
+__PACKAGE__->register_method({
+ name => 'monitor',
+ path => '{vmid}/monitor',
+ method => 'POST',
+ protected => 1,
+ proxyto => 'node',
+ description => "Execute Qemu monitor commands.",
+ permissions => {
+ check => ['perm', '/vms/{vmid}', [ 'VM.Monitor' ]],
+ },
+ parameters => {
+ additionalProperties => 0,
+ properties => {
+ node => get_standard_option('pve-node'),
+ vmid => get_standard_option('pve-vmid'),
+ command => {
+ type => 'string',
+ description => "The monitor command.",
+ }
+ },
+ },
+ returns => { type => 'string'},
+ code => sub {
+ my ($param) = @_;
+
+ my $vmid = $param->{vmid};
+
+ my $conf = PVE::QemuServer::load_config ($vmid); # check if VM exists
+
+ my $res = '';
+ eval {
+ $res = PVE::QemuServer::vm_human_monitor_command($vmid, $param->{command});
+ };
+ $res = "ERROR: $@" if $@;
+
+ return $res;
+ }});
1;