mirror of
https://github.com/xcat2/xcat-core.git
synced 2025-06-03 03:50:08 +00:00
restructure uninstall xcat doc
This commit is contained in:
huweihua
parent
0495555413
commit
4ae0d45fde
@ -0,0 +1,25 @@
|
||||
Backup and Restore xCAT
|
||||
=======================
|
||||
|
||||
|
||||
Backup xCAT User Data
|
||||
---------------------
|
||||
|
||||
Before removing xCAT, recommend to backup xCAT database. It's convenient to restore xCAT management environment in the future if needed. ::
|
||||
|
||||
dumpxCATdb -p <path_to_save_the_database>
|
||||
|
||||
For more information of on ``dumpxCATdb``, please refer to :doc:`dumpxCATdb </guides/admin-guides/references/man1/dumpxCATdb.1>`.
|
||||
|
||||
|
||||
|
||||
|
||||
Restore xCAT User Data
|
||||
----------------------
|
||||
|
||||
If need to restore xCAT environment, after :doc:`xCAT software installation </guides/install-guides/index>`, you can restore xCAT DB by data files dumped in the past. ::
|
||||
|
||||
restorexCATdb -p <path_to_save_the_database>
|
||||
|
||||
For more information of on ``restorexCATdb``, please refer to :doc:`restorexCATdb </guides/admin-guides/references/man1/restorexCATdb.1>`.
|
||||
|
||||
8
docs/source/guides/install-guides/maintenance/index.rst
Normal file
8
docs/source/guides/install-guides/maintenance/index.rst
Normal file
@ -0,0 +1,8 @@
|
||||
Maintenance
|
||||
===========
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
backup_restore_xcat.rst
|
||||
uninstall_xcat.rst
|
||||
224
docs/source/guides/install-guides/maintenance/uninstall_xcat.rst
Normal file
224
docs/source/guides/install-guides/maintenance/uninstall_xcat.rst
Normal file
@ -0,0 +1,224 @@
|
||||
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. below list maybe helpful for you. They are the packages list of xcat installation tarball. These list are the whole RPMs list, it's possible for some RPMs not to be installed due to them are not suitable for your environment. Please do judgment by yourself.
|
||||
|
||||
* 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) <http://xcat.org/files/xcat/repos/yum/xcat-dep/>`_
|
||||
|
||||
`Debian Packages List (Ubuntu) <http://xcat.org/files/xcat/repos/apt/xcat-dep/>`_
|
||||
|
||||
|
||||
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
|
||||
----------------
|
||||
|
||||
* :doc:`Removing xCAT DB from PostgreSQL </advanced/hierarchy/databases/postgres_remove>`.
|
||||
|
||||
* :doc:`Removing xCAT DB from MySQL/MariaDB </advanced/hierarchy/databases/mysql_remove>`.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user