Difference between revisions of "Update Manager/9.2"

From PC-BSD Wiki
Jump to: navigation, search
(Marked this version for translation)
 
(99 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<noinclude>{{NavHeader|back=PBI Manager|forward=Meta Package Manager}}</noinclude>
+
<noinclude><translate>
PC-BSD 9.0 introduced a redesigned Update Manager to make it easy to update the underlying FreeBSD world or kernel, drivers, software installed via packages, ports, or PBIs, and to apply security updates. Unlike previous versions of PC-BSD, the 9.x series of PC-BSD uses the ''GENERIC'' FreeBSD kernel in order to ease kernel updating. Update Manager provides an easy to use GUI; however, the underlying mechanism is based on shell scripts. This means that advanced users don't need to run a window manager in order to use the upgrade functionality. These shell scripts use '''sudo''' so that regular user accounts can run upgrades without requiring access to the root password.
+
  
An icon located in your system tray lets you tell at a glance if any of your PBIs are out-of-date or if a system update is available. This icon has several possible states:  
+
<!--T:1-->
 +
{{UseTOC{{putVers}}|Nav}}</noinclude>
  
[[Image:Updated.png]] your system is up-to-date
+
<!--T:2-->
 +
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. 
  
[[Image:Working.png]] the system is currently checking for updates and patches; this happens automatically whenever you boot your system
+
<!--T:40-->
 +
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.3a summarizes the possible statuses of this icon.
  
[[Image:Sysupdates.png]] your operating system is out-of-date and system update(s) or patch(es) are available
+
<!--T:41-->
 +
'''Table 7.3a: Update Manager Status'''
  
[[Image:Pbiupdates.png]] newer versions of installed PBI(s) are available; click this icon to open AppCafe® so that you can [[Using_AppCafe®#Updating_Installed_PBIs | update the PBI(s)]]
+
<!--T:9-->
 +
{|class=simple_table width=auto <!-- special case - not converted to other table style/format -->
 +
|[[File:Updated1.png|text-bottom|36px]]
 +
|your system is up-to-date
 +
|-
 +
|[[File:Working1.png|text-bottom|36px]]
 +
|the system is currently checking for updates and patches
 +
|-
 +
|[[File:Sysupdates1.png|text-bottom|36px]]
 +
|your operating system is out-of-date and system update(s) or patch(es) are available
 +
|-
 +
|[[File:Pbiupdates1.png|text-bottom|36px]]
 +
|newer versions of installed PBI(s) are available
 +
|-
 +
|[[File:Pkgupdates.png|text-bottom|36px]]
 +
|newer versions of installed packages are available
 +
|-
 +
|[[File:Connecterror1.png|text-bottom|36px]]
 +
|the system was unable to check for updates, meaning you should check your Internet connection
 +
|-
 +
|[[File:Updating.png|text-bottom|36px]]
 +
|the system is currently updating
 +
|-
 +
|[[File:Restart.png|text-bottom]]
 +
|the system needs to restart in order for the newly installed update to take effect
 +
|}
  
[[Image:Connecterror.png]] the system was unable to check for updates, meaning you should check your Internet connection
+
<!--T:10-->
 +
If you right-click the icon, you will see the menu shown in Figure 7.3a. As seen in the menu, Update Manager will automatically track updates to software installed using either the graphical or command line equivalents of {{local|link=Package Manager}}, {{local|link=AppCafe®}}, and {{local|link=Warden®}}.
  
If you right-click the icon, you will see the menu shown in Figure 6.3a:
+
<!--T:42-->
 +
[[File:Update1d.png|thumb|'''Figure 7.3a: Right-click Menu for Update Manager''']]
 +
[[File:Update2b.png|thumb|393px|'''Figure 7.3b: Applying a System Update''']]
  
'''Figure 6.3a: Right-click Menu for Update Manager'''
+
<!--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'''.
  
[[Image:Update1a.png]]
+
===Applying a System Update=== <!--T:43-->
  
Selecting "Start the Update Manager" from the right-click menu or double-clicking the icon will open Update Manager so that you can review the available update(s).  
+
<!--T:12-->
 +
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. Figure 7.3b shows an example of an available system update within Update Manager.
  
Figure 6.3b shows a screenshot of Update Manager:
+
<!--T:14-->
 +
If your system is fully up-to-date, there will not be any entries in Update Manager. If you click the entry for a listed update, the “Update Details” box will provide some details about the update.
  
'''Figure 6.3b: Update Manager'''
+
<!--T:16-->
 +
To install an update, highlight its entry and click the "Install selected updates" button. A progress bar will indicate the progress of the update.
  
[[File:Update2a.png]]
+
<!--T:17-->
 +
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.
  
If any updates are available, they will be listed; if your system is fully up-to-date, there won't be any entries.
+
===Upgrading the Operating System=== <!--T:44-->
  
If you hover over a listed update, a pop-up menu will provide some details about the update.
+
<!--T:45-->
 +
If you are running a {{local|link=Using a Rolling Release|rolling release}}, Update Manager can be used to upgrade to the latest version of the operating system.
  
To install an update, check the update(s) that you wish to install and click the "Install selected updates" button. You can watch the update's progress as seen in Figure 6.3c:
+
<!--T:50-->
 +
{{danger|width=auto|icon64={{redlight|IMPORTANT--README BEFORE ATTEMPTING AN UPGRADE!}}<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/>
  
'''Figure 6.3c: Installing a System Update'''
+
<!--T:54-->
 +
:::* The boot loader and default ZFS layout changed with the July 23, 2013 rolling release. 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 PC-BSD® 9.1-RELEASE or a rolling release 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/>
  
[[File:Update3a.png]]
+
<!--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.}}
  
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 won't reboot the system. Update Manager won't automatically reboot, 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.
+
<!--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 backup your home directory to a remote system. It is also recommended to use {{local|link=Boot Manager}} to backup your current boot environment before performing the upgrade.'' '''
  
You can see which updates are available, which have been ignored, and which have been applied by looking at the contents of ''/var/db/pc-updatemanager''. Each update ends in a ''.upd'' extension and has an associated SHA checksum. This ''.upd'' file contains information about the update, as seen in the following example:
+
<!--T:52-->
 +
[[File:Update4a.png|thumb|393px|'''Figure 7.3c: Upgrading the Operating System''']]
  
Name: Fix issue with incorrect version showing as root
+
<!--T:24-->
Date: 12-20-2011
+
Before attempting an upgrade, you should also be aware of the following caveats:
MD5: fecd1cd157cc4092989e90c5b83e1a9f
+
Size: 1
+
Mirror: ftp://ftp.pcbsd.org/pub/
+
FileURL: /system-updates/9.0-RC3/patch-12202011-fixrc.txz
+
StandAlone: NO
+
RequiresReboot: NO
+
DetailsURL: http://www.pcbsd.org/
+
  
 +
<!--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:53-->
 +
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.3c, the "Base System Updates" indicates that a system advisory is available, as well as an update to 9.2-RC3 and then 9.2-RC4. The "Update Details" section lists the files that will be changed if the system is upgraded.
 +
 +
<!--T:34-->
 +
{{note|width=auto|icon64=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.}}
 +
 +
<!--T:35-->
 +
To perform the upgrade, check the box for the "Base System Updates" 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.
 +
 +
<!--T:18-->
 
<noinclude>
 
<noinclude>
[[category:handbook]]
+
<!-- {{Refheading}} --><!-- uncomment when citelink is used on the page -->
[[category:Maintaining and Extending PC-BSD]]
+
 
[[category:Update Manager]]
 
[[category:Update Manager]]
 +
[[category:Maintaining and Extending PC-BSD®]]
 +
[[category:handbook]]
 +
</translate>
 +
<languages/>
 
</noinclude>
 
</noinclude>

Latest revision as of 01:13, 18 December 2013


Contents


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.3a summarizes the possible statuses of this icon.

Table 7.3a: Update Manager Status

Updated1.png your system is up-to-date
Working1.png the system is currently checking for updates and patches
Sysupdates1.png your operating system is out-of-date and system update(s) or patch(es) are available
Pbiupdates1.png newer versions of installed PBI(s) are available
Pkgupdates.png newer versions of installed packages are available
Connecterror1.png the system was unable to check for updates, meaning you should check your Internet connection
Updating.png the system is currently updating
Restart.png 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.3a. As seen in the menu, Update Manager will automatically track updates to software installed using either the graphical or command line equivalents of Package Manager, AppCafe®, and Warden®.

Figure 7.3a: Right-click Menu for Update Manager
Figure 7.3b: 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.

[edit] Applying a System Update

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. Figure 7.3b shows an example of an available system update within Update Manager.

If your system is fully up-to-date, there will not be any entries in Update Manager. If you click the entry for a listed update, the “Update Details” box will provide some details about the update.

To install an update, highlight its entry and 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 "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.

[edit] Upgrading the Operating System

If you are running a rolling release, Update Manager can be used to upgrade to the latest version of the operating system.

DANGER!  IMPORTANT--README BEFORE ATTEMPTING AN UPGRADE! 
  • 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 changed with the July 23, 2013 rolling release. This change was needed to support boot environments and ZFS snapshot management with Life Preserver. This means that you can not upgrade from a release prior to that date. If you are running PC-BSD® 9.1-RELEASE or a rolling release 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.
  • 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.

Before performing an operating system upgrade, always back up the data that is important to you. Life Preserver can be used to backup your home directory to a remote system. It is also recommended to use Boot Manager to backup your current boot environment before performing the upgrade.

Figure 7.3c: Upgrading the Operating System

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

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

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.3c, the "Base System Updates" indicates that a system advisory is available, as well as an update to 9.2-RC3 and then 9.2-RC4. The "Update Details" section lists the files that will be changed if the system is upgraded.

NOTE: 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 "Base System Updates" entry and click the "Install selected updates" button. A progress bar will indicate the download status of the files that changed with the upgrade.

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.

Other languages:German 13% • ‎English 100% • ‎French 7%
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox