Difference between revisions of "Pkgng and pc-metapkgmanager/9.2/de"

From PC-BSD Wiki
Jump to: navigation, search
(Updating to match new version of source page)
Line 1: Line 1:
 
<noinclude>
 
<noinclude>
{{NavHeader|back=PBI Manager|forward=pc-updatemanager|custompagename=‎pkgng und pc-metapkgmanager}}</noinclude>
+
{{NavHeader|back=PBI Manager|forward=pc-updatemanager}}</noinclude>
  
Im Februar 2013 wechselte PC-BSD® vom traditionellen FreeBSD-Ports-System auf pkgng, der nächsten Generation des Paket-Management-Systems für FreeBSD.
+
Im Februar 2013 wechselte PC-BSD® vom traditionellen FreeBSD-Ports-System auf pkgng, der nächsten Generation des Paket-Management-Systems für FreeBSD.
 
+
{{note|icon64= Users of PC-BSD® 9.1-RELEASE will not be affected by this change unless they upgrade or install a [[Using a Rolling Release| rolling release]].}}
+
 
+
All of the PC-BSD® utilities that deal with installing or updating software now use the pkgng system. This allows users to safely install non-PBI software from the command line without that software being deleted by a system upgrade.
+
  
 
Since FreeBSD does not have an official pkgng repository yet, the PC-BSD® project provides its own repository containing all of the packages that can be built using pkgng.
 
Since FreeBSD does not have an official pkgng repository yet, the PC-BSD® project provides its own repository containing all of the packages that can be built using pkgng.
Line 12: Line 8:
 
PC-BSD® provides a custom command, '''pc-pkg''', which is a small wrapper to '''pkg'''. When '''pc-pkg''' is used with the '''install''' or '''upgrade''' flags, it  will automatically connect to the PC-BSD® pkgng repository using the integrated [http://aria2.sourceforge.net/ aria2] downloader utility, which can significantly reduce download speeds over a slow link.
 
PC-BSD® provides a custom command, '''pc-pkg''', which is a small wrapper to '''pkg'''. When '''pc-pkg''' is used with the '''install''' or '''upgrade''' flags, it  will automatically connect to the PC-BSD® pkgng repository using the integrated [http://aria2.sourceforge.net/ aria2] downloader utility, which can significantly reduce download speeds over a slow link.
  
If you are used to using the traditional FreeBSD package system, you will notice that the commands used to install and manage software differ slightly. For example, instead of using '''pkg_add''' to install a package from a remote repository, use '''pkg install''' or '''pc-pkg install''' (notice there is now a space instead of an underscore). Type '''man pkg''' to see a list of the available commands. Once you know the name of a command, you can use the built-in help system to get more information about that command. For example, to learn more about '''pkg install''', type '''pkg help install'''.
+
If you are used to using the traditional FreeBSD package system, take note that the commands used to install and manage software differ slightly. For example, instead of using '''pkg_add''' to install a package from a remote repository, use '''pkg install''' or '''pc-pkg install''' (notice there is now a space instead of an underscore)
 +
 
 +
The [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/pkgng-intro.html FreeBSD Handbook] provides an introduction to using pkgng. Section 5.5.1 is not needed on a PC-BSD® or TrueOS® system as the operating system installation does this for you. The various pkgng commands have associated man pages. Type '''man pkg''' for an overview of general usage; the names of the associated man pages will be found towards the bottom of this man page. Once you know the name of a command, you can also use the built-in help system to get more information about that command. For example, to learn more about '''pkg install''', type '''pkg help install'''.
  
 
===pc-metapkgmanager===
 
===pc-metapkgmanager===
  
'''pc-metapkgmanager''' is the back-end command line utility used by the PC-BSD® installer, 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.
+
'''pc-metapkgmanager''' is the back-end command line utility used by the PC-BSD® installer, Package 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.
  
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}}.
+
PC-BSD® uses pkgsets to determine which system components are available and which applications are installed with each system component. Currently, two pkgsets 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 TrueOS® server.  
  
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:
+
The '''pc-metapkgmanager''' command can be used to install or delete meta-packages or to change the default pkgset. If you type the command without any options, it will display its usage:
  
