From 96714d720ce568aafac6ac45b35fe1341a8d38d5 Mon Sep 17 00:00:00 2001
From: Tim Laszlo <tim.laszlo@gmail.com>
Date: Mon, 2 Aug 2010 21:41:23 +0000
Subject: Packages: Allow soft relaods and use a checksum for cache file.

Use checksum for cache file.
Allow reloads of config.xml and sources without downloading everything.
Merged config.xml and source processing into a single function.

git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@5997 ce84e21b-d406-0410-9b95-82705330c041
---
 doc/server/plugins/generators/packages.txt | 39 ++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

(limited to 'doc')

diff --git a/doc/server/plugins/generators/packages.txt b/doc/server/plugins/generators/packages.txt
index 75349b3a3..923dafefb 100644
--- a/doc/server/plugins/generators/packages.txt
+++ b/doc/server/plugins/generators/packages.txt
@@ -211,6 +211,16 @@ Once line per file download needed. Packages/config.xml will be reloaded
 at this time, so any source specification changes (new or modified
 sources in this file) will be reflected by the server at this point.
 
+Soft reload
+-----------
+
+.. versionadded:: 1.1.0
+
+A soft reload can be performed to reread the configuration file and download only missing sources.::
+
+    [0:3711] bcfg2-admin xcmd Packages.Reload
+    True
+
 Availability
 ============
 
@@ -241,6 +251,35 @@ need to use :ref:`BoundEntries <boundentries>` like below
 
     <BoundPackage name="mem-agent" priority="1" version="auto" type="yum" verify="false"/>
 
+Generating Client APT/Yum Configurations
+========================================
+
+.. versionadded:: 1.1.0
+
+Client repository information can be generated automatically from software sources using
+:doc:`./tgenshi/index` or :doc:`./tcheetah`.  A list of source urls are exposed in the client's metadata as 
+metadata.Packages.sources.
+
+An example :doc:`./tgenshi/index` APT template::
+
+    # bcfg2 maintained apt
+
+    {% for s in metadata.Packages.sources %}\
+    deb ${s.url}${s.version} ${s.groups[0]} {% for comp in s.components %}$comp {% end %}
+
+    {% end %}\
+
+An example :doc:`./tgenshi/index` YUM template::
+
+    # bcfg2 maintained yum
+
+    % for s in metadata.Packages.sources %}\
+    [${s.groups[0]}_${s.component}]
+    name=${s.groups[0]}_${s.component}
+    baseurl=${s.url}
+
+    {% end %}\
+
 Debugging unexpected behavior
 =============================
 
-- 
cgit v1.2.3-1-g7c22