Difference between revisions of "Pc-updatemanager/9.2"

From PC-BSD Wiki
Jump to: navigation, search
(Starting the Upgrade From the Command Line)
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<noinclude>{{NavHeader|back=Multiple Boot Environments|forward=Creating an Automated Installation with pc-sysinstall}}</noinclude>
+
<noinclude>{{NavHeader|back=Multiple Boot Environments|forward=Creating an Automated Installation with pc-sysinstall|custompagename=Upgrading PC-BSD{{r}}|custompagecategory={{PAGENAME}}}}</noinclude>
PC-BSD's [[Update Manager]] makes it easy to upgrade from an earlier version of 9.0 (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.
+
  
'''NOTE:''' 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. Also, it is not possible to "upgrade" from FreeBSD to PC-BSD.
+
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.
  
'''DANGER:''' '' '''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 [[Life Preserver]]. While it is unlikely that something will go wrong, you'll be glad that you made that backup just in case.
+
Before attempting an upgrade, be aware of the following caveats:
  
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 {{citelink|url=http://trac.pcbsd.org/browser/pcbsd/current/build-files/conf/upgrade-excludes|here}}. The upgrade process will also merge any customizations you have made to the new versions of the following files: ''boot/loader.conf'', ''/etc/rc.conf'', and ''/etc/sysctl.conf.''
+
* 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.  
  
'''NOTE:''' 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, [[Submit_PBI_Requests | request]] that your favourite port/package is made into a PBI as PBIs are preserved during an upgrade.
+
* it is not possible to upgrade from FreeBSD to PC-BSD®.
  
To perform the upgrade, 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 the administrative 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.3a, the operating system is currently at 9.0-BETA1 and Update Manager is indicating that 9.0-BETA1.5 is available.
+
* 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.
  
'''Figure 5.3a: Using Update Manager to Upgrade the Operating System'''
+
* '' '''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, [[Submit PBI Requests | 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 {{citelink|url=http://trac.pcbsd.org/browser/pcbsd/branches/9.1/build-files/conf/upgrade-excludes|txt=upgrade-excludes}}. 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 the administrative 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 operating system is currently at 9.0-BETA1 and Update Manager is indicating that 9.0-BETA1.5 is available.
 +
 
 +
'''Figure 5.4a: Using Update Manager to Upgrade the Operating System'''
  
 
[[Image:Upgrade1.png]]
 
[[Image:Upgrade1.png]]
  
To perform the update, check the box for the System Upgrade entry and click the "Install selected updates" button. A progress bar will indicate:
+
To perform the update, 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 ''PCBSD.tbz'' upgrade file
  
 
* the download status of the software packages that are installed with the operating system and which have newer available versions
 
* the download status of the software packages that are installed with the operating system and which have newer available versions
  
How long the 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, the message seen in Figure 5.3b will appear.
+
How long the 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, the message seen in Figure 5.4b will appear.
  
'''Figure 5.3b: System is Ready to Reboot'''
+
'''Figure 5.4b: System is Ready to Reboot'''
  
 
[[Image:Upgrade2.png]]
 
[[Image:Upgrade2.png]]
  
PC-BSD won't automatically reboot the system, giving you the opportunity to close any applications that you have open before you reboot the system yourself.
+
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.
  
After rebooting, a console message will appear similar to this one:  
+
After rebooting, a console message will appear similar to this one:
  
 
  ##############################################################
 
  ##############################################################
Line 40: Line 49:
 
  >
 
  >
  
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. If you are ready to leave the system alone while it completes the update, don't 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.
+
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. 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
 
  # PC-BSD System Upgrade
Line 52: Line 61:
 
  Rebooting for stage 2 of upgrade...Shutdown NOW!
 
  Rebooting for stage 2 of upgrade...Shutdown NOW!
  
The system will automatically reboot into the new operating system and continue with the application updates.  
+
The system will automatically reboot into the new operating system and continue with the application updates.
  
 
  # PC-BSD System Upgrade
 
  # PC-BSD System Upgrade
Line 62: Line 71:
 
  Update finished! Rebooting...
 
  Update finished! Rebooting...
  
Your system will now reboot into the newly installed operating system.
+
Your system will now reboot into the newly-installed operating system.
  
=== Starting the Upgrade From the Command Line ===
+
=== Using the Command Line ===
  
 
<noinclude>{{refheading}}</noinclude>
 
<noinclude>{{refheading}}</noinclude>
Line 70: Line 79:
 
[[category:handbook]]
 
[[category:handbook]]
 
[[category:Advanced Installation Topics]]
 
[[category:Advanced Installation Topics]]
[[Category:Upgrading PC-BSD]]
+
[[Category:Upgrading PC-BSD®]]
 
</noinclude>
 
</noinclude>

Revision as of 12:27, 15 November 2012

(Sorry for the inconvenience)

Contents

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 upgrade-excludes[1]. 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 PanelUpdate Manager or type pc-su pc-updategui from a terminal. After inputting the administrative 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 operating system is currently at 9.0-BETA1 and Update Manager is indicating that 9.0-BETA1.5 is available.

Figure 5.4a: Using Update Manager to Upgrade the Operating System

Upgrade1.png

To perform the update, 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 the 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, the message seen in Figure 5.4b will appear.

Figure 5.4b: System is Ready to Reboot

Upgrade2.png

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.

After rebooting, a console message will appear similar to this one:

##############################################################
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. 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.0-BETA1.5
# 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!

The system will automatically reboot into the new operating system and continue with the application updates.

# PC-BSD System Upgrade
# Updating to 9.0-BETA1.5
# Please do NOT reboot the system until the update is finished
##############################################################
Installing system packages...
Cleaning up...DONE
Update finished! Rebooting...

Your system will now reboot into the newly-installed operating system.

Using the Command Line

References


  1. http://trac.pcbsd.org/browser/pcbsd/branches/9.1/build-files/conf/upgrade-excludes
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox