'''pc-metapkgmanager''' is the back-end command line utility used by the PC-BSD® installer, System Manager, Update Manager, and Warden® to manage meta-packages. Meta-packages are like system components, and include supported and unsupported desktops, development utilities, hardware drivers, and miscellaneous applications such as MythTV or XBMC.

+

<!--T:1-->

+

{{UseTOC{{putVers}}|Nav}}</noinclude>

−

Beginning with version 9.1, PC-BSD® uses metapkgsets to determine which system components are available and which applications are installed with each system component. Currently, two metapkgsets are available: ''pcbsd'' which defines the available desktop components, and ''warden'' which defines the components available when creating a jail with Warden® or installing a PC-BSD® server. You can view the contents of these metapkgsets on {{citelink|url=http://trac.pcbsd.org/browser/pcbsd/current#build-files/metapkgsets|txt=trac}}.

+

<!--T:27-->

+

PC-BSD® provides a graphical Package Manager utility to Control Panel which can be used to manage

+

installed desktops and system components. It can also be used as a front-end to the FreeBSD packages collection. If you prefer to start this utility from the command line, type '''pc-su pc-pkgmanager'''.

−

The '''pc-metapkgmanager''' command can be used at the command line to install or delete meta-packages, update to the latest package set, or to change the default metapkgset. If you type the command without any options, it will display its usage:

+

<!--T:31-->

+

Figure 7.2a shows Package Manager with its categories expanded. This sample system uses NVIDIA for graphics and the default desktop manager of KDE was kept during the installation. This default view is known as Basic View.

update pkg,pkg2 <loc> -- Update system packages. Can use 'all' or <pkg,pkg2>.

+

−

<loc> should be a FTP / HTTP url where pkg_add

+

−

can fetch packages, or an absolute path to

+

−

location of pkg files on disk.

+

−

--pkgset <pkgset> -- Change default pkgset we are using

+

−

--chroot <dir> -- Operate on the directory specified using chroot

+

−

To determine which meta-packages are available:

+

===Install System Components=== <!--T:41-->

−

'''pc-metapkgmanager list |more'''

+

<!--T:29-->

−

Meta Package: Awesome

+

To install or uninstall components, check the boxes for the components that you wish to install, uncheck the boxes for the components that you wish to remove, then click the "Apply" button to perform the requested operations.

To determine if a meta-package is installed, specify its name as shown in the above list:

+

===Install FreeBSD Packages=== <!--T:42-->

−

'''pc-metapkgmanager status Awesome'''

+

<!--T:32-->

−

The meta-pkg Awesome is not installed

+

To instead manage FreeBSD packages, click <span class=traverse>View{{rarr}}Advanced</span> to change to Advanced View. This view is shown in Figure 7.2b with the editors category expanded.

−

To install the meta-package, specify the meta-package name shown in the above list and provide the URL to the meta-package location for your architecture. The following example installs the Awesome meta-package on a 64-bit system. Only the superuser can install meta-packages.

The search utility can be used to find packages to install. Alternately, if you know the software category, expand it and check the software you would like to install. As you browse, you can select multiple packages. If you click an application name, its Package Information screen will display, as seen in the example in Figure 7.2c.

−

Installing Meta-Package: Awesome

+

−

Pending package changes: 1

+

−

Installing package: awesome-3.4.11_1

+

−

The meta-pkg Awesome is installed

+

−

Finished Meta-Package: Awesome

+

−

Meta-Package changes finished!

+

−

To delete an installed meta-package, specify its name. Only the superuser can install meta-packages.

To change the default metapkgset between ''pcbsd'' and ''warden'', modify the ''PCBSD_METAPKGSET'' variable in ''/usr/local/etc/pcbsd.conf''.

+

<!--T:37-->

+

* '''Description:''' displays the name and version of the package, its download size, the URL to its homepage, and a brief description.

−

'''pc-metapkgmanager''' can also be used to upgrade the packages that came with the operating system. When you run the '''pc-metapkgmanager list | more''' command, the "base-system" meta-package lists these packages. To determine if any are out-of-date:

+

<!--T:38-->

+

* '''Options:''' shows the options compiled into the package. Options will be listed as either ''on'' or ''off''.

−

'''pc-metapkgmanager status base-system'''

+

<!--T:39-->

−

??The meta-pkg base-system is partially installed??

+

* '''Dependencies:''' lists any additional packages that will be installed as dependencies of the selected package.

−

??To update the out-of-date base packages, run the following command as the superuser:??

+

<!--T:40-->

+

Once you have made your selections, click the "Apply" button to install the selected software.

As newer versions of installed packages become available, they are listed in the "Package Updates" tab of Package Manager. In the example shown in Figure 7.2d, three updates are available, representing package updates to the PC-BSD® utilities, the GUI versions of those utilities, and to the base packages installed with the operating system.

* if you are running RELEASE, any changes to the packages that come with the operating system as well as any packages installed in Basic View show up around the 1st and 15th of each month

+

+

<!--T:49-->

+

* if you are running STABLE, any changes to the packages that come with the operating system as well as any packages installed in Basic View show up around the 5th and 20th of each month

+

+

<!--T:50-->

+

* if you installed any FreeBSD packages from Advanced View, these show up whenever a new version becomes available

+

+

<!--T:51-->

+

Note that these are target dates which may slip by a few days if the build server experiences problems building packages from ports.

+

+

<!--T:52-->

+

To update to the newest versions of packages, click the "Update packages" button.

+

+

<!--T:25-->

<noinclude>

<noinclude>

−

[[category:handbook]]

+

<!-- {{refheading}} --><!-- uncomment when citelink is used on the page -->

−

[[category:Maintaining and Extending PC-BSD®]]

+

[[category:Meta Package Manager]]

[[category:Meta Package Manager]]

+

[[category:Maintaining and Extending PC-BSD®]]

+

[[category:handbook]]

+

</translate>

+

<languages/>

</noinclude>

</noinclude>

Latest revision as of 23:31, 15 December 2013

Package ManagerProtection (edit): sysopEdited by: Tigersharke

PC-BSD® provides a graphical Package Manager utility to Control Panel which can be used to manage
installed desktops and system components. It can also be used as a front-end to the FreeBSD packages collection. If you prefer to start this utility from the command line, type pc-su pc-pkgmanager.

Figure 7.2a shows Package Manager with its categories expanded. This sample system uses NVIDIA for graphics and the default desktop manager of KDE was kept during the installation. This default view is known as Basic View.

To install or uninstall components, check the boxes for the components that you wish to install, uncheck the boxes for the components that you wish to remove, then click the "Apply" button to perform the requested operations.

To instead manage FreeBSD packages, click View → Advanced to change to Advanced View. This view is shown in Figure 7.2b with the editors category expanded.

Figure 7.2b: Managing FreeBSD Packages

The search utility can be used to find packages to install. Alternately, if you know the software category, expand it and check the software you would like to install. As you browse, you can select multiple packages. If you click an application name, its Package Information screen will display, as seen in the example in Figure 7.2c.

Figure 7.2c: Viewing a Package's Information

The Package Information is divided into three tabs:

Description: displays the name and version of the package, its download size, the URL to its homepage, and a brief description.

Options: shows the options compiled into the package. Options will be listed as either on or off.

Dependencies: lists any additional packages that will be installed as dependencies of the selected package.

Once you have made your selections, click the "Apply" button to install the selected software.

As newer versions of installed packages become available, they are listed in the "Package Updates" tab of Package Manager. In the example shown in Figure 7.2d, three updates are available, representing package updates to the PC-BSD® utilities, the GUI versions of those utilities, and to the base packages installed with the operating system.

Figure 7.2d: Package Updates Available

Updates are added using the following target schedule:

if you are running RELEASE, any changes to the packages that come with the operating system as well as any packages installed in Basic View show up around the 1st and 15th of each month

if you are running STABLE, any changes to the packages that come with the operating system as well as any packages installed in Basic View show up around the 5th and 20th of each month

if you installed any FreeBSD packages from Advanced View, these show up whenever a new version becomes available

Note that these are target dates which may slip by a few days if the build server experiences problems building packages from ports.

To update to the newest versions of packages, click the "Update packages" button.