{{txtbox|box='''pc-metapkgmanager'''
+
'''pc-metapkgmanager'''
usage: pc-metapkgmanager [options]
+
usage: pc-metapkgmanager [options]
Options:
+
Options:
&nbsp;add pkg1,pkg2 <loc> -- Add the specified list of meta-packages  
+
add pkg1,pkg2 <loc> -- Add the specified list of meta-packages  
&nbsp;                          <loc> should be a FTP / HTTP url where pkg_add
+
del pkg1,pkg2   -- Delete the specified list of meta-packages
&nbsp;                          can fetch packages, or an absolute path to
+
list            -- List the available meta-packages
&nbsp;                          location of pkg files on disk.
+
status <pkg>    -- List the status of the specified meta-packages
&nbsp;checkup -- Check for updates to pkgs
+
  --pkgset <pkgset> -- Change default pkgset we are using
&nbsp;del pkg1,pkg2   -- Delete the specified list of meta-packages
+
&nbsp;list            -- List the available meta-packages
+
&nbsp;status <pkg>    -- List the status of the specified meta-packages
+
&nbsp;update pkg,pkg2 <loc> -- Update system packages. Can use 'all' or <pkg,pkg2>.
+
&nbsp;                          <loc> should be a FTP / HTTP url where pkg_add
+
&nbsp;                          can fetch packages, or an absolute path to
+
&nbsp;                          location of pkg files on disk.
+
&nbsp;--pkgset <pkgset> -- Change default pkgset we are using
+
&nbsp;--chroot <dir> -- Operate on the directory specified using chroot}}
+
 
+
=== Finding, Installing, and Uninstalling Meta-Packages ===
+
  
 
To determine which meta-packages are available:
 
To determine which meta-packages are available:
  
{{txtbox|box='''pc-metapkgmanager list {{pipe}} more'''
+
'''pc-metapkgmanager list {{pipe}} more'''
Meta Package: Awesome
+
Meta Package: Awesome
<nowiki>-</nowiki>------------------------------------
+
-------------------------------------
Description: A highly configurable, next generation framework window manager
+
Description: A highly configurable, next generation framework window manager
Icon: /var/db/pc-metapkgmanager/pkgsets/pcbsd/Awesome/pkg-icon.png
+
Icon: /usr/local/share/pcbsd/metaset/pcbsd/Awesome/pkg-icon.png
Parent: Unsupported-Desktops
+
Parent: Unsupported-Desktops
Desktop: YES
+
Desktop: YES
Required Packages:
+
Required Packages:
awesome-3.4.13
+
pcbsd-meta-awesome
Meta Package: Compiz
+
Meta Package: Compiz
<nowiki>-</nowiki>------------------------------------
+
-------------------------------------
Description: Compiz - OpenGL compositing manager
+
Description: Compiz - OpenGL compositing manager
Icon: /var/db/pc-metapkgmanager/pkgsets/pcbsd/Compiz/pkg-icon.png
+
Icon: /usr/local/share/pcbsd/metaset/pcbsd/Compiz/pkg-icon.png
Parent: Misc
+
Parent: Misc
Desktop: NO
+
Desktop: NO
Required Packages:
+
Required Packages:
compiz-fusion-0.8.4_2
+
pcbsd-meta-compiz
Meta Package: Desktops
+
Meta Package: Desktops
<nowiki>-</nowiki>------------------------------------
+
-------------------------------------
Description: Supported Desktop Environments for your PC-BSD system.  
+
Description: Supported Desktop Environments for your PC-BSD system.  
Icon: /var/db/pc-metapkgmanager/pkgsets/pcbsd/Desktops/pkg-icon.png
+
Icon: /usr/local/share/pcbsd/metaset/pcbsd/Desktops/pkg-icon.png
Desktop: NO
+
Desktop: NO
Category Entry
+
--More--(byte 989)}}
Meta Package: Development
+
<nowiki>-</nowiki>------------------------------------
+
Description: Development tools and utilities for your Desktop
+
Icon: /var/db/pc-metapkgmanager/pkgsets/pcbsd/Development/pkg-icon.png
+
Desktop: NO
+
--More--(byte 989)}}
+
  
To view which meta-packages are available in an alternate metapkgset, specify the metapkgset name. For example, to view the available ''warden'' meta-packages from your desktop, use this command:
+
To change the default pkgset, modify the ''PCBSD_METAPKGSET'' variable in ''/usr/local/etc/pcbsd.conf''.  
 
