THIS PAGES NEEDS UPDATING
Update Manager provides a graphical interface that is used for updating the version of PC-BSD® and for applying security updates. It is also used to update installed PBIs, installed system components, and Warden® meta-packages.
This section describes how to use the Update Manager GUI to update PBIs or Warden® meta-packages and to apply system updates. Upgrading PC-BSD® demonstrates how to start an operating system upgrade from the GUI.
Advanced users can use the following command line utilities to achieve the same results:
- pbi_update: used to update installed PBIs
- pc-metapkgmanager: used to update installed system components or Warden® meta-packages
- pc-updatemanager: used to update the operating system
An icon located in the system tray lets you determine at a glance if any of your installed PBIs are out-of-date, or if a system update is available. This icon has several possible states:
|your system is up-to-date.|
|the system is currently checking for updates and patches; this happens automatically whenever you boot your system.|
|your operating system is out-of-date and system update(s) or patch(es) are available.|
|newer versions of installed PBI(s) are available; click this icon to open AppCafe® so that you can update the PBI(s).|
|the system was unable to check for updates, meaning you should check your Internet connection.|
|the system is currently updating. You should see this icon once you click the "Install selected updates" button.|
|the system needs to restart in order for the newly installed update to take effect. You will not be able to use Update Manager again until the system is rebooted.|
If you right-click the icon, you will see the menu shown in Figure 7.3a. If updates are available for installed PBIs, AppCafe® will also open to the "Installed" tab so that you can view the new versions which are available.
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".
Selecting "Start the Update Manager" from the right-click menu will open Update Manager so that you can review the available system update(s).
Figure 7.3b shows a screenshot of Update Manager.
If any updates are available, they will be listed; if your system is fully up-to-date, there will not be any entries.
If you hover over a listed update, a pop-up menu will provide some details about the update.
To install an update, check the update(s) that you wish to install and click the "Install selected updates" button. You can watch the progress of the update, as seen in Figure 7.3c:
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 "OK" button at the informational message will not automatically reboot the system, meaning you can continue to use your computer for other tasks while the system is being updated. Finish whatever you are doing and reboot the computer at a time that is convenient for you.
THIS IS CHANGING
PC-BSD® makes it easy to upgrade from an earlier version of 9.x (including beta and RC versions) to the latest version of PC-BSD®. When the upgrade is finished, simply reboot to access the new version of your PC-BSD® operating system. The upgrade can be performed using the graphical Update Manager or from the command line.
Before attempting an upgrade, be aware of the following caveats:
- it is not recommended to update between major branches: for example, from a 7.x or 8.x version to a 9.x version of PC-BSD®. Instead, backup your data and do a fresh install of the new version.
- it is not possible to upgrade from FreeBSD to PC-BSD®.
- 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.
- before performing any upgrade, always back up your important data to an external backup device, such as a removable USB drive, or to another system using a utility such as Life Preserver. While it is unlikely that something will go wrong, you will be glad that you made that backup just in case.
- when you do an upgrade, programs installed via FreeBSD ports or packages will be removed. If you want to preserve these across system updates, you should install these within a ports jail using Warden®. Better yet, request that your favorite port/package is made into a PBI as PBIs are preserved during an upgrade.
- an upgrade will preserve the data in the home directories, any installed PBIs, and user accounts. It also preserves common configuration files--you can view the list of files which are excluded from the upgrade in . The upgrade process will also merge any customizations you have made into the new versions of the following files: boot/loader.conf, /etc/rc.conf, and /etc/sysctl.conf.
Using Update Manager
To start Update Manager, make sure that your Internet connection is active and go to Control Panel ➜ Update Manager or type pc-su pc-updategui from a terminal. After inputting your password, Update Manager will look for updates and inform you if a newer version of the operating system is available. In the example shown in Figure 5.4a, the current operating system is 9.0 and Update Manager is indicating that the upgrade to 9.1 is available.
if you know that a new release is available and it is not showing 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.
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 PCBSD.tbz upgrade file
- the download status of the software packages that are installed with the operating system and which have newer available versions
How long these downloads take depends upon the speed of your network connection: for example, it can take an hour or so over a DSL connection. You can continue to use your PC-BSD® system while Update Manager downloads the files it needs to /usr/local/tmp/.
Once the downloads are finished, a pop-up message will indicate that the system is now ready to reboot in order to finish the upgrade. PC-BSD® will not automatically reboot the system, giving you the opportunity to close any applications that you have open before you reboot the system yourself.
it is very important that once you reboot, you do not interrupt the upgrade process. This process may take up to 30 minutes, so plan your reboot for a time when you do not need immediate access to your system.
After rebooting, a series of console messages will appear similar to these (depending upon your choices as described):
A system update to PC-BSD is ready to be installed. This may take 30 minutes or more. If you wish to postpone the update, type 'skip' and press enter. You will be prompted again during the next system boot. The update will begin automatically in 20 seconds.>
# Updating to 9.1 # Please do NOT reboot the system until the update is finished ############################################################## Cleaning old system pkgs..... Extracting updated world environment...DONE! Extracting kernel and boot environment...DONE Cleaning up old files...DONERebooting for stage 2 of upgrade...Shutdown NOW!
# Updating to 9.1 # Please do NOT reboot the system until the update is finished ############################################################## Installing system packages... Cleaning up...DONEUpdate finished! Rebooting...
<ref>tags exist, but no
<references/>tag was found