mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2025-01-22 20:45:18 +00:00
06a0d57f5a
There are a number of flaws with our packaging of the libvirtd
daemon:
- Installing 'libvirt' does not install 'qemu-kvm' or 'xen'
etc which are required to actually run the hypervisor in
question
- Installing 'libvirt' pulls in the default configuration
files which may not be wanted & cause problems if installed
inside a guest
- It is not possible to explicitly required all the peices
required to manage a specific hypervisor
This change takes the 'libvirt' RPM and and changes it thus
- libvirt: just a virtual package with dep on libvirt-daemon,
libvirt-daemon-config-network & libvirt-daemon-config-nwfilter
- libvirt-daemon: the libvirt daemon and related pieces
- libvirt-daemon-config-network: the default network config
- libvirt-daemon-config-nwfilter: the network filter configs
- libvirt-docs: the website HTML
We then introduce some more virtual (empty) packages
- libvirt-daemon-qemu: Deps on libvirt-daemon & 'qemu'
- libvirt-daemon-kvm: Deps on libvirt-daemon & 'qemu-kvm'
- libvirt-daemon-lxc: Deps on libvirt-daemon
- libvirt-daemon-uml: Deps on libvirt-daemon
- libvirt-daemon-xen: Deps on libvirt-daemon & 'xen'
- libvirt-qemu: Deps on libvirt-daemon-qemu & libvirt-daemon-config-{network,nwfilter}
- libvirt-kvm: Deps on libvirt-daemon-kvm & libvirt-daemon-config-{network,nwfilter}
- libvirt-lxc: Deps on libvirt-daemon-lxc & libvirt-daemon-config-{network,nwfilter}
- libvirt-uml: Deps on libvirt-daemon-uml & libvirt-daemon-config-{network,nwfilter}
- libvirt-xen: Deps on libvirt-daemon-xen & libvirt-daemon-config-network
My intent in the future is to turn on the driver modules by
default, at which time 'libvirt-daemon' will cease to include
any specific drivers, instead we'll get libvirt-daemon-driver-XXXX
packages for each driver. The libvirt-daemon-XXX packages will
then pull in each driver that they require.
It is recommended that applications required a locally installed
libvirtd daemon, use either 'Requires: libvirt-daemon-XXXX' or
'Requires: libvirt-XXX' and *not* "Requires: libvirt-daemon"
or 'Requires: libvirt'
* libvirt.spec.in: Refactor RPMs
* docs/packaging.html.in, docs/sitemap.html.in: Document
new RPM split rationale
107 lines
4.7 KiB
XML
107 lines
4.7 KiB
XML
<?xml version="1.0"?>
|
|
<html>
|
|
<body>
|
|
<h1>Distribution packaging</h1>
|
|
|
|
<ul id="toc"></ul>
|
|
|
|
<p>
|
|
This page describes the rationale behind the libvirt distribution
|
|
packaging in RPM format. The RPM specfile provided with libvirt targets
|
|
all Fedora and RHEL releases. It is split up into a number of sub-RPMs
|
|
in order to facilitate minimal installations, targetting specific
|
|
feature sets.
|
|
</p>
|
|
|
|
<h2><a name="real">Real packages</a></h2>
|
|
|
|
<p>
|
|
The so called "real" packages provide the actual file payloads
|
|
related to libvirt. If very specific / targetted functionality
|
|
is required, then applications can depend on one or more of these
|
|
real packages.
|
|
</p>
|
|
|
|
<dl>
|
|
<dt>libvirt-client</dt>
|
|
<dd>This package provides the main libvirt.so library along with
|
|
the virsh command line tool. If a C based application only wants
|
|
to be able to manage remote hypervisors, this is all that they
|
|
need depend on</dd>
|
|
<dt>libvirt-devel</dt>
|
|
<dd>This package provides the header files and libraries required
|
|
to compile and link C applications using libvirt</dd>
|
|
<dt>libvirt-python</dt>
|
|
<dd>This package provides the Python binding to the C libraries.
|
|
It will pull in the libvirt-client RPM. If a Python application
|
|
only wants to be able to manage remote hypervisors, this is all
|
|
that they need depend on</dd>
|
|
<dt>libvirt-daemon</dt>
|
|
<dd>This package provides server side libvirtd daemon, which is
|
|
required in order to manage any stateful hypervisors (currently
|
|
QEMU, KVM, Xen, LXC and UML).</dd>
|
|
<dt>libvirt-daemon-config-network</dt>
|
|
<dd>This package provides the standard configuration files for
|
|
setting up a NAT based network</dd>
|
|
<dt>libvirt-daemon-config-nwfilter</dt>
|
|
<dd>This package provides the standard configuration files for
|
|
network filter rules for ensuring clean VM traffic.</dd>
|
|
</dl>
|
|
|
|
<h2><a name="virtual">Virtual packages</a></h2>
|
|
|
|
<p>
|
|
The virtual packages provide convenient targets for application dependencies to
|
|
pull in functionality related to specific hypervisors. Since the packaging of
|
|
the <code>libvirt-daemon</code> RPM is expected to change in the future to split
|
|
each hypervisor driver out into a separate RPM, applications are strongly
|
|
recommended to depend on one of the following virtual packages, instead of
|
|
depending directly on <code>libvirt-daemon</code>
|
|
</p>
|
|
|
|
<dl>
|
|
<dt>libvirt</dt>
|
|
<dd>This package, simply pulls in every single other server side RPM.
|
|
If an application wants to ensure all possible libvirt drivers are installed,
|
|
this is what they should depend on</dd>
|
|
|
|
<dt>libvirt-daemon-qemu</dt>
|
|
<dd>This package pulls in the server side daemon, drivers and the QEMU TCG binaries
|
|
required to provide emulation of non-native architectures</dd>
|
|
<dt>libvirt-daemon-kvm</dt>
|
|
<dd>This package pulls in the server side daemon, drivers and the KVM binaries
|
|
required to provide hardware accelerated virtualization of the native
|
|
architectures</dd>
|
|
<dt>libvirt-daemon-lxc</dt>
|
|
<dd>This package pulls in the server side daemon and drivers required to
|
|
run native Linux containers</dd>
|
|
<dt>libvirt-daemon-uml</dt>
|
|
<dd>This package pulls in the server side daemon and drivers required to
|
|
run User Mode Linux. The application must still provide the actual
|
|
UML binary kernels</dd>
|
|
<dt>libvirt-daemon-xen</dt>
|
|
<dd>This package pulls in the server side daemon and drivers required to
|
|
run guests on the Xen hypervisor.</dd>
|
|
|
|
<dt>libvirt-qemu</dt>
|
|
<dd>This package pulls in the server side daemon, drivers and the QEMU TCG binaries
|
|
required to provide emulation of non-native architectures</dd>
|
|
<dt>libvirt-kvm</dt>
|
|
<dd>This package pulls in the server side daemon, drivers and the KVM binaries
|
|
required to provide hardware accelerated virtualization of the native
|
|
architectures</dd>
|
|
<dt>libvirt-lxc</dt>
|
|
<dd>This package pulls in the server side daemon, drivers and default
|
|
configuration files required to run native Linux containers</dd>
|
|
<dt>libvirt-uml</dt>
|
|
<dd>This package pulls in the server side daemon, drivers and default
|
|
configuration files required to run User Mode Linux. The application
|
|
must still provide the actual UML binary kernels</dd>
|
|
<dt>libvirt-xen</dt>
|
|
<dd>This package pulls in the server side daemon, drivers and default
|
|
configuration files required to run guests on the Xen hypervisor.</dd>
|
|
</dl>
|
|
|
|
</body>
|
|
</html>
|