Asking and Reporting the Smart Way

Note

It would be far easier when there are issues or questions, someone could just physically work on your system to see what is running, how it was installed and what hardware is in use. But with FOSS that luxury is rarely there, so all need to rely on users providing comprehensive info for any issue they might have found, question they have or problems faced. Here we’ll try to give as many options as possible to let you ask and report the smart way.

Sysinfo Tool in Octopi

KaOS provides you with an easy to use option to give very complete info about all of your system. Open Octopi and go to the Tools menu, there click on Sysinfo, or you can use your keyboard in Octopi with shortcut:

Ctrl-Shift-S

That will open a pop-up window, with information on what logs will be gathered and the path to your home directory were the octopi-sysinfo log will be created. It will take 10-20 seconds to gather all info. After checking the report you can now use a pastebin service or copy/paste it directly in the forum, a bug report, Gitter or provide it in IRC.

Info to provide for Installation Issues

If for any reason you are faced with problems in Live mode or running the installer, first follow this check-list:

1. How did you create the Live Media? Make sure to follow the tutorials to properly create installation media for KaOS. See USB and DVD creation guides.

2. Did you check the sha256sum of the downloaded ISO?

   sha256sum /path/to/the/downloaded/<kaOS>.iso

   compare the result with the sha256sum provided on the Download page, make sure they match

3. Are you using a GPT partition table on a BIOS system? If so, follow the instruction to set up properly since the installer cannot create such a setup yet. See Create GPT on BIOS

4. Provide the installation log:

   • Live Mode: ~/installation.log
   • Installed System: /var/log/installation.log

Disk layout info is often needed. Many installation related errors are due to incompatible settings, wrong partition table for chosen settings, selecting an automated partitioning option while only the manual option is viable for a certain layout. To provide that info run:

sudo blkid

and:

sudo fdisk -l

Using a Pastebin Service to Provide Info

All examples so far create text info that often is too large to add to a forum post, not possible supply in an IRC channel or hard to read when added to an email. It is much cleaner and easier to copy the output of any command and paste it into a service like:

https://bin.disroot.org/
https://gist.github.com/
http://pastebin.com

After pasting in your info, just hit “submit” or “paste”, it will return a URL that you can use to link to.

Creating a Pacman Log

The sysinfo tool in Octopi creates a very complete set of logs, but there are times it is easier to get individual logs or more details are needed.

Whenever there are update issues, always provide a pacman log. It often is not needed to use more of this log than one week prior to the current date of any update issue. To see the full log:

kate /var/log/pacman.log

Scroll down to the appropriate date and pastebin the relevant section.

Using Dinit Logs

Many of the Dinit services used in KaOS will create a log in /var/log, you can check there for any issue with a specific service.

sudo dinitctl list

This will provide a list with all running services and the status of each of those services.

sudo dinitctl status greetd

This will show the status of the greetd service.

For a more complete list of what dinitctl can do read:

https://davmac.org/projects/dinit/man-pages-html/dinitctl.8.html
https://davmac.org/projects/dinit/man-pages-html/dinit-monitor.8.html