InstallingAboutUsOnOSX
Contents
Xcode tools
- Available on OS X install DVD or from http://developer.apple.com/tools/xcode/
Git
- Download binary from http://code.google.com/p/git-osx-installer/downloads/list?can=3
- Verify that git functions.
Dev environment
(Includes precompiled Apache, PHP, Ruby, and all necessary libraries and extensions)
Copy Base Files
- Download au_dev_environment.dmg from nimbus and open the image file.
- Copy [dev image]/opt and [dev image]/www to /
cp -r /Volumes/AboutUs\ dev\ environment/www /Volumes/AboutUs\ dev\ environment/opt /
Update git repositories
- In /www/aboutus/au-tools and /www/aboutus/www edit the .git/config file to point to user@nimbus
- Run the following in both of the above directories:
git pull
- Edit /www/aboutus/compostus/.git/config and change the URL for the 'origin' remote to
git@github.com:AboutUs/compostus.git
- Run 'git pull' in the /www/aboutus/compostus director. When performing git pull for the first time, make sure you are in compostus branch.
- Clone electric_sheep into /www/aboutus/electric_sheep
git clone git@github.com:AboutUs/electric_sheep.git /www/aboutus/electric_sheep
Setup MySQL
- Copy mysql-5.0.67-osx10.5-x86 to /usr/local
- Run the following commands to set up mysql:
cd /usr/local sudo ln -s mysql-5.0.67-osx10.5-x86 mysql sudo chown -R _mysql /usr/local/mysql/data sudo mysqld_safe (If you haven't start your mysql)
Configure your environment
- Edit your ~/.profile (or ~/.bashrc) and append the lines from [dev image]/profile
- Restart any open terminal sessions.
- Append the following line to /etc/hosts:
127.0.0.1 compostus
Install gem requirements
- Update rubygems and geminstaller
sudo gem update --system sudo gem update geminstaller`
- Add github as a gem source
gem source -a http://gems.github.com/
- (optional) Disable generation of rDoc and ri documentation to speed up the gem install process by editing ~/.gemrc to include
gem: --no-rdoc --no-ri
- Go to /www/aboutus/compostus/compost and run geminstaller as root. This will standarized all gems needed to run AboutUs.
MacPorts
- Libraries copied over as part of dev environment install process should work fine.
- However, the MacPorts installation is partially broken and won't install new libraries. To fix this, reinstall MacPorts (available at http://www.macports.org/install.php). This won't remove or overwrite existing libraries.
- Do this after existing dev environment has been installed.
Oddities
- If vim is acting strangely, remove the MacPorts version--the built-in OS X version works much better. Do so by running
port uninstall vim
Build from scratch
Don't do this, it is many times more effort. If we somehow lose the dev environment image, here are partially correct instructions on how to rebuild from scratch: InstallingAboutUsOnOSXFromScratch.