Changes

This page documents the setup configuration and Maintenance maintenance of the bcfg2 configuration management system used in the Fedora ARM build farm. ==Server Side== ===Server Setup=== ===Configuring Groups=== ===Configuring Clients===    ==Client Side== The client in a bcfg2 instance is simply responsible for accessing the configuration details on the remote server and changing the host so that it conforms with those details. ===Client Install=== At the time of this document's creation, there is one missing dependency of bcfg2 in the Fedora ARM repository. The packages themselves have been built in Koji, but are waiting on signing and final release. The location of this dependency, python-lxml is: * For ARMv5TEL/ARMv7l builders: http://arm.koji.fedoraproject.org/packages/python-lxml/2.3/1.fc15/armv5tel/python-lxml-2.3-1.fc15.armv5tel.rpm* For ARMv7HL builders: http://arm.koji.fedoraproject.org/packages/python-lxml/2.3/1.fc15/armv5tel/python-lxml-2.3-1.fc15.armv5tel.rpm After installing this dependency, clients can be installed by running<pre>yum -y install bcfg2 </pre>  ===Client Configuration=== Bcfg2 requires the use of a key generated by the initialization of the server to run. The bcfg2 service can be initialized via command line arguments, but the preferred way of of handling this is to use a configuration file. A configuration file should be created at /etc/bcfg2.conf and contain the following entries: <pre>[communication]protocol = xmlrpc/sslpassword = XXXXXX #This should be set as the password from the serverca = /etc/bcfg2.crt #Copied from the server  [components]bcfg2 = https://hongkong.proximity.on.ca:6789 # This should be the fqdn and port of the server component.</pre> ===Client Update=== To force an update from the server, use the command:<pre>bcfg2 -vq </pre> To ensure that a client is up to date, use the command:<pre>bcfg2 -vqn </pre>