Created page with "pc-updatemanager"
New page
<noinclude>
{{UseTOC{{putVers}}|Nav|title=pc-updatemanager}}</noinclude>
'''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}}.
If you type '''pc-updatemanager''', it will show its available options:
{{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}}
===Upgrading Packages===
To determine if newer versions of packages are available, type the following command as the superuser.
{{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"}}
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:
{{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}}
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.
===Applying System Updates===
To determine if any system updates are available, type the following command as the superuser:
{{txtbox|box='''pc-updatemanager check'''{{nbsp|58}}
The following updates are available:
<nowiki>------------------------------------</nowiki>
NAME: Update PKGNG repository configuration
TYPE: PATCH
TAG: pkgng-1.2.3-12112013
DETAILS: <nowiki>http://trac.pcbsd.org/wiki/patch-20131211-pkg</nowiki>
SIXE: 2Mb
To install: "pc-updatemanager install pkgng-1.2.3-12112013"}}
Follow the instructions to install the update:
{{note|icon64=System updates are one-way, meaning you cannot unapply an update once it is installed. If this is a concern, create a {{local|link=Boot Manager|boot environment}} first, before applying the update.}}
===Upgrading the Operating System===
Users who prefer to upgrade the operating system from the command line can use '''pc-updatemanager''' instead of the graphical Update Manager.
{{caveat|width=auto|icon64=''' ''before performing any 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.'' '''}}
Once a new RELEASE has been announced, it should appear as available using the following command:
{{txtbox|box='''pc-updatemanager check'''{{nbsp|44}}
The following updates are available:
<nowiki>------------------------------------</nowiki>
NAME: System Update to 10.0-RELEASE
TYPE: SYSUPDATE
TAG: fbsd-10.0-RELEASE
VERSION: 10.0-RELEASE
To install: "pc-updatemanager install fbsd-10.0-RELEASE"}}
To start the upgrade, follow the "To install" instructions. Messages will indicate the status of the upgrade.
Once the upgrade is complete, a message will indicate that you need to reboot the system in order for the changes to take effect. Close any applications that you have open, then type '''reboot''' in order to load the latest version of the operating system and finish the upgrade.
<noinclude>
<!-- {{refheading}} --><!-- uncomment if citelink used in page -->
[[Category:Upgrading PC-BSD®]]
[[category:Advanced Installation Topics]]
[[category:handbook]]
<languages/>
</noinclude>