Difference between revisions of "InstallingAboutUsOnOSX"

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, /www/aboutus/www, and /www/aboutus/compostus edit the .git/config file and change the URL for the 'origin' remote to

git@github.com:AboutUs/compostus.git

• Run 'git pull' in each of the above directories:

• Clone electric_sheep into /www/aboutus/electric_sheep

  git clone <email>15bb9cd2f75f14e2b92c6ec81bd372cb</email>: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

• If you are asked for an SSL password when starting the dev server, try 'default'

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.