Troubleshooting#

  1. If you encounter the error ‘Due to the dpkg being busy it’s impossible to finish the installation’, stop your system update and then, rerun the installer.

  2. If you exceed the ‘low space’ warning threshold, run the following command to remove some temporary files:

    rm /data-xfs/ie_storage/imports/*
    
  3. 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>/*
    
  4. If, in rare cases, your installation or upgrade fails with apt-get related errors found in the ansible.log, ensure apt-get is configured properly, run:

    sudo apt-get update
    

    and rerun platform_installer.

  5. If a user forgets his/her password on an instance that does not have an SMPT (mail) server configured, run the platform_update_password.sh script from the installation package to generate a new password for the user.

  6. 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.

  7. To investigate problems during the installation, the following logs are available:

Location

Contents

platform_logs/install.log

Installation, gathering data, executing external tools

platform_logs/k3s_install.log

Installation of k3s

platform_logs/k3s_uninstall.log

Uninstallation of k3s

platform_logs/ansible.log

Platform installation/upgrade/uninstallation