From 68f2fa13c1d5e7913d8a62f2c712f866b44221cf Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Mon, 23 Aug 2010 15:56:44 +0000 Subject: doc: Style fixes Signed-off-by: Sol Jerome git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@6031 ce84e21b-d406-0410-9b95-82705330c041 --- doc/client/tools/yumng.txt | 63 ++++++++++++++++++++++++++++++---------------- 1 file changed, 42 insertions(+), 21 deletions(-) (limited to 'doc/client/tools') diff --git a/doc/client/tools/yumng.txt b/doc/client/tools/yumng.txt index ce1b0a0ad..08fa2d45c 100644 --- a/doc/client/tools/yumng.txt +++ b/doc/client/tools/yumng.txt @@ -56,12 +56,14 @@ Features RPMng Driver Overview ===================== -The RPMng driver uses a mixture of rpm commands and rpm-python as detailed in the sections below. +The RPMng driver uses a mixture of rpm commands and rpm-python as detailed +in the sections below. rpmtools module --------------- -The rpmtools module conatins most of the rpm-python code and is imported by RPMng.py and YUMng.py. +The rpmtools module conatins most of the rpm-python code and is imported +by RPMng.py and YUMng.py. RPMng.RefreshPackages() ----------------------- @@ -145,7 +147,7 @@ configuration file options or as the default driver for RPM packages. From the command line:: - bcfg2 -n -v -d -D Action,POSIX,Chkconfig,RPMng + bcfg2 -n -v -d -D Action,POSIX,Chkconfig,RPMng This produces quite a bit of output so you may want to redirect the output to a file for review. @@ -221,7 +223,7 @@ old RPM driver. Example - an empty list:: [RPMng] - installonlypackages = + installonlypackages = Example - The default list:: @@ -261,8 +263,11 @@ The RPMng/YUMng drivers do the following three checks/status: #. Version #. rpm verify -Setting pkg_checks = true (the default) in the client configuration file means that all three checks will be done for all packages. -Setting pkg_checks = false in the client configuration file means that only the Installed check will be done for all packages. +Setting pkg_checks = true (the default) in the client configuration file +means that all three checks will be done for all packages. + +Setting pkg_checks = false in the client configuration file means that +only the Installed check will be done for all packages. The true/false value can be any combination of upper and lower case. @@ -279,8 +284,12 @@ The RPMng/YUMng drivers do the following three checks/status: #. Version #. rpm verify -Setting pkg_verify = true (the default) in the client configuration file means that all three checks will be done for all packages as long as pkg_checks = true. -Setting pkg_verify = false in the client configuration file means that the rpm verify wil not be done for all packages on the client. +Setting pkg_verify = true (the default) in the client configuration +file means that all three checks will be done for all packages as long +as pkg_checks = true. + +Setting pkg_verify = false in the client configuration file means that +the rpm verify wil not be done for all packages on the client. The true/false value can be any combination of upper and lower case. @@ -296,7 +305,9 @@ The RPMng/YUMng drivers do the following three checks/status: #. Version #. rpm verify -install_action controls whether or not a package instance will be installed if the installed check fails (i.e. if the package instance isn't installed). +install_action controls whether or not a package instance will be +installed if the installed check fails (i.e. if the package instance +isn't installed). If install_action = install then the package instance is installed. If install_action = none then the package instance is not installed. @@ -313,10 +324,15 @@ The RPMng/YUMng drivers do the following three checks/status: #. Version #. rpm verify -version_fail_action controls whether or not a package instance will be updated if the version check fails (i.e. if the installed package instance isn't the same version as specified in the configuration). +version_fail_action controls whether or not a package instance will +be updated if the version check fails (i.e. if the installed package +instance isn't the same version as specified in the configuration). + +If version_fail_action = upgrade then the package instance is upgraded +(or downgraded). -If version_fail_action = upgrade then the package instance is upgraded (or down graded). -If version_fail_action = none then the package instance is not upgraded (or down graded). +If version_fail_action = none then the package instance is not upgraded +(or downgraded). .. note:: #. verion_fail_action must evaluate true for both the client (this option) and the package instance (see the Instance Tag version_fail_action attribute below) for the action to take place. @@ -338,7 +354,7 @@ If verify_fail_action = reinstall then the package instance is reinstalled. If verify_fail_action = none then the package instance is not reinstalled. .. note:: - #. verify_fail_action must evaluate true for both the client (this option) and the package instance (see the Instance Tag verify_fail_action attribute below) for the action to take place. + #. verify_fail_action must evaluate true for both the client (this option) and the package instance (see the Instance Tag verify_fail_action attribute below) for the action to take place. #. yum cannot reinstall packages, so this option is really only relevant to RPMng. #. RPMng will not attempt to reinstall a package instance if the only failure is an RPM configuration file. #. RPMng will not attempt to reinstall a package instance if the only failure is an RPM dependency failure. @@ -347,22 +363,23 @@ Interactive Mode ---------------- Running the client in interactive mode (-I) prompts for the actions to -be taken as before. Prompts are per package and may apply to multiple -instances of that package. Each per package prompt will contain a list +be taken as before. Prompts are per package and may apply to multiple +instances of that package. Each per package prompt will contain a list of actions per instance. -Actions are encoded as +Actions are encoded as D - Delete I - Install -R - Reinstall +R - Reinstall U - Upgrade/Downgrade -An example is below. The example is from a system that is still using the old Pkgmgr format, so the epoch and arch appear as '*'.:: +An example is below. The example is from a system that is still using +the old Pkgmgr format, so the epoch and arch appear as '*'.:: Install/Upgrade/delete Package aaa_base instance(s) - R(*:10.2-38.*) (y/N) Install/Upgrade/delete Package evms instance(s) - R(*:2.5.5-67.*) (y/N) @@ -434,7 +451,7 @@ Pkgmgr Configuration Also see the general :ref:`Pkgmgr ` and :ref:`server-plugins-structures-altsrc` pages. - + Package Tag (Old style) ^^^^^^^^^^^^^^^^^^^^^^^ @@ -720,7 +737,11 @@ Kernel Per Instance Ignore ^^^^^^^^^^^^^^^^^^^ -.. note:: In this case a per instance ignore is actually a bad idea as the verify failure is because of multiarch issues where the last package installed wins. So this would be better as a Package level ignore. +.. note:: + + In this case a per instance ignore is actually a bad idea as the + verify failure is because of multiarch issues where the last package + installed wins. So this would be better as a Package level ignore. Ignore tag entries only work with the RPMng driver. They do not appear to be supported in YUMng as of 1.0pre5. @@ -757,7 +778,7 @@ on the yum man page) is valid. For RPMng a minimal entry is .. code-block:: xml - + verify_fail_action -- cgit v1.2.3-1-g7c22