Changes between Version 15 and Version 16 of Install


Ignore:
Timestamp:
12/01/06 15:41:33 (17 years ago)
Author:
lueningh
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Install

    v15 v16  
    1 = Installation = 
     1= Installation and Configuration = 
    22 
    33[[TracNav]] 
    44 
    5 1. Prerequisites 
    6  * See [wiki:Prereqs] page 
     5== Installation == 
    76 
    8 2. Configure communication settings 
    9  * copy examples/bcfg2.conf /etc/bcfg2.conf 
    10  * Choose a port for the bcfg2 server 
    11  * Set the bcfg2= line in components section bcfg2.conf to point at the server location [[BR]] 
    12    bcfg2=https://servername.domain.com:port 
    13  * Choose a shared secret password, placing it in the password= line of the communication section of /etc/bcfg2.conf 
     7 1. Install Prerequisites 
     8   * Install the prerequisite libraries.  See the [wiki:Prereqs] page for more information. 
     9 1. Install Bcfg2 
     10    * '''From packages:''' The easiest way to install Bcfg2 is from packages for your operating system.  You can grab packages (and source packages) for various OSes from the [wiki:Downloads] page. Install them as you would any other packages.  The server package only needs to be installed on your designated Bcfg2 server machine; the clients package needs to be installed on any machine you plan to manage by Bcfg2. 
     11    * '''From source:''' The Bcfg2 source tarball can also be grabbed from the [wiki:Downloads] page.    After untarring the file, you can build Bcfg2 with {{{python setup.py install --prefix=/install/prefix}}}  This will install both the client and server on that machine. 
    1412 
    15 3. Generate an ssl cert 
    16  * openssl req -x509 -nodes -days 1000 -newkey rsa:1024 -out cert.pem -keyout cert.pem 
    17  * Set the key= line in the communication section of bcfg2.conf to point at this new certificate 
     13== Configuration == 
    1814 
    19 4. Install the [ftp://ftp.mcs.anl.gov/pub/bcfg/bcfg2-0.8-demo-repo.tar.gz example repository] 
    20  * Untar this file into your repository location 
    21  * Set this location in the repository line of the server section of /etc/bcfg2.conf 
     15Both the client and server read their configuration information from `/etc/bcfg2.conf`.  If you installed from a package, you should have a default version of this file installed.  If not, or if you installed from source, you can find one in the `examples/` directory of the Bcfg2 source distribution. 
    2216 
    23 5. Start up the bcfg2 server 
    24  * /etc/init.d/bcfg2-server start 
     17 1. The `[server]` section 
     18   * Point `repository` at the location of your Bcfg2 repository (where all of you configuratione elements will live).  You can start out with [ftp://ftp.mcs.anl.gov/pub/bcfg/bcfg2-0.8-demo-repo.tar.gz example repository] if you need some inspiration. 
     19     * `repository = /var/lib/bcfg2` 
     20   * Choose the `structures` you want to make use of.  The selection in the example configuration file should work fine until you have a complete repository set up. 
     21     * `structures = Bundler,Base` 
     22   * Choose the `generators` you want to use.  Again, keeping the defaults is appropriate for a new installation. 
     23     * `generators = SSHbase,Cfg,Pkgmgr,Svcmgr` 
     24 1. The `[statistics]` section 
     25   * This section controls how statistics information is sent out.  Set `sendmailpath` to the location of your sendmail binary 
     26     * `sendmailpath = /usr/sbin/sendmail` 
     27 1. The `[communication]` section 
     28   * Set the protocol you wish to use.  The currently recommended choice is xmlrpc/ssl. 
     29     * `protocol = xmlrpc/ssl` 
     30   * Select a shared secret password for use between your clients and server 
     31     * `password = roboconfig` 
     32   * Generate an ssl certificate for client/server communication and set its location 
     33     * `openssl req -x509 -nodes -days 1000 -newkey rsa:1024 -out bcfg2cert.pem -keyout bcfg2cert.pem` 
     34     * `key = /etc/bcfg2cert.pem` 
     35 1. The `[components]` section 
     36   * Set the URL for your Bcfg2 server.  This tells clients where to find the server and tells the server what port to listen on. 
     37     * `bcfg2 = https://config.example.com:6789` 
    2538 
    26 6. Copy bcfg2.conf to clients 
    27  * remove the key= line and server section; they aren't needed on clients 
     39Once your bcfg2.conf file is complete and either the example repository or an empty skeleton repository are in place, you can start up the bcfg2 server: 
    2840 
    29 The server is now up and running. Now you need to create your configuration specification. 
     41 * `/etc/init.d/bcfg2-server start` 
     42 
     43Copy the config files out to the clients, and you are installed!  Next step:  get that repository working for your particular environment.