Troubleshooting#

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.
If you exceed the ‘low space’ warning threshold, run the following command to remove some temporary files:
```
rm /data-xfs/ie_storage/imports/*
```
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>/*
```
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.
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.
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.
If your installation fails at the ansible step, check the platform_logs/ansible.log. If you find errors related to the task: [utils/apt/install : Install Package] with a message msg: <class 'apt_pkg.Cache> returned a result with an error set and the following error message [...] The error was: 'dict object' has no attribute 'stderr', follow the steps below.
1. Run the command locale to check the current locale settings
```
locale
```
  Note
  
  If the output shows variable set .UTF-8, the issue lies elsewhere.
2. Install language package (example for German):
```
apt-get install language-pack-de -y
```
3. (Optional) Back up your current locale file
```
cp /etc/default/locale /etc/default/locale.bak
```
4. Reconfigure your locale settings by running:
```
dpkg-reconfigure locales
```
  - Select desired language with .UTF-8 suffix using Space, then press Enter
  - Choose your default locale with .UTF-8 ending
5. Set language for all users in /etc/profile or preferably create script /etc/profile.d/00-set-locale.sh. This is an alternative to setting the language in ~/.profile separately for each user. (Use previously selected language in place of: <lang>)
```
LANG=<lang>
LC_ALL=<lang>
LANGUAGE=<lang>
export LANG LC_ALL LANGUAGE
```
6. Open a new terminal session and verify that the locale settings have been updated by running:
```
locale
```
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