1 package PVE
::QemuServer
::Memory
;
6 use PVE
::Tools
qw(run_command lock_file lock_file_full file_read_firstline dir_glob_foreach);
7 use PVE
::Exception
qw(raise raise_param_exc);
10 my $MAX_MEM = 4194304;
13 sub get_numa_node_list
{
16 for (my $i = 0; $i < $MAX_NUMA; $i++) {
17 my $entry = $conf->{"numa$i"} or next;
18 my $numa = PVE
::QemuServer
::parse_numa
($entry) or next;
21 return @numa_map if @numa_map;
22 my $sockets = $conf->{sockets
} || 1;
23 return (0..($sockets-1));
26 # only valid when numa nodes map to a single host node
27 sub get_numa_guest_to_host_map
{
30 for (my $i = 0; $i < $MAX_NUMA; $i++) {
31 my $entry = $conf->{"numa$i"} or next;
32 my $numa = PVE
::QemuServer
::parse_numa
($entry) or next;
33 $map->{$i} = print_numa_hostnodes
($numa->{hostnodes
});
36 my $sockets = $conf->{sockets
} || 1;
37 return {map { $_ => $_ } (0..($sockets-1))};
41 my ($conf, $vmid, $memory, $sockets, $func) = @_;
47 if($conf->{hugepages
} && $conf->{hugepages
} == 1024) {
48 $current_size = 1024 * $sockets;
55 return if $current_size == $memory;
57 my @numa_map = get_numa_node_list
($conf);
59 for (my $j = 0; $j < 8; $j++) {
60 for (my $i = 0; $i < 32; $i++) {
61 my $name = "dimm${dimm_id}";
63 my $numanode = $numa_map[$i % @numa_map];
64 $current_size += $dimm_size;
65 &$func($conf, $vmid, $name, $dimm_size, $numanode, $current_size, $memory);
66 return $current_size if $current_size >= $memory;
72 sub foreach_reverse_dimm
{
73 my ($conf, $vmid, $memory, $sockets, $func) = @_;
79 if($conf->{hugepages
} && $conf->{hugepages
} == 1024) {
80 $current_size = 8355840;
83 $current_size = 4177920;
87 return if $current_size == $memory;
89 my @numa_map = get_numa_node_list
($conf);
91 for (my $j = 0; $j < 8; $j++) {
92 for (my $i = 0; $i < 32; $i++) {
93 my $name = "dimm${dimm_id}";
95 my $numanode = $numa_map[(31-$i) % @numa_map];
96 $current_size -= $dimm_size;
97 &$func($conf, $vmid, $name, $dimm_size, $numanode, $current_size, $memory);
98 return $current_size if $current_size <= $memory;
104 sub qemu_memory_hotplug
{
105 my ($vmid, $conf, $defaults, $opt, $value) = @_;
107 return $value if !PVE
::QemuServer
::check_running
($vmid);
110 $sockets = $conf->{sockets
} if $conf->{sockets
};
112 my $memory = $conf->{memory
} || $defaults->{memory
};
113 $value = $defaults->{memory
} if !$value;
114 return $value if $value == $memory;
116 my $static_memory = $STATICMEM;
117 $static_memory = $static_memory * $sockets if ($conf->{hugepages
} && $conf->{hugepages
} == 1024);
119 die "memory can't be lower than $static_memory MB" if $value < $static_memory;
120 die "you cannot add more memory than $MAX_MEM MB!\n" if $memory > $MAX_MEM;
122 if($value > $memory) {
124 my $numa_hostmap = get_numa_guest_to_host_map
($conf) if $conf->{hugepages
};
126 foreach_dimm
($conf, $vmid, $value, $sockets, sub {
127 my ($conf, $vmid, $name, $dimm_size, $numanode, $current_size, $memory) = @_;
129 return if $current_size <= $conf->{memory
};
131 if ($conf->{hugepages
}) {
133 my $hugepages_size = hugepages_size
($conf, $dimm_size);
134 my $path = hugepages_mount_path
($hugepages_size);
135 my $host_numanode = $numa_hostmap->{$numanode};
136 my $hugepages_topology->{$hugepages_size}->{$host_numanode} = hugepages_nr
($dimm_size, $hugepages_size);
139 my $hugepages_host_topology = hugepages_host_topology
();
140 hugepages_allocate
($hugepages_topology, $hugepages_host_topology);
142 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "object-add", 'qom-type' => "memory-backend-file", id
=> "mem-$name", props
=> {
143 size
=> int($dimm_size*1024*1024), 'mem-path' => $path, share
=> JSON
::true
, prealloc
=> JSON
::true
} ); };
145 hugepages_reset
($hugepages_host_topology);
149 hugepages_pre_deallocate
($hugepages_topology);
151 eval { hugepages_update_locked
($code); };
154 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "object-add", 'qom-type' => "memory-backend-ram", id
=> "mem-$name", props
=> { size
=> int($dimm_size*1024*1024) } ) };
158 eval { PVE
::QemuServer
::qemu_objectdel
($vmid, "mem-$name"); };
162 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "device_add", driver
=> "pc-dimm", id
=> "$name", memdev
=> "mem-$name", node
=> $numanode) };
164 eval { PVE
::QemuServer
::qemu_objectdel
($vmid, "mem-$name"); };
167 #update conf after each succesful module hotplug
168 $conf->{memory
} = $current_size;
169 PVE
::QemuConfig-
>write_config($vmid, $conf);
174 foreach_reverse_dimm
($conf, $vmid, $value, $sockets, sub {
175 my ($conf, $vmid, $name, $dimm_size, $numanode, $current_size, $memory) = @_;
177 return if $current_size >= $conf->{memory
};
178 print "try to unplug memory dimm $name\n";
182 eval { PVE
::QemuServer
::qemu_devicedel
($vmid, $name) };
184 my $dimm_list = qemu_dimm_list
($vmid);
185 last if !$dimm_list->{$name};
186 raise_param_exc
({ $name => "error unplug memory module" }) if $retry > 5;
190 #update conf after each succesful module unplug
191 $conf->{memory
} = $current_size;
193 eval { PVE
::QemuServer
::qemu_objectdel
($vmid, "mem-$name"); };
194 PVE
::QemuConfig-
>write_config($vmid, $conf);
202 my $dimmarray = PVE
::QemuServer
::vm_mon_cmd_nocheck
($vmid, "query-memory-devices");
205 foreach my $dimm (@$dimmarray) {
207 $dimms->{$dimm->{data
}->{id
}}->{id
} = $dimm->{data
}->{id
};
208 $dimms->{$dimm->{data
}->{id
}}->{node
} = $dimm->{data
}->{node
};
209 $dimms->{$dimm->{data
}->{id
}}->{addr
} = $dimm->{data
}->{addr
};
210 $dimms->{$dimm->{data
}->{id
}}->{size
} = $dimm->{data
}->{size
};
211 $dimms->{$dimm->{data
}->{id
}}->{slot
} = $dimm->{data
}->{slot
};
217 my ($conf, $vmid, $sockets, $cores, $defaults, $hotplug_features, $cmd) = @_;
219 my $memory = $conf->{memory
} || $defaults->{memory
};
220 my $static_memory = 0;
222 if ($hotplug_features->{memory
}) {
223 die "NUMA needs to be enabled for memory hotplug\n" if !$conf->{numa
};
224 die "Total memory is bigger than ${MAX_MEM}MB\n" if $memory > $MAX_MEM;
226 $sockets = $conf->{sockets
} if $conf->{sockets
};
228 $static_memory = $STATICMEM;
229 $static_memory = $static_memory * $sockets if ($conf->{hugepages
} && $conf->{hugepages
} == 1024);
231 die "minimum memory must be ${static_memory}MB\n" if($memory < $static_memory);
232 push @$cmd, '-m', "size=${static_memory},slots=255,maxmem=${MAX_MEM}M";
236 $static_memory = $memory;
237 push @$cmd, '-m', $static_memory;
240 die "numa needs to be enabled to use hugepages" if $conf->{hugepages
} && !$conf->{numa
};
244 my $numa_totalmemory = undef;
245 for (my $i = 0; $i < $MAX_NUMA; $i++) {
246 next if !$conf->{"numa$i"};
247 my $numa = PVE
::QemuServer
::parse_numa
($conf->{"numa$i"});
250 die "missing NUMA node$i memory value\n" if !$numa->{memory
};
251 my $numa_memory = $numa->{memory
};
252 $numa_totalmemory += $numa_memory;
254 my $mem_object = print_mem_object
($conf, "ram-node$i", $numa_memory);
257 my $cpulists = $numa->{cpus
};
258 die "missing NUMA node$i cpus\n" if !defined($cpulists);
259 my $cpus = join(',cpus=', map {
260 my ($start, $end) = @$_;
261 defined($end) ?
"$start-$end" : $start
265 my $hostnodelists = $numa->{hostnodes
};
266 if (defined($hostnodelists)) {
268 my $hostnodes = print_numa_hostnodes
($hostnodelists);
271 my $policy = $numa->{policy
};
272 die "you need to define a policy for hostnode $hostnodes\n" if !$policy;
273 $mem_object .= ",host-nodes=$hostnodes,policy=$policy";
275 die "numa hostnodes need to be defined to use hugepages" if $conf->{hugepages
};
278 push @$cmd, '-object', $mem_object;
279 push @$cmd, '-numa', "node,nodeid=$i,cpus=$cpus,memdev=ram-node$i";
282 die "total memory for NUMA nodes must be equal to vm static memory\n"
283 if $numa_totalmemory && $numa_totalmemory != $static_memory;
285 #if no custom tology, we split memory and cores across numa nodes
286 if(!$numa_totalmemory) {
288 my $numa_memory = ($static_memory / $sockets);
290 for (my $i = 0; $i < $sockets; $i++) {
291 die "host NUMA node$i doesn't exist\n" if ! -d
"/sys/devices/system/node/node$i/" && $conf->{hugepages
};
293 my $cpustart = ($cores * $i);
294 my $cpuend = ($cpustart + $cores - 1) if $cores && $cores > 1;
295 my $cpus = $cpustart;
296 $cpus .= "-$cpuend" if $cpuend;
298 my $mem_object = print_mem_object
($conf, "ram-node$i", $numa_memory);
300 push @$cmd, '-object', $mem_object;
301 push @$cmd, '-numa', "node,nodeid=$i,cpus=$cpus,memdev=ram-node$i";
306 if ($hotplug_features->{memory
}) {
307 foreach_dimm
($conf, $vmid, $memory, $sockets, sub {
308 my ($conf, $vmid, $name, $dimm_size, $numanode, $current_size, $memory) = @_;
310 my $mem_object = print_mem_object
($conf, "mem-$name", $dimm_size);
312 push @$cmd, "-object" , $mem_object;
313 push @$cmd, "-device", "pc-dimm,id=$name,memdev=mem-$name,node=$numanode";
315 #if dimm_memory is not aligned to dimm map
316 if($current_size > $memory) {
317 $conf->{memory
} = $current_size;
318 PVE
::QemuConfig-
>write_config($vmid, $conf);
324 sub print_mem_object
{
325 my ($conf, $id, $size) = @_;
327 if ($conf->{hugepages
}) {
329 my $hugepages_size = hugepages_size
($conf, $size);
330 my $path = hugepages_mount_path
($hugepages_size);
332 return "memory-backend-file,id=$id,size=${size}M,mem-path=$path,share=on,prealloc=yes";
334 return "memory-backend-ram,id=$id,size=${size}M";
339 sub print_numa_hostnodes
{
340 my ($hostnodelists) = @_;
343 foreach my $hostnoderange (@$hostnodelists) {
344 my ($start, $end) = @$hostnoderange;
345 $hostnodes .= ',' if $hostnodes;
346 $hostnodes .= $start;
347 $hostnodes .= "-$end" if defined($end);
349 for (my $i = $start; $i <= $end; ++$i ) {
350 die "host NUMA node$i doesn't exist\n" if ! -d
"/sys/devices/system/node/node$i/";
356 sub hugepages_mount
{
358 my $mountdata = PVE
::ProcFSTools
::parse_proc_mounts
();
360 foreach my $size (qw(2048 1048576)) {
361 next if (! -d
"/sys/kernel/mm/hugepages/hugepages-${size}kB");
363 my $path = "/run/hugepages/kvm/${size}kB";
366 $_->[2] =~ /^hugetlbfs/ &&
372 File
::Path
::make_path
($path) if (!-d
$path);
373 my $cmd = ['/bin/mount', '-t', 'hugetlbfs', '-o', "pagesize=${size}k", 'hugetlbfs', $path];
374 run_command
($cmd, errmsg
=> "hugepage mount error");
379 sub hugepages_mount_path
{
382 $size = $size * 1024;
383 return "/run/hugepages/kvm/${size}kB";
388 my ($size, $hugepages_size) = @_;
390 return $size / $hugepages_size;
394 my ($conf, $size) = @_;
396 die "hugepages option is not enabled" if !$conf->{hugepages
};
398 if ($conf->{hugepages
} eq 'any') {
400 #try to use 1GB if available && memory size is matching
401 my $gb_exists = -d
"/sys/kernel/mm/hugepages/hugepages-1048576kB";
402 if ($gb_exists && ($size % 1024 == 0)) {
404 } elsif (-d
"/sys/kernel/mm/hugepages/hugepages-2048kB") {
408 die "your system doesn't support hugepages for memory size $size\n"
411 die "your system doesn't support hugepages\n";
415 my $hugepagesize = $conf->{hugepages
} * 1024 . "kB";
417 if (! -d
"/sys/kernel/mm/hugepages/hugepages-$hugepagesize") {
418 die "your system doesn't support hugepages of $hugepagesize\n";
420 die "Memory size $size is not a multiple of the requested hugepages size $hugepagesize\n" if ($size % $conf->{hugepages
}) != 0;
421 return $conf->{hugepages
};
426 sub hugepages_topology
{
429 my $hugepages_topology = {};
431 return if !$conf->{numa
};
433 my $defaults = PVE
::QemuServer
::load_defaults
();
434 my $memory = $conf->{memory
} || $defaults->{memory
};
435 my $static_memory = 0;
437 $sockets = $conf->{smp
} if $conf->{smp
}; # old style - no longer iused
438 $sockets = $conf->{sockets
} if $conf->{sockets
};
439 my $numa_custom_topology = undef;
440 my $hotplug_features = PVE
::QemuServer
::parse_hotplug_features
(defined($conf->{hotplug
}) ?
$conf->{hotplug
} : '1');
442 if ($hotplug_features->{memory
}) {
443 $static_memory = $STATICMEM;
444 $static_memory = $static_memory * $sockets if ($conf->{hugepages
} && $conf->{hugepages
} == 1024);
446 $static_memory = $memory;
449 #custom numa topology
450 for (my $i = 0; $i < $MAX_NUMA; $i++) {
451 next if !$conf->{"numa$i"};
452 my $numa = PVE
::QemuServer
::parse_numa
($conf->{"numa$i"});
455 $numa_custom_topology = 1;
456 my $numa_memory = $numa->{memory
};
457 my $hostnodelists = $numa->{hostnodes
};
458 my $hostnodes = print_numa_hostnodes
($hostnodelists);
460 die "more than 1 hostnode value in numa node is not supported when hugepages are enabled" if $hostnodes !~ m/^(\d)$/;
461 my $hugepages_size = hugepages_size
($conf, $numa_memory);
462 $hugepages_topology->{$hugepages_size}->{$hostnodes} += hugepages_nr
($numa_memory, $hugepages_size);
466 #if no custom numa tology, we split memory and cores across numa nodes
467 if(!$numa_custom_topology) {
469 my $numa_memory = ($static_memory / $sockets);
471 for (my $i = 0; $i < $sockets; $i++) {
473 my $hugepages_size = hugepages_size
($conf, $numa_memory);
474 $hugepages_topology->{$hugepages_size}->{$i} += hugepages_nr
($numa_memory, $hugepages_size);
478 if ($hotplug_features->{memory
}) {
479 my $numa_hostmap = get_numa_guest_to_host_map
($conf);
481 foreach_dimm
($conf, undef, $memory, $sockets, sub {
482 my ($conf, undef, $name, $dimm_size, $numanode, $current_size, $memory) = @_;
484 $numanode = $numa_hostmap->{$numanode};
486 my $hugepages_size = hugepages_size
($conf, $dimm_size);
487 $hugepages_topology->{$hugepages_size}->{$numanode} += hugepages_nr
($dimm_size, $hugepages_size);
491 return $hugepages_topology;
494 sub hugepages_host_topology
{
497 my $hugepages_host_topology = {};
499 dir_glob_foreach
("/sys/devices/system/node/", 'node(\d+)', sub {
500 my ($nodepath, $numanode) = @_;
502 dir_glob_foreach
("/sys/devices/system/node/$nodepath/hugepages/", 'hugepages\-(\d+)kB', sub {
503 my ($hugepages_path, $hugepages_size) = @_;
505 $hugepages_size = $hugepages_size / 1024;
506 my $hugepages_nr = PVE
::Tools
::file_read_firstline
("/sys/devices/system/node/$nodepath/hugepages/$hugepages_path/nr_hugepages");
507 $hugepages_host_topology->{$hugepages_size}->{$numanode} = $hugepages_nr;
511 return $hugepages_host_topology;
514 sub hugepages_allocate
{
515 my ($hugepages_topology, $hugepages_host_topology) = @_;
517 #allocate new hupages if needed
518 foreach my $size (sort keys %$hugepages_topology) {
520 my $nodes = $hugepages_topology->{$size};
522 foreach my $numanode (keys %$nodes) {
524 my $hugepages_size = $size * 1024;
525 my $hugepages_requested = $hugepages_topology->{$size}->{$numanode};
526 my $path = "/sys/devices/system/node/node${numanode}/hugepages/hugepages-${hugepages_size}kB/";
527 my $hugepages_free = PVE
::Tools
::file_read_firstline
($path."free_hugepages");
528 my $hugepages_nr = PVE
::Tools
::file_read_firstline
($path."nr_hugepages");
530 if ($hugepages_requested > $hugepages_free) {
531 my $hugepages_needed = $hugepages_requested - $hugepages_free;
532 PVE
::ProcFSTools
::write_proc_entry
($path."nr_hugepages", $hugepages_nr + $hugepages_needed);
533 #verify that is correctly allocated
534 $hugepages_free = PVE
::Tools
::file_read_firstline
($path."free_hugepages");
535 if ($hugepages_free < $hugepages_requested) {
536 #rollback to initial host config
537 hugepages_reset
($hugepages_host_topology);
538 die "hugepage allocation failed";
547 sub hugepages_default_nr_hugepages
{
550 my $cmdline = PVE
::Tools
::file_read_firstline
("/proc/cmdline");
551 my $args = PVE
::Tools
::split_args
($cmdline);
553 my $parsed_size = 2; # default is 2M
555 foreach my $arg (@$args) {
556 if ($arg eq "hugepagesz=2M") {
558 } elsif ($arg eq "hugepagesz=1G") {
560 } elsif ($arg =~ m/^hugepages=(\d+)?$/) {
561 if ($parsed_size == $size) {
570 sub hugepages_pre_deallocate
{
571 my ($hugepages_topology) = @_;
573 foreach my $size (sort keys %$hugepages_topology) {
575 my $hugepages_size = $size * 1024;
576 my $path = "/sys/kernel/mm/hugepages/hugepages-${hugepages_size}kB/";
577 my $hugepages_nr = hugepages_default_nr_hugepages
($size);
578 PVE
::ProcFSTools
::write_proc_entry
($path."nr_hugepages", $hugepages_nr);
582 sub hugepages_reset
{
583 my ($hugepages_topology) = @_;
585 foreach my $size (sort keys %$hugepages_topology) {
587 my $nodes = $hugepages_topology->{$size};
588 foreach my $numanode (keys %$nodes) {
590 my $hugepages_nr = $hugepages_topology->{$size}->{$numanode};
591 my $hugepages_size = $size * 1024;
592 my $path = "/sys/devices/system/node/node${numanode}/hugepages/hugepages-${hugepages_size}kB/";
594 PVE
::ProcFSTools
::write_proc_entry
($path."nr_hugepages", $hugepages_nr);
599 sub hugepages_update_locked
{
600 my ($code, @param) = @_;
602 my $timeout = 60; #could be long if a lot of hugepages need to be alocated
604 my $lock_filename = "/var/lock/hugepages.lck";
606 my $res = lock_file
($lock_filename, $timeout, $code, @param);