Testing and bug reporting

From PCLinuxOShelp Knowledge Base

Jump to: navigation, search
  • Relevant to all editions of PCLinuxOS.


This page should give you a brief introduction to testing and bug reporting for PCLinuxOS. If you are interested in contributing this way, please follow the instructions and join. Welcome!


Testing and bug reporting is an important way to contribute to PCLinuxOS and make it perfect. PCLinuxOS relies on a dedicated band of testers to properly check each and every package in a separate section of the repository before being released for wider usage in the general section.

Testing is the process to ensure that PCLinuxOS keeps rolling.

After packages (applications) are built and before they are launched into the stable environment each package is made available for testing to ensure that it does not adversely affect an install. These packages are placed into the "test" section of the repository.

During the testing process, it is a possibility that an install is rendered broken, or have other problems. The testing process expects this and our testers work together to solve these issues.

Contraindications to testing

It is not recommended to activate testing :

  • On a production machine or one that you have important information on.
  • If you feel that you are not able to troubleshoot or support an install yourself.

If you do not feel that you are experienced enough to activate testing DO NOT DO IT. Instead watch the threads within the testing area and see what is reported and the kind of issues that are faced. Eventually you may be confident enough to sign up as a tester.

How to join the list of testers

  • Go to this running thread http://www.pclinuxos.com/forum/index.php/topic,104577.0.html
  • Read the first post and then copy paste the disclaimer and then sign it.
  • Wait for a Personal Message from an administrator.
  • Reply if asked with a brief explanation as to why do you want to be a Tester.
  • Wait for approval.
  • Start testing away!

Points to remember

  • Once you activate the test section of the repository, you immediately lose support for that install in the "stable" part of the forum. For this reason alone we suggest that you use a separate partition or safer still a separate machine for your testing install.
  • Problems found in testing must only be discussed in the testing area the forum. It is against the forum rules to discuss test packages in the other (help) sections of the forum.
  • There is no guarantee that the dev-team will answer problems or reports in the testing section of the forum. It is not a "support" board. Problem packages may simply be withdrawn.
  • Using real life hardware "bare-steel" is preferred. Virtual Box and its likes are not a good testing environment as the troubleshooting potential is very limited (as its not real hardware) but maybe alright for some application trouble shooting.
  • By activating testing you accept that the install is temporary. On occasion you may be asked to reinstall in the process.
  • When you activate testing you are accepting that PCLinuxOS has no liability to loss of information or other issues that may develop from being an active tester.
  • When testing is activated, it is very important to ensure you do not install software from outside the repository. This will taint your testing environment and give false information about your install should the external application replace existing libs (libraries) when it is installed.
  • Remember that the more information you supply, the better. As in asking for support, if you don't tell us about what you have done and what results you got, we will not know. And just as in a request for support, "It don't work" is not information; it is a story.
  • Logs can be a wealth of troubleshooting information.
    • Although some application program logs can be scattered around the file system's directories, many of them are somewhere in your user's home directory.
    • The most important system log files are kept in the /var/log directory.
  • Kernel updates are independent of general system updates for PCLinuxOS. So if possible test with both the default kernel for the latest .iso and with the latest kernel available in the repository.

How to enable testing

The "test' section of the repository is accessible via an option within the Synaptic package manager.

  • Open Synaptic. Go to Settings > Repositories. Click and highlight the line corresponding to your mirror such that the URI box should show the address of your selected mirror.
  • Now look in the Section(s) box. You should see :
x86_64 kde5 xfce4 
  • Now click at the end of the above line and add test at the end so that your line should now read :
x86_64 kde5 xfce4 test
  • The result should look like this : Synaptic enable testing
  • Click OK and hit Reload.

NOTE : Activating test is a simple process, but one that renders your install unsupportable in the stable part of the forum.

How to know what is new for testing

  • Watch for posts in the testing section of the forum
  • Click on Reload in Synaptic, click on the Status button on lower left and then New in repository on the left. This will show you the new packages that have been added to be tested.
  • New versions of packages that you have installed will show in the Upgradable list.
  • Packages in testing will have test in the component column

Important links

Personal tools