ReferencePlatforms/Test/Mac

Talos on Mac

Important: Do _NOT_ upgrade past 10.4.8. hdiutil has a bug/feature in 10.4.9 and above that prevents Talos Buildbot's from working properly.

OS Setup

1. Change the resolution
   • System Preferences -> Displays
   • Select 1024x768
2. Turn off the screen saver
   • System Preferences -> Desktop & Screen Saver
   • Move 'Start screen saver' to 'Never'
3. Create a 'mozqa' account

niutil -create / /Users/mozqa
niutil -createprop / /Users/mozqa uid 503
niutil -createprop / /Users/mozqa gid 503
niutil -createprop / /Users/mozqa realname "Mozilla QA"
niutil -createprop / /Users/mozqa home "/Users/mozqa"
niutil -createprop / /Users/mozqa shell "/bin/bash"
niutil -createprop / /Users/mozqa passwd "*"
niutil -create / /Groups/mozqa
niutil -createprop / /Groups/mozqa gid 503
passwd mozqa

1. Enable VNC
   • System Preferences -> Sharing
   • Make sure 'Apple Remote Desktop' is checked.
   • Click 'Access Privileges'
   • Change the VNC password
2. Install the mozqa ssh key in ~/.ssh

XCode Installation

1. The next step is to retrieve the Mac reference platform packages from CVS:

export CVS_RSH=ssh
ocvs -d :ext:unittest@cvs.mozilla.org:/mofo co ref-platforms/mac

1. Install Xcode
   1. Mount the Xcode dmg
   2. Double click on XcodeTools.mpkg
   3. In the 'Installation Type' section choose 'Customize' and enable everything under 'Cross-Development'

Wget

curl ftp://ftp.gnu.org/pub/gnu/wget/wget-1.10.2.tar.gz > wget-1.10.2.tar.gz
tar -zvxf wget-1.10.2.tar.gz
cd wget-1.10.2
./configure --prefix=/usr
make
sudo make install

BuildBot Setup

Install Python 2.4.4

1. Download and install MacPython

wget http://www.pythonmac.org/packages/py24-fat/dmg/python-2.4.4-macosx2006-10-18.dmg
hdiutil attach python-2.4.4-macosx2006-10-18.dmg
cd /Volumes/Univeral\ MacPython\ 2.4.4
sudo installer -pkg MacPython.mpkg -target /
cd ..
hdiutil detach /Volumes/Univeral\ MacPython\ 2.4.4

• You must logout and log back in to make sure you are using the new version of Python.

Install Twisted and Zope-Interface

wget http://tmrc.mit.edu/mirror/twisted/Twisted/2.4/Twisted-2.4.0.tar.bz2
tar -jvxf Twisted-2.4.0.tar.bz2
cd Twisted-2.4.0
cd ZopeInterface-3.1.0c1
python setup.py build
sudo python setup.py install
cd ../TwistedCore-2.4.0/
python setup.py build
sudo python setup.py install
cd ..
python setup.py build
sudo python setup.py install
cd ..

Install BuildBot

ocvs -d:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot co -d buildbot mozilla/tools/buildbot
cd buildbot
python setup.py build
sudo python setup.py install
cd ..
rm -rf buildbot/

Talos Setup

Install PyYAML

wget http://pyyaml.org/download/pyyaml/PyYAML-3.05.tar.gz
tar -zvxf PyYAML-3.05.tar.gz
cd PyYAML-3.05
python setup.py build
sudo python setup.py install

Setting up a Talos Buildbot slave

How to setup a Buildbot Talos slave (replace the master.host, username, and password with the correct values)

cd ~
mkdir talos-slave
buildbot create-slave talos-slave master.host:9989 username password

You should then start the slave once to create the proper directory structure.

buildbot start talos-slave
buildbot stop talos-slave

When running Buildbot slaves on Mac you must start it from a Terminal window in VNC and leave that window open (even though it's a daemon process). hdiutil will throw errors if you do not.

Apache Setup

The DocumentRoot will be dependent on the builddir of your Buildbot slave. In this section that directory will be referred to as $BUILDDIR.

Pageset

You will need to install a pageset in /Users/mozqa/pages

The rest

• Create an empty directory so Apache doesn't complain:

cd ~/talos-slave/$BUILDDIR
mkdir talos

• Open up /etc/httpd/httpd.conf and change both references of "/Library/WebServer/Documents" to "/Users/mozqa/talos-slave/$BUILDDIR/talos".

Add an alias so Apache knows where the pageset is. Add this to your configuration file: Alias /page_load_test/pages /home/mozqa/pages

<Directory /home/mozqa/pages>
    Options Indexes
    Order allow,deny
    Allow from all
</Directory>

Restart apache with:

sudo apachectl restart

Updating Talos

Assuming your Buildbot master configuration is proper, Buildbot will automatically update Talos on every performance run. If the pageset is updated, you will need to refresh /home/mozqa/pages.