Switch to unified view

a/README.markdown b/README.markdown
...
...
36
    ~$ sudo aptitude install python-pip
36
    ~$ sudo aptitude install python-pip
37
    ~$ sudo pip install virtualenv
37
    ~$ sudo pip install virtualenv
38
38
39
Once you have virtualenv installed, you need to create a virtual environment.  We'll call our Allura environment 'anvil'.
39
Once you have virtualenv installed, you need to create a virtual environment.  We'll call our Allura environment 'anvil'.
40
40
41
    ~$ virtualenv --system-site-packages anvil
41
    ~$ virtualenv anvil
42
42
43
This gives us a nice, clean environment into which we can install all the allura dependencies.
43
This gives us a nice, clean environment into which we can install all the allura dependencies.
44
(The --system-site-packages flag is to include the python-svn package).  In order to use the virtual environment, you'll need to activate it:
44
(The --system-site-packages flag is to include the python-svn package).  In order to use the virtual environment, you'll need to activate it:
45
45
46
    ~$ . anvil/bin/activate
46
    ~$ . anvil/bin/activate
...
...
59
59
60
    (anvil)~/src$ cd allura
60
    (anvil)~/src$ cd allura
61
    (anvil)~/src/allura$ pip install -r requirements.txt
61
    (anvil)~/src/allura$ pip install -r requirements.txt
62
62
63
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.
63
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.
64
65
Optional, for SVN support: symlink the system pysvn package into our virtual environment
66
67
    (anvil)~/src/allura$ ln -s /usr/lib/python2.7/dist-packages/pysvn ~/anvil/lib/python2.7/site-packages/
64
68
65
And now to setup the Allura applications for development.  If you want to setup all of them, run `./rebuild-all.bash`
69
And now to setup the Allura applications for development.  If you want to setup all of them, run `./rebuild-all.bash`
66
If you only want to use a few tools, run:
70
If you only want to use a few tools, run:
67
71
68
    cd Allura
72
    cd Allura
...
...
83
    (anvil)~/src$ wget http://archive.apache.org/dist/lucene/solr/1.4.1/apache-solr-1.4.1.tgz
87
    (anvil)~/src$ wget http://archive.apache.org/dist/lucene/solr/1.4.1/apache-solr-1.4.1.tgz
84
    (anvil)~/src$ tar xf apache-solr-1.4.1.tgz
88
    (anvil)~/src$ tar xf apache-solr-1.4.1.tgz
85
    (anvil)~/src$ cd apache-solr-1.4.1/example/
89
    (anvil)~/src$ cd apache-solr-1.4.1/example/
86
    (anvil)~/src/apache-solr-1.4.1/example/$ mkdir -p ~/src/allura/solr_config/conf
90
    (anvil)~/src/apache-solr-1.4.1/example/$ mkdir -p ~/src/allura/solr_config/conf
87
    (anvil)~/src/apache-solr-1.4.1/example/$ cp solr/conf/solrconfig.xml ~/src/allura/solr_config/conf/
91
    (anvil)~/src/apache-solr-1.4.1/example/$ cp solr/conf/solrconfig.xml ~/src/allura/solr_config/conf/
92
    (anvil)~/src/apache-solr-1.4.1/example/$ mkdir ~/logs/
88
    (anvil)~/src/apache-solr-1.4.1/example/$ nohup java -Dsolr.solr.home=$(cd;pwd)/src/allura/solr_config -jar start.jar > ~/logs/solr.log &
93
    (anvil)~/src/apache-solr-1.4.1/example/$ nohup java -Dsolr.solr.home=$(cd;pwd)/src/allura/solr_config -jar start.jar > ~/logs/solr.log &
89
94
90
95
91
### Allura task processing
96
### Allura task processing
92
97
...
...
99
104
100
In order to initialize the Allura database, you'll need to run the following:
105
In order to initialize the Allura database, you'll need to run the following:
101
106
102
    (anvil)~/src/allura/Allura$ paster setup-app development.ini
107
    (anvil)~/src/allura/Allura$ paster setup-app development.ini
103
108
104
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:
109
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:
105
110
106
    (anvil)~/src/allura/Allura$ nohup paster serve --reload development.ini > ~/logs/tg.log &
111
    (anvil)~/src/allura/Allura$ nohup paster serve --reload development.ini > ~/logs/tg.log &
107
112
108
## Next Steps
113
## Next Steps
109
114