diff options
author | Raul Cuza <raulcuza@gmail.com> | 2011-07-07 16:26:20 -0400 |
---|---|---|
committer | Raul Cuza <raulcuza@gmail.com> | 2011-07-07 16:26:20 -0400 |
commit | 2659263b9a6660e0dbcb3cac1967714b8cfb3639 (patch) | |
tree | 383fcb1e9f4d8860d301ab1726a521f08b0a614e /doc/getting_started/macosx/notes.txt | |
parent | e788eb6afaf00516425e48ae27c72c20c5e4636a (diff) | |
download | bcfg2-2659263b9a6660e0dbcb3cac1967714b8cfb3639.tar.gz bcfg2-2659263b9a6660e0dbcb3cac1967714b8cfb3639.tar.bz2 bcfg2-2659263b9a6660e0dbcb3cac1967714b8cfb3639.zip |
Add documentation on how to get started with Bcfg2 on Mac OS X (10.6).
Diffstat (limited to 'doc/getting_started/macosx/notes.txt')
-rw-r--r-- | doc/getting_started/macosx/notes.txt | 77 |
1 files changed, 77 insertions, 0 deletions
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!) + |