]>
git.proxmox.com Git - pve-cluster.git/blob - data/PVE/CLI/pvecm.pm
1 package PVE
::CLI
::pvecm
;
9 use PVE
::Tools
qw(run_command);
16 use base
qw(PVE::CLIHandler);
18 $ENV{HOME
} = '/root'; # for ssh-copy-id
20 my $basedir = "/etc/pve";
21 my $clusterconf = "$basedir/corosync.conf";
22 my $libdir = "/var/lib/pve-cluster";
23 my $backupdir = "/var/lib/pve-cluster/backup";
24 my $dbfile = "$libdir/config.db";
25 my $authfile = "/etc/corosync/authkey";
29 print "backup old database\n";
37 ['gzip', '-', \
">${backupdir}/config-${ctime}.sql.gz"],
40 run_command
($cmd, 'errmsg' => "cannot backup old database\n");
46 foreach my $fn (<$backupdir/config-*.sql
.gz
>) {
47 if ($fn =~ m!/config-(\d+)\.sql.gz$!) {
48 push @bklist, [$fn, $1];
52 @bklist = sort { $b->[1] <=> $a->[1] } @bklist;
54 while (scalar (@bklist) >= $maxfiles) {
56 print "delete old backup '$d->[0]'\n";
61 # lock method to ensure local and cluster wide atomicity
62 # if we're a single node cluster just lock locally, we have no other cluster
63 # node which we could contend with, else also acquire a cluster wide lock
64 my $config_change_lock = sub {
67 my $local_lock_fn = "/var/lock/pvecm.lock";
68 PVE
::Tools
::lock_file
($local_lock_fn, 10, sub {
69 PVE
::Cluster
::cfs_update
(1);
70 my $members = PVE
::Cluster
::get_members
();
71 if (scalar(keys %$members) > 1) {
72 return PVE
::Cluster
::cfs_lock_file
('corosync.conf', 10, $code);
79 __PACKAGE__-
>register_method ({
83 description
=> "Generate new cryptographic key for corosync.",
85 additionalProperties
=> 0,
89 description
=> "Output file name"
93 returns
=> { type
=> 'null' },
98 my $filename = $param->{filename
};
101 $> == 0 || die "Error: Authorization key must be generated as root user.\n";
102 my $dirname = dirname
($filename);
104 die "key file '$filename' already exists\n" if -e
$filename;
106 File
::Path
::make_path
($dirname) if $dirname;
108 run_command
(['corosync-keygen', '-l', '-k', $filename]);
113 __PACKAGE__-
>register_method ({
117 description
=> "Generate new cluster configuration.",
119 additionalProperties
=> 0,
122 description
=> "The name of the cluster.",
123 type
=> 'string', format
=> 'pve-node',
128 description
=> "Node id for this node.",
134 description
=> "Number of votes for this node.",
139 type
=> 'string', format
=> 'ip',
140 description
=> "This specifies the network address the corosync ring 0".
141 " executive should bind to and defaults to the local IP address of the node.",
145 type
=> 'string', format
=> 'address',
146 description
=> "Hostname (or IP) of the corosync ring0 address of this node.".
147 " Defaults to the hostname of the node.",
151 type
=> 'string', format
=> 'ip',
152 description
=> "This specifies the network address the corosync ring 1".
153 " executive should bind to and is optional.",
157 type
=> 'string', format
=> 'address',
158 description
=> "Hostname (or IP) of the corosync ring1 address, this".
159 " needs an valid bindnet1_addr.",
164 returns
=> { type
=> 'null' },
169 -f
$clusterconf && die "cluster config '$clusterconf' already exists\n";
171 PVE
::Cluster
::setup_sshd_config
(1);
172 PVE
::Cluster
::setup_rootsshconfig
();
173 PVE
::Cluster
::setup_ssh_keys
();
175 -f
$authfile || __PACKAGE__-
>keygen({filename
=> $authfile});
177 -f
$authfile || die "no authentication key available\n";
179 my $clustername = $param->{clustername
};
181 $param->{nodeid
} = 1 if !$param->{nodeid
};
183 $param->{votes
} = 1 if !defined($param->{votes
});
185 my $nodename = PVE
::INotify
::nodename
();
187 my $local_ip_address = PVE
::Cluster
::remote_node_ip
($nodename);
189 $param->{bindnet0_addr
} = $local_ip_address
190 if !defined($param->{bindnet0_addr
});
192 $param->{ring0_addr
} = $nodename if !defined($param->{ring0_addr
});
194 die "Param bindnet1_addr and ring1_addr are dependend, use both or none!\n"
195 if (defined($param->{bindnet1_addr
}) != defined($param->{ring1_addr
}));
197 my $bind_is_ipv6 = Net
::IP
::ip_is_ipv6
($param->{bindnet0_addr
});
199 # use string as here-doc format distracts more
200 my $interfaces = "interface {\n ringnumber: 0\n" .
201 " bindnetaddr: $param->{bindnet0_addr}\n }";
203 my $ring_addresses = "ring0_addr: $param->{ring0_addr}" ;
205 # allow use of multiple rings (rrp) at cluster creation time
206 if ($param->{bindnet1_addr
}) {
207 die "IPv6 and IPv4 cannot be mixed, use one or the other!\n"
208 if Net
::IP
::ip_is_ipv6
($param->{bindnet1_addr
}) != $bind_is_ipv6;
210 $interfaces .= "\n interface {\n ringnumber: 1\n" .
211 " bindnetaddr: $param->{bindnet1_addr}\n }\n";
213 $interfaces .= "rrp_mode: passive\n"; # only passive is stable and tested
215 $ring_addresses .= "\n ring1_addr: $param->{ring1_addr}";
218 # No, corosync cannot deduce this on its own
219 my $ipversion = $bind_is_ipv6 ?
'ipv6' : 'ipv4';
225 cluster_name: $clustername
227 ip_version: $ipversion
235 nodeid: $param->{nodeid}
236 quorum_votes: $param->{votes}
241 provider: corosync_votequorum
250 PVE
::Tools
::file_set_contents
($clusterconf, $config);
252 PVE
::Cluster
::ssh_merge_keys
();
254 PVE
::Cluster
::gen_pve_node_files
($nodename, $local_ip_address);
256 PVE
::Cluster
::ssh_merge_known_hosts
($nodename, $local_ip_address, 1);
258 run_command
('systemctl restart pve-cluster'); # restart
260 run_command
('systemctl restart corosync'); # restart
265 __PACKAGE__-
>register_method ({
269 description
=> "Adds a node to the cluster configuration.",
271 additionalProperties
=> 0,
273 node
=> PVE
::JSONSchema
::get_standard_option
('pve-node'),
276 description
=> "Node id for this node.",
282 description
=> "Number of votes for this node",
288 description
=> "Do not throw error if node already exists.",
292 type
=> 'string', format
=> 'address',
293 description
=> "Hostname (or IP) of the corosync ring0 address of this node.".
294 " Defaults to nodes hostname.",
298 type
=> 'string', format
=> 'address',
299 description
=> "Hostname (or IP) of the corosync ring1 address, this".
300 " needs an valid bindnet1_addr.",
305 returns
=> { type
=> 'null' },
310 if (!$param->{force
} && (-t STDIN
|| -t STDOUT
)) {
311 die "error: `addnode` should not get called interactively!\nUse ".
312 "`pvecm add <cluster-node>` to add a node to a cluster!\n";
315 PVE
::Cluster
::check_cfs_quorum
();
318 my $conf = PVE
::Cluster
::cfs_read_file
("corosync.conf");
319 my $nodelist = PVE
::Corosync
::nodelist
($conf);
320 my $totem_cfg = PVE
::Corosync
::totem_config
($conf);
322 my $name = $param->{node
};
324 # ensure we do not reuse an address, that can crash the whole cluster!
325 my $check_duplicate_addr = sub {
327 return if !defined($addr);
329 while (my ($k, $v) = each %$nodelist) {
330 next if $k eq $name; # allows re-adding a node if force is set
331 if ($v->{ring0_addr
} eq $addr || ($v->{ring1_addr
} && $v->{ring1_addr
} eq $addr)) {
332 die "corosync: address '$addr' already defined by node '$k'\n";
337 &$check_duplicate_addr($param->{ring0_addr
});
338 &$check_duplicate_addr($param->{ring1_addr
});
340 $param->{ring0_addr
} = $name if !$param->{ring0_addr
};
342 die "corosync: using 'ring1_addr' parameter needs a configured ring 1 interface!\n"
343 if $param->{ring1_addr
} && !defined($totem_cfg->{interface
}->{1});
345 die "corosync: ring 1 interface configured but 'ring1_addr' parameter not defined!\n"
346 if defined($totem_cfg->{interface
}->{1}) && !defined($param->{ring1_addr
});
348 if (defined(my $res = $nodelist->{$name})) {
349 $param->{nodeid
} = $res->{nodeid
} if !$param->{nodeid
};
350 $param->{votes
} = $res->{quorum_votes
} if !defined($param->{votes
});
352 if ($res->{quorum_votes
} == $param->{votes
} &&
353 $res->{nodeid
} == $param->{nodeid
}) {
354 print "node $name already defined\n";
355 if ($param->{force
}) {
361 die "can't add existing node\n";
363 } elsif (!$param->{nodeid
}) {
368 foreach my $v (values %$nodelist) {
369 if ($v->{nodeid
} eq $nodeid) {
378 $param->{nodeid
} = $nodeid;
381 $param->{votes
} = 1 if !defined($param->{votes
});
383 PVE
::Cluster
::gen_local_dirs
($name);
385 eval { PVE
::Cluster
::ssh_merge_keys
(); };
388 $nodelist->{$name} = {
389 ring0_addr
=> $param->{ring0_addr
},
390 nodeid
=> $param->{nodeid
},
393 $nodelist->{$name}->{ring1_addr
} = $param->{ring1_addr
} if $param->{ring1_addr
};
394 $nodelist->{$name}->{quorum_votes
} = $param->{votes
} if $param->{votes
};
396 PVE
::Corosync
::update_nodelist
($conf, $nodelist);
399 $config_change_lock->($code);
406 __PACKAGE__-
>register_method ({
410 description
=> "Removes a node to the cluster configuration.",
412 additionalProperties
=> 0,
416 description
=> "Hostname or IP of the corosync ring0 address of this node.",
420 returns
=> { type
=> 'null' },
425 my $local_node = PVE
::INotify
::nodename
();
426 die "Cannot delete myself from cluster!\n" if $param->{node
} eq $local_node;
428 PVE
::Cluster
::check_cfs_quorum
();
431 my $conf = PVE
::Cluster
::cfs_read_file
("corosync.conf");
432 my $nodelist = PVE
::Corosync
::nodelist
($conf);
437 foreach my $tmp_node (keys %$nodelist) {
438 my $d = $nodelist->{$tmp_node};
439 my $ring0_addr = $d->{ring0_addr
};
440 my $ring1_addr = $d->{ring1_addr
};
441 if (($tmp_node eq $param->{node
}) ||
442 (defined($ring0_addr) && ($ring0_addr eq $param->{node
})) ||
443 (defined($ring1_addr) && ($ring1_addr eq $param->{node
}))) {
445 $nodeid = $d->{nodeid
};
450 die "Node/IP: $param->{node} is not a known host of the cluster.\n"
453 delete $nodelist->{$node};
455 PVE
::Corosync
::update_nodelist
($conf, $nodelist);
457 run_command
(['corosync-cfgtool','-k', $nodeid]) if defined($nodeid);
460 $config_change_lock->($code);
466 __PACKAGE__-
>register_method ({
470 description
=> "Adds the current node to an existing cluster.",
472 additionalProperties
=> 0,
476 description
=> "Hostname (or IP) of an existing cluster member."
480 description
=> "Node id for this node.",
486 description
=> "Number of votes for this node",
492 description
=> "Do not throw error if node already exists.",
496 type
=> 'string', format
=> 'address',
497 description
=> "Hostname (or IP) of the corosync ring0 address of this node.".
498 " Defaults to nodes hostname.",
502 type
=> 'string', format
=> 'address',
503 description
=> "Hostname (or IP) of the corosync ring1 address, this".
504 " needs an valid configured ring 1 interface in the cluster.",
509 returns
=> { type
=> 'null' },
514 my $nodename = PVE
::INotify
::nodename
();
516 PVE
::Cluster
::setup_sshd_config
();
517 PVE
::Cluster
::setup_rootsshconfig
();
518 PVE
::Cluster
::setup_ssh_keys
();
520 my $host = $param->{hostname
};
522 my ($errors, $warnings) = ('', '');
525 my ($msg, $suppress) = @_;
528 $warnings .= "* $msg\n";
530 $errors .= "* $msg\n";
534 if (!$param->{force
}) {
537 &$error("authentication key '$authfile' already exists", $param->{force
});
540 if (-f
$clusterconf) {
541 &$error("cluster config '$clusterconf' already exists", $param->{force
});
544 my $vmlist = PVE
::Cluster
::get_vmlist
();
545 if ($vmlist && $vmlist->{ids
} && scalar(keys %{$vmlist->{ids
}})) {
546 &$error("this host already contains virtual guests", $param->{force
});
549 if (system("corosync-quorumtool -l >/dev/null 2>&1") == 0) {
550 &$error("corosync is already running, is this node already in a cluster?!", $param->{force
});
554 # check if corosync ring IPs are configured on the current nodes interfaces
558 if (!PVE
::JSONSchema
::pve_verify_ip
($ip, 1)) {
560 eval { $ip = PVE
::Network
::get_ip_from_hostname
($host); };
562 &$error("cannot use '$host': $@\n") ;
567 my $cidr = (Net
::IP
::ip_is_ipv6
($ip)) ?
"$ip/128" : "$ip/32";
568 my $configured_ips = PVE
::Network
::get_local_ip_from_cidr
($cidr);
570 &$error("cannot use IP '$ip', it must be configured exactly once on local node!\n")
571 if (scalar(@$configured_ips) != 1);
575 &$check_ip($param->{ring0_addr
});
576 &$check_ip($param->{ring1_addr
});
578 warn "warning, ignore the following errors:\n$warnings" if $warnings;
579 die "detected the following error(s):\n$errors" if $errors;
581 # make sure known_hosts is on local filesystem
582 PVE
::Cluster
::ssh_unmerge_known_hosts
();
584 my $cmd = ['ssh-copy-id', '-i', '/root/.ssh/id_rsa', "root\@$host"];
585 run_command
($cmd, 'outfunc' => sub {}, 'errfunc' => sub {},
586 'errmsg' => "unable to copy ssh ID");
588 $cmd = ['ssh', $host, '-o', 'BatchMode=yes',
589 'pvecm', 'addnode', $nodename, '--force', 1];
591 push @$cmd, '--nodeid', $param->{nodeid
} if $param->{nodeid
};
593 push @$cmd, '--votes', $param->{votes
} if defined($param->{votes
});
595 push @$cmd, '--ring0_addr', $param->{ring0_addr
} if defined($param->{ring0_addr
});
597 push @$cmd, '--ring1_addr', $param->{ring1_addr
} if defined($param->{ring1_addr
});
599 if (system (@$cmd) != 0) {
600 my $cmdtxt = join (' ', @$cmd);
601 die "unable to add node: command failed ($cmdtxt)\n";
604 my $tmpdir = "$libdir/.pvecm_add.tmp.$$";
608 print "copy corosync auth key\n";
609 $cmd = ['rsync', '--rsh=ssh -l root -o BatchMode=yes', '-lpgoq',
610 "[$host]:$authfile $clusterconf", $tmpdir];
612 system(@$cmd) == 0 || die "can't rsync data from host '$host'\n";
614 mkdir "/etc/corosync";
615 my $confbase = basename
($clusterconf);
617 $cmd = "cp '$tmpdir/$confbase' '/etc/corosync/$confbase'";
618 system($cmd) == 0 || die "can't copy cluster configuration\n";
620 my $keybase = basename
($authfile);
621 system ("cp '$tmpdir/$keybase' '$authfile'") == 0 ||
622 die "can't copy '$tmpdir/$keybase' to '$authfile'\n";
624 print "stopping pve-cluster service\n";
626 system("umount $basedir -f >/dev/null 2>&1");
627 system("systemctl stop pve-cluster") == 0 ||
628 die "can't stop pve-cluster service\n";
634 system("systemctl start pve-cluster") == 0 ||
635 die "starting pve-cluster failed\n";
637 system("systemctl start corosync");
641 while (!PVE
::Cluster
::check_cfs_quorum
(1)) {
643 print "waiting for quorum...";
649 print "OK\n" if !$printqmsg;
651 my $local_ip_address = PVE
::Cluster
::remote_node_ip
($nodename);
653 print "generating node certificates\n";
654 PVE
::Cluster
::gen_pve_node_files
($nodename, $local_ip_address);
656 print "merge known_hosts file\n";
657 PVE
::Cluster
::ssh_merge_known_hosts
($nodename, $local_ip_address, 1);
659 print "restart services\n";
660 # restart pvedaemon (changed certs)
661 system("systemctl restart pvedaemon");
662 # restart pveproxy (changed certs)
663 system("systemctl restart pveproxy");
665 print "successfully added node '$nodename' to cluster.\n";
676 __PACKAGE__-
>register_method ({
680 description
=> "Displays the local view of the cluster status.",
682 additionalProperties
=> 0,
685 returns
=> { type
=> 'null' },
690 PVE
::Corosync
::check_conf_exists
();
692 my $cmd = ['corosync-quorumtool', '-siH'];
696 exit (-1); # should not be reached
699 __PACKAGE__-
>register_method ({
703 description
=> "Displays the local view of the cluster nodes.",
705 additionalProperties
=> 0,
708 returns
=> { type
=> 'null' },
713 PVE
::Corosync
::check_conf_exists
();
715 my $cmd = ['corosync-quorumtool', '-l'];
719 exit (-1); # should not be reached
722 __PACKAGE__-
>register_method ({
726 description
=> "Tells corosync a new value of expected votes.",
728 additionalProperties
=> 0,
732 description
=> "Expected votes",
737 returns
=> { type
=> 'null' },
742 PVE
::Corosync
::check_conf_exists
();
744 my $cmd = ['corosync-quorumtool', '-e', $param->{expected
}];
748 exit (-1); # should not be reached
752 __PACKAGE__-
>register_method ({
753 name
=> 'updatecerts',
754 path
=> 'updatecerts',
756 description
=> "Update node certificates (and generate all needed files/directories).",
758 additionalProperties
=> 0,
761 description
=> "Force generation of new SSL certifate.",
766 description
=> "Ignore errors (i.e. when cluster has no quorum).",
772 returns
=> { type
=> 'null' },
776 PVE
::Cluster
::setup_rootsshconfig
();
778 PVE
::Cluster
::gen_pve_vzdump_symlink
();
780 if (!PVE
::Cluster
::check_cfs_quorum
(1)) {
781 return undef if $param->{silent
};
782 die "no quorum - unable to update files\n";
785 PVE
::Cluster
::setup_ssh_keys
();
787 my $nodename = PVE
::INotify
::nodename
();
789 my $local_ip_address = PVE
::Cluster
::remote_node_ip
($nodename);
791 PVE
::Cluster
::gen_pve_node_files
($nodename, $local_ip_address, $param->{force
});
792 PVE
::Cluster
::ssh_merge_keys
();
793 PVE
::Cluster
::ssh_merge_known_hosts
($nodename, $local_ip_address);
794 PVE
::Cluster
::gen_pve_vzdump_files
();
799 __PACKAGE__-
>register_method ({
803 description
=> "Used by VM/CT migration - do not use manually.",
805 additionalProperties
=> 0,
807 get_migration_ip
=> {
810 description
=> 'return the migration IP, if configured',
813 migration_network
=> {
816 description
=> 'the migration network used to detect the local migration IP',
821 description
=> 'Run a command with a tcp socket as standard input.'
822 .' The IP address and port are printed via this'
823 ." command's stdandard output first, each on a separate line.",
826 'extra-args' => PVE
::JSONSchema
::get_standard_option
('extra-args'),
829 returns
=> { type
=> 'null'},
833 if (!PVE
::Cluster
::check_cfs_quorum
(1)) {
838 my $network = $param->{migration_network
};
839 if ($param->{get_migration_ip
}) {
840 die "cannot use --run-command with --get_migration_ip\n"
841 if $param->{'run-command'};
842 if (my $ip = PVE
::Cluster
::get_local_migration_ip
($network)) {
847 # do not keep tunnel open when asked for migration ip
851 if ($param->{'run-command'}) {
852 my $cmd = $param->{'extra-args'};
853 die "missing command\n"
854 if !$cmd || !scalar(@$cmd);
856 # Get an ip address to listen on, and find a free migration port
858 if (defined($network)) {
859 $ip = PVE
::Cluster
::get_local_migration_ip
($network)
860 or die "failed to get migration IP address to listen on\n";
861 $family = PVE
::Tools
::get_host_address_family
($ip);
863 my $nodename = PVE
::INotify
::nodename
();
864 ($ip, $family) = PVE
::Network
::get_ip_from_hostname
($nodename, 0);
866 my $port = PVE
::Tools
::next_migrate_port
($family, $ip);
868 PVE
::Tools
::pipe_socket_to_command
($cmd, $ip, $port);
872 print "tunnel online\n";
875 while (my $line = <STDIN
>) {
877 last if $line =~ m/^quit$/;
885 keygen
=> [ __PACKAGE__
, 'keygen', ['filename']],
886 create
=> [ __PACKAGE__
, 'create', ['clustername']],
887 add
=> [ __PACKAGE__
, 'add', ['hostname']],
888 addnode
=> [ __PACKAGE__
, 'addnode', ['node']],
889 delnode
=> [ __PACKAGE__
, 'delnode', ['node']],
890 status
=> [ __PACKAGE__
, 'status' ],
891 nodes
=> [ __PACKAGE__
, 'nodes' ],
892 expected
=> [ __PACKAGE__
, 'expected', ['expected']],
893 updatecerts
=> [ __PACKAGE__
, 'updatecerts', []],
894 mtunnel
=> [ __PACKAGE__
, 'mtunnel', ['extra-args']],