|
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 |
|