Difference between revisions of "Update Your PCLinuxOS"

From PCLinuxOSHelp Knowledge Base
Jump to: navigation, search
(update)
Line 3: Line 3:
 
=== Introduction ===
 
=== Introduction ===
  
''PCLinuxOS'' is a Linux distribution that follows the system of rolling updates. It means that you do not need to reinstall each time an update is released and when fully updated you have the most current system. However it is very important to update properly to make sure that your system does not break.
+
PCLinuxOS is a Linux distribution that follows the system of rolling updates. It means that you do not need to reinstall each time an update is released and when fully updated you already have the most current system. However it is very important to update properly to make sure that your system does not break. It is recommended that you do a proper system update as outlined below '''once every week or two'''.  Leaving a long gap between system updates may cause the update path for some software to breakdown. Do not wait more than 60 days to update your system.  
  
* It is recommended that you do a proper system update as outlined below '''once every week or two'''.
+
The update procedure below will properly update your system by updating, adding and removing packages as necessary. There are some important exceptions:
* Leaving a long gap between system updates may cause breakdown. Do not wait more than 60 days to update your system.  
 
  
[ '''PCLinuxOS DOES NOT AUTOMATICALLY UPDATE KERNELS;ONE SHOULD INSTALL NEW KERNELS MANUALLY FROM SYNAPTIC.''']
+
* The kernel is not updated but new kernels may be added if you have the '''kernel-latest''' package installed.  See [[Kernel|Kernel Updates]] for details.
 +
* The LibreOffice suite is updated manually or by using LibreOffice Manager.
 +
* VirtualBox is updated manually or by using VirtualBox Manager.
  
 +
PCLinuxOS updates are delivered over the internet so a working internet connection is needed. Broadband connections are preferred because sometimes the updates can be of the order of hundreds of MBs. So before proceeding with the update, make sure that you have a working internet connection.
  
=== Preparation ===
+
=== Updating using Synaptic ===
  
PCLinuxOS updates are delivered over the internet. A working internet connection is needed. Broadband connections are preferred because sometimes the updates can be of the order of hundreds of MBs. So before proceeding with the update, make sure that you have a working internet connection.
+
Synaptic is the software that manages the task of downloading and installing updates for your system. The software on your system is delivered as packages and hence Synaptic is also called package manager. You can launch it by any one of the following methods:
  
=== Locating Synaptic ===
+
* By clicking on Synaptic Package Manager icon in the taskbar near the left hand lower corner of your screen.    [[file:Synaptic_Locate.png]]
 +
* By going to PC Menu (Also called Kickoff Application Launcher) at the left hand lower corner of your screen > Applications > Software Centre > Synaptic Package Manager.
 +
* By typing 'synaptic' into a root terminal.
 +
* If you have one of the update-notifier applications installed they usually have an option for launching Synaptic.
  
[[file:300px-Synaptic_Ready.png]]
+
As soon as Synaptic starts, it scans your system for existing software and gets ready.  
 
 
Synaptic is the software that manages the task of downloading and installing updates for your system. The software on your system is delivered as packages and hence Synaptic is also called package manager. You can launch it by any one of the following 3 methods:
 
 
 
[[file:Synaptic_Locate.png]]
 
 
 
  * By clicking on Synaptic Package Manager icon in the taskbar near the left hand lower corner of your screen.
 
  * By going to PC Menu (Also called Kickoff Application Launcher) at the left hand lower corner of your screen > Applications > Software Centre > Package Manager.
 
  * By typing 'synaptic' into a terminal.
 
 
 
=== Running Synaptic ===
 
 
 
Since updating your system might require making changes to the system as a whole or changing important system files, Synaptic needs the privileges of super user or root. Hence while starting up Synaptic, you need to enter the root password first.
 
