[[File:Update2d.png|thumb|393px|'''Figure 7.2b: Applying a System Update''']]

[[File:Update2d.png|thumb|393px|'''Figure 7.2b: Applying a System Update''']]

<!--T:11-->

<!--T:11-->

−

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'''.

+

By default, updates are checked every 24 hours or whenever you boot the system. You can check for updates now 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 change how often the update check occurs, click “Automatic updates check” and select a schedule from its menu. To remove Update Manager from the system tray, click "Quit". You can put the icon back into the tray by typing '''pc-systemupdatertray'''.

===Applying a System Update (GUI Method)=== <!--T:43-->

===Applying a System Update (GUI Method)=== <!--T:43-->

Line 55:

Line 55:

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 63:

Line 65:

<!--T:55-->

<!--T:55-->

−

{{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 a system update. If there is an issue with the update, reboot the system and select the entry that represents the time the 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:

}}

}}

−

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

+

<!--T:61-->

+

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

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

−

<!--T:45-->

+

===Upgrading from 9.x to 10.x=== <!--T:44-->

−

Update Manager can be used to upgrade to the latest version of the operating system.

+

<!--T:50-->

<!--T:50-->

−

{{danger|icon64={{redlight|IMPORTANT--README BEFORE ATTEMPTING AN UPGRADE!}}<br/>

+

{{danger|icon64={{redlight|IMPORTANT--README!}}<br/>

* 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.<br/>

* 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.<br/>

<!--T:54-->

<!--T:54-->

−

* The boot loader and default ZFS layout changed with the July 23, 2013 image. This change was needed to support {{local|link=Boot Manager|boot environments}} and ZFS snapshot management with {{local|link=Life Preserver}}. This means that you can ''' ''not'' ''' upgrade from a release prior to that date. If you are running a PC-BSD® version prior to July 23, you will need to backup your important data to another system or external drive and then perform a new installation. The new installation will create the required ZFS layout.<br/>

+

* 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.}}

−

+

−

<!--T:51-->

+

−

* The ZFS version changed between 9.2 and 9.1 and ZFS does not support downgrading to an earlier version of ZFS. This means that you cannot downgrade a 9.2 installation to a 9.1 installation.}}

+

−

+

−

<!--T:47-->

+

−

''' ''Before performing an operating system upgrade, always back up the data that is important to you. {{local|link=Life Preserver}} can be used to send a system backup to a remote system. It is also recommended to use {{local|link=Boot Manager}} to backup your current boot environment before performing the upgrade.'' '''

Before attempting an upgrade, you should also be aware of the following caveats:

+

−

+

−

<!--T:26-->

+

−

* it is not possible to upgrade from FreeBSD to PC-BSD®. However, you can {{local|link=Convert_a_FreeBSD_System_to_PC-BSD®|convert a FreeBSD system to PC-BSD®}}.

+

−

+

−

<!--T:27-->

+

−

* the temporary files used by the upgrade process require 2GB of free space in ''/usr/''. If you receive an error message indicating that you do not have enough free space to perform the upgrade, you will need to delete some files or move them elsewhere in order to create enough free space.

+

−

+

−

<!--T:30-->

+

−

* an upgrade will preserve the data in the home directories, any installed PBIs, and user accounts. It also preserves common configuration files and will merge any customizations you have made into the new versions of the following files: ''boot/loader.conf'', ''/etc/rc.conf'', and ''/etc/sysctl.conf.''

+

−

+

−

<!--T:56-->

+

−

Once you have backed up your data and confirmed that your version of PC-BSD® is older than July 23, you can use Update Manager to upgrade the operating system. In the example shown in Figure 7.2c, a system upgrade to 10.0-RELEASE is available.

+

−

+

−

<!--T:34-->

+

−

{{note|icon48=If a RELEASE has been announced but the update does not appear in Update Manager, make sure that any updates that do show are applied first. That way, the system will be fully patched and ready for the system upgrade.}}

+

−

+

−

<!--T:35-->

+

−

To perform the upgrade, check the box for the "System Upgrade" entry and click the "Install selected updates" button. A progress bar will indicate the download status of the files that changed with the upgrade.

+

−

+

−

<!--T:39-->

+

−

Once the downloads are finished and applied, Update Manager will indicate that the system is fully updated. Close any applications that you have open, then reboot in order to load the latest version of the operating system.

+

−

+

−

====Upgrading the Operating System (CLI Method)====

+

−

+

−

Users who prefer to upgrade the operating system from the command line can use '''pc-updatemanager''' instead of the graphical Update Manager.

+

−

+

−

Once a new RELEASE has been announced, it should appear as available using the following command:

+

−

+

−

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

+

−

The following updates are available:

+

−

<nowiki>------------------------------------</nowiki>

+

−

NAME: System Update to 10.0-RELEASE

+

−

TYPE: SYSUPDATE

+

−

TAG: fbsd-10.0-RELEASE

+

−

VERSION: 10.0-RELEASE

+

−

To install: "pc-updatemanager install fbsd-10.0-RELEASE"}}

+

===Upgrading from 10.x to 10.1=== <!--T:66-->

−

To start the upgrade, follow the "To install" instructions. Messages will indicate the status of the upgrade.

+

<!--T:67-->

+

Upgrading from any 10.x version to 10.1 is the same as applying any system update. This means that the update to 10.1 will either appear in the graphical Update Manager or in the listing for '''pc-updatemanager check'''. It will be listed as ''10.1-update-11032014-10'' with a description of "Update system to 10.1-RELEASE".

−

Once the upgrade is complete, a message will indicate that you need to reboot the system in order for the changes to take effect. Close any applications that you have open, then type '''reboot''' in order to load the latest version of the operating system and finish the upgrade.

+

<!--T:88-->

+

{{note|icon64=A fresh install, rather than an update, is required if you wish to either take advantage of UEFI boot or encrypt the disks. This means that you will have to backup your data to an external drive or another system, perform the install, than restore your data from backup.}}

<!--T:18-->

<!--T:18-->

Latest revision as of 09:23, 12 November 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 now 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 change how often the update check occurs, click “Automatic updates check” and select a schedule from its menu. To remove Update Manager from the system tray, click "Quit". You can put the icon back into the tray by typing pc-systemupdatertray.

Contents

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

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:

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 any 10.x version to 10.1 is the same as applying any system update. This means that the update to 10.1 will either appear in the graphical Update Manager or in the listing for pc-updatemanager check. It will be listed as 10.1-update-11032014-10 with a description of "Update system to 10.1-RELEASE".

A fresh install, rather than an update, is required if you wish to either take advantage of UEFI boot or encrypt the disks. This means that you will have to backup your data to an external drive or another system, perform the install, than restore your data from backup.