Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Tree [3b7ce7] /
History



File Date Author Commit
Allura 2012-09-27 Cory Johns Cory Johns [9184c4] [#5015] Upgrade EasyWidgets and fix failing tests
AlluraTesting 2012-09-27 Cory Johns Cory Johns [d3f57e] Fixed test failing from webtest upgrade
ForgeActivity 2012-08-15 Cory Johns Cory Johns [5c439d] Merge branch '42cc_4500' of ssh://git.code.sf.n...
ForgeBlog 2012-09-10 Dave Brondsema Dave Brondsema [6cdc0f] [#4718] add main_menu implementations for Forge...
ForgeChat 2012-09-10 Dave Brondsema Dave Brondsema [6cdc0f] [#4718] add main_menu implementations for Forge...
ForgeDiscussion 2012-09-28 Cory Johns Cory Johns [3b7ce7] [#5015] Fixed issue with literal 'add_forum' in...
ForgeDownloads 2012-09-11 Dave Brondsema Dave Brondsema [874548] [#4718] remove unused /downloads/nav.json (whic...
ForgeGit 2012-09-27 Yuriy Arhipov Yuriy Arhipov [3d42e7] [#4938] ticket:177 added timezone test for Forg...
ForgeHg 2012-09-28 Dave Brondsema Dave Brondsema [43300c] [#4938] more precise test, so it won't fail whe...
ForgeLink 2012-08-09 Hendrik Brummermann Hendrik Brummermann [b6daea] [#4654] adds support for suffixes to the link t...
ForgeSVN 2012-09-25 Cory Johns Cory Johns [ef38eb] [#2809] Improved SVN clone hook handling and fi...
ForgeShortUrl 2012-09-27 Cory Johns Cory Johns [7bb1cd] [#4637] Added confirmation before removing shor...
ForgeTracker 2012-09-27 Anton Kasyanov Anton Kasyanov [ee5eb2] [#4530] ticket:179 transfer text from ticket co...
ForgeWiki 2012-09-30 Yuriy Arhipov Yuriy Arhipov [bd9063] [#4990] ticket:181 fixed count labels error, ad...
NoWarnings 2011-02-01 Wolf Wolf [23c644] License is Apache 2
fuse 2011-11-19 Rick Copeland Rick Copeland [943e3a] Fix FUSE filesystem to handle path correctly
scripts 2012-09-21 Cory Johns Cory Johns [6a72db] [#2809] Removed unneeded call to _setup_hooks i...
solr_config 2010-03-23 Rick Copeland Rick Copeland [01d9bf] [#118] - Testing infrastructure upgrades
vagrant 2012-07-18 Tim Van Steenburgh Tim Van Steenburgh [c0c52d] Merge branch 'dev' of git://sfi-engr-scm-1/forg...
.gitattributes 2011-03-13 Wolf Wolf [4f057b] make git-diff hunk headers python-aware
.gitignore 2012-06-05 Evgeniy Filatov Evgeniy Filatov [faee5c] ticket:67 added clonedigger reports to gitignore
.gitmodules 2009-12-01 Wolf Wolf [e4830b] Remove Ming submodule
CONTRIBUTING 2012-08-20 Dave Brondsema Dave Brondsema [a3fa45] update CONTRIBUTING doc to reflect current proc...
LICENSE 2011-02-01 Wolf Wolf [23c644] License is Apache 2
Makefile 2012-06-06 Yaroslav Luzin Yaroslav Luzin [7c3f95] ticket:67 Run clonedigger after tests
Makefile.def.buildbot 2012-06-06 Yaroslav Luzin Yaroslav Luzin [7c3f95] ticket:67 Run clonedigger after tests
README.markdown 2012-04-30 Dave Brondsema Dave Brondsema [4e302e] [#4140] update README scm dir to match dev.ini'...
coverage-report-all.sh 2011-01-27 Paul Sokolovsky Paul Sokolovsky [397c72] [#1237] Add script to produce combined coverage...
rebuild.bash 2012-07-18 Tim Van Steenburgh Tim Van Steenburgh [c0c52d] Merge branch 'dev' of git://sfi-engr-scm-1/forg...
requirements-common.txt 2012-09-27 Cory Johns Cory Johns [9184c4] [#5015] Upgrade EasyWidgets and fix failing tests
requirements-optional.txt 2012-08-15 Cory Johns Cory Johns [5c439d] Merge branch '42cc_4500' of ssh://git.code.sf.n...
requirements-sf.txt 2012-09-20 Dave Brondsema Dave Brondsema [af0a1e] [#4948] new html2text build that includes https...
requirements.txt 2012-09-07 Igor Bondarenko Igor Bondarenko [e95fcf] [#4785] ticket:163 add SQLAlchemy and MySQL-pyt...
run_clonedigger 2012-06-05 Evgeniy Filatov Evgeniy Filatov [65b0c9] ticket:67 excluded tests from clonedigger run
run_tests 2012-09-03 Yuriy Arhipov Yuriy Arhipov [31f5f3] [#4637] ticket:146 Create URL shortener Allura App
update.sh 2012-07-12 Dave Brondsema Dave Brondsema [45b7b9] [#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