summaryrefslogtreecommitdiffstats
path: root/cobbler.pod
diff options
context:
space:
mode:
authormdehaan@mdehaan.rdu.redhat.com <>2007-02-14 12:24:42 -0500
committerJim Meyering <jim@meyering.net>2007-02-14 12:24:42 -0500
commit09c6c7cc22dddc4354082b82d5eda447a0bdfb03 (patch)
tree90344cb74ad36d6c7b0a2e062ad3ef8ce88ee56b /cobbler.pod
parentd5971f58acb88a3c379debf18c30fe3afe98e09f (diff)
downloadthird_party-cobbler-09c6c7cc22dddc4354082b82d5eda447a0bdfb03.tar.gz
third_party-cobbler-09c6c7cc22dddc4354082b82d5eda447a0bdfb03.tar.xz
third_party-cobbler-09c6c7cc22dddc4354082b82d5eda447a0bdfb03.zip
Run check in post to ensure cobbler tree setup, such that distros/systems/profiles can be added immediately, without the need to run "sync" to create the base directories.
Diffstat (limited to 'cobbler.pod')
-rw-r--r--cobbler.pod12
1 files changed, 6 insertions, 6 deletions
diff --git a/cobbler.pod b/cobbler.pod
index 2b4abb9..07c2e96 100644
--- a/cobbler.pod
+++ b/cobbler.pod
@@ -252,11 +252,13 @@ B<cobbler system remove --name=string>
B<cobbler remove repo --name=string>
-=head2 APPLYING CONFIGURATIONS
+=head2 REBUILDING CONFIGURATIONS
B<cobbler sync>
-Cobbler sync must be run after changing /var/lib/cobbler/settings or manually editing kickstart templates or other internal files in /var/lib/cobbler. Cobbler sync's job is to make sure that the provisionable entities and the cobbler internal configuration are in sync.
+Cobbler sync is used to repair or rebuild the contents /tftpboot or /var/www/cobbler when something has changed behind the scenes. It brings the filesystem up to date with the configuration as understood by cobbler.
+
+Sync should be run whenever files in /var/www/cobbler are manually edited or when making changes to kickstart files. In practice, this should not happen often, though running sync too many times does not cause any adverse effects.
=head1 EXAMPLES
@@ -308,8 +310,6 @@ B<cobbler system add --name=AA:BB:CC:DD:EE:FE --profile=rhel4u3-dbservers>
B<cobbler report>
-B<cobbler sync>
-
=head2 REPOSITORY MIRRORING WORKFLOW
The following example shows how to set up a repo mirror for two repositories, and create a profile
@@ -327,8 +327,6 @@ B<cobbler reposync>
B<cobbler profile add --name=p1 --distro=existing_distro_name --kickstart=/etc/cobbler/kickstart_fc6.ks --repos="magicfooi386 magicbari386">
-B<cobbler sync>
-
See the expanded description towards the bottom of this manpage for further information about
repo management.
@@ -497,6 +495,8 @@ Enterprising users can edit the files in /var/lib/cobbler directly versus using
mechanism for user error here is to delete the files in /var/lib/cobbler. There are also a few configuration
files in /etc/cobbler that can be edited.
+Running "cobbler sync" is required to apply any changes that are made manually.
+
=head2 API
Cobbler also makes itself available as a Python API for use by higher level management software.