If your system is fully up-to-date, there will not be any entries in Update Manager.

If your system is fully up-to-date, there will not be any entries in Update Manager.

+

<!--T:56-->

Depending upon the type of update, an “Update Details” pane may or may not appear when you check the box next to the update.

Depending upon the type of update, an “Update Details” pane may or may not appear when you check the box next to the update.

+

<!--T:57-->

To update the system, check the boxes to select the updates to install or check the “Select/Deselect All” box. Once the updates are selected, click the “Install selected updates” button. A progress bar will indicate the progress of the update.

To update the system, check the boxes to select the updates to install or check the “Select/Deselect All” box. Once the updates are selected, click the “Install selected updates” button. A progress bar will indicate the progress of the update.

Line 65:

Line 67:

{{note|icon64=System updates are one-way, meaning you cannot unapply an update once it is installed. However, PC-BSD® 10.0.2 and higher automatically creates a boot environment before applying each system update. If there is an issue with the update, reboot the system and select the entry that represents the time that update occurred. This will reboot the version of the operating system before the update was applied. For systems earlier than 10.0.2, create a manual boot environment using {{local|link=Boot Manager}} ''' ''before'' ''' applying any updates}}

{{note|icon64=System updates are one-way, meaning you cannot unapply an update once it is installed. However, PC-BSD® 10.0.2 and higher automatically creates a boot environment before applying each system update. If there is an issue with the update, reboot the system and select the entry that represents the time that update occurred. This will reboot the version of the operating system before the update was applied. For systems earlier than 10.0.2, create a manual boot environment using {{local|link=Boot Manager}} ''' ''before'' ''' applying any updates}}

−

====Applying a System Update (CLI Method)====

+

====Applying a System Update (CLI Method)==== <!--T:58-->

+

<!--T:59-->

TrueOS® users, or those who prefer to use a command-line utility, can use '''pc-updatemanager''', the command line equivalent to Update Manager, to apply system updates. If you type '''pc-updatemanager''', it will show its available options:

TrueOS® users, or those who prefer to use a command-line utility, can use '''pc-updatemanager''', the command line equivalent to Update Manager, to apply system updates. If you type '''pc-updatemanager''', it will show its available options:

+

<!--T:60-->

{{txtbox|box='''pc-updatemanager'''{{nbsp|64}}

{{txtbox|box='''pc-updatemanager'''{{nbsp|64}}

/usr/local/bin/pc-updatemanager - Usage

/usr/local/bin/pc-updatemanager - Usage

Line 83:

Line 87:

}}

}}

+

<!--T:61-->

To determine if any system updates are available, type the following command:

To determine if any system updates are available, type the following command:

+

<!--T:62-->

{{txtbox|box='''sudo pc-updatemanager check'''{{nbsp|58}}

{{txtbox|box='''sudo pc-updatemanager check'''{{nbsp|58}}

Checking for FreeBSD updates...

Checking for FreeBSD updates...

Line 112:

Line 118:

To install: "pc-updatemanager install pkgng-conflict-03122014"}}

To install: "pc-updatemanager install pkgng-conflict-03122014"}}

+

<!--T:63-->

This is the command line equivalent of the results seen in Figure 7.2b. Follow the instructions to install each update. For example, this will apply the "Remove fdescfs" patch:

This is the command line equivalent of the results seen in Figure 7.2b. Follow the instructions to install each update. For example, this will apply the "Remove fdescfs" patch:

Note that a boot environment is created before the patch is applied as this system is running 10.0.2.

Note that a boot environment is created before the patch is applied as this system is running 10.0.2.

Line 140:

Line 149:

* The boot loader and default ZFS layout has changed to support {{local|link=Boot Manager|boot environments}} and ZFS snapshot management with {{local|link=Life Preserver}}. For this reason, we recommend that 9.x users backup their important data to another system or external drive and then perform a new installation which will create the required ZFS layout.}}

