diff options
author | Sol Jerome <sol.jerome@gmail.com> | 2011-04-23 21:54:21 -0500 |
---|---|---|
committer | Sol Jerome <sol.jerome@gmail.com> | 2011-04-23 21:54:21 -0500 |
commit | ca22f61e441563e46ac668c007fc10bb9e9694a9 (patch) | |
tree | b415668901a356f839313ea0f46e7300db77ac77 /doc/appendix | |
parent | 608fb57dd36053eb252d188ea7ba2c0a80a5631f (diff) | |
download | bcfg2-ca22f61e441563e46ac668c007fc10bb9e9694a9.tar.gz bcfg2-ca22f61e441563e46ac668c007fc10bb9e9694a9.tar.bz2 bcfg2-ca22f61e441563e46ac668c007fc10bb9e9694a9.zip |
doc: Add documentation for bootstrapping new clients
Signed-off-by: Sol Jerome <sol.jerome@gmail.com>
Diffstat (limited to 'doc/appendix')
-rw-r--r-- | doc/appendix/guides/bootstrap.txt | 39 | ||||
-rw-r--r-- | doc/appendix/guides/centos.txt | 5 | ||||
-rw-r--r-- | doc/appendix/guides/ubuntu.txt | 17 |
3 files changed, 55 insertions, 6 deletions
diff --git a/doc/appendix/guides/bootstrap.txt b/doc/appendix/guides/bootstrap.txt new file mode 100644 index 000000000..b9b5f318e --- /dev/null +++ b/doc/appendix/guides/bootstrap.txt @@ -0,0 +1,39 @@ +.. -*- mode: rst -*- + +.. _appendix-guides-bootstrap: + +========= +Bootstrap +========= + +Once you have your bcfg2 server setup and working, a common next step to +take is automating the addition of new clients. + +The method for bootstrapping your clients will vary depending on your +needs. The simplest way to go about this is to create a public default +group in ``Metadata/groups.xml``. Example: + +.. code-block:: xml + + <Group profile='true' name='basic' public='true' default='true'> + +This allows clients to freely associate themselves with this group so that +you will not be required to manually add them to ``Metadata/clients.xml`` +prior to running the client. + +.. note:: + + Reverse DNS will need to work in order to automate the process of + bootstrapping clients without first adding them to + ``Metadata/clients.xml``. + +There are command line options available on the client which allow +you to specify the options that are normally found in the client's +``/etc/bcfg2.conf``:: + + bcfg2 -x password -p basic -S https://bcfg2-server:6789 + +The above command will add the client to ``Metadata/clients.xml`` with the +profile *basic*. Generally, the configuration given to the client by the +bcfg2 server in this initial run will include the ``/etc/bcfg2.conf`` file +so that the client won't need to specify these options on future runs. diff --git a/doc/appendix/guides/centos.txt b/doc/appendix/guides/centos.txt index dae11e5d4..d788891de 100644 --- a/doc/appendix/guides/centos.txt +++ b/doc/appendix/guides/centos.txt @@ -586,3 +586,8 @@ Dynamic (web) reports ===================== See installation instructions at :ref:`reports-dynamic` + +Next Steps +========== + +:ref:`getting_started-index-next-steps` diff --git a/doc/appendix/guides/ubuntu.txt b/doc/appendix/guides/ubuntu.txt index 86f82d0b8..a597a5492 100644 --- a/doc/appendix/guides/ubuntu.txt +++ b/doc/appendix/guides/ubuntu.txt @@ -506,13 +506,8 @@ Now we run the client and see there are no more unmanaged entries! :: managed. Please see :ref:`unsorted-writing_specification` for more details. -Dynamic (web) reports -===================== - -See installation instructions at :ref:`appendix-guides-web-reports-install` - Upstart -======= +^^^^^^^ Upstart services are defined like this: @@ -526,3 +521,13 @@ Some Upstart services require additional parameters, like network-interface and <Service name="network-interface" status="on" type="upstart" parameters="INTERFACE=eth0"/> <Service name="bridge-network-interface" status="on" type="upstart" parameters="INTERFACE=br0"/> + +Dynamic (web) reports +===================== + +See installation instructions at :ref:`appendix-guides-web-reports-install` + +Next Steps +========== + +:ref:`getting_started-index-next-steps` |