+
{{txtbox|box='''pc-metapkgmanager --pkgset warden list {{pipe}} more'''
+
Meta Package: Apache
+
<nowiki>-</nowiki>------------------------------------
+
Description: The Apache Web Server
+
Icon: /var/db/pc-metapkgmanager/pkgsets/warden/Apache/pkg-icon.png
+
Parent: Web-Servers
+
Desktop: NO
+
Required Packages:
+
apache-2.2.22_6
+
Meta Package: BigBlueButton
+
<nowiki>-</nowiki>------------------------------------
+
Description: BigBlueButton enables universities and colleges to deliver
+
a high-quality learning experience to remote students.
+
Icon: /var/db/pc-metapkgmanager/pkgsets/warden/BigBlueButton/pkg-icon.png
+
Parent: Web-Apps
+
Desktop: NO
+
Required Packages:
+
mysql-server-5.5.27
+
bigbluebutton-0.71_3
+
Meta Package: Database-Servers
+
<nowiki>-</nowiki>------------------------------------
+
Description: Database Server Software
+
Icon: /var/db/pc-metapkgmanager/pkgsets/warden/Database-Servers/pkg-icon.png
+
Desktop: NO
+
Category Entry
+
Meta Package: Development
+
<nowiki>-</nowiki>------------------------------------
+
Description: Development tools and utilities
+
Icon: /var/db/pc-metapkgmanager/pkgsets/warden/Development/pkg-icon.png
+
--More--(byte 989)}}
+
 
+
To permanently change the default metapkgset between ''pcbsd'' and ''warden'', modify the ''PCBSD_METAPKGSET'' variable in ''/usr/local/etc/pcbsd.conf''.  
+
  
 
To determine if a meta-package is installed, specify its "Meta Package" name as shown in the output of the '''pc-metapkgmanager list''' command. For example, to see if the Awesome desktop is installed:
 
To determine if a meta-package is installed, specify its "Meta Package" name as shown in the output of the '''pc-metapkgmanager list''' command. For example, to see if the Awesome desktop is installed:
  
{{txtbox|box='''pc-metapkgmanager status Awesome'''
+
'''pc-metapkgmanager status Awesome'''
The meta-pkg Awesome is not installed}}
+
The meta-pkg Awesome is not installed
  
 
To install the meta-package, use the '''add''' option and specify the meta-package name. Only the superuser can install meta-packages.  
 
To install the meta-package, use the '''add''' option and specify the meta-package name. Only the superuser can install meta-packages.  
Line 118: Line 66:
 
The following example installs the Awesome meta-package. '''pc-metapkgmanager''' will provide messages regarding the status of the installation:
 
The following example installs the Awesome meta-package. '''pc-metapkgmanager''' will provide messages regarding the status of the installation:
  
