From b5f9b0c73c9e79ec36c2831161a9914794db75c8 Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Tue, 30 Mar 2010 18:23:16 +0000 Subject: doc: Finish the centos quickstart (except for dynamic reports) Signed-off-by: Sol Jerome git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@5805 ce84e21b-d406-0410-9b95-82705330c041 --- doc/quickstart/centos.txt | 219 ++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 203 insertions(+), 16 deletions(-) (limited to 'doc') diff --git a/doc/quickstart/centos.txt b/doc/quickstart/centos.txt index 5bd3b14c4..858910832 100644 --- a/doc/quickstart/centos.txt +++ b/doc/quickstart/centos.txt @@ -226,14 +226,12 @@ something like this The last thing we need is for the client to have the proper arch group membership. For this, we will make use of the :ref:`unsorted-dynamic_groups` capabilities of the Probes plugin. Add -Probes to your plugins line in ``bcfg2.conf`` and create the Probe. +Probes to your plugins line in ``bcfg2.conf`` and create the Probe.:: -.. code-block:: sh - - root@lucid:~# grep plugins /etc/bcfg2.conf + [root@centos ~]# grep plugins /etc/bcfg2.conf plugins = Base,Bundler,Cfg,Metadata,Packages,Probes,Rules,SSHbase - root@lucid:~# mkdir /var/lib/bcfg2/Probes - root@lucid:~# cat /var/lib/bcfg2/Probes/groups + [root@centos ~]# mkdir /var/lib/bcfg2/Probes + [root@centos ~]# cat /var/lib/bcfg2/Probes/groups #!/bin/sh echo "group:`uname -m`" @@ -253,7 +251,7 @@ it with the *yum* package. .. code-block:: xml - root@lucid:~# cat /var/lib/bcfg2/Bundler/base-packages.xml + [root@centos ~]# cat /var/lib/bcfg2/Bundler/base-packages.xml @@ -280,7 +278,7 @@ Now if we run the client, we can see what this has done for us.:: Finished Loaded tool drivers: Action Chkconfig POSIX YUMng - Package pam failed verification. + Package pam failed verification. Phase: initial Correct entries: 94 @@ -350,17 +348,206 @@ Now you can go through these and continue adding the packages you want to your Bundle. After a while, I ended up with a minimal bundle that looks like this -*This section needs to be updated for v1* +.. code-block:: xml -Generate service listing -======================== + + + + + + + + + + + + + + + + + -*This section needs to be updated for v1* +Now when I run the client, you can see I have only one unmanaged +package:: + + [root@centos ~]# bcfg2 -veqn + Running probe groups + Probe groups has result: + x86_64 + Loaded plugins: fastestmirror + Loading mirror speeds from cached hostfile + Excluding Packages in global exclude list + Finished + Loaded tool drivers: + Action Chkconfig POSIX YUMng + Extra Package gpg-pubkey e8562897-459f07a4.None. + Extra Package gpg-pubkey 217521f6-45e8a532.None. + + Phase: initial + Correct entries: 187 + Incorrect entries: 0 + Total managed entries: 187 + Unmanaged entries: 16 + + + Phase: final + Correct entries: 187 + Incorrect entries: 0 + Total managed entries: 187 + Unmanaged entries: 16 + Package:gpg-pubkey + Service:atd + Service:avahi-daemon + Service:bcfg2-server + ... + +The gpg-pubkey packages are special in that they are not really +packages. Currently, the way to manage them is using :ref:`BoundEntries +`. So, after adding them, our Bundle now looks like this + +.. note:: This does not actually control the contents of the files, + you will need to do this part separately (see below). + +.. code-block:: xml + + + + + + + + + + + + + + + + + + + + + + + +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 -DBStats -------- +.. code-block:: xml + + + + + + + + + + + + + + + + + + + + + + + + + +Then add the files to Cfg:: + + mkdir -p Cfg/etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5 + cp /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-5 !$/RPM-GPG-KEY-CentOS-5 + mkdir -p Cfg/etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL + cp /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL !$/RPM-GPG-KEY-EPEL + +Now, running the client shows only unmanaged Service entries. Woohoo! + +Manage services ++++++++++++++++ + +Now let's clear up the unmanaged service entries by adding the following +entries to our bundle... + +.. code-block:: xml + + + + + + + + + + + + + + + + + + +...and bind them in Rules + +.. code-block:: xml + + [root@centos ~]# cat /var/lib/bcfg2/Rules/services.xml + + + + + + + + + + + + + + + + + + + +Now we run the client and see there are no more unmanaged entries! :: + + [root@centos ~]# bcfg2 -veqn + Running probe groups + Probe groups has result: + x86_64 + Loaded plugins: fastestmirror + Loading mirror speeds from cached hostfile + Excluding Packages in global exclude list + Finished + Loaded tool drivers: + Action Chkconfig POSIX YUMng + + Phase: initial + Correct entries: 205 + Incorrect entries: 0 + Total managed entries: 205 + Unmanaged entries: 0 + + + Phase: final + Correct entries: 205 + Incorrect entries: 0 + Total managed entries: 205 + Unmanaged entries: 0 -Setting up Django -+++++++++++++++++ +Dynamic (web) Reports +--------------------- *This section needs to be updated for v1* -- cgit v1.2.3-1-g7c22