From 232476219e69afc14647892250bba08a3118a7e7 Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Thu, 14 Apr 2011 09:22:26 -0500 Subject: doc: Fix some documentation issues (#980) Signed-off-by: Sol Jerome --- doc/appendix/guides/centos.txt | 8 ++++++-- doc/appendix/guides/converging_rhel5.txt | 2 +- doc/appendix/guides/fedora.txt | 8 ++++++-- doc/client/tools/yumng.txt | 16 ++++++++++++---- doc/help/troubleshooting.txt | 12 ++++++++++++ 5 files changed, 37 insertions(+), 9 deletions(-) (limited to 'doc') diff --git a/doc/appendix/guides/centos.txt b/doc/appendix/guides/centos.txt index d89d532ba..525cb5a98 100644 --- a/doc/appendix/guides/centos.txt +++ b/doc/appendix/guides/centos.txt @@ -431,7 +431,7 @@ packages. Currently, the way to manage them is using :ref:`BoundEntries .. code-block:: xml - + @@ -452,6 +452,10 @@ packages. Currently, the way to manage them is using :ref:`BoundEntries +.. note:: + + version="foo" is just a dummy attribute for the gpg-pubkey Package + To actually push the gpg keys out via Bcfg2, you will need to manage the files as well. This can be done by adding Path entries for each of the gpg keys you want to manage @@ -461,7 +465,7 @@ gpg keys you want to manage - + diff --git a/doc/appendix/guides/converging_rhel5.txt b/doc/appendix/guides/converging_rhel5.txt index 7581d307f..d6a9d2d1c 100644 --- a/doc/appendix/guides/converging_rhel5.txt +++ b/doc/appendix/guides/converging_rhel5.txt @@ -81,7 +81,7 @@ For a "Package" - + diff --git a/doc/appendix/guides/fedora.txt b/doc/appendix/guides/fedora.txt index 4e3244eaa..12432b04f 100644 --- a/doc/appendix/guides/fedora.txt +++ b/doc/appendix/guides/fedora.txt @@ -339,7 +339,7 @@ Bundle now looks like this .. code-block:: xml - + @@ -360,6 +360,10 @@ Bundle now looks like this +.. note:: + + version="foo" is just a dummy attribute for the gpg-pubkey Package + To actually push the gpg keys out via Bcfg2, you will need to manage the files as well. This can be done by adding Path entries for each of the gpg keys you want to manage @@ -369,7 +373,7 @@ of the gpg keys you want to manage - + diff --git a/doc/client/tools/yumng.txt b/doc/client/tools/yumng.txt index dd712ddec..c2e9161a1 100644 --- a/doc/client/tools/yumng.txt +++ b/doc/client/tools/yumng.txt @@ -18,9 +18,15 @@ and SUSE based distributions. Examples of this are: -* SLES10 and openSUSE 10.2 both install six GPG keys. From an RPM perspective this means that there are six packages with the name gpg-pubkey. -* YUM always installs, as opposed to upgrades, kernel packages. This is hard coded in YUM (actually it can be overridden in yum.conf), so systems using YUM will eventually have multiple kernel packages installed. -* Red Hat family x86_64 based systems frequently have both an x86_64 and an i386 version of the same package installed. +* SLES10 and openSUSE 10.2 both install six GPG keys. From an RPM + perspective this means that there are six packages with the name + gpg-pubkey. +* YUM always installs, as opposed to upgrades, kernel packages. This is + hard coded in YUM (actually it can be overridden in yum.conf), + so systems using YUM will eventually have multiple kernel packages + installed. +* Red Hat family x86_64 based systems frequently have both an x86_64 + and an i386 version of the same package installed. The new Pkgmgr format files with Instances are therefore the only way to accurately describe an RPM based system. It is recommended that all RPM @@ -50,7 +56,9 @@ Features * Support for per instance ignoring of individual files for the RPM verification with the Ignore tag. * Multiple package Instances with full version information listed in interactive mode. * Support for installation and removal of gpg-pubkey packages. -* Support for controlling what action is taken on package verification failure with the install_action, version_fail_action and verify_fail_action attributes. +* Support for controlling what action is taken on package + verification failure with the install_action, version_fail_action and + verify_fail_action attributes. RPMng Driver Overview diff --git a/doc/help/troubleshooting.txt b/doc/help/troubleshooting.txt index 17bc391bd..e593db2f7 100644 --- a/doc/help/troubleshooting.txt +++ b/doc/help/troubleshooting.txt @@ -145,6 +145,10 @@ be taken to remedy them. | | | character present | | | | | in this file. | | +------------------------------+----------+---------------------+--------------+ +| Got unknown entries | Server | The Packages plugin | [11]_ | +| [list of unknown entries] | | has no knowledge of | | +| | | the listed entries | | ++------------------------------+----------+---------------------+--------------+ .. [1] This entry is not being bound. Ensure that a version of this @@ -166,6 +170,14 @@ be taken to remedy them. group is properly setup. .. [10] Ensure the correct encoding is specified in the [components] section of ``bcfg2.conf``. +.. [11] For packages listed other than **gpg-pubkey**, this error means + that the Packages plugin is unable to find the package in any of + the sources listed in ``Packages/config.xml``. The issue often + arises when the client is not in one of the groups necessary for + the Source listed. In the case of gpg-pubkey, you can safely + ignore the message as the Packages plugin has no knowledge of + these packages (however, note that this package is most often + specified as a BoundPackage entry). FAQs ==== -- cgit v1.2.3-1-g7c22