{{txtbox|box='''pc-metapkgmanager add Awesome'''  
+
'''pc-metapkgmanager add Awesome'''  
Pending Meta-Package changes: 1
+
Pending Meta-Package changes: 1
Package source: NET
+
Installing Meta-Package: Awesome (pcbsd-meta-awesome)
Preparing to add: Awesome...
+
  Updating repository catalogue
Checking for updates to old packages...
+
  /usr/local/tmp/All/pcbsd-meta-awesome-13661335100% of 2860  B   18 kBps 00m01s
Installing Meta-Package: Awesome
+
Updating repository catalogue
Getting package list...
+
Resuming download of: /usr/local/tmp/All/pcbsd-meta-awesome-1366133527.txz
Pending package changes: 6
+
The following 1 packages will be installed:
Downloading package: awesome-3.4.13
+
        Installing pcbsd-meta-awesome: 1366133527
//usr/local/tmp/awesome-3.4.13.txz            100% of 704 kB  637 kBps
+
0 B to be downloaded
Downloading package: libev-4.11,1
+
  Checking integrity... done
//usr/local/tmp/libev-4.11,1.txz              100% of 117 kB  361 kBps
+
[1/1] Installing pcbsd-meta-awesome-1366133527... done
Downloading package: libxdg-basedir-1.1.1
+
Cleaning up cache files..Done
//usr/local/tmp/libxdg-basedir-1.1.1.txz      100% of  11 kB  130 kBps
+
The meta-pkg Awesome is installed
Downloading package: xcb-util-image-0.3.8
+
Extracting ports overlay data...DONE
//usr/local/tmp/xcb-util-image-0.3.8.txz      100% of  18 kB  141 kBps
+
Finished Meta-Package: Awesome
Downloading package: xcb-util-keysyms-0.3.8
+
Meta-Package changes finished!
//usr/local/tmp/xcb-util-keysyms-0.3.8.txz   100% of 8040  B  72 kBps
+
Downloading package: xcb-util-wm-0.3.8
+
//usr/local/tmp/xcb-util-wm-0.3.8.txz        100% of  35 kB 148 kBps
+
Installing package: awesome-3.4.13
+
Skipping installed package: libev-4.11,1
+
Skipping installed package: libxdg-basedir-1.1.1
+
Skipping installed package: xcb-util-image-0.3.8
+
Skipping installed package: xcb-util-keysyms-0.3.8
+
Skipping installed package: xcb-util-wm-0.3.8
+
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 uninstall meta-packages. As seen in the following example, '''pc-metapkgmanager''' automatically determines which dependent packages are still needed by other applications and which can be safely removed.
 
To delete an installed meta-package, specify its name. Only the superuser can uninstall meta-packages. As seen in the following example, '''pc-metapkgmanager''' automatically determines which dependent packages are still needed by other applications and which can be safely removed.
  
{{txtbox|box='''pc-metapkgmanager del Awesome'''
+
'''pc-metapkgmanager del Awesome'''
Pending Meta-Package changes: 1
+
Pending Meta-Package changes: 1
Removing Meta-Package: Awesome
+
Removing Meta-Package: Awesome
Getting package list...
+
Removing: pcbsd-meta-awesome
Pending package changes: 66
+
The meta-pkg Awesome is not installed
Removing: awesome-3.4.13
+
Meta-Package changes finished!
Skipping Meta-Required: giflib-4.2.0_2
+
Removing: libev-4.11,1
+
Removing: libxdg-basedir-1.1.1
+
Removing: xcb-util-image-0.3.8
+
Removing: xcb-util-keysyms-0.3.8
+
Removing: xcb-util-wm-0.3.8
+
Skipping Required: bitstream-vera-1.10_5
+
Skipping Required: cairo-1.10.2_4,2
+
<snip output of other required packages>
+
The meta-pkg Awesome is not installed
+
Meta-Package changes finished!}}
+
 
+
=== Upgrading Meta-Packages ===
+
 
+
'''pc-metapkgmanager''' can also be used to determine if any meta-packages are out of date and to update meta-packages. To determine if any meta-packages have newer versions:
+
 
+
{{txtbox|box='''pc-metapkgmanager checkup'''
+
All packages are up to date!}}
+
 
+
In this example, all meta-packages are at their latest versions. If any were out of date, you would instead receive the message "The following package updates are available:" followed by the names of the out-of-date meta-packages.
+
 
+
To update a meta-package, use the '''pc-metapkgmanager update''' command followed by the name of the specific meta-package or the word '''all''' to update all out-of-date meta-packages.
+
 
+
'''pc-metapkgmanager''' records any error messages to ''/tmp/.pc-metamanager.log''. This log file automatically rotates whenever it reaches 5MB in size.
+
  
 
<noinclude>
 
<noinclude>
 
<!-- {{refheading}} --><!-- uncomment when citelink is used on this page -->
 
<!-- {{refheading}} --><!-- uncomment when citelink is used on this page -->
[[category:pkgng anwenden]]
+
[[category:Using pkgng]]
[[category:Installing Applications and Keeping PC-BSD® Updated]] [[category:Handbuch]]
+
[[category:Installing Applications and Keeping PC-BSD® Updated]]
 +
[[category:handbook]]
 
<languages/>
 
<languages/>
 
</noinclude>
 
</noinclude>

Revision as of 09:16, 29 August 2013

(Sorry for the inconvenience)

Contents

Im Februar 2013 wechselte PC-BSD® vom traditionellen FreeBSD-Ports-System auf pkgng, der nächsten Generation des Paket-Management-Systems für FreeBSD.

Since FreeBSD does not have an official pkgng repository yet, the PC-BSD® project provides its own repository containing all of the packages that can be built using pkgng.

PC-BSD® provides a custom command, pc-pkg, which is a small wrapper to pkg. When pc-pkg is used with the install or upgrade flags, it will automatically connect to the PC-BSD® pkgng repository using the integrated aria2 downloader utility, which can significantly reduce download speeds over a slow link.

If you are used to using the traditional FreeBSD package system, take note that the commands used to install and manage software differ slightly. For example, instead of using pkg_add to install a package from a remote repository, use pkg install or pc-pkg install (notice there is now a space instead of an underscore).

The FreeBSD Handbook provides an introduction to using pkgng. Section 5.5.1 is not needed on a PC-BSD® or TrueOS® system as the operating system installation does this for you. The various pkgng commands have associated man pages. Type man pkg for an overview of general usage; the names of the associated man pages will be found towards the bottom of this man page. Once you know the name of a command, you can also use the built-in help system to get more information about that command. For example, to learn more about pkg install, type pkg help install.

pc-metapkgmanager

pc-metapkgmanager is the back-end command line utility used by the PC-BSD® installer, Package 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.

PC-BSD® uses pkgsets to determine which system components are available and which applications are installed with each system component. Currently, two pkgsets 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 TrueOS® server.

The pc-metapkgmanager command can be used to install or delete meta-packages or to change the default pkgset. If you type the command without any options, it will display its usage:

pc-metapkgmanager
usage: pc-metapkgmanager [options]
Options:
add pkg1,pkg2 <loc>	 -- Add the specified list of meta-packages 
del pkg1,pkg2	  	 -- Delete the specified list of meta-packages
list     	         -- List the available meta-packages
status <pkg>    	 -- List the status of the specified meta-packages
--pkgset <pkgset>	 -- Change default pkgset we are using

To determine which meta-packages are available:

pc-metapkgmanager list | more
Meta Package: Awesome
-------------------------------------
Description: A highly configurable, next generation framework window manager
Icon: /usr/local/share/pcbsd/metaset/pcbsd/Awesome/pkg-icon.png
Parent: Unsupported-Desktops
Desktop: YES
Required Packages:
pcbsd-meta-awesome
Meta Package: Compiz
-------------------------------------
Description: Compiz - OpenGL compositing manager
Icon: /usr/local/share/pcbsd/metaset/pcbsd/Compiz/pkg-icon.png
Parent: Misc
Desktop: NO
Required Packages:
pcbsd-meta-compiz
Meta Package: Desktops
-------------------------------------
Description: Supported Desktop Environments for your PC-BSD system. 
Icon: /usr/local/share/pcbsd/metaset/pcbsd/Desktops/pkg-icon.png
Desktop: NO
--More--(byte 989)}}

