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



File Date Author Commit
Allura 2012-10-11 Cory Johns Cory Johns [30c0f4] [#4942] Removed some more references to ForgeDo...
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-08 Dave Brondsema Dave Brondsema <Commit a0b3a366fc73b33ef76fbc375709cd37879dd6d2> [#5086] avoid errors on already orphaned BlogPo...
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...
ForgeGit 2012-10-16 Cory Johns Cory Johns <Commit 71eaa5319a74d2c617d10a8431c4941043e8958a> [#5094] Fixed issue with paging not being appli...
ForgeHg 2012-10-15 Cory Johns Cory Johns <Commit f88173a6f64f523cf5a83c9bab5fdf8528836ed1> [#5094] Removed use of CommitRun by SVN repos
ForgeLink 2012-08-09 Hendrik Brummermann Hendrik Brummermann <Commit b6daea38823d052369a9e85134c404bcff696ed2> [#4654] adds support for suffixes to the link t...
ForgeSVN 2012-10-16 Cory Johns Cory Johns <Commit 71eaa5319a74d2c617d10a8431c4941043e8958a> [#5094] Fixed issue with paging not being appli...
ForgeShortUrl 2012-10-02 Cory Johns Cory Johns <Commit e8469834c1ff8e917078d75993831cd27a3bfd67> [#4785] Fixed missed variable rename
ForgeTracker 2012-10-10 Igor Bondarenko Igor Bondarenko <Commit 3d9e0fccaac6d897d3de95d8624faa6b43fb81d8> [#5074] ticket:188 remove trailing spaces
ForgeWiki 2012-09-30 Yuriy Arhipov Yuriy Arhipov <Commit 9a021b4959e88ba494127bc738e0f3bba7a7f02e> [#4990] ticket:181 fixed count labels error, ad...
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-10-15 Cory Johns Cory Johns <Commit 19ecd406e897ba1758da9b9f53051391ac2915fa> [#5107] Changed jinja memcached config setting ...
requirements-sf.txt 2012-10-15 Dave Brondsema Dave Brondsema <Commit 0e48fcf1a55ec1319a74b2090eea8a340535f2bc> [#5017] remove pylibmc from requirements-sf.txt
requirements.txt 2012-10-02 Cory Johns Cory Johns <Commit d385e5632c915bbe512f5240ed12bbb223139444> [#4785] Remove unneeded requirements
run_clonedigger 2012-10-11 Cory Johns Cory Johns [30c0f4] [#4942] Removed some more references to ForgeDo...
run_tests 2012-10-11 Cory Johns Cory Johns [30c0f4] [#4942] Removed some more references to ForgeDo...
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