1 package PVE
::QemuServer
::Memory
;
6 use PVE
::JSONSchema
qw(parse_property_string);
7 use PVE
::Tools
qw(run_command lock_file lock_file_full file_read_firstline dir_glob_foreach);
8 use PVE
::Exception
qw(raise raise_param_exc);
11 use PVE
::QemuServer
::Helpers
qw(parse_number_sets);
12 use PVE
::QemuServer
::Monitor
qw(mon_cmd);
19 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
20 description
=> "CPUs accessing this NUMA node.",
21 format_description
=> "id[-id];...",
25 description
=> "Amount of memory this NUMA node provides.",
30 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
31 description
=> "Host NUMA nodes to use.",
32 format_description
=> "id[-id];...",
37 enum
=> [qw(preferred bind interleave)],
38 description
=> "NUMA allocation policy.",
42 PVE
::JSONSchema
::register_format
('pve-qm-numanode', $numa_fmt);
45 type
=> 'string', format
=> $numa_fmt,
46 description
=> "NUMA topology.",
48 PVE
::JSONSchema
::register_standard_option
("pve-qm-numanode", $numadesc);
53 my $res = parse_property_string
($numa_fmt, $data);
54 $res->{cpus
} = parse_number_sets
($res->{cpus
}) if defined($res->{cpus
});
55 $res->{hostnodes
} = parse_number_sets
($res->{hostnodes
}) if defined($res->{hostnodes
});
62 sub get_host_phys_address_bits
{
63 return $_host_bits if defined($_host_bits);
65 my $fh = IO
::File-
>new ('/proc/cpuinfo', "r") or return;
66 while (defined(my $line = <$fh>)) {
67 # hopefully we never need to care about mixed (big.LITTLE) archs
68 if ($line =~ m/^address sizes\s*:\s*(\d+)\s*bits physical/i) {
69 $_host_bits = int($1);
75 return; # undef, cannot really do anything..
82 if (my $cpu_prop_str = $conf->{cpu
}) {
83 $cpu = PVE
::JSONSchema
::parse_property_string
('pve-vm-cpu-conf', $cpu_prop_str)
84 or die "Cannot parse cpu description: $cpu_prop_str\n";
87 if (my $phys_bits = $cpu->{'phys-bits'}) {
88 if ($phys_bits eq 'host') {
89 $bits = get_host_phys_address_bits
();
90 } elsif ($phys_bits =~ /^(\d+)$/) {
91 $bits = int($phys_bits);
95 if (!defined($bits)) {
96 my $host_bits = get_host_phys_address_bits
() // 36; # fixme: what fallback?
97 if ($cpu->{cputype
} && $cpu->{cputype
} =~ /^(host|max)$/) {
100 $bits = $host_bits > 40 ?
40 : $host_bits; # take the smaller one
104 $bits = $bits & ~1; # round down to nearest even as limit is lower with odd bit sizes
106 # heuristic: remove 20 bits to get MB and half that as QEMU needs some overhead
107 my $bits_to_max_mem = int(1<<($bits - 21));
109 return $bits_to_max_mem > 4*1024*1024 ?
4*1024*1024 : $bits_to_max_mem;
112 sub get_numa_node_list
{
115 for (my $i = 0; $i < $MAX_NUMA; $i++) {
116 my $entry = $conf->{"numa$i"} or next;
117 my $numa = parse_numa
($entry) or next;
120 return @numa_map if @numa_map;
121 my $sockets = $conf->{sockets
} || 1;
122 return (0..($sockets-1));
125 sub host_numanode_exists
{
128 return -d
"/sys/devices/system/node/node$id/";
131 # only valid when numa nodes map to a single host node
132 sub get_numa_guest_to_host_map
{
135 for (my $i = 0; $i < $MAX_NUMA; $i++) {
136 my $entry = $conf->{"numa$i"} or next;
137 my $numa = parse_numa
($entry) or next;
138 $map->{$i} = print_numa_hostnodes
($numa->{hostnodes
});
140 return $map if %$map;
141 my $sockets = $conf->{sockets
} || 1;
142 return {map { $_ => $_ } (0..($sockets-1))};
146 my ($conf, $vmid, $memory, $static_memory, $func) = @_;
149 my $current_size = $static_memory;
152 if($conf->{hugepages
} && $conf->{hugepages
} == 1024) {
158 return if $current_size == $memory;
160 my @numa_map = get_numa_node_list
($conf);
162 for (my $j = 0; $j < 8; $j++) {
163 for (my $i = 0; $i < 32; $i++) {
164 my $name = "dimm${dimm_id}";
166 my $numanode = $numa_map[$i % @numa_map];
167 $current_size += $dimm_size;
168 &$func($conf, $vmid, $name, $dimm_size, $numanode, $current_size, $memory);
169 return $current_size if $current_size >= $memory;
175 sub qemu_memory_hotplug
{
176 my ($vmid, $conf, $defaults, $value) = @_;
178 return $value if !PVE
::QemuServer
::Helpers
::vm_running_locally
($vmid);
180 my $sockets = $conf->{sockets
} || 1;
182 my $memory = $conf->{memory
} || $defaults->{memory
};
183 $value = $defaults->{memory
} if !$value;
184 return $value if $value == $memory;
186 my $static_memory = $STATICMEM;
187 $static_memory = $static_memory * $sockets if ($conf->{hugepages
} && $conf->{hugepages
} == 1024);
189 die "memory can't be lower than $static_memory MB" if $value < $static_memory;
190 my $MAX_MEM = get_max_mem
($conf);
191 die "you cannot add more memory than max mem $MAX_MEM MB!\n" if $value > $MAX_MEM;
193 if ($value > $memory) {
197 foreach_dimm
($conf, $vmid, $value, $static_memory, sub {
198 my ($conf, $vmid, $name, $dimm_size, $numanode, $current_size, $memory) = @_;
200 return if $current_size <= $conf->{memory
};
202 if ($conf->{hugepages
}) {
203 $numa_hostmap = get_numa_guest_to_host_map
($conf) if !$numa_hostmap;
205 my $hugepages_size = hugepages_size
($conf, $dimm_size);
206 my $path = hugepages_mount_path
($hugepages_size);
207 my $host_numanode = $numa_hostmap->{$numanode};
208 my $hugepages_topology->{$hugepages_size}->{$host_numanode} = hugepages_nr
($dimm_size, $hugepages_size);
211 my $hugepages_host_topology = hugepages_host_topology
();
212 hugepages_allocate
($hugepages_topology, $hugepages_host_topology);
214 eval { mon_cmd
($vmid, "object-add", 'qom-type' => "memory-backend-file", id
=> "mem-$name", size
=> int($dimm_size*1024*1024), 'mem-path' => $path, share
=> JSON
::true
, prealloc
=> JSON
::true
) };
216 hugepages_reset
($hugepages_host_topology);
220 hugepages_pre_deallocate
($hugepages_topology);
222 eval { hugepages_update_locked
($code); };
225 eval { mon_cmd
($vmid, "object-add", 'qom-type' => "memory-backend-ram", id
=> "mem-$name", size
=> int($dimm_size*1024*1024) ) };
229 eval { PVE
::QemuServer
::qemu_objectdel
($vmid, "mem-$name"); };
233 eval { mon_cmd
($vmid, "device_add", driver
=> "pc-dimm", id
=> "$name", memdev
=> "mem-$name", node
=> $numanode) };
235 eval { PVE
::QemuServer
::qemu_objectdel
($vmid, "mem-$name"); };
238 #update conf after each succesful module hotplug
239 $conf->{memory
} = $current_size;
240 PVE
::QemuConfig-
>write_config($vmid, $conf);
245 my $dimms = qemu_memdevices_list
($vmid, 'dimm');
247 my $current_size = $memory;
248 for my $name (sort { ($b =~ /^dimm(\d+)$/)[0] <=> ($a =~ /^dimm(\d+)$/)[0] } keys %$dimms) {
250 my $dimm_size = $dimms->{$name}->{size
} / 1024 / 1024;
252 last if $current_size <= $value;
254 print "try to unplug memory dimm $name\n";
258 eval { PVE
::QemuServer
::qemu_devicedel
($vmid, $name) };
260 my $dimm_list = qemu_memdevices_list
($vmid, 'dimm');
261 last if !$dimm_list->{$name};
262 raise_param_exc
({ $name => "error unplug memory module" }) if $retry > 5;
265 $current_size -= $dimm_size;
266 #update conf after each succesful module unplug
267 $conf->{memory
} = $current_size;
269 eval { PVE
::QemuServer
::qemu_objectdel
($vmid, "mem-$name"); };
270 PVE
::QemuConfig-
>write_config($vmid, $conf);
273 return $conf->{memory
};
276 sub qemu_memdevices_list
{
277 my ($vmid, $type) = @_;
279 my $dimmarray = mon_cmd
($vmid, "query-memory-devices");
282 foreach my $dimm (@$dimmarray) {
283 next if $type && $dimm->{data
}->{id
} !~ /^$type(\d+)$/;
284 $dimms->{$dimm->{data
}->{id
}}->{id
} = $dimm->{data
}->{id
};
285 $dimms->{$dimm->{data
}->{id
}}->{node
} = $dimm->{data
}->{node
};
286 $dimms->{$dimm->{data
}->{id
}}->{addr
} = $dimm->{data
}->{addr
};
287 $dimms->{$dimm->{data
}->{id
}}->{size
} = $dimm->{data
}->{size
};
288 $dimms->{$dimm->{data
}->{id
}}->{slot
} = $dimm->{data
}->{slot
};
294 my ($conf, $vmid, $sockets, $cores, $defaults, $hotplug, $cmd) = @_;
296 my $memory = $conf->{memory
} || $defaults->{memory
};
297 my $static_memory = 0;
300 die "NUMA needs to be enabled for memory hotplug\n" if !$conf->{numa
};
301 my $MAX_MEM = get_max_mem
($conf);
302 die "Total memory is bigger than ${MAX_MEM}MB\n" if $memory > $MAX_MEM;
304 for (my $i = 0; $i < $MAX_NUMA; $i++) {
305 die "cannot enable memory hotplugging with custom NUMA topology\n"
306 if $conf->{"numa$i"};
309 my $sockets = $conf->{sockets
} || 1;
311 $static_memory = $STATICMEM;
312 $static_memory = $static_memory * $sockets if ($conf->{hugepages
} && $conf->{hugepages
} == 1024);
314 die "minimum memory must be ${static_memory}MB\n" if($memory < $static_memory);
315 push @$cmd, '-m', "size=${static_memory},slots=255,maxmem=${MAX_MEM}M";
319 $static_memory = $memory;
320 push @$cmd, '-m', $static_memory;
323 die "numa needs to be enabled to use hugepages" if $conf->{hugepages
} && !$conf->{numa
};
327 my $numa_totalmemory = undef;
328 for (my $i = 0; $i < $MAX_NUMA; $i++) {
329 next if !$conf->{"numa$i"};
330 my $numa = parse_numa
($conf->{"numa$i"});
333 die "missing NUMA node$i memory value\n" if !$numa->{memory
};
334 my $numa_memory = $numa->{memory
};
335 $numa_totalmemory += $numa_memory;
337 my $mem_object = print_mem_object
($conf, "ram-node$i", $numa_memory);
340 my $cpulists = $numa->{cpus
};
341 die "missing NUMA node$i cpus\n" if !defined($cpulists);
342 my $cpus = join(',cpus=', map {
343 my ($start, $end) = @$_;
344 defined($end) ?
"$start-$end" : $start
348 my $hostnodelists = $numa->{hostnodes
};
349 if (defined($hostnodelists)) {
351 my $hostnodes = print_numa_hostnodes
($hostnodelists);
354 my $policy = $numa->{policy
};
355 die "you need to define a policy for hostnode $hostnodes\n" if !$policy;
356 $mem_object .= ",host-nodes=$hostnodes,policy=$policy";
358 die "numa hostnodes need to be defined to use hugepages" if $conf->{hugepages
};
361 push @$cmd, '-object', $mem_object;
362 push @$cmd, '-numa', "node,nodeid=$i,cpus=$cpus,memdev=ram-node$i";
365 die "total memory for NUMA nodes must be equal to vm static memory\n"
366 if $numa_totalmemory && $numa_totalmemory != $static_memory;
368 #if no custom tology, we split memory and cores across numa nodes
369 if (!$numa_totalmemory) {
370 my $numa_memory = ($static_memory / $sockets);
372 for (my $i = 0; $i < $sockets; $i++) {
373 die "host NUMA node$i doesn't exist\n"
374 if !host_numanode_exists
($i) && $conf->{hugepages
};
376 my $mem_object = print_mem_object
($conf, "ram-node$i", $numa_memory);
377 push @$cmd, '-object', $mem_object;
379 my $cpus = ($cores * $i);
380 $cpus .= "-" . ($cpus + $cores - 1) if $cores > 1;
382 push @$cmd, '-numa', "node,nodeid=$i,cpus=$cpus,memdev=ram-node$i";
388 foreach_dimm
($conf, $vmid, $memory, $static_memory, sub {
389 my ($conf, $vmid, $name, $dimm_size, $numanode, $current_size, $memory) = @_;
391 my $mem_object = print_mem_object
($conf, "mem-$name", $dimm_size);
393 push @$cmd, "-object" , $mem_object;
394 push @$cmd, "-device", "pc-dimm,id=$name,memdev=mem-$name,node=$numanode";
396 die "memory size ($memory) must be aligned to $dimm_size for hotplugging\n"
397 if $current_size > $memory;
402 sub print_mem_object
{
403 my ($conf, $id, $size) = @_;
405 if ($conf->{hugepages
}) {
407 my $hugepages_size = hugepages_size
($conf, $size);
408 my $path = hugepages_mount_path
($hugepages_size);
410 return "memory-backend-file,id=$id,size=${size}M,mem-path=$path,share=on,prealloc=yes";
412 return "memory-backend-ram,id=$id,size=${size}M";
417 sub print_numa_hostnodes
{
418 my ($hostnodelists) = @_;
421 foreach my $hostnoderange (@$hostnodelists) {
422 my ($start, $end) = @$hostnoderange;
423 $hostnodes .= ',' if $hostnodes;
424 $hostnodes .= $start;
425 $hostnodes .= "-$end" if defined($end);
427 for (my $i = $start; $i <= $end; ++$i ) {
428 die "host NUMA node$i doesn't exist\n" if !host_numanode_exists
($i);
434 sub hugepages_mount
{
436 my $mountdata = PVE
::ProcFSTools
::parse_proc_mounts
();
438 foreach my $size (qw(2048 1048576)) {
439 next if (! -d
"/sys/kernel/mm/hugepages/hugepages-${size}kB");
441 my $path = "/run/hugepages/kvm/${size}kB";
444 $_->[2] =~ /^hugetlbfs/ &&
450 File
::Path
::make_path
($path) if (!-d
$path);
451 my $cmd = ['/bin/mount', '-t', 'hugetlbfs', '-o', "pagesize=${size}k", 'hugetlbfs', $path];
452 run_command
($cmd, errmsg
=> "hugepage mount error");
457 sub hugepages_mount_path
{
460 $size = $size * 1024;
461 return "/run/hugepages/kvm/${size}kB";
466 my ($size, $hugepages_size) = @_;
468 return $size / $hugepages_size;
471 sub hugepages_chunk_size_supported
{
474 return -d
"/sys/kernel/mm/hugepages/hugepages-". ($size * 1024) ."kB";
478 my ($conf, $size) = @_;
479 die "hugepages option is not enabled" if !$conf->{hugepages
};
480 die "memory size '$size' is not a positive even integer; cannot use for hugepages\n"
481 if $size <= 0 || $size & 1;
483 die "your system doesn't support hugepages\n"
484 if !hugepages_chunk_size_supported
(2) && !hugepages_chunk_size_supported
(1024);
486 if ($conf->{hugepages
} eq 'any') {
488 # try to use 1GB if available && memory size is matching
489 if (hugepages_chunk_size_supported
(1024) && ($size & 1023) == 0) {
491 } elsif (hugepages_chunk_size_supported
(2)) {
494 die "host only supports 1024 GB hugepages, but requested size '$size' is not a multiple of 1024 MB\n"
498 my $hugepagesize = $conf->{hugepages
};
500 if (!hugepages_chunk_size_supported
($hugepagesize)) {
501 die "your system doesn't support hugepages of $hugepagesize MB\n";
502 } elsif (($size % $hugepagesize) != 0) {
503 die "Memory size $size is not a multiple of the requested hugepages size $hugepagesize\n";
510 sub hugepages_topology
{
511 my ($conf, $hotplug) = @_;
513 my $hugepages_topology = {};
515 return if !$conf->{numa
};
517 my $defaults = PVE
::QemuServer
::load_defaults
();
518 my $memory = $conf->{memory
} || $defaults->{memory
};
519 my $static_memory = 0;
520 my $sockets = $conf->{sockets
} || 1;
521 my $numa_custom_topology = undef;
524 $static_memory = $STATICMEM;
525 $static_memory = $static_memory * $sockets if ($conf->{hugepages
} && $conf->{hugepages
} == 1024);
527 $static_memory = $memory;
530 #custom numa topology
531 for (my $i = 0; $i < $MAX_NUMA; $i++) {
532 next if !$conf->{"numa$i"};
533 my $numa = parse_numa
($conf->{"numa$i"});
536 $numa_custom_topology = 1;
537 my $numa_memory = $numa->{memory
};
538 my $hostnodelists = $numa->{hostnodes
};
539 my $hostnodes = print_numa_hostnodes
($hostnodelists);
541 die "more than 1 hostnode value in numa node is not supported when hugepages are enabled" if $hostnodes !~ m/^(\d)$/;
542 my $hugepages_size = hugepages_size
($conf, $numa_memory);
543 $hugepages_topology->{$hugepages_size}->{$hostnodes} += hugepages_nr
($numa_memory, $hugepages_size);
547 #if no custom numa tology, we split memory and cores across numa nodes
548 if(!$numa_custom_topology) {
550 my $numa_memory = ($static_memory / $sockets);
552 for (my $i = 0; $i < $sockets; $i++) {
554 my $hugepages_size = hugepages_size
($conf, $numa_memory);
555 $hugepages_topology->{$hugepages_size}->{$i} += hugepages_nr
($numa_memory, $hugepages_size);
560 my $numa_hostmap = get_numa_guest_to_host_map
($conf);
562 foreach_dimm
($conf, undef, $memory, $static_memory, sub {
563 my ($conf, undef, $name, $dimm_size, $numanode, $current_size, $memory) = @_;
565 $numanode = $numa_hostmap->{$numanode};
567 my $hugepages_size = hugepages_size
($conf, $dimm_size);
568 $hugepages_topology->{$hugepages_size}->{$numanode} += hugepages_nr
($dimm_size, $hugepages_size);
572 return $hugepages_topology;
575 sub hugepages_host_topology
{
578 my $hugepages_host_topology = {};
580 dir_glob_foreach
("/sys/devices/system/node/", 'node(\d+)', sub {
581 my ($nodepath, $numanode) = @_;
583 dir_glob_foreach
("/sys/devices/system/node/$nodepath/hugepages/", 'hugepages\-(\d+)kB', sub {
584 my ($hugepages_path, $hugepages_size) = @_;
586 $hugepages_size = $hugepages_size / 1024;
587 my $hugepages_nr = PVE
::Tools
::file_read_firstline
("/sys/devices/system/node/$nodepath/hugepages/$hugepages_path/nr_hugepages");
588 $hugepages_host_topology->{$hugepages_size}->{$numanode} = $hugepages_nr;
592 return $hugepages_host_topology;
595 sub hugepages_allocate
{
596 my ($hugepages_topology, $hugepages_host_topology) = @_;
598 #allocate new hupages if needed
599 foreach my $size (sort keys %$hugepages_topology) {
601 my $nodes = $hugepages_topology->{$size};
603 foreach my $numanode (keys %$nodes) {
605 my $hugepages_size = $size * 1024;
606 my $hugepages_requested = $hugepages_topology->{$size}->{$numanode};
607 my $path = "/sys/devices/system/node/node${numanode}/hugepages/hugepages-${hugepages_size}kB/";
608 my $hugepages_free = PVE
::Tools
::file_read_firstline
($path."free_hugepages");
609 my $hugepages_nr = PVE
::Tools
::file_read_firstline
($path."nr_hugepages");
611 if ($hugepages_requested > $hugepages_free) {
612 my $hugepages_needed = $hugepages_requested - $hugepages_free;
613 PVE
::ProcFSTools
::write_proc_entry
($path."nr_hugepages", $hugepages_nr + $hugepages_needed);
614 #verify that is correctly allocated
615 $hugepages_free = PVE
::Tools
::file_read_firstline
($path."free_hugepages");
616 if ($hugepages_free < $hugepages_requested) {
617 #rollback to initial host config
618 hugepages_reset
($hugepages_host_topology);
619 die "hugepage allocation failed";
628 sub hugepages_default_nr_hugepages
{
631 my $cmdline = PVE
::Tools
::file_read_firstline
("/proc/cmdline");
632 my $args = PVE
::Tools
::split_args
($cmdline);
634 my $parsed_size = 2; # default is 2M
636 foreach my $arg (@$args) {
637 if ($arg eq "hugepagesz=2M") {
639 } elsif ($arg eq "hugepagesz=1G") {
641 } elsif ($arg =~ m/^hugepages=(\d+)?$/) {
642 if ($parsed_size == $size) {
651 sub hugepages_pre_deallocate
{
652 my ($hugepages_topology) = @_;
654 foreach my $size (sort keys %$hugepages_topology) {
656 my $hugepages_size = $size * 1024;
657 my $path = "/sys/kernel/mm/hugepages/hugepages-${hugepages_size}kB/";
658 my $hugepages_nr = hugepages_default_nr_hugepages
($size);
659 PVE
::ProcFSTools
::write_proc_entry
($path."nr_hugepages", $hugepages_nr);
663 sub hugepages_reset
{
664 my ($hugepages_topology) = @_;
666 foreach my $size (sort keys %$hugepages_topology) {
668 my $nodes = $hugepages_topology->{$size};
669 foreach my $numanode (keys %$nodes) {
671 my $hugepages_nr = $hugepages_topology->{$size}->{$numanode};
672 my $hugepages_size = $size * 1024;
673 my $path = "/sys/devices/system/node/node${numanode}/hugepages/hugepages-${hugepages_size}kB/";
675 PVE
::ProcFSTools
::write_proc_entry
($path."nr_hugepages", $hugepages_nr);
680 sub hugepages_update_locked
{
681 my ($code, @param) = @_;
683 my $timeout = 60; #could be long if a lot of hugepages need to be alocated
685 my $lock_filename = "/var/lock/hugepages.lck";
687 my $res = lock_file
($lock_filename, $timeout, $code, @param);