xCAT Management Node Migration
This document describes how to migrate xCAT Management node to a new node. The following example describes a typical scenario, this example is verified on redhat7.3.
Initially, the first xcat management node is active, and the second node is passive.
Backup all useful xCAT data from xCAT Management node to back-up server at regular intervals.
When the first xCAT management node is broken, use backup to restore original xCAT data to the second node with the same host name and ip.
Backup Old xCAT Management Node
Backup xCAT management node data to backup server:
1.1 Backup xCAT important files and directories:
Get
installdir
fromsite
table, backupinstalldir
directory, in this case, back upinstall
directory:lsdef -t site clustersite -i installdir Object name: clustersite installdir=/installBackup these two xCAT directories:
~/.xcat /etc/xcatNote
Backing up
~/.xcat
is for all users who have xCAT client certs.If there are customized files and directories for
otherpkgdir
,pkgdir
,pkglist
ortemplate
in some osimage definitions, backup these files and directories. for example:lsdef -t osimage customized_rhels7.4-x86_64-install-compute -i otherpkgdir,pkgdir,pkglist,template Object name: customized_rhels7.4-x86_64-install-compute otherpkgdir=/<customized_dir>/post/otherpkgs/rhels7.4/x86_64 pkgdir=/<customized_pkgdir>/rhels7.4/x86_64 pkglist=/<customized_pkglist_dir>/compute.rhels7.pkglist template=/<customized_temp_dir>/compute.rhels7.tmpl
1.2 Backup ssh related files:
/etc/ssh
~/.ssh
1.3 Backup host files:
/etc/resolv.conf
/etc/hosts
/etc/passwd
/etc/group
1.4 Backup yum resource files:
/etc/yum.repos.d
1.5 Backup conserver conf files:
/etc/conserver.cf
1.6 Backup DNS related files:
/etc/named
/etc/named.conf
/etc/named.iscdlv.key
/etc/named.root.key
/etc/rndc.key
/etc/sysconfig/named
/var/named
1.7 Backup dhcp files:
/etc/dhcp
/var/lib/dhcpd
/etc/sysconfig/dhcpd
/etc/sysconfig/dhcpd6
1.8 Backup apache:
/etc/httpd
/var/www
1.9 Backup tftp files:
/tftpboot
1.10 Backup NTP configure file:
/etc/ntp.conf
1.11 Backup database configure files (optional):
[PostgreSQL]
/var/lib/pgsql/data/pg_hba.conf /var/lib/pgsql/data/postgresql.conf
1.12 Backup NFS (optional):
/etc/exports
/var/lib/nfs
/etc/sysconfig/nfs
1.13 (optional)
Besides the files mentioned above, there may be some additional customization files and production files that need to be backup, depending on your local unique requirements. Here are some example files that can be considered:
/.profile
/.rhosts
/etc/auto_master
/etc/auto/maps/auto.u
/etc/motd
/etc/security/limits
/etc/netscvc.conf
/etc/inetd.conf
/etc/security/passwd
/etc/security/group
/etc/services
/etc/inittab(andmore)
1.14 Backup the xCAT database tables for the current configuration, using command:
dumpxCATdb -p <your_backup_dir>
1.15 Save all installed xCAT RPM names into a file:
rpm -qa|grep -i xCAT > xcat_rpm_names
1.16 (Optional) Find customization made to files installed from packages, backup these files. For example
rpm -q --verify -a conserver-xcat
rpm -q --verify -a xCAT-server
rpm -q --verify -a syslinux-xcat
rpm -q --verify -a xCAT-client
rpm -q --verify -a xCAT
Restore xCAT management node
2.1 Power off old xCAT management server before configuring new xCAT management server
2.2 Configure new xCAT management server using the same ip and hostname as old xCAT management server. Configure the same additional network for hardware management network if needed, for example, bmc network or hmc network. xCAT management server setup refer to Prepare the Management Node
2.3 Overwrite files/directories mentioned in above 1.2, 1.3, 1.4 from backup server to new xCAT management server
2.4 Download xcat-core and xcat-dep tar ball, then install xCAT in new xCAT management server, refer to install xCAT
2.5 Use rpm -qa|grep -i xCAT
to list all xCAT RPMs in new xCAT management node, compare these RPMs base name with those in xcat_rpm_names
from above 1.15. If some RPMs are missing, use yum install <rpm_package_basename>
to install missing RPMs.
2.6 If use MySQL
/MariaDB
/PostgreSQL
, migrate xCAT to use MySQL/MariaDB/PostgreSQL
refer to Configure a Database
2.7 To restore the xCAT database
Restore xCAT database from the
/dbbackup/db
directory withoutauditlog
andeventlog
, enter:restorexCATdb -p /dbbackup/dbRestore the xCAT database including
auditlog
andeventlog
from the/dbbackup/db
directory, enter:restorexCATdb -a -p /dbbackup/db(optional) Overwrite files in above 1.11, restart
PostgreSQL
:service postgresql restart
2.8 Overwrite remaining files/directories mentioned in above 1.1, 1.5, 1.6, 1.7, 1.8, 1.9, 1.10, 1.12; If needed, check if files exist based on above 1.13 and 1.16.
2.9 Verify xCAT:
tabdump site
2.10 Restart named
, use nslookup
to check DNS
:
service named restart
nslookup <cn1>
2.11 Restart conserver
, use rcons
to check console:
service conserver restart
rcons <cn1>
2.12 Configure DHCP:
makedhcp -n
makedhcp -a
2.13 Restart httpd
for REST API, for more information refer to Rest API:
service httpd restart