uninstall_xcat.rst

Remove xCAT

We're sorry to see you go! Here are some steps for removing the xCAT product.

Clean Up xCAT Related Configuration

1. To clean up the node information from dhcp :

   makedhcp -d -a

2. To clean up the node information in tftpboot :

   nodeset all offline

3. To clean up the node information from /etc/hosts (optional)

Keeping xCAT nodes information in /etc/hosts is harmless, but if you really want to remove them from /etc/hosts run: :

makehosts -d all  

4. To clean up the node information from DNS (optional)

After removing all the nodes from /etc/hosts, run below command to clean up the node information from DNS. :

makedns -n

Stop xCAT Service

1. Stop xCAT service :

   service xcatd stop

2. Stop xCAT related services(Optional)

XCAT uses various network services on the management node and service nodes, the network services setup by xCAT may need to be cleaned up on the management node and service nodes before uninstalling xCAT.

• NFS : Stop nfs service, unexport all the file systems exported by xCAT, and remove the xCAT file systems from /etc/exports.
• HTTP: Stop http service, remove the xcat.conf in the http configuration directory.
• TFTP: Stop tftp service, remove the tftp files created by xCAT in tftp directory.
• DHCP: Stop dhcp service, remove the configuration made by xCAT in dhcp configuration files.
• DNS : Stop the named service, remove the named entries created by xCAT from the named database.

Remove xCAT Files

1. Remove the xCAT RPMs

There is no easy way to distinct all the packages depending by xCAT. For packages shipped by xCAT, you can remove them by the commands below.

[RHEL and SLES] :

rpm -qa |grep -i xcat

[Ubuntu] :

dpkg -l | awk '/xcat/ { print $2 }'

If you want to remove more cleanly, the list below maybe helpful. Listed are the packages of xcat installation tarball. Some RPMs may not to be installed in a specific environment.

• XCAT Core Packages list (xcat-core):

  [RHEL and SLES] :

  perl-xCAT
  xCAT
  xCAT-buildkit
  xCAT-client
  xCAT-confluent
  xCAT-genesis-scripts-ppc64
  xCAT-genesis-scripts-x86_64
  xCAT-server
  xCATsn
  xCAT-SoftLayer
  xCAT-test
  xCAT-vlan

  [Ubuntu] :

  perl-xcat
  xcat
  xcat-buildkit
  xcat-client
  xcat-confluent
  xcat-genesis-scripts
  xcat-server
  xcatsn
  xcat-test
  xcat-vlan

• XCAT Dependency Packages (xcat-dep):

  [RHEL and SLES] :

  conserver-xcat cpio cpio-lang elilo-xcat esxboot-xcat fping ganglia-devel ganglia-gmetad ganglia-gmond ganglia-gmond-modules-python ganglia-web grub2-xcat ipmitool-xcat libconfuse libconfuse-devel libganglia lldpd net-snmp-perl perl-AppConfig perl-Compress-Raw-Zlib perl-Crypt-Blowfish perl-Crypt-CBC perl-Crypt-Rijndael perl-Crypt-SSLeay perl-DBD-DB2 perl-DBD-DB2Lite perl-DBD-Pg perl-DBD-SQLite perl-Expect perl-HTML-Form perl-IO-Compress-Base perl-IO-Compress-Zlib perl-IO-Socket-SSL perl-IO-Stty perl-IO-Tty perl-JSON perl-Net-DNS perl-Net-Telnet perl-SOAP-Lite perl-Test-Manifest perl-version perl-XML-Simple pyodbc rrdtool scsi-target-utils stunnel syslinux-xcat systemconfigurator systemimager-client systemimager-common systemimager-server xCAT-genesis-base-ppc64 xCAT-genesis-base-x86_64 xCAT-genesis-x86_64 xCAT-UI-deps xnba-kvm xnba-undi yaboot-xcat zhcp

  [Ubuntu] :

  conserver-xcat elilo-xcat grub2-xcat ipmitool-xcat syslinux syslinux-extlinux syslinux-xcat xcat-genesis-base-amd64 xcat-genesis-base-ppc64 xnba-undi

Along with xCAT development, above lists maybe change, you can get the latest list through below links:

• XCAT Core Packages List (xcat-core)

  [RHEL and SLES] :

  http://xcat.org/files/xcat/repos/yum/<version>/xcat-core/

  [Ubuntu] :

  http://xcat.org/files/xcat/repos/apt/<version>/xcat-core/

• XCAT Dependency Packages (xcat-dep)

RPM Packages List (RHEL and SLES)

Debian Packages List (Ubuntu)

Generally, we use yum install xCAT to install xCAT, so these are some RPMs shipped by operating system are installed during xCAT installation. We don't have an easy way to find out all of them, but keep these RPMs are harmless.

2. Remove xCAT certificate file :

   rm -rf /root/.xcat

3. Remove xCAT data file

By default, xCAT use SQLite, remove SQLite data file under /etc/xcat/. :

rm -rf /etc/xcat

4. Remove xCAT related file(Optional)

XCAT has ever operated below directory when it was running. Do judgment by yourself before removing these directory, to avoid removing some directories used for other purpose in your environment. :

/install
/tftpboot
/etc/yum.repos.d/xCAT-*
/etc/sysconfig/xcat
/etc/apache2/conf.d/xCAT-*
/etc/logrotate.d/xCAT-*
/etc/rsyslogd.d/xCAT-*
/var/log/xcat   
/opt/xcat/
/mnt/xcat  

Remove Databases

• Removing xCAT DB from PostgreSQL </advanced/hierarchy/databases/postgres_remove>.
• Removing xCAT DB from MySQL/MariaDB </advanced/hierarchy/databases/mysql_remove>.