git clone https://@opensourceprojects.eu/git/p/osp/osp-allura osp-osp-allura



File Date Author Commit
Allura 2012-10-02 Dave Brondsema Dave Brondsema <Commit 3424db958d1959a0977db903720ca5018ead3ffa> [#5012] avoid mongo BSON encoding error, by ens...
AlluraTesting 2012-09-27 Cory Johns Cory Johns <Commit d3f57e9ad797059a2c54bbfad112479eda80a7d7> Fixed test failing from webtest upgrade
ForgeActivity 2012-08-14 Tim Van Steenburgh Tim Van Steenburgh <Commit 03e52e80d26aa57035bb579a946b3d0c7c32cb67> Merge branch '42cc_4189_new_dev' into dev
ForgeBlog 2012-10-02 Dave Brondsema Dave Brondsema <Commit 40777de32d2893eadbd157c4654ed36f7f8dab8e> [#5031] remove project_id from unique index; th...
ForgeChat 2012-09-10 Dave Brondsema Dave Brondsema <Commit 6cdc0f35f0ecdf3c8974de5b79ecb753f3022da1> [#4718] add main_menu implementations for Forge...
ForgeDiscussion 2012-09-28 Cory Johns Cory Johns <Commit 3b7ce7ed3103ecd6058bb062573b6c8a1441a28c> [#5015] Fixed issue with literal 'add_forum' in...
ForgeDownloads 2012-09-11 Dave Brondsema Dave Brondsema <Commit 8745481d741cdb2e27cd1c289b3967767410a455> [#4718] remove unused /downloads/nav.json (whic...
ForgeGit 2012-10-01 Cory Johns Cory Johns <Commit fffbaa7227a909dd3cf0be353413760a694bc7d7> [#5022] Tie in copy_hooks flag to install_app
ForgeHg 2012-10-01 Cory Johns Cory Johns <Commit fffbaa7227a909dd3cf0be353413760a694bc7d7> [#5022] Tie in copy_hooks flag to install_app
ForgeLink 2012-08-09 Hendrik Brummermann Hendrik Brummermann <Commit b6daea38823d052369a9e85134c404bcff696ed2> [#4654] adds support for suffixes to the link t...
ForgeSVN 2012-10-08 Cory Johns Cory Johns [0c25b5] [#5083] Fixed typo in SVN import
ForgeShortUrl 2012-10-02 Cory Johns Cory Johns <Commit e8469834c1ff8e917078d75993831cd27a3bfd67> [#4785] Fixed missed variable rename
ForgeTracker 2012-10-02 Dave Brondsema Dave Brondsema <Commit 62c872437b821d767efe152a4ae8aa2d07021771> [#4968] provide pluggable ticket import_id conv...
ForgeWiki 2012-09-12 Cory Johns Cory Johns <Commit 2b5c68c894541b7fcef58073ac541a5d1c51a365> [#4713] Added Thread.new() to prevent duplicate...
NoWarnings 2011-02-01 Wolf Wolf <Commit 23c644ff05fdc87e89b443afe1f6f9d25b4e2cff> License is Apache 2
fuse 2011-11-19 Rick Copeland Rick Copeland <Commit 943e3a7c9509d7bd85763e50be819ca9e0fd59a1> Fix FUSE filesystem to handle path correctly
scripts 2012-10-03 Dave Brondsema Dave Brondsema <Commit 78ab60f9a0d7251effc238b98dc110706876da8e> [#5023] add migration for new queue_empty field
solr_config 2010-03-23 Rick Copeland Rick Copeland <Commit 01d9bfb1ddef49835820f1d10b2414ba56703480> [#118] - Testing infrastructure upgrades
vagrant 2012-07-18 Tim Van Steenburgh Tim Van Steenburgh <Commit c0c52d558c403c21370cf72f917140e05eb94e08> Merge branch 'dev' of git://sfi-engr-scm-1/forg...
.gitattributes 2011-03-13 Wolf Wolf <Commit 4f057bfbac58f84bffea3fdfa9e562415a6bf359> make git-diff hunk headers python-aware
.gitignore 2012-06-22 Tim Van Steenburgh Tim Van Steenburgh <Commit 9d8474bbcea68af43f25a4c90fd87bfd7cc5594c> Merge branch 'dev' into tv/4142
.gitmodules 2009-12-01 Wolf Wolf <Commit e4830bd691eb52e6ae1e0921b09247bf4ec3aed5> Remove Ming submodule
CONTRIBUTING 2012-08-20 Dave Brondsema Dave Brondsema <Commit a3fa450f0a74519f793ce324b17b3f0dd737af80> update CONTRIBUTING doc to reflect current proc...
LICENSE 2011-02-01 Wolf Wolf <Commit 23c644ff05fdc87e89b443afe1f6f9d25b4e2cff> License is Apache 2
Makefile 2012-06-22 Tim Van Steenburgh Tim Van Steenburgh <Commit 9d8474bbcea68af43f25a4c90fd87bfd7cc5594c> Merge branch 'dev' into tv/4142
Makefile.def.buildbot 2012-06-22 Tim Van Steenburgh Tim Van Steenburgh <Commit 9d8474bbcea68af43f25a4c90fd87bfd7cc5594c> Merge branch 'dev' into tv/4142
README.markdown 2012-04-30 Dave Brondsema Dave Brondsema <Commit 3b4e131ab4096404f15302e9ec8f4bd072fc44e0> [#4140] update README scm dir to match dev.ini'...
coverage-report-all.sh 2011-01-27 Paul Sokolovsky Paul Sokolovsky <Commit 397c7248c20c9f4d79ed28b0c480ba1e0a891bf2> [#1237] Add script to produce combined coverage...
rebuild.bash 2012-07-18 Tim Van Steenburgh Tim Van Steenburgh <Commit c0c52d558c403c21370cf72f917140e05eb94e08> Merge branch 'dev' of git://sfi-engr-scm-1/forg...
requirements-common.txt 2012-10-01 Dave Brondsema Dave Brondsema <Commit fbf2b30979bab640cd4ec4934ee3ac056e01323c> [#5024] add a hint and limit to last_post query
requirements-optional.txt 2012-08-14 Tim Van Steenburgh Tim Van Steenburgh <Commit 03e52e80d26aa57035bb579a946b3d0c7c32cb67> Merge branch '42cc_4189_new_dev' into dev
requirements-sf.txt 2012-09-20 Dave Brondsema Dave Brondsema <Commit af0a1eab2afba8920780a1706ff46d74d660963d> [#4948] new html2text build that includes https...
requirements.txt 2012-10-02 Cory Johns Cory Johns <Commit d385e5632c915bbe512f5240ed12bbb223139444> [#4785] Remove unneeded requirements
run_clonedigger 2012-06-22 Tim Van Steenburgh Tim Van Steenburgh <Commit 9d8474bbcea68af43f25a4c90fd87bfd7cc5594c> Merge branch 'dev' into tv/4142
run_tests 2012-09-03 Yuriy Arhipov Yuriy Arhipov <Commit 31f5f3ff06c922c57a98b5b8f9a82437c25ece82> [#4637] ticket:146 Create URL shortener Allura App
update.sh 2012-07-13 Dave Brondsema Dave Brondsema <Commit 45b7b93f9b1dcaab922107ea2232fb730fdf03f2> [#4539] add script to get an environment up to ...

Read Me

Sandbox Creation

We'll use VirtualBox and Ubuntu 12.04 (11.10 works too) to create a disposable sandbox for Forge 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.

Forge Installation

Before we begin, you'll need the following additional packages in order to work with the Forge source code.

~$ sudo aptitude install git-core subversion python-svn

You'll also need additional development packages in order to compile some of the modules. Use google for additional PIL/jpeg help.

~$ sudo aptitude install 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

And finally our document-oriented database, MongoDB

~$ sudo aptitude install mongodb-server

If you are using a different base system, make sure you have Mongo 1.8 or better. If you need to upgrade, you can download the latest from http://www.mongodb.org/downloads

Setting up a virtual python environment

The first step to installing the Forge 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 Forge environment 'anvil'.

~$ virtualenv --system-site-packages anvil

This gives us a nice, clean environment into which we can install all the forge dependencies. (The site-packages flag is to include the python-svn package). In order to use the virtual environment, you'll need to activate it. You'll need to do this whenever you're working on the Forge codebase so you may want to consider adding it to your ~/.bashrc file.

~$ . anvil/bin/activate

Installing the Forge code and dependencies

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

(anvil)~$ mkdir src
(anvil)~$ cd src
(anvil)~/src$ git clone git://git.code.sf.net/p/allura/git.git forge

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 forge
(anvil)~/src/forge$ 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.

And now to setup each of the Forge applications for development. Because there are quite a few (at last count 15), we'll use a simple shell loop to set them up.

for APP in Allura* Forge* NoWarnings
do
    pushd $APP
    python setup.py develop
    popd
done

Hopefully everything completed without errors. We'll also need to create a place for Forge to store any SCM repositories that a project might create.

for SCM in git svn hg
do
    mkdir -p ~/var/scm/$SCM
    chmod 777 ~/var/scm/$SCM
    sudo ln -s ~/var/scm/$SCM /tmp
done

Initializing the environment

The 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 http://apache.mirrors.tds.net/lucene/solr/1.4.1/apache-solr-1.4.1.tgz
(anvil)~/src$ tar xf apache-solr-1.4.1.tgz
(anvil)~/src$ cd apache-solr-1.4.1/example/
(anvil)~/src/apache-solr-1.4.1/example/$ mkdir -p ~/src/forge/solr_config/conf
(anvil)~/src/apache-solr-1.4.1/example/$ cp solr/conf/solrconfig.xml ~/src/forge/solr_config/conf/
(anvil)~/src/apache-solr-1.4.1/example/$ nohup java -Dsolr.solr.home=$(cd;pwd)/src/forge/solr_config -jar start.jar > ~/logs/solr.log &

Forge task processing

Responds to asynchronous task requests.

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

TurboGears application server

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

(anvil)~/src/forge/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. It should complete in 5-6 minutes. Once this is done, you can start the application server.

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

Next Steps

Go to the server running on your local machine port 8080.
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