Upgrading PC-BSD® - Revision history

Tigersharke at 04:12, 24 April 2013

2013-04-24T04:12:20Z

Tigersharke at 00:03, 22 April 2013

2013-04-22T00:03:20Z

Drulavigne at 15:45, 19 April 2013

2013-04-19T15:45:15Z

Drulavigne at 15:15, 16 April 2013

2013-04-16T15:15:27Z

Drulavigne: Marked this version for translation

2013-04-12T18:45:37Z

Marked this version for translation

Drulavigne at 18:45, 12 April 2013

2013-04-12T18:45:29Z

Tigersharke: /* Using Update Manager */

2013-04-09T05:05:55Z

‎Using Update Manager

Tigersharke at 12:56, 1 April 2013

2013-04-01T12:56:43Z

Tigersharke at 16:40, 7 March 2013

2013-03-07T16:40:45Z

Tigersharke: /* Using Update Manager */

2013-02-27T04:47:46Z

‎Using Update Manager

@@ Line 1: / Line 1: @@
-<translate>
+<noinclude><translate>
 <!--T:1-->
-<noinclude>{{NavHeader|back=Update Manager |forward=Meta Package Manager|custompagename=Upgrading PC-BSD{{r}}|custompagecategory={{PAGENAME}}}}</noinclude>
+{{NavHeader|back=Update Manager |forward=Meta Package Manager|custompagename=Upgrading PC-BSD{{r}}|custompagecategory={{PAGENAME}}}}</noinclude>
 <!--T:2-->
@@ Line 118: / Line 118: @@
 <!--T:27-->
 <noinclude>
-[[category:handbook]]
+{{refheading}}
-[[category:Advanced Installation Topics]]
 [[Category:Upgrading PC-BSD®]]
-</noinclude>
+[[category:Advanced Installation Topics]]
 </translate>
 <languages/>

← Older revision		Revision as of 00:03, 22 April 2013
Line 125:		Line 125:
	</noinclude>		</noinclude>
	</translate>		</translate>
		+	<languages/>

@@ Line 2: / Line 2: @@
 <!--T:1-->
-<noinclude>{{NavHeader|back=Multiple Boot Environments|forward=Creating an Automated Installation with pc-sysinstall|custompagename=Upgrading PC-BSD{{r}}|custompagecategory={{PAGENAME}}}}</noinclude>
+<noinclude>{{NavHeader|back=Update Manager |forward=Meta Package Manager|custompagename=Upgrading PC-BSD{{r}}|custompagecategory={{PAGENAME}}}}</noinclude>
 <!--T:2-->

← Older revision		Revision as of 15:15, 16 April 2013
Line 1:		Line 1:
−	<translate><!--T:1-->	+	<translate>
		+
		+	<!--T:1-->
	<noinclude>{{NavHeader\|back=Multiple Boot Environments\|forward=Creating an Automated Installation with pc-sysinstall\|custompagename=Upgrading PC-BSD{{r}}\|custompagecategory={{PAGENAME}}}}</noinclude>		<noinclude>{{NavHeader\|back=Multiple Boot Environments\|forward=Creating an Automated Installation with pc-sysinstall\|custompagename=Upgrading PC-BSD{{r}}\|custompagecategory={{PAGENAME}}}}</noinclude>

@@ Line 1: / Line 1: @@
-<translate><noinclude>{{NavHeader|back=Multiple Boot Environments|forward=Creating an Automated Installation with pc-sysinstall|custompagename=Upgrading PC-BSD{{r}}|custompagecategory={{PAGENAME}}}}</noinclude>
+<translate><!--T:1-->
 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 [[Update Manager | 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, [[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 ===
+=== Using Update Manager === <!--T:10-->
 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 current operating system is 9.0 and Update Manager is indicating that the upgrade to 9.1 is available.
 [[File:Upgrade1a.png|thumb|393px|'''Figure 5.4a: Using Update Manager to Upgrade the Operating System''']]
 {{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.}}
 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|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.}}
 After rebooting, a series of console messages will appear similar to these (depending upon your choices as described):
 {{txtbox|box=<nowiki>##############################################################</nowiki>
 A system update to PC-BSD is ready to be installed.
@@ Line 68: / Line 87: @@
 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.}}
-=== Using the Command Line ===
+=== Using the Command Line === <!--T:21-->
 To start a system upgrade from the command line, become the superuser and use the following command to check to see if an update is available:
 {{txtbox|box='''pc-updatemanager check'''
 The following updates are available:
@@ Line 83: / Line 104: @@
 To install this update run "/usr/local/bin/pc-updatemanager install release-9.1"}}
 Follow the instructions to install the update:
 {{txtbox|box='''pc-updatemanager install release-9.1'''
 STARTINGUPDATE: 9.1
 Downloading Master Files...}}
 The upgrade will then proceed as usual and you will be prompted when the system is ready to reboot.
 <noinclude>{{refheading}}</noinclude>
 <noinclude>

@@ Line 23: / Line 23: @@
 [[File:Upgrade1a.png|thumb|393px|'''Figure 5.4a: Using Update Manager to Upgrade the Operating System''']]
-{{note|width=48.5%|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.}}
+{{note|width=48.5%|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.}}
 To perform the upgrade, check the box for the "System Upgrade" entry and click the "Install selected updates" button. A progress bar will indicate:
@@ Line 34: / Line 34: @@
 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=48.5%|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.}}
-{{note|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):

@@ Line 67: / Line 67: @@
 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 now reboot into the newly-installed operating system.}}
+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.}}
 === Using the Command Line ===