From 3c90ebcb31dc5f0f49e5c0ee9f00de78fc237af2 Mon Sep 17 00:00:00 2001 From: Raul Cuza Date: Thu, 7 Jul 2011 13:54:01 -0400 Subject: Document versioning conventions used by Bcfg2. --- doc/development/versioning.txt | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 doc/development/versioning.txt (limited to 'doc') diff --git a/doc/development/versioning.txt b/doc/development/versioning.txt new file mode 100644 index 000000000..e32a361a0 --- /dev/null +++ b/doc/development/versioning.txt @@ -0,0 +1,18 @@ +.. -*- mode: rst -*- + +.. _development-tips: + +Versioning Bcfg2 +---------------- + +#. These are the conventions Bcfg2 has adopted for `versioning`_: + + * The version number will be broken down into Major.Minor.MicroBuild. + * Major and Minor are ever increasing integers. + * Micro is a single digit integer. This is because of limits in some +of the package systems (specifically Mac OS X). + * Build is either missing or refers to release candidates: e.g. +"pre3". + + +.. _versioning: https://secure.wikimedia.org/wikipedia/en/wiki/Software_versioning -- cgit v1.2.3-1-g7c22 From 2659263b9a6660e0dbcb3cac1967714b8cfb3639 Mon Sep 17 00:00:00 2001 From: Raul Cuza Date: Thu, 7 Jul 2011 16:26:20 -0400 Subject: Add documentation on how to get started with Bcfg2 on Mac OS X (10.6). --- doc/getting_started/macosx/notes.txt | 77 ++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 doc/getting_started/macosx/notes.txt (limited to 'doc') diff --git a/doc/getting_started/macosx/notes.txt b/doc/getting_started/macosx/notes.txt new file mode 100644 index 000000000..88178fee9 --- /dev/null +++ b/doc/getting_started/macosx/notes.txt @@ -0,0 +1,77 @@ += Setting up Bcfg2 From Scratch = + +Ala [[http://blog.conpocococo.org/post/6079832974/managing-etc-motd-with-bcfg2-starting-from-an-empty-vm|Managing /etc/motd with Bcfg2 Starting From an Empty VM]], I'll be setting up a fresh OS X 10.6 machine to be managed by [[http://bcfg2.org|Bcfg2]]. + +== Get OS X 10.6 Running == + +Use your favorite provisioning method (e.g. open-box-then-push-power-button, DVD, [[http://www.deploystudio.com/Home.html|DeplyStudio]], etc) to get your operating system running and fully patched. + +For this hands on, I'm running OS X 10.6.8 (Build 10K540) with the +supplied python 2.6.1. I've also turned on Remote Login (i.e. ssh) so I +can use my client to write this document going through the steps; having +ssh on is not a requirement for this howto. + +== Get bcfg2-server Working == + +=== Get bcfg2 package === + +You might be able to get a package already built for you, but it is not hard to build it from the source. You'll need git (via [[https://code.google.com/p/git-osx-installer/|git-osx-installer]] or [[https://github.com/mxcl/homebrew|homebrew]] the former is easier, the later more developer friendly) and Apple's [[http://developer.apple.com/xcode/|xcode]]. + +The first step is to clone the bcfg2 repository into a working directory: + +{{{#!highlight bash +cd ~/Devloper +git clone git://git.mcs.anl.gov/bcfg2.git +cd bcfg2 +}}} + +At this point you will probably want to checkout a release tag (`git tag -l` to +see a list of them). This test is using v1.2.0pre4. Once you've done +that you can build the server. + +{{{#!highlight bash +git checkout v1.2.0pre4 +cd osx +make server +}}} + +The server package contains both the client and the server. The package +is located at ./osx/bcfg2-VERSION.pkg. Copy it to the machine you want +to set up from scratch and install it. + +THIS NEEDS TO VERIFIED +Some of the differences between bcfg2 on Mac OS X and Debian is that the +libraries are stored at +`/Library/Frameworks/Python.framework/Versions/Current/share/bcfg2/` +`/Library/Python/site-packages/Bcfg2/` +instead of `/usr/lib/pymodules/` and `/usr/share/pyshare/Bcfg2. Also, +instead of cron and init.d, +`/Library/LaunchDaemons/gov.anl.mcs.bcfg2-daily.plist` controls peridic +runs and starts and stops. The runtime files are stored in +`/usr/local/bin` under Mac OS X instead of /usr/sbin/ for Debian. +VERIFY + +Error: bcfg2-admin init +""" +10.6_client :~ user$ sudo /usr/local/bin/bcfg2-admin init +Failed to import lxml dependency. Shutting down server. +""" + +Try: sudo easy_install lxml. If you don't have gcc-4.2 installed, you'll +need to install it on a machine that does. Then move +`/Library/Python/2.6/sites-packages/lxml-2.3-py2.6-macosx-10.6-universal.egg` +to the client and add the line +"./lxml-2.3-py2.6-macosx-10.6-universal.egg" to +`/Library/Python/2.6/site-packages/easy-install.pth`. + +getting a new error: + +$ sudo /usr/local/bin/bcfg2-admin init +Interactively initialize a new repository. + +bcfg2-admin init +$ + +So what is lxml easy_install fully installing? Need to make a package +(Lettuce to the rescue!) + -- cgit v1.2.3-1-g7c22