|
|
| (15 intermediate revisions by 6 users not shown) |
| Line 1: |
Line 1: |
| | Come join the collective! Bots for new platforms or adding bots for for existing platforms will increase the build capabilities available, and are therefore much appreciated. | | Come join the collective! Bots for new platforms or adding bots for for existing platforms will increase the build capabilities available, and are therefore much appreciated. |
| | | | |
| − | What you need is a reasonably fast machine, with decent RAM and disk, and of course an Internet connection. It might be easier to first set up the openoffice build environment on this machine. | + | What you need is a reasonably fast machine, with decent RAM and disk, and of course a stable internet connection. It might be easier to first set up the openoffice build environment on this machine. |
| | | | |
| − | | + | Please see http://code.google.com/p/ootermite/wiki/AddNewBuildBot for more information. |
| − | | + | [[Category:Build_System]] |
| − | == Buildbot Requirements ==
| |
| − | The Buildbot requires:
| |
| − | * Python 2.3 or later: http://www.python.org
| |
| − | * Twisted: http://twistedmatrix.com - most recent version is recommended. You'll need at least "Twisted" (the core package), and you'll also want TwistedMail, TwistedWeb, and TwistedWords.
| |
| − | ** Note: For Twisted, you first need to install Zope.
| |
| − | | |
| − | == Getting the OpenOffice Buildbot ==
| |
| − | The Buildbot has been customized for Openoffice.org builds. Please checkout buildbot-0.7.3 from [http://cvs.gnome.org/viewcvs/ooo-build/scratch/buildbot/ Gnome CVS].
| |
| − | <pre>
| |
| − | cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login
| |
| − | no password
| |
| − | cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co ooo-build/scratch/buildbot/buildbot-0.7.3
| |
| − | </pre>
| |
| − | | |
| − | == Installing the Buildbot ==
| |
| − | * Note:
| |
| − | ** Detailed instuctions are at http://buildbot.sourceforge.net/manual-0.7.3.html#Requirements
| |
| − | ** The install may need to be to run as root (su).
| |
| − | After all requirements are met, install buildbot by running following commands in buildbot directory.
| |
| − | <pre>
| |
| − | python setup.py build
| |
| − | python setup.py install
| |
| − | </pre>
| |
| − | Test installation is proper by running the command
| |
| − | <pre>"buildbot --version"</pre>
| |
| − | * Install is OK if you see the version information for Buildbot and Twisted.
| |
| − | * Errors such as 'no such command' or "ImportError" means something went wrong.
| |
| − | * Note: For more detailed instuctions see http://buildbot.sourceforge.net/manual-0.7.3.html#Installing-the-code
| |
| − | | |
| − | == Setting up the Buildbot ==
| |
| − | # Make a buildbot directory on the machine at an appropriate place.
| |
| − | ** The full path name for this directory is hereinafter referred to as ''slavedir''.
| |
| − | <pre>mkdir buildbot_ooo</pre>
| |
| − | # Run the buildbot command to create a build slave:
| |
| − | <pre>
| |
| − | buildbot slave ''slavedir'' ''MASTERHOST'':''PORT'' ''SLAVENAME'' ''PASSWORD''
| |
| − | </pre>
| |
| − | #* where
| |
| − | *** MASTERHOST = ooo-staging.osuosl.org and PORT = 9989
| |
| − | *** Choose a ''SLAVENAME'' and ''PASSWORD'' and report them to botmaster administrator
| |
| − | *** For more detailed instuctions see http://buildbot.sourceforge.net/manual-0.7.3.html#Creating-a-buildslave
| |
| − | *** For additional creation options see http://buildbot.sourceforge.net/manual-0.7.3.html#Buildslave-Options
| |
| − | # Fill in the hostinfo files
| |
| − | #* ''slavedir''/info/admin should contain your name and email address. This is the '''buildslave admin address'''
| |
| − | #* ''slavedir''/info/host should be filled with a brief description of the host. For example: OS, version, memory size, CPU speed, versions of relevant libraries installed, and finally the version of the buildbot code which is running on the machine.
| |
| − | # Checkout some OO build specific scripts from http://cvs.gnome.org/viewcvs/ooo-build/scratch/buildbot/slave/
| |
| − | <pre>
| |
| − | cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome login
| |
| − | no password
| |
| − | cvs -z3 -d :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co ooo-build/scratch/buildbot/slave
| |
| − | </pre>
| |
| − | #* copy these files to ''slavedir''
| |
| − | #* buildbotget.pl - perl script for checking out OO source code from CVS
| |
| − | #* buildoo - script to start OO build process. Note: You need to properly edit this file to meet your plateform requirement.
| |
| − | #* smoketestoo - script to start OO smoke test after successful compliation. Note: You need to properly edit this file to meet your plateform requirement.
| |
| − | | |
| − | == Email botmaster admin ==
| |
| − | # Once all the above steps are done, You need to email buildmaster administrator with the following information.
| |
| − | ** ''SLAVENAME'' & ''PASSWORD'' : This is the same that you used while creating buildslave.
| |
| − | ** ''slavedir'' (full path) e.g. /home/bbot/buildslave_ooostaging
| |
| − | ** The configure command you are using for configuring OO on this build platform. e.g. ./configure --with-system-freetype
| |
| − | # Once buildmaster administrator receives this above information, he will add your buildslave to buildfarm and then your slave will become OOBuildSlave and will be listed on buildmaster status page [http://ooo-staging.osuosl.org:8010]
| |