To change the default pkgset, modify the PCBSD_METAPKGSET variable in /usr/local/etc/pcbsd.conf.

To determine if a meta-package is installed, specify its "Meta Package" name as shown in the output of the pc-metapkgmanager list command. For example, to see if the Awesome desktop is installed:

pc-metapkgmanager status Awesome
The meta-pkg Awesome is not installed

To install the meta-package, use the add option and specify the meta-package name. Only the superuser can install meta-packages.

The following example installs the Awesome meta-package. pc-metapkgmanager will provide messages regarding the status of the installation:

pc-metapkgmanager add Awesome 
Pending Meta-Package changes: 1
Installing Meta-Package: Awesome (pcbsd-meta-awesome)
Updating repository catalogue
/usr/local/tmp/All/pcbsd-meta-awesome-13661335100% of 2860  B   18 kBps 00m01s
Updating repository catalogue
Resuming download of: /usr/local/tmp/All/pcbsd-meta-awesome-1366133527.txz
The following 1 packages will be installed:
       Installing pcbsd-meta-awesome: 1366133527
0 B to be downloaded
Checking integrity... done
[1/1] Installing pcbsd-meta-awesome-1366133527... done
Cleaning up cache files..Done
The meta-pkg Awesome is installed
Extracting ports overlay data...DONE
Finished Meta-Package: Awesome
Meta-Package changes finished!

To delete an installed meta-package, specify its name. Only the superuser can uninstall meta-packages. As seen in the following example, pc-metapkgmanager automatically determines which dependent packages are still needed by other applications and which can be safely removed.

pc-metapkgmanager del Awesome
Pending Meta-Package changes: 1
Removing Meta-Package: Awesome
Removing: pcbsd-meta-awesome
The meta-pkg Awesome is not installed
Meta-Package changes finished!
Other languages:German 19% • ‎English 100% • ‎French 10%
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox