Uninstalling AEN (AEN 4.2.1)

Each AEN node must be uninstalled separately.

Begin by setting the AEN Functional ID (NFI). The NFI is the username of the AEN Service Account which is used to run all AEN services and is also the username of the AEN Admin account. The NFI may be any name. The default NFI is wakari. The NFI is also often set to aen_admin. The NFI (and AEN Functional Group or NFG) are described in the installation instructions.

Set the NFI with this command:

export AEN_SRVC_ACCT="aen_admin"

Replace the name aen_admin with the NFI that was set in your installation of Anaconda Enterprise Notebooks.

Uninstalling a server node

To remove a server node, run the following commands as root or sudo on the server node’s host system:

1. Stop the server processes:

   service wakari-server stop
   

2. Stop MongoDB:

   service mongod stop
   

3. Remove AEN server software, AEN database files and NGINX configuration:

   rm -Rf /opt/wakari/wakari-server
   rm -Rf /opt/wakari/miniconda
   rm -Rf /var/lib/mongo/wakari*
   rm -Rf /etc/nginx/conf.d/www.enterprise.conf
   

   NOTE: Remove /etc/nginx/conf.d/www.enterprise.https.conf if SSL is enabled on the Server node.

4. Restart MongoDB and NGINX:

   service mongod restart
   service nginx restart
   

5. Check for any outstanding server processes and stop them:

   ps -ef | grep -e wakari-server -e wk-server
   

6. Remove the AEN Service Account:

   userdel $AEN_SRVC_ACCT
   

7. Check for and remove any references to “aen” or “wakari” from the root user’s .condarc file:

   grep -i aen ~/.condarc
   grep -i wakari ~/.condarc
   

Uninstalling a gateway node

To uninstall a gateway node, run the following commands as root or sudo on the gateway host system:

1. Stop the gateway processes:

   service wakari-gateway stop
   

2. Remove gateway software:

   rm -Rf /opt/wakari/wakari-gateway
   

3. Check for any outstanding gateway processes and stop them:

   ps -ef | grep -e wakari-gateway -e wk-gateway
   

4. Remove the AEN Service Account:

   userdel $AEN_SRVC_ACCT
   

5. Check for and remove any references to “aen” or “wakari” from the root user’s .condarc file:

   grep -i aen ~/.condarc
   grep -i wakari ~/.condarc
   

Uninstalling a compute node

To remove a compute node, run the following commands as root or sudo on each compute node host system:

1. Stop the compute processes:

   service wakari-compute stop
   

2. Remove the compute software:

   rm -Rf /opt/wakari/wakari-compute
   rm -Rf /opt/wakari/miniconda
   rm -Rf /opt/wakari/anaconda
   

3. Check for any outstanding compute processes and stop them:

   ps -ef | grep -e wakari-compute -e wk-compute
   

4. Remove the AEN Service Account:

   userdel $AEN_SRVC_ACCT
   

5. Check for and remove any references to “aen” or “wakari” from the root user’s .condarc file:

   grep -i aen ~/.condarc
   grep -i wakari ~/.condarc
   

OPTIONAL: Removing projects from compute nodes

CAUTION: This is an extreme measure and is not necessary in most instances. We recommend you create and verify a backup before doing this or any other file removal.

To remove all AEN projects from all of your compute nodes:

rm -Rf /projects