[http://www.example.com link title]
 
    As soon as Synaptic starts, it scans your system for existing software and gets ready.  
 
  
 
[[file:300px-Synaptic_Scanning.png]]
 
[[file:300px-Synaptic_Scanning.png]]
  
    Now you need to reload the package information to become informed about new, removed or upgraded software packages. Click on 'Reload' button.  
+
Now you need to reload the package information to become informed about new, removed or upgraded software packages. Click on 'Reload' button.  
  
 
[[file:300px-Synaptic_Reload.png]]
 
[[file:300px-Synaptic_Reload.png]]
  
    A window labelled 'Downloading package information' will come up and show the progress of this operation. Once the download is complete, Synaptic will do another scan and get ready for the next step.  
+
A window labelled 'Downloading package information' will come up and show the progress of this operation. Once the download is complete, Synaptic will do another scan and get ready for the next step.  
  
 
[[file:300px-Synaptic_Downloading_Package_Information.png]]
 
[[file:300px-Synaptic_Downloading_Package_Information.png]]
  
    Now click on 'Mark All Upgrades'.  
+
Now click on 'Mark All Upgrades'.  
  
 
[[file:300px-Synaptic_Mark_All_Upgrades.png]]
 
[[file:300px-Synaptic_Mark_All_Upgrades.png]]
  
 +
You will get another window with the prompt "Mark additional required changes?'. Go through the list and click on 'Mark'.
 +
 +
[[file:300px-Synaptic_Mark_Additional_Required_Changes.png]]
  
    You will get another window with the prompt "Mark additional required changes?'. Go through the list and click on 'Mark'.  
+
Now click on 'Apply'. You will be presented with another summary window. You can expand To be upgraded To be installed and To be removed sections by clicking on the small triangle before each line.  Pay '''attention''' to the To be removed section.  While it is normal for a few packages to be removed as part of an upgrade, if this list is very long without corresponding packages appearing in the To be installed section it could be an indication of a problem.
 +
After going through the list, click on 'Apply' to begin the actual process of downloading and installing updates. 
 +
[[file:300px-Synaptic_Apply_The_Following_Changes.png]]
  
[[file:300px-Synaptic_Mark_Additional_Required_Changes.png]]
+
Once the process is complete you may see another window showing some output. Some of the changes effected by Synaptic might require you to either log-off and log-in again or rarely in case of kernel update etc require you to reboot which would be shown in this window. After this you may close Synaptic.  
  
 +
If required, as mentioned above, log-off/log-in or reboot.
  
    Now click on 'Apply'. You will be presented with another summary window. After going through the list, click on 'Apply' to begin the actual process of downloading and installing updates.
+
That completes your system update.  
    You can expand To be upgraded and To be installed sections by clicking on the small triangle before each line.  
 
  
[[file:300px-Synaptic_Apply_The_Following_Changes.png]]
+
=== Updating using the command line ===
  
    Once the process is complete you may see another window showing some output. Some of the changes effected by Synaptic might require you to either log-off and log-in again or rarely in case of kernel update etc require you to reboot which would be shown in this window. After this you may close Synaptic.
+
For those who prefer to update using the command line the correct procedure is to use is:
  
    If required, as mentioned above, log-off/log-in or reboot.
+
apt-get update && apt-get dist-upgrade
  
    That completes your system update.  
+
The '''apt-get''' command is used to access the package management system.  You may be familiar with this command from Debian based distributions and it works in a similar (but not exactly the same) way on PCLinuxOS.  First we use '''update''' to get the current package list and only if that is successful then use '''dist-upgrade''' to perform the actual updating.
  
=== Note ===
+
{{Warning|Do NOT use "apt-get upgrade" as this will NOT properly update the system and could leave you with broken packages}}
  
[[file:300px-Synaptic_Packages_Not_Retrieved.png]]
+
=== Possible problems ===
  
* In case Synaptic gives a prompt such as "Not able to retrieve all packages, continue anyway?" '''DO NOT'' click Yes. Say <font color="#0000FF">'''NO'''</font> and try updating sometime later after reloading the repository indexes (press Reload). This might be because the repositories are being updated with new software themselves and only after this process is complete, you should update your system. If the message continues to appear even after a day, report the issue to the [https://www.pclinuxos.com/forum forum].
+
The most common problems encountered occur if you are trying to update at the same time as your chosen repository mirror is syncing with the master repository. In this case you may see an error like the following:
  
 +
[[file:300px-Synaptic_Packages_Not_Retrieved.png]]
  
* '''''DO NOT USE''''' apt-get update and apt-get upgrade from the command line. '''This has never been the recommended way'''. If you insist on using command line, the correct procedure is '''''apt-get update''''' and '''''apt-get dist-upgrade'''''.
+
'''DO NOT'' click Yes. Say <font color="#0000FF">'''NO'''</font> and try updating sometime later after reloading the repository indexes (press Reload).  
* Once a new ISO is produced and made available to the public, we no longer test upgrading from older ISO releases. This does not mean, though, that previous releases should not be used. On the contrary, there is no need to reinstall PCLinuxOS unless you wish to have a fresh install, due to PCLinuxOS being a "rolling" release distribution.
 
  
 +
If the message continues to appear even after a day, report the issue to the [https://www.pclinuxos.com/forum forum].
  
 
[[category:HowTo]]
 
[[category:HowTo]]

Revision as of 03:13, 6 July 2020

This page deals with the method of keeping your PCLinuxOS system up-to date.

Introduction

PCLinuxOS is a Linux distribution that follows the system of rolling updates. It means that you do not need to reinstall each time an update is released and when fully updated you already have the most current system. However it is very important to update properly to make sure that your system does not break. It is recommended that you do a proper system update as outlined below once every week or two. Leaving a long gap between system updates may cause the update path for some software to breakdown. Do not wait more than 60 days to update your system.

The update procedure below will properly update your system by updating, adding and removing packages as necessary. There are some important exceptions:

  • The kernel is not updated but new kernels may be added if you have the kernel-latest package installed. See Kernel Updates for details.
  • The LibreOffice suite is updated manually or by using LibreOffice Manager.
  • VirtualBox is updated manually or by using VirtualBox Manager.

PCLinuxOS updates are delivered over the internet so a working internet connection is needed. Broadband connections are preferred because sometimes the updates can be of the order of hundreds of MBs. So before proceeding with the update, make sure that you have a working internet connection.

Updating using Synaptic

Synaptic is the software that manages the task of downloading and installing updates for your system. The software on your system is delivered as packages and hence Synaptic is also called package manager. You can launch it by any one of the following methods:

  • By clicking on Synaptic Package Manager icon in the taskbar near the left hand lower corner of your screen. Synaptic Locate.png
  • By going to PC Menu (Also called Kickoff Application Launcher) at the left hand lower corner of your screen > Applications > Software Centre > Synaptic Package Manager.
  • By typing 'synaptic' into a root terminal.
  • If you have one of the update-notifier applications installed they usually have an option for launching Synaptic.

As soon as Synaptic starts, it scans your system for existing software and gets ready.

300px-Synaptic Scanning.png

Now you need to reload the package information to become informed about new, removed or upgraded software packages. Click on 'Reload' button.

300px-Synaptic Reload.png

A window labelled 'Downloading package information' will come up and show the progress of this operation. Once the download is complete, Synaptic will do another scan and get ready for the next step.

300px-Synaptic Downloading Package Information.png

Now click on 'Mark All Upgrades'.

300px-Synaptic Mark All Upgrades.png

You will get another window with the prompt "Mark additional required changes?'. Go through the list and click on 'Mark'.

300px-Synaptic Mark Additional Required Changes.png

Now click on 'Apply'. You will be presented with another summary window. You can expand To be upgraded To be installed and To be removed sections by clicking on the small triangle before each line. Pay attention to the To be removed section. While it is normal for a few packages to be removed as part of an upgrade, if this list is very long without corresponding packages appearing in the To be installed section it could be an indication of a problem. After going through the list, click on 'Apply' to begin the actual process of downloading and installing updates. 300px-Synaptic Apply The Following Changes.png

Once the process is complete you may see another window showing some output. Some of the changes effected by Synaptic might require you to either log-off and log-in again or rarely in case of kernel update etc require you to reboot which would be shown in this window. After this you may close Synaptic.

If required, as mentioned above, log-off/log-in or reboot.

That completes your system update.

Updating using the command line

For those who prefer to update using the command line the correct procedure is to use is:

apt-get update && apt-get dist-upgrade

The apt-get command is used to access the package management system. You may be familiar with this command from Debian based distributions and it works in a similar (but not exactly the same) way on PCLinuxOS. First we use update to get the current package list and only if that is successful then use dist-upgrade to perform the actual updating.

IconWarning.png
Warning!
Do NOT use "apt-get upgrade" as this will NOT properly update the system and could leave you with broken packages


Possible problems

The most common problems encountered occur if you are trying to update at the same time as your chosen repository mirror is syncing with the master repository. In this case you may see an error like the following:

300px-Synaptic Packages Not Retrieved.png

'DO NOT click Yes. Say NO and try updating sometime later after reloading the repository indexes (press Reload).

If the message continues to appear even after a day, report the issue to the forum.