Difference between revisions of "Pc-updatemanager/9.2"

From PC-BSD Wiki
Jump to: navigation, search
 
(67 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|custompagename=Upgrading PC-BSD{{r}}|custompagecategory={{PAGENAME}}}}</noinclude>
+
<noinclude><translate>
[[Update Manager]] 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.
+
  
'''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®.
+
<!--T:1-->
 +
{{UseTOC{{putVers}}|Nav|title=pc-updatemanager}}</noinclude>
  
'''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 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.
+
<!--T:22-->
 +
'''pc-updatemanager''' is the command line equivalent to {{local|link=Update Manager}}. It can be used to apply system updates and to perform an operating system upgrade. It can also be used to update packages, providing a command line equivalent to the "Package Updates" tab of {{local|link=Package_Manager|anchor=Update_Installed_Packages|Package Manager}}.
  
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 on the {{citelink|url=http://trac.pcbsd.org/browser/pcbsd/current/build-files/conf/upgrade-excludes|PC-BSD® Trac site}}. 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.''
+
<!--T:31-->
 +
If you type '''pc-updatemanager''', it will show its available options:
  
'''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 favorite port/package is made into a PBI as PBIs are preserved during an upgrade.
+
<!--T:32-->
 +
{{txtbox|box='''pc-updatemanager'''{{nbsp|64}}
 +
/usr/local/bin/pc-updatemanager - Usage
 +
<nowiki>----</nowiki>
 +
{{nbsp}} branches              - List available system branches
 +
{{nbsp}} chbranch <tag>        - Change to new system branch
 +
{{nbsp}} check                - Check for system updates
 +
{{nbsp}} install <tag>,<tag2>  - Install system updates
 +
{{nbsp}} pkgcheck              - Check for updates to packages
 +
{{nbsp}} pkgupdate            - Install packages updates}}
  
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.
+
===Upgrading Packages=== <!--T:37-->
  
'''Figure 5.4a: Using Update Manager to Upgrade the Operating System'''
+
<!--T:38-->
 +
To determine if newer versions of packages are available, type the following command as the superuser.
  
[[Image:Upgrade1.png]]
+
<!--T:39-->
 +
{{txtbox|box='''pc-updatemanager pkgcheck'''{{nbsp|55}}
 +
{{nbsp}} Updating repository catalogue
 +
{{nbsp}} Upgrades have been requested for the following 253 packages:
 +
{{nbsp}} list of packages snipped
 +
{{nbsp}} The upgrade will require 70 MB more space
 +
{{nbsp}} 439 MB to be downloaded
 +
{{nbsp}} To start the upgrade run "/usr/local/bin/pc-updatemanager pkgupdate"}}
  
To perform the update, check the box for the System Upgrade entry and click the "Install selected updates" button. A progress bar will indicate:
+
<!--T:40-->
 +
In this example, newer versions are available for 253 packages. The list of package names was snipped from the sample output. If no updates were available, the output would have instead said "All packages are up to date!".
  
* the download status of the ''PCBSD.tbz'' upgrade file
+
<!--T:41-->
 +
If updates are available, you can install them with this command:
  
* the download status of the software packages that are installed with the operating system and which have newer available versions
+
<!--T:42-->
 +
{{txtbox|box='''pc-updatemanager pkgupdate'''{{nbsp|54}}
 +
{{nbsp}} Updating repository catalogue
 +
{{nbsp}} snip downloading and reinstalling output
 +
{{nbsp}} [253/253] Upgrading pcbsd-base from 1374071964 to 1378408836... done
 +
{{nbsp}} Extracting desktop overlay data...DONE}}
  
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.
+
<!--T:43-->
 +
While the output has been snipped from this example, the update process will download the latest versions of the packages which need updating, displaying the download progress for each file. Once the downloads are complete, it will display the reinstallation process for each file. The last step of the update process is to extract the desktop (or server) overlay and then to return the prompt.
  
'''Figure 5.3b: System is Ready to Reboot'''
+
<!--T:44-->
 +
How long the package upgrade takes depends upon the number of packages and the speed of the Internet connection. If you run this command on a desktop, you should log out and log in again so that you load the latest version of the desktop and its applications. If you run this command on a server while running the tcsh shell, type '''rehash''' in order to tell the shell that new applications have been installed.
  
[[Image:Upgrade2.png]]
+
<!-- Content not published
 +
===Applying System Updates=== <!--T:34-->
  
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.
+
<!--T:35-->
 +
To determine if any system updates are available, type the following command as the superuser:
  
After rebooting, a console message will appear similar to this one:  
+
<!--T:23-->
 +
{{txtbox|box='''pc-updatemanager check'''{{nbsp|58}}
 +
{{nbsp}} The following updates are available:
 +
{{nbsp}} <nowiki>------------------------------------</nowiki>}}
  
##############################################################
+
<!--T:24-->
A system update to PC-BSD is ready to be installed.
+
Follow the instructions to install the update:
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.
+
===Upgrading the Operating System=== <!--T:36-->
  
# PC-BSD System Upgrade
+
<!--T:30-->
# Updating to 9.0-BETA1.5
+
{{caveat|width=auto|icon64=''' ''before performing an operating system upgrade, read the caveats listed in {{local|link=Update_Manager|anchor=Upgrading_the_Operating_System|Update manager}}. Be sure to backup your important data to another system or external device before starting the upgrade.'' '''}}
# 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.  
+
<!--T:25-->
 +
{{txtbox|box='''pc-updatemanager install release-9.1'''{{nbsp|44}}
 +
{{nbsp}} STARTINGUPDATE: 9.1
 +
{{nbsp}} Downloading Master Files...}}
  
# PC-BSD System Upgrade
+
<!--T:26-->
# Updating to 9.0-BETA1.5
+
The upgrade will then proceed as usual and you will be prompted when the system is ready to reboot. -->
# 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.
+
<!--T:27-->
 
+
=== Starting the Upgrade From the Command Line ===
+
 
+
<noinclude>{{refheading}}</noinclude>
+
 
<noinclude>
 
<noinclude>
 +
<!-- {{refheading}} --><!-- uncomment if citelink used in page -->
 +
[[Category:Upgrading PC-BSD®]]
 +
[[category:Advanced Installation Topics]]
 
[[category:handbook]]
 
[[category:handbook]]
[[category:Advanced Installation Topics]]
+
</translate>
[[Category:Upgrading PC-BSD®]]
+
<languages/>
 
</noinclude>
 
</noinclude>

Latest revision as of 00:34, 16 December 2013


Contents


pc-updatemanager is the command line equivalent to Update Manager. It can be used to apply system updates and to perform an operating system upgrade. It can also be used to update packages, providing a command line equivalent to the "Package Updates" tab of Package Manager.

If you type pc-updatemanager, it will show its available options:

pc-updatemanager                                                                

/usr/local/bin/pc-updatemanager - Usage ----   branches - List available system branches   chbranch <tag> - Change to new system branch   check - Check for system updates   install <tag>,<tag2> - Install system updates   pkgcheck - Check for updates to packages

  pkgupdate - Install packages updates

[edit] Upgrading Packages

To determine if newer versions of packages are available, type the following command as the superuser.

pc-updatemanager pkgcheck                                                       

  Updating repository catalogue   Upgrades have been requested for the following 253 packages:   list of packages snipped   The upgrade will require 70 MB more space   439 MB to be downloaded

  To start the upgrade run "/usr/local/bin/pc-updatemanager pkgupdate"

In this example, newer versions are available for 253 packages. The list of package names was snipped from the sample output. If no updates were available, the output would have instead said "All packages are up to date!".

If updates are available, you can install them with this command:

pc-updatemanager pkgupdate                                                      

  Updating repository catalogue   snip downloading and reinstalling output   [253/253] Upgrading pcbsd-base from 1374071964 to 1378408836... done

  Extracting desktop overlay data...DONE

While the output has been snipped from this example, the update process will download the latest versions of the packages which need updating, displaying the download progress for each file. Once the downloads are complete, it will display the reinstallation process for each file. The last step of the update process is to extract the desktop (or server) overlay and then to return the prompt.

How long the package upgrade takes depends upon the number of packages and the speed of the Internet connection. If you run this command on a desktop, you should log out and log in again so that you load the latest version of the desktop and its applications. If you run this command on a server while running the tcsh shell, type rehash in order to tell the shell that new applications have been installed.

Other languages:German 59% • ‎English 100% • ‎French 9%