* The boot loader and default ZFS layout has changed to support {{local|link=Boot Manager|boot environments}} and ZFS snapshot management with {{local|link=Life Preserver}}. For this reason, we recommend that 9.x users backup their important data to another system or external drive and then perform a new installation which will create the required ZFS layout.}}

−

===Upgrading from 10.x to 10.0.2 (GUI Method)===

+

===Upgrading from 10.x to 10.0.2 (GUI Method)=== <!--T:66-->

+

<!--T:67-->

Upgrading from any 10.x version to 10.0.2 is considered to be a minor, rather than a major, upgrade. This means that the operating system and kernel are fully patched if all patches in Update Manager have been applied.

Upgrading from any 10.x version to 10.0.2 is considered to be a minor, rather than a major, upgrade. This means that the operating system and kernel are fully patched if all patches in Update Manager have been applied.

+

<!--T:68-->

To update the PC-BSD® utilities to their latest version, use the "Package Updates" tab of Package Manager for earlier 10.x versions or {{local|link=AppCafe®}}, for beta/RC versions of 10.0.2.

To update the PC-BSD® utilities to their latest version, use the "Package Updates" tab of Package Manager for earlier 10.x versions or {{local|link=AppCafe®}}, for beta/RC versions of 10.0.2.

Line 149:

Line 160:

'''NOTE:''' it is a good idea to create a [[Boot Manager|boot environment]] before updating the PC-BSD® utilities. After updating, PC-BSD® will automatically do this for you with any subsequent updates.

'''NOTE:''' it is a good idea to create a [[Boot Manager|boot environment]] before updating the PC-BSD® utilities. After updating, PC-BSD® will automatically do this for you with any subsequent updates.

+

<!--T:69-->

In the example shown in Figure 7.2c, a user on a 10.0.2 beta system has clicked the "Start Updates" button in {{local|link=AppCafe®}}, then the "Show Details" button. The details indicate the current version of the PC-BSD® utilities and the versions they will be updated to.

In the example shown in Figure 7.2c, a user on a 10.0.2 beta system has clicked the "Start Updates" button in {{local|link=AppCafe®}}, then the "Show Details" button. The details indicate the current version of the PC-BSD® utilities and the versions they will be updated to.

Click "Yes" to perform the update. When the update is finished, a reboot is recommended.

Click "Yes" to perform the update. When the update is finished, a reboot is recommended.

−

====Upgrading from 10.x to 10.0.2 (CLI Method)====

+

====Upgrading from 10.x to 10.0.2 (CLI Method)==== <!--T:71-->

+

<!--T:72-->

Users who prefer to upgrade the PC-BSD utilities from the command line can use the following command:

Users who prefer to upgrade the PC-BSD utilities from the command line can use the following command:

+

<!--T:73-->

{{txtbox|box='''sudo pc-updatemanager pkg check'''{{nbsp|44}}

{{txtbox|box='''sudo pc-updatemanager pkg check'''{{nbsp|44}}

Updating repository catalogue

Updating repository catalogue

Line 165:

Line 180:

Upgrades have been requested for the following 3 packages:

Upgrades have been requested for the following 3 packages:

−

Upgrading pcbsd-utils: 1402404619 -> 1402675082

+

<!--T:74-->

+

Upgrading pcbsd-utils: 1402404619 -> 1402675082

Upgrading pcbsd-utils-qt4: 1402404153 -> 1402705215

Upgrading pcbsd-utils-qt4: 1402404153 -> 1402705215

Upgrading pcbsd-base: 1401994478 -> 1402603526

Upgrading pcbsd-base: 1401994478 -> 1402603526

+

<!--T:75-->

The upgrade will require 631 KB more space

The upgrade will require 631 KB more space

+

<!--T:76-->

58 MB to be downloaded

58 MB to be downloaded

+

<!--T:77-->

To start the upgrade run "/usr/local/bin/pc-updatemanager pkgupdate"}}

To start the upgrade run "/usr/local/bin/pc-updatemanager pkgupdate"}}

+

<!--T:78-->

This example is from a 10.0.2 beta system and is the command line equivalent to the screen shown in Figure 7.2c.

This example is from a 10.0.2 beta system and is the command line equivalent to the screen shown in Figure 7.2c.

+

<!--T:79-->

To start the upgrade:

To start the upgrade:

+

<!--T:80-->

{{txtbox|box='''sudo pc-updatemanager pkgupdate'''

{{txtbox|box='''sudo pc-updatemanager pkgupdate'''

Updating repository catalogue

Updating repository catalogue

Line 187:

Line 209:

Upgrades have been requested for the following 3 packages:

Upgrades have been requested for the following 3 packages:

−

Upgrading pcbsd-utils: 1402404619 -> 1402675082

+

<!--T:81-->

+

Upgrading pcbsd-utils: 1402404619 -> 1402675082

Upgrading pcbsd-utils-qt4: 1402404153 -> 1402705215

Upgrading pcbsd-utils-qt4: 1402404153 -> 1402705215

Upgrading pcbsd-base: 1401994478 -> 1402603526

Upgrading pcbsd-base: 1401994478 -> 1402603526

+

<!--T:82-->

The upgrade will require 631 KB more space

The upgrade will require 631 KB more space

+

<!--T:83-->

58 MB to be downloaded

58 MB to be downloaded

pcbsd-utils-1402675082.txz 100% 16MB 2.1MB/s 2.5MB/s 00:08

pcbsd-utils-1402675082.txz 100% 16MB 2.1MB/s 2.5MB/s 00:08

Line 204:

Line 229:

Upgrades have been requested for the following 3 packages:

Upgrades have been requested for the following 3 packages:

−

Upgrading pcbsd-utils: 1402404619 -> 1402675082

+

<!--T:84-->

+

Upgrading pcbsd-utils: 1402404619 -> 1402675082

Upgrading pcbsd-utils-qt4: 1402404153 -> 1402705215

Upgrading pcbsd-utils-qt4: 1402404153 -> 1402705215

Upgrading pcbsd-base: 1401994478 -> 1402603526

Upgrading pcbsd-base: 1401994478 -> 1402603526

+

<!--T:85-->

The upgrade will require 631 KB more space

The upgrade will require 631 KB more space

+

<!--T:86-->

0 B to be downloaded

0 B to be downloaded

Checking integrity... done

Checking integrity... done

Line 217:

Line 245:

Extracting desktop overlay data...DONE}}

Extracting desktop overlay data...DONE}}

+

<!--T:87-->

Once the upgrade is complete, it is recommended to close any applications that you have open, then type '''reboot''' to reboot the system.

Once the upgrade is complete, it is recommended to close any applications that you have open, then type '''reboot''' to reboot the system.

Revision as of 08:53, 18 June 2014

Update ManagerProtection (edit): Edited by: Drulavigne

Update Manager provides a graphical interface for updating the version of PC-BSD® and for applying security updates. This utility can be started from Control Panel or by typing pc-updategui. It can also be accessed from its icon in the system tray, if you are logged into a desktop that provides a system tray.

The status of the icon lets you determine at a glance if any of your installed applications are out-of-date, if a system update is available, or if a new version of the operating system is available. Table 7.2a summarizes the possible statuses of this icon.

Table 7.2a: Update Manager Status

your system is up-to-date

the system is currently checking for updates and patches

your operating system is out-of-date and system update(s) or patch(es) are available

newer versions of installed applications are available

the system was unable to check for updates, meaning you should check your Internet connection

the system is currently updating

the system needs to restart in order for the newly installed update to take effect

If you right-click the icon, you will see the menu shown in Figure 7.2a. As seen in the menu, Update Manager will automatically track updates to software installed using either the graphical or command line equivalents of AppCafe® and Warden®.

Figure 7.2a: Right-click Menu for Update Manager

Figure 7.2b: Applying a System Update

By default, updates are checked every 24 hours or whenever you boot the system. You can check for updates at any time by selecting "Check for updates". To disable the update check when the system boots, uncheck the "Run at startup" box. To disable the pop-up message over the icon when an update becomes available, uncheck the "Display notifications" box. To remove Update Manager from the system tray, click "Quit". You can put the icon back into the tray by typing pc-systemupdatertray.

Contents

Applying a System Update (GUI Method)

Occasionally, the PC-BSD® project releases a system update which addresses a fixed security vulnerability or a bug which impacts the use of the operating system. If the update is based on a FreeBSD security advisory, the update is usually available within 24 hours of the FreeBSD security announcement. To install a system update, open Update Manager and input your password when prompted. Figure 7.2b shows an example of a system where several updates are available .

If your system is fully up-to-date, there will not be any entries in Update Manager.

Depending upon the type of update, an “Update Details” pane may or may not appear when you check the box next to the update.

To update the system, check the boxes to select the updates to install or check the “Select/Deselect All” box. Once the updates are selected, click the “Install selected updates” button. A progress bar will indicate the progress of the update.

If the update requires a reboot, you will be notified to do so after the update has been installed. If a reboot is needed, clicking the "Close" button at the informational message will not automatically reboot the system. Finish whatever you are doing and reboot the computer to finish the update process.

System updates are one-way, meaning you cannot unapply an update once it is installed. However, PC-BSD® 10.0.2 and higher automatically creates a boot environment before applying each system update. If there is an issue with the update, reboot the system and select the entry that represents the time that update occurred. This will reboot the version of the operating system before the update was applied. For systems earlier than 10.0.2, create a manual boot environment using Boot Managerbefore applying any updates

Applying a System Update (CLI Method)

TrueOS® users, or those who prefer to use a command-line utility, can use pc-updatemanager, the command line equivalent to Update Manager, to apply system updates. If you type pc-updatemanager, it will show its available options:

Note that a boot environment is created before the patch is applied as this system is running 10.0.2.

Upgrading from 9.x to 10.x

IMPORTANT--README!

PC-BSD® has switched to ZFS-only. This means that you can not upgrade a system that is either 32-bit or formatted with UFS. If the hardware supports 64-bit, you will need to backup your important data to another system or external drive and then perform a new installation. The new installation will perform a format of the selected disk(s) with ZFS.

The boot loader and default ZFS layout has changed to support boot environments and ZFS snapshot management with Life Preserver. For this reason, we recommend that 9.x users backup their important data to another system or external drive and then perform a new installation which will create the required ZFS layout.

Upgrading from 10.x to 10.0.2 (GUI Method)

Upgrading from any 10.x version to 10.0.2 is considered to be a minor, rather than a major, upgrade. This means that the operating system and kernel are fully patched if all patches in Update Manager have been applied.

To update the PC-BSD® utilities to their latest version, use the "Package Updates" tab of Package Manager for earlier 10.x versions or AppCafe®, for beta/RC versions of 10.0.2.

NOTE: it is a good idea to create a boot environment before updating the PC-BSD® utilities. After updating, PC-BSD® will automatically do this for you with any subsequent updates.

In the example shown in Figure 7.2c, a user on a 10.0.2 beta system has clicked the "Start Updates" button in AppCafe®, then the "Show Details" button. The details indicate the current version of the PC-BSD® utilities and the versions they will be updated to.

Figure 7.2c: Upgrading the PC-BSD® Utilities

Click "Yes" to perform the update. When the update is finished, a reboot is recommended.

Upgrading from 10.x to 10.0.2 (CLI Method)

Users who prefer to upgrade the PC-BSD utilities from the command line can use the following command:

sudo pc-updatemanager pkg check

Updating repository catalogue
Updating repository catalogue
Upgrades have been requested for the following 3 packages: