From ca22f61e441563e46ac668c007fc10bb9e9694a9 Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Sat, 23 Apr 2011 21:54:21 -0500 Subject: doc: Add documentation for bootstrapping new clients Signed-off-by: Sol Jerome --- doc/appendix/guides/bootstrap.txt | 39 +++++++++++++++++++++++++++++++++++++++ doc/appendix/guides/centos.txt | 5 +++++ doc/appendix/guides/ubuntu.txt | 17 +++++++++++------ 3 files changed, 55 insertions(+), 6 deletions(-) create mode 100644 doc/appendix/guides/bootstrap.txt (limited to 'doc/appendix') 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 + + + +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 + +Dynamic (web) reports +===================== + +See installation instructions at :ref:`appendix-guides-web-reports-install` + +Next Steps +========== + +:ref:`getting_started-index-next-steps` -- cgit v1.2.3-1-g7c22