Uninstallation Guide#

The following guide describes the process of uninstalling the platform.

Note

Please contact your Intel® Geti™ account representative or technical support personnel if you have any questions.

Uninstalling the Intel® Geti™ platform#

To uninstall the platform, you can use the platform_installer script from the package that was used to install or upgrade the platform.

To uninstall the platform run the following command:

sudo ./platform_installer uninstall

or

sudo ./platform_installer uninstall --config-file my_config.yaml

depending on whether you want to pass the parameters manually or via a config file.

Uninstall with wizard#

When running in the wizard mode, the installer will prompt for the following data:

  1. Uninstall k3s and platform (in case k3s was installed by the platform’s installer) or only the platform. To uninstall k3s, the process has to be run on the master node of the kubernetes cluster, the same, on which the platform (with k3s) has been installed originally.

    Do you want to uninstall the underlying Kubernetes cluster as well? (Y/n)
    

    If the answer is ‘n’ the installer asks for the Kubernetes admin kubeconfig location:

    Path to kubeconfig file (example: /home/my-user/admin.conf):
    
  2. Confirm the data deletion. When confirmed, the folder specified as ‘Path to the data storage’ will be deleted.

    Do you want do delete all the platform data, including models, datasets, and users data? (Y/n)
    
  3. Review your answers and confirm.

    Platform version: <version>
    Do you want to uninstall k3s? You will irreversibly lose your k3s deployment. (y/N):
    
    < Or, depending on user's choice >
    Do you want to uninstall k3s? You will irreversibly lose your k3s deployment, all the platform data, including models, datasets, and users data. (y/N):
    
    < Or >
    You will be asked to provide the password if you are not logged in as
    Do you want to irreversibly uninstall the platform? (y/N):
    
    < Or >
    Do you want to irreversibly uninstall the platform and delete all the platform data, including models, datasets, and users data? (y/N):
    

Uninstall with configuration file#

If the –config-file parameter is provided, the script will be executed without any user interaction.

The configuration file is a yaml file with all configuration data specified in advance. The template for the file can be found in the installation package in the platform folder and it has the following initial content:

# Path to the admin kubeconfig file for platform uninstallation on existing Kubernetes
# If empty or entry missing it is assumed that k3s and platform will be uninstalled on the local machine
kube_config:

# Do you want to delete all the platform data, including models, datasets, and users data?
# ('Yes' if not specified)
# Example entry:
# delete_data: No
delete_data:

Troubleshooting#

  1. If uninstallation of the k3s based deployment fails, you can remove it by uninstalling k3s and removing data folder contents:

    sudo /usr/local/bin/k3s-uninstall.sh
    sudo rm -fr /<data_folder>/*
    
  2. If the user inadvertently uninstalls k3s, it is not required to execute any Intel® Geti™ uninstallation. The only action needed is the deletion of the data folder. The platform does not retain any data beyond k3s and the data folder.

  3. To investigate problems during the uninstallation, the following logs are available:

    Location

    Contents

    platform_logs/k3s_uninstall.log

    Uninstallation of k3s

    platform_logs/ansible.log

    Platform installation/upgrade/uninstallation