Configuring For Apache

You will need to install mod_wsgi. Once you decided where shiftspace will live. You add something like the following to your Apache configuration file:

Details here soon

Make sure that you have all of the ShiftSpace dependencies installed.

Make sure that shiftspace/server/sessions has the proper permissions so that session data can be written to that directory. If you would like to sessions differently you’ll need to refer to the CherryPy sessions documentation.

chown -R www-data:www-data sessions

It’s important that couchdb-lucene be able to write to the directory where it keeps it indexes. The best thing to do is explicitly define the path where you want the index to live like so:

; CouchDB Configuration Settings                                                                                                                                                                          

; Custom settings should be made in this file. They will override settings                                                                                                                                
; in default.ini, but unlike changes made to default.ini, this file won't be                                                                                                                              
; overwritten on server upgrade.                                                                                                                                                                          

[couchdb]
;max_document_size = 4294967296 ; bytes                                                                                                                                                                   
os_process_timeout=60000 ; 60 seconds for couchdb-lucene                                                                                                                                                  

[httpd]
;port = 5984                                                                                                                                                                                              
;bind_address = 127.0.0.1                                                                                                                                                                                 

[log]
;level = debug                                                                                                                                                                                            

[update_notification]                                                                                                                                            
indexer=/path/to/java -Dcouchdb.lucene.dir=/path/to/indexes -jar /path/to/couchdb-lucene-0.4-jar-with-dependencies.jar -index

; To create an admin account uncomment the '[admins]' section below and add a                                                                                                                             
; line in the format 'username = password'. When you next start CouchDB, it                                                                                                                               
; will change the password to a hash (so that your passwords don't linger                                                                                                                                 
; around in plain-text files). You can add more admin accounts with more                                                                                                                                  
; 'username = password' lines. Don't forget to restart CouchDB after                                                                                                                                      
; changing this.                                                                                                                                                                                          
;[admins]                                                                                                                                                                                                 
;admin = mysecretpassword                                                                                                                                                                                 

[external]
; CHANGE THIS LINE, username should be set to your username                                                                                                                                               
fti=/path/to/java -Dcouchdb.lucene.dir=/path/to/indexes -jar /path/to/couchdb-lucene-0.4-jar-with-dependencies.jar -search

[httpd_db_handlers]
_fti={couch_httpd_external, handle_external_req, <<"fti">>}

And make sure couchdb can write to the indexes directory:

chown -R couchdb:couchdb /path/to/indexes
chmod -R 0770 /path/to/indexes