Difference between revisions of "Update Manager/9.2"

From PC-BSD Wiki
Jump to: navigation, search
(46 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 operating system, installed PBIs, and system components 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 facilitate upgrading the operating system itself.
+
  
This section describes how to use the Update Manager GUI to update PBIs and apply system updates. [[Upgrading PC-BSD]] demonstrates how to start an operating system upgrade from the GUI.
+
<!--T:1-->
 +
{{NavHeader|back=Package Manager|forward=PBI Manager}}</noinclude>
  
Advanced users can use the following command line utilities to achieve the same results:
+
<!--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. 
  
* [[PBI_Manager#pbi_update.281.29 | '''pbi_update''']]: used to update installed PBIs
+
<!--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.
  
* [[Meta_Package_Manager | '''pc-metapkgmanager''']]: used to update installed system components
+
<!--T:41-->
 +
'''Table 7.3a: Update Manager Status'''
  
* [[Upgrading_PC-BSD#Starting_the_Upgrade_From_the_Command_Line | '''pc-updatemanager''']]: used to update the operating system
+
<!--T:9-->
 +
{|class=simple_table width=48% <!-- 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: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
 +
|}
  
An icon located in the 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: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 [[Package Manager]], [[AppCafe®]], and [[Warden®]].
  
[[Image:Updated1.png]] your system is up-to-date.
+
<!--T:42-->
 +
[[File:Update1d.png|thumb|'''Figure 7.3a: Right-click Menu for Update Manager''']]  
 +
[[File:Update2b.png|thumb|393px|'''Figure 7.3b: Update Manager''']]
  
[[Image:Working1.png]] the system is currently checking for updates and patches; this happens automatically whenever you boot your system.
+
<!--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:Sysupdates1.png]] your operating system is out-of-date and system update(s) or patch(es) are available.
+
===Applying a System Update=== <!--T:43-->
  
[[Image:Pbiupdates1.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: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. To install a system update, open Update Manager. Figure 7.3b shows an example of an available system update within Update Manager.
  
[[Image:Connecterror1.png]] the system was unable to check for updates, meaning you should check your Internet connection.
+
<!--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.  
  
[[Image:Updating.png]] the system is currently updating. You should see this icon once you click the "Install selected updates" button.
+
<!--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.
  
[[Image:Restart.png]] 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.
+
<!--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 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.
+
===Upgrading the Operating System=== <!--T:44-->
  
'''Figure 7.3a: Right-click Menu for Update Manager'''
+
<!--T:45-->
 +
Update Manager can also be used to upgrade to the latest version of the operating system.
  
[[Image:Update1c.png]]
+
<!--T:46-->
 +
'''NOTE:''' if you wish to upgrade the operating system every month instead of waiting until the next release, refer to [[Using a Rolling Release]].
  
Selecting "Start the Update Manager" from the right-click menu will open Update Manager so that you can review the available update(s).  
+
<!--T:47-->
 +
''' ''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.3b shows a screenshot of Update Manager:
+
<!--T:24-->
 +
Before attempting an upgrade, you should also be aware of the following caveats:
  
'''Figure 7.3b: Update Manager'''
+
<!--T:25-->
 +
* it is not recommended to update between major branches: for example, from a 8.x version to a 9.x version of PC-BSD®. Instead, backup your data and do a fresh install of the new version.
  
[[File:Update2a.png]]
+
<!--T:48-->
 +
* you will not be able to upgrade to 9.2 if the current operating system is either 32-bit or formatted with UFS.
  
If any updates are available, they will be listed; if your system is fully up-to-date, there will not be any entries.  
+
<!--T:26-->
 +
* it is not possible to upgrade from FreeBSD to PC-BSD®. However, you can [[Convert_a_FreeBSD_System_to_PC-BSD®|convert a FreeBSD system to PC-BSD®]].
  
If you hover over a listed update, a pop-up menu will provide some details about the update.
+
<!--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.
  
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 7.3c:
+
<!--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.''
  
'''Figure 7.3c: Installing a System Update'''
+
<!--T:34-->
 +
{{note|width=46%|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.}}
  
[[File:Update3a.png]]
+
<!--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:
  
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.
+
<!--T:36-->
 +
* the download status of the ''PCBSD.tbz'' upgrade file
  
 +
<!--T:37-->
 +
* the download status of the software packages that are installed with the operating system and which have newer available versions
 +
 +
<!--T:38-->
 +
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/''.
 +
 +
<!--T:39-->
 +
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.
 +
{{warning|width=46%|align=right|icon64=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.}}
 +
 +
<!--T:19-->
 +
After rebooting, a series of console messages will appear similar to these (depending upon your choices as described):
 +
 +
<!--T:20-->
 +
{{txtbox|box=<nowiki>##############################################################</nowiki>
 +
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.
 +
>
 +
|txt=
 +
Since this portion of the updating process can make your system unavailable for as long as half an hour, this message allows you to skip completing the update for now if you need to reboot into the system.}}
 +
{{txtbox|box={{pound}} PC-BSD System Upgrade
 +
{{pound}} Updating to 9.1
 +
{{pound}} Please do NOT reboot the system until the update is finished
 +
<nowiki>##############################################################</nowiki>{{nbsp|2}}
 +
Cleaning old system pkgs.....
 +
Extracting updated world environment...DONE!
 +
Extracting kernel and boot environment...DONE
 +
Cleaning up old files...DONE
 +
Rebooting for stage 2 of upgrade...Shutdown NOW!
 +
|txt=
 +
If you are ready to leave the system alone while it completes the update, do not do anything and the update will begin in 20 seconds. It is important to not reboot the system until this portion of the upgrade completes.}}
 +
{{txtbox|box={{pound}} PC-BSD System Upgrade
 +
{{pound}} Updating to 9.1
 +
{{pound}} Please do NOT reboot the system until the update is finished
 +
<nowiki>##############################################################</nowiki>{{nbsp|2}}
 +
Installing system packages...
 +
Cleaning up...DONE
 +
Update finished! Rebooting...
 +
|txt=
 +
The system will automatically reboot into the new operating system and continue with the application updates. After that has completed, your system will then reboot into the newly-installed operating system.}}
 +
 +
<!--T:18-->
 
<noinclude>
 
<noinclude>
[[category:handbook]]
+
{{Refheading}}
[[category:Maintaining and Extending PC-BSD]]
+
 
[[category:Update Manager]]
 
[[category:Update Manager]]
 +
[[category:Maintaining and Extending PC-BSD®]]
 +
[[category:handbook]]
 +
</translate>
 +
<languages/>
 
</noinclude>
 
</noinclude>

Revision as of 09:09, 6 September 2013

(Sorry for the inconvenience)

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
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: Update Manager

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.

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

Upgrading the Operating System

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

NOTE: if you wish to upgrade the operating system every month instead of waiting until the next release, refer to Using a Rolling Release.

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.

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

  • it is not recommended to update between major branches: for example, from a 8.x version to a 9.x version of PC-BSD®. Instead, backup your data and do a fresh install of the new version.
  • you will not be able to upgrade to 9.2 if the current operating system is either 32-bit or formatted with UFS.
  • 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.
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 "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.

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

>
Since this portion of the updating process can make your system unavailable for as long as half an hour, this message allows you to skip completing the update for now if you need to reboot into the system.
# PC-BSD System Upgrade

# 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...DONE

Rebooting for stage 2 of upgrade...Shutdown NOW!
If you are ready to leave the system alone while it completes the update, do not do anything and the update will begin in 20 seconds. It is important to not reboot the system until this portion of the upgrade completes.
# PC-BSD System Upgrade

# Updating to 9.1 # Please do NOT reboot the system until the update is finished ##############################################################   Installing system packages... Cleaning up...DONE

Update finished! Rebooting...
The system will automatically reboot into the new operating system and continue with the application updates. After that has completed, your system will then reboot into the newly-installed operating system.


References


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

Variants
Actions
Navigation
Toolbox