From a76cb5331c626bb7ce3c963bb4f3924f91c5ed01 Mon Sep 17 00:00:00 2001 From: Tracey Clark Date: Tue, 16 Jan 2024 20:40:24 -0600 Subject: [PATCH] Fixed more review issues, fixed numbering to be dynamic --- docs/user/troubleshooting/plasma.md | 52 ++++++++++------------------- 1 file changed, 18 insertions(+), 34 deletions(-) diff --git a/docs/user/troubleshooting/plasma.md b/docs/user/troubleshooting/plasma.md index 8fb0d63f7..73398b694 100644 --- a/docs/user/troubleshooting/plasma.md +++ b/docs/user/troubleshooting/plasma.md @@ -19,13 +19,12 @@ This is often caused by a Firefox bug. It can be triggered by various things, li You may not need to reboot to recover from this state. Killing all firefox processes may be all that's necessary. To do so: 1. Open a virtual terminal by pressing `Ctrl+Alt+F3`. -2. Run the following to kill all firefox windows: +1. Run the following to kill all firefox windows: ```bash killall firefox ``` This should close all Firefox windows. -3. Return to the Plasma session by pressing `Ctrl-Alt-F2`. - +1. Return to the Plasma session by pressing `Ctrl+Alt+F2`. You should now be able to use Plasma normally. ## Application windows look corrupt / incomplete @@ -34,52 +33,41 @@ You may not need to reboot to recover from this state. Killing all firefox proce - Application windows look corrupt. For example, NeoChat does not display room or user icons. - Menus in an application are blank. -You may be able to fix this by clearing KDE / Plasma cache files, by following the steps below. +You may be able to fix this by clearing KDE / Plasma cache files. -:::caution +:::cautionImportant -You should not be logged into your Plasma session while doing this. It is also highly recommended to back up the folders mentioned below before deleting anything. +You should not be logged into your Plasma session while deleting the cache files, booting from a live USB is necessary. ::: -1. While still logged into your Plasma session, cd to your home directory: - +1. While still logged into your Plasma session, go to your home directory: ```bash cd ``` - -2. Run these commands to back up the following directories: - +1. Run these commands to back up the following directories: ```bash cp -av ~/.kde{,.bak} cp -av ~/.config{,.bak} cp -av ~/.local{,.bak} cp -av ~/share{,.bak} ``` - - The output will show what files were copied. Each directory will have another copy with a .bak extension such as `~/.config.bak`. These can be used to recover configuration files, if necessary. - -2. Shut down the system. Boot from a live USB, such as one of the Solus live environments. -3. Mount your hard drive's system. For instructions on how to do this see [Mounting your system](/docs/user/troubleshooting/boot-rescue#mounting-your-system). -4. Change to your user's directory where you mounted your system. In this example, your system has been mounted to `/mount`: - + The commands create a copy of the folders. Each copy has the `.bak` extension (Example: `~/.config.bak`). These can be used to recover configuration files, if necessary. +1. Shut down the system. +1. Boot from a live USB, which you can create from one of the [Solus installers](https://getsol.us/download/). +1. [Mount your hard drive's file system](./boot-rescue.md#mounting-your-system). +1. Change to your user's directory where you mounted your file system. For example, if you used `/mount`: ```bash cd /mount/home/username ``` - Replace "username" with the username you use for Solus. You can make sure the directory is correct by listing the files: - ```bash ls -laH ``` - You should see the files you would usually see in your home directory when logged into Solus normally. - -5. Now you need to remove the various caches that Plasma uses. - - Run the following from your home directory that you just switched to: - +1. Remove the various caches that Plasma uses. + Execute the following commands: ```bash rm -rf .kde rm -rf .cache/plasmashell* @@ -97,16 +85,12 @@ You should not be logged into your Plasma session while doing this. It is also h rm -f plasma* rm -rf kde* akonadi* KDE kconf_updaterc baloo* dolphinrc drkonqirc gwenviewrc kmail2rc k*rc katemetainfos ``` -6. Shut down the live environment and remove the live USB drive. -7. Reboot back into your regular Plasma session. Check the application to see if it looks OK now. -8. It should not be necessary to recover the cache files that were deleted. If you need to, you can recover a file by copying it from the backup directory to the actual directory. +1. Shut down the live environment and remove the live USB drive. +1. Reboot back into your regular Plasma session. Verify the issue is fixed. +1. If you experience system instability, restore the previously backed up folders. - For example, to recover the file `.kde/share/config/kdeglobals`: - ``` - cp -av .kde.bak/share/config/kdeglobals .kde/share/config/kdeglobals - ``` To restore an entire directory: ``` cp -rav .kde.bak/share/config/ .kde/share/config ``` - After restoring the file(s) or directories, log out of Plasma and log back in. \ No newline at end of file + After restoring the file(s) or directories, restart your system. \ No newline at end of file