Uninstall Connext for Debian
############################

This section details how to successfully uninstall |ConnextShort| Debian packages 
using standard Debian ``apt`` commands. 

Basic Removal
*************
Use the ``apt remove`` command to uninstall some or all |ConnextShort| packages 
from your Debian system. 

Remove specific packages
------------------------
Use ``apt remove --autoremove`` to uninstall a specific package and its 
dependencies. For example, to uninstall all packages installed by a 
:ref:`section-basic-installation`:

.. code-block:: shell

   apt remove --autoremove rti-connext-dds-<version>

The ``--autoremove`` option removes any packages automatically installed 
as a dependency for the removed package, if no other installed packages 
are still dependent on them. 

Remove all packages
-------------------
The ``rti-connext-dds-<version>-common`` package is a required dependency 
for all other |ConnextShort| packages. If you want to uninstall all |ConnextShort| Debian 
packages from your system, remove the ``rti-connext-dds-<version>-common`` 
package:

.. code-block:: shell

   apt remove rti-connext-dds-<version>-common

Files not removed
-----------------
The``apt remove`` command does not remove the following:

- Files marked as conffiles. See the table :ref:`TableConffiles`  
  for a list of these files. See the `Debian Policy Manual <https://www.debian.org/doc/debian-policy/ap-pkg-conffiles.html>`_ 
  for information about conffiles. 
- Entries the removed package(s) added to the ``debconf`` database.

The ``debconf`` database stores your RTI License Agreement response. Since 
these database entries are not removed, your response is preserved even 
after the ``rti-connext-dds-<version>-common``  package has been removed. 
As a result, you won't be required to accept the license again the next 
time you install a |ConnextShort| Debian package.

.. list-table:: Connext Debian Package Conffiles
   :name: TableConffiles
   :widths: 40 60
   :header-rows: 1

   * - Package
     - conffiles
   * - ``rti-connext-dds-<version>-common``
     - * ``/opt/rti.com/rti_connext_dds-<version>/rti_license.dat``
       * ``/opt/rti.com/rti_connext_dds-<version>/rti_versions.xml``
       * ``/opt/rti.com/rti_connext_dds-<version>/resource/scripts/rticommon_config.sh``

.. _section-complete-removal:

Complete Removal
****************

Use ``apt purge`` to uninstall all |ConnextShort| packages from your Debian system. 
Since the ``rti-connext-dds-<version>-common`` package is  a required 
dependency for all |ConnextShort| packages, purging it will also remove all 
other |ConnextShort| Debian packages.

Use the following command to completely remove |ConnextShort| from your Debian system:

.. code-block:: shell
   
   apt purge rti-connext-dds-<version>-common

This command completes the following actions:

- Uninstalls all |ConnextShort| Debian packages for the selected <version>. 
- Deletes the ``/opt/rti.com/rti_connext_dds-<version>`` installation 
  directory.
- Clears all entries added by a |ConnextShort| Debian package from the ``debconf`` 
  database.

After purging |ConnextShort|, you have to manually remove the 
``${HOME}/rti_workspace/<version>/`` directory, if it exists. This directory 
is automatically created after running an executable in 
``/opt/rti.com/rti_connext_dds-<version>/bin`` after installing the 
``rti-connext-dds-<version>-workspace`` package.