Tree [956b6c] allura_20130530 /
History



File Date Author Commit
Allura 2013-05-29 Cory Johns Cory Johns [956b6c] [#4994] Fixed race condition when posting notif...
AlluraTesting 2013-05-13 Dave Brondsema Dave Brondsema [ac7e00] be more flexible in mimetypes during test valid...
ForgeActivity 2013-04-18 Peter Hartmann Peter Hartmann [6f8012] Override newline after license header in jinja2...
ForgeBlog 2013-04-30 Tim Van Steenburgh Tim Van Steenburgh [d34331] [#6172] Rename new Feed object to FeedArgs
ForgeChat 2013-05-17 Cory Johns Cory Johns [e34ca4] [#6226] Added missing indexes for project_id fo...
ForgeDiscussion 2013-05-23 Dave Brondsema Dave Brondsema [6702bc] add license to new files, ignore some generated...
ForgeGit 2013-05-23 Tim Van Steenburgh Tim Van Steenburgh [62a27c] [#6125] Remove 'committed' from email subject
ForgeLink 2013-04-30 Tim Van Steenburgh Tim Van Steenburgh [724493] [#6172] Remove default TG file extension handling.
ForgeSVN 2013-05-23 Tim Van Steenburgh Tim Van Steenburgh [62a27c] [#6125] Remove 'committed' from email subject
ForgeShortUrl 2013-04-24 Dave Brondsema Dave Brondsema [d958fa] [#2835] show search help on all search pages
ForgeTracker 2013-05-23 Igor Bondarenko Igor Bondarenko [82f675] [#5656] ticket:358 Respect new email monitoring...
ForgeUserStats 2013-05-15 Dave Brondsema Dave Brondsema [983418] [#6212] use registration date (was stats start ...
ForgeWiki 2013-05-24 Igor Bondarenko Igor Bondarenko [067705] [#6267] ticket:360 A little more tests for wiki...
NoWarnings 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary
fuse 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary
scripts 2013-04-12 Peter Hartmann Peter Hartmann [647759] Add Apache Ant buildfile for use with Apache Rat
solr_config 2013-03-12 Igor Bondarenko Igor Bondarenko [5b2dfd] [#2835] ticket:290 Make solr's `text` field stored
vagrant 2013-05-24 Tim Van Steenburgh Tim Van Steenburgh [e375ef] Fix venv permissions problem
.gitattributes 2011-03-13 Wolf Wolf [4f057b] make git-diff hunk headers python-aware
.gitignore 2013-01-22 Tim Van Steenburgh Tim Van Steenburgh [d8a364] Update .gitignore with new ini file for forced ...
.gitmodules 2009-12-01 Wolf Wolf [e4830b] Remove Ming submodule
CONTRIBUTING 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary
LICENSE 2011-02-01 Wolf Wolf [23c644] License is Apache 2
Makefile 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary
Makefile.def.buildbot 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary
NOTICE 2013-04-18 Peter Hartmann Peter Hartmann [ee4602] [#4648] Add NOTICE file in top directory
README.markdown 2013-05-15 Dave Brondsema Dave Brondsema [78e97a] use correct comment syntax in README.markdown
coverage-report-all.sh 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary
rat-excludes.txt 2013-05-23 Dave Brondsema Dave Brondsema [53d8b0] ignore two MIT-licensed JS libraries
rebuild-all.bash 2013-04-15 Peter Hartmann Peter Hartmann [c17704] [#4648] Add missing license headers
requirements-common.txt 2013-05-23 Tim Van Steenburgh Tim Van Steenburgh [5f7d38] Merge branch 'master' of https://git-wip-us.apa...
requirements-optional.txt 2013-05-23 Dave Brondsema Dave Brondsema [d41220] match PyMollom to capitalization used on pypi
requirements-sf.txt 2013-05-23 Dave Brondsema Dave Brondsema [d41220] match PyMollom to capitalization used on pypi
requirements.txt 2013-04-24 Cory Johns Cory Johns [022d84] [#6093] Moved WebError requirement so it's not ...
run_clonedigger 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary
run_tests 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary
update.sh 2013-04-12 Peter Hartmann Peter Hartmann [ddf08c] Apply Apache License 2.0 header where necessary

Read Me

Sandbox Creation

We'll use VirtualBox and Ubuntu 12.04 (11.10 works too) to create a disposable sandbox for Allura development/testing.

  • Download and install VirtualBox for your platform.

  • Download a minimal Ubuntu 12.04 64-bit ISO.

  • Create a new virtual machine in Virtual Box, selecting Ubuntu (64 bit) as the OS type. The rest of the wizards' defaults are fine.

  • When you launch the virtual machine for the first time, you will be prompted to attach your installation media. Browse to the mini.iso that you downloaded earlier.

  • After a text-only installation, you may end up with a blank screen and blinking cursor. Press Alt-F1 to switch to the first console.

  • Consult available documentation for help installing Ubuntu.

Installation

Before we begin, you'll need to install some system packages. Use google if you need additional PIL/jpeg help.

~$ sudo aptitude install git-core default-jre-headless python-dev libssl-dev libldap2-dev libsasl2-dev libjpeg8-dev zlib1g-dev
~$ sudo ln -s /usr/lib/x86_64-linux-gnu/libz.so /usr/lib
~$ sudo ln -s /usr/lib/x86_64-linux-gnu/libjpeg.so /usr/lib

To install MongoDB 2.2.3, follow the instructions here:

http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/

Optional, for SVN support:

~$ sudo aptitude install subversion python-svn

Setting up a virtual python environment

The first step to installing the Allura platform is installing a virtual environment via virtualenv. This helps keep our distribution python installation clean.

~$ sudo aptitude install python-pip
~$ sudo pip install virtualenv

Once you have virtualenv installed, you need to create a virtual environment. We'll call our Allura environment 'anvil'.

~$ virtualenv anvil

This gives us a nice, clean environment into which we can install all the allura dependencies.
In order to use the virtual environment, you'll need to activate it:

~$ . anvil/bin/activate

You'll need to do this whenever you're working on the Allura codebase so you may want to consider adding it to your ~/.bashrc file.

Installing the Allura code and dependencies

Now we can get down to actually getting the Allura code and dependencies downloaded and ready to go.

(anvil)~$ mkdir src
(anvil)~$ cd src
(anvil)~/src$ git clone https://git-wip-us.apache.org/repos/asf/incubator-allura.git allura

Although the application setup.py files define a number of dependencies, the requirements.txt files are currently the authoritative source, so we'll use those with pip to make sure the correct versions are installed.

(anvil)~/src$ cd allura
(anvil)~/src/allura$ pip install -r requirements.txt

This will take a while. If you get an error from pip, it is typically a temporary download error. Just run the command again and it will quickly pass through the packages it already downloaded and then continue.

Optional, for SVN support: symlink the system pysvn package into our virtual environment

(anvil)~/src/allura$ ln -s /usr/lib/python2.7/dist-packages/pysvn ~/anvil/lib/python2.7/site-packages/

And now to setup the Allura applications for development. If you want to setup all of them, run ./rebuild-all.bash
If you only want to use a few tools, run:

cd Allura
python setup.py develop
cd ../ForgeWiki   # required tool
python setup.py develop
# repeat for any other tools you want to use

Initializing the environment

The Allura forge consists of several components, all of which need to be running to have full functionality.

SOLR search and indexing server

We have a custom config ready for use.

(anvil)~$ cd ~/src
(anvil)~/src$ wget -nv http://archive.apache.org/dist/lucene/solr/4.2.1/solr-4.2.1.tgz
(anvil)~/src$ tar xf solr-4.2.1.tgz && rm -f solr-4.2.1.tgz
(anvil)~/src$ cp -f allura/solr_config/schema.xml solr-4.2.1/example/solr/collection1/conf

(anvil)~/src$ cd solr-4.2.1/example/
(anvil)~/src/apache-solr-1.4.1/example/$ mkdir ~/logs/
(anvil)~/src/apache-solr-1.4.1/example/$ nohup java -jar start.jar > ~/logs/solr.log &

Allura task processing

Allura uses a background task service called "taskd" to do async tasks like sending emails, and indexing data into solr, etc. Let's get it running

(anvil)~$ cd ~/src/allura/Allura
(anvil)~/src/allura/Allura$ nohup paster taskd development.ini > ~/logs/taskd.log &

The application server

In order to initialize the Allura database, you'll need to run the following:

(anvil)~/src/allura/Allura$ paster setup-app development.ini

This shouldn't take too long, but it will start the taskd server doing tons of stuff in the background. Once this is done, you can start the application server:

(anvil)~/src/allura/Allura$ nohup paster serve --reload development.ini > ~/logs/tg.log &

Next Steps

Go to the Allura webapp running on your local machine port 8080.
(If you're running this inside a VM, you'll probably have to configure the port forwarding settings)

You can log in with username admin1, test-user or root. They all have password "foo". (For more details
on the default data, see bootstrap.py)

There are a few default projects (like "test") and neighborhoods. Feel free to experiment with them. If you want to
register a new project in your own forge, visit /p/add_project

Extra