summaryrefslogtreecommitdiffstats
path: root/INSTALL.webfaction
diff options
context:
space:
mode:
authorEvgeny Fadeev <evgeny.fadeev@gmail.com>2010-04-10 11:29:55 -0400
committerEvgeny Fadeev <evgeny.fadeev@gmail.com>2010-04-10 11:29:55 -0400
commit6fd183a0e5ac47491ed7a8ffb2c36177575c9cc4 (patch)
tree7b8512ca3df149da221119e54fc60fe72fbebeca /INSTALL.webfaction
parent8822e0f2cf61d7f0564a67fcd0a1f435e8635603 (diff)
downloadaskbot-6fd183a0e5ac47491ed7a8ffb2c36177575c9cc4.tar.gz
askbot-6fd183a0e5ac47491ed7a8ffb2c36177575c9cc4.tar.bz2
askbot-6fd183a0e5ac47491ed7a8ffb2c36177575c9cc4.zip
fixed up INSTALL, settings_local.py.dist and replaced strings osqa->askbot everywhere, except main README file
Diffstat (limited to 'INSTALL.webfaction')
-rw-r--r--INSTALL.webfaction146
1 files changed, 73 insertions, 73 deletions
diff --git a/INSTALL.webfaction b/INSTALL.webfaction
index 401971a0..dc172e7b 100644
--- a/INSTALL.webfaction
+++ b/INSTALL.webfaction
@@ -1,28 +1,28 @@
-Detailed instructions for installing OSQA on WebFaction
+Detailed instructions for installing Askbot on WebFaction
Adapted from http://code.pinaxproject.com/wiki/DetailedPinaxWebfaction/
Please email turian at gmail with any updates or corrections.
-Installing OSQA on Webfaction
+Installing Askbot on Webfaction
------------------------------------
-Details the steps for setting up OSQA on a Webfaction shared-hosting
+Details the steps for setting up Askbot on a Webfaction shared-hosting
account, including email setup, using Apache2, mod_wsgi, psycopg2.
If you want to search-and-replace through this file, you will need to replace:
- osqa_server [name of Webfaction application, which will be in ~/webapps/]
- osqa_static [name of Webfaction application for static media serving]
- DOMAIN.com [domain name for OSQA site]
+ askbot_server [name of Webfaction application, which will be in ~/webapps/]
+ askbot_static [name of Webfaction application for static media serving]
+ DOMAIN.com [domain name for Askbot site]
PORT [port number assigned by WebFaction to your mod_wsgi application]
- SITENAME [name you give the OSQA site, which will contain the apache logs]
- MYOSQA [name of the OSQA project]
+ SITENAME [name you give the Askbot site, which will contain the apache logs]
+ myaskbot [name of the Askbot project]
MAILBOX_USERNAME [username you give the email address]
MAILBOX_PASSWORD [password that webfaction gives to this email username]
- OSQADATABASE_NAME [username you give the database]
- OSQADATABASE_PASSWORD [password that webfaction gives to this database]
- ~/envs/osqa [directory for the OSQA python environment, grep for 'env']
+ AskbotDATABASE_NAME [username you give the database]
+ AskbotDATABASE_PASSWORD [password that webfaction gives to this database]
+ ~/envs/askbot [directory for the Askbot python environment, grep for 'env']
USERNAME [your WebFaction username]
Some things I'm not sure about:
@@ -30,7 +30,7 @@ Some things I'm not sure about:
Here's what I don't know how to do:
* Set up a nginx server for static media.
* Configure sphinx search
- * Use PostgreSQL, not MySQL: http://osqa.net/question/13/can-i-use-osqa-with-postgresql
+ * Use PostgreSQL, not MySQL: http://askbot.net/question/13/can-i-use-askbot-with-postgresql
Webfaction Control Panel
@@ -46,7 +46,7 @@ for you, website/subdomain and associate the two for you.)
Let's call the domain DOMAIN.com.
Create a new Webfaction application with a "Type:" of "mod_wsgi
- 2.5/Python2.5", naming it "osqa_server". (These instructions
+ 2.5/Python2.5", naming it "askbot_server". (These instructions
might also work with mod_wsgi 2.0, if you like.)
https://panel.webfaction.com/app_/list
@@ -55,8 +55,8 @@ for you, website/subdomain and associate the two for you.)
it PORT.
Create a new Webfaction website which will associate the subdomain
- with the new osqa_server application. Give it name SITENAME, at least one
- domain, and set it to use the osqa_server application for the site's
+ with the new askbot_server application. Give it name SITENAME, at least one
+ domain, and set it to use the askbot_server application for the site's
root location, "/".
https://panel.webfaction.com/site/list
@@ -64,20 +64,20 @@ for you, website/subdomain and associate the two for you.)
You will need to create a database, typically one for each project
you create. Change the type to PostgreSql and modify the name (it
defaults to your webfaction account name) by adding an underscore
- and a project-specific identifier such as "_osqa". Before
+ and a project-specific identifier such as "_askbot". Before
leaving this section of the control panel, you may wish to change
the password.
https://panel.webfaction.com/database/create
- Call these OSQADATABASE_NAME and OSQADATABASE_PASSWORD.
+ Call these AskbotDATABASE_NAME and AskbotDATABASE_PASSWORD.
Save the database password for later.
[The following I haven't figured out yet]
You will probably want to add a static media server. This is a
Webfaction application. I created one of type "Static only (no
- .htaccess)" and with the name of "osqa_static".
+ .htaccess)" and with the name of "askbot_static".
https://panel.webfaction.com/app_/create
@@ -96,15 +96,15 @@ for you, website/subdomain and associate the two for you.)
https://panel.webfaction.com/email/list
-OSQA Software
+Askbot Software
--------------
Log onto webfaction and get the code. I use my fork because I have
a simple pip installation:
- git://github.com/turian/osqa.git
+ git://github.com/turian/askbot.git
In my situation, I keep source code in ~/utils/src, create
- virtual environments in ~/envs/osqa, and create Pinax projects in
- ~/webapps/osqa_server/projects.
+ virtual environments in ~/envs/askbot, and create Pinax projects in
+ ~/webapps/askbot_server/projects.
You will need pip + virtualenv installed:
@@ -112,15 +112,15 @@ OSQA Software
easy_install --prefix=~/utils/ virtualenv
cd ~/utils/src/
- git clone git://github.com/turian/osqa.git
- cd osqa
+ git clone git://github.com/turian/askbot.git
+ cd askbot
# We need python2.5 to be compatible with WSGI
- python2.5 ~/utils/bin/pip install -E ~/envs/osqa -r osqa-requirements.txt
- source ~/envs/osqa/bin/activate
+ python2.5 ~/utils/bin/pip install -E ~/envs/askbot -r askbot-requirements.txt
+ source ~/envs/askbot/bin/activate
# [Optional] If you want a MySQL database
- easy_install-2.5 --prefix ~/envs/osqa/ mysql-python
+ easy_install-2.5 --prefix ~/envs/askbot/ mysql-python
Additional Software
-------------------
@@ -147,39 +147,39 @@ Additional Software
Create a Project
----------------
- In Pinax, you clone a project from OSQA.
- However, OSQA we just copy it.
+ In Pinax, you clone a project from Askbot.
+ However, Askbot we just copy it.
- cd ~/webapps/osqa_server
+ cd ~/webapps/askbot_server
mkdir projects
cd projects
- cp -R ~/utils/src/osqa MYOSQA
- cd MYOSQA
- export OSQAPROJECT=`pwd`
+ cp -R ~/utils/src/askbot myaskbot
+ cd myaskbot
+ export AskbotPROJECT=`pwd`
- Make some directories, as described in the OSQA INSTALL file:
+ Make some directories, as described in the Askbot INSTALL file:
[okay I haven't actually done this yet]
-# mkdir -p $OSQASITE/upfiles/
-# mkdir -p $OSQALOG
-# sudo chown -R `whoami`:www-data $OSQASITE
-# sudo chown -R `whoami`:www-data $OSQALOG
-# chmod -R g+w $OSQASITE/upfiles
-# chmod -R g+w $OSQALOG
+# mkdir -p $AskbotSITE/upfiles/
+# mkdir -p $AskbotLOG
+# sudo chown -R `whoami`:www-data $AskbotSITE
+# sudo chown -R `whoami`:www-data $AskbotLOG
+# chmod -R g+w $AskbotSITE/upfiles
+# chmod -R g+w $AskbotLOG
Edit the settings files:
- cd $OSQAPROJECT
+ cd $AskbotPROJECT
cp settings_local.py.dist settings_local.py
vi settings_local.py settings.py
Pay attention to the following settings:
DATABASE_ENGINE = 'mysql'
- DATABASE_NAME = 'OSQADATABASE_NAME'
- DATABASE_USER = 'OSQADATABASE_NAME'
- DATABASE_PASSWORD = 'OSQADATABASE_PASSWORD'
+ DATABASE_NAME = 'AskbotDATABASE_NAME'
+ DATABASE_USER = 'AskbotDATABASE_NAME'
+ DATABASE_PASSWORD = 'AskbotDATABASE_PASSWORD'
EMAIL_HOST='smtp.webfaction.com'
EMAIL_HOST_USER='MAILBOX_USERNAME'
@@ -197,7 +197,7 @@ Create a Project
Create a directory for logs:
- cd $OSQAPROJECT
+ cd $AskbotPROJECT
mkdir log
Modify mail cron scripts "cron/send_email_alerts" as follows:
@@ -206,8 +206,8 @@ Create a Project
#!/bin/sh
- WORKON_HOME=~/envs/osqa
- PROJECT_ROOT=~/webapps/osqa_server/projects/MYOSQA/
+ WORKON_HOME=~/envs/askbot
+ PROJECT_ROOT=~/webapps/askbot_server/projects/myaskbot/
# activate virtual environment
. $WORKON_HOME/bin/activate
@@ -217,7 +217,7 @@ Create a Project
Use command "crontab -e" to add this script to your cron file, to run twice a day::
- 1 0,12 * * * ~/webapps/osqa_server/projects/MYOSQA/cron/send_email_alerts
+ 1 0,12 * * * ~/webapps/askbot_server/projects/myaskbot/cron/send_email_alerts
[Configure sphinx]
@@ -229,8 +229,8 @@ Create a Project
Build media directory links within the project and create symbolic
links on the static media server.
python manage.py build_media -all
- mkdir ~/webapps/OSQA_STATIC/MYOSQA
- ln -sd ~/webapps/osqa_server/projects/MYOSQA/site_media ~/webapps/OSQA_STATIC/MYOSQA/site_media
+ mkdir ~/webapps/Askbot_STATIC/myaskbot
+ ln -sd ~/webapps/askbot_server/projects/myaskbot/site_media ~/webapps/Askbot_STATIC/myaskbot/site_media
Set up the badges:
@@ -249,7 +249,7 @@ Create a Project
4. Use `crontab -e` to call `cron/multi_award_badges` maybe
four times an hour.
- 4,19,34,49 * * * * ~/webapps/osqa_server/projects/MYOSQA/cron/multi_award_badges
+ 4,19,34,49 * * * * ~/webapps/askbot_server/projects/myaskbot/cron/multi_award_badges
5. Repeat steps 1-4 for `cron/once_award_badges`.
@@ -257,10 +257,10 @@ Create a Project
Configure Apache2
----------------
- Edit ~/webapps/osqa_server/apache2/conf/httpd.conf as follows::
+ Edit ~/webapps/askbot_server/apache2/conf/httpd.conf as follows::
ServerAdmin "MAILBOX_USERNAME@DOMAIN.com"
- ServerRoot "/home/USERNAME/webapps/osqa_server/apache2"
+ ServerRoot "/home/USERNAME/webapps/askbot_server/apache2"
ServerName DOMAIN.com
LoadModule dir_module modules/mod_dir.so
@@ -274,42 +274,42 @@ Configure Apache2
KeepAlive Off
Listen PORT
LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
- CustomLog /home/USERNAME/logs/user/access_osqa_server_log combined
- ErrorLog /home/USERNAME/logs/user/error_osqa_server_log
+ CustomLog /home/USERNAME/logs/user/access_askbot_server_log combined
+ ErrorLog /home/USERNAME/logs/user/error_askbot_server_log
ServerLimit 2
#SetEnvIf X-Forwarded-SSL on HTTPS=1
- WSGIPythonPath /home/USERNAME/envs/osqa/lib/python2.5/site-packages/
- WSGIScriptAlias / /home/USERNAME/webapps/osqa_server/projects/MYOSQA/osqa.wsgi
+ WSGIPythonPath /home/USERNAME/envs/askbot/lib/python2.5/site-packages/
+ WSGIScriptAlias / /home/USERNAME/webapps/askbot_server/projects/myaskbot/askbot.wsgi
LoadModule alias_module modules/mod_alias.so
- WSGIDaemonProcess osqaWSGI user=USERNAME group=USERNAME threads=25 python-path=/home/USERNAME/envs/osqa/lib/python2.5/site-packages
- WSGIProcessGroup osqaWSGI
+ WSGIDaemonProcess askbotWSGI user=USERNAME group=USERNAME threads=25 python-path=/home/USERNAME/envs/askbot/lib/python2.5/site-packages
+ WSGIProcessGroup askbotWSGI
NameVirtualHost 127.0.0.1:PORT
- #ErrorLog "logs/MYOSQA_2009_05_06.log"
+ #ErrorLog "logs/myaskbot_2009_05_06.log"
SetHandler none
- #Alias /site_media /home/USERNAME/webapps/static/MYOSQA/site_media
+ #Alias /site_media /home/USERNAME/webapps/static/myaskbot/site_media
#force all content to be served as static files
#otherwise django will be crunching images through itself wasting time
- Alias /content/ /home/USERNAME/webapps/osqa_server/projects/MYOSQA/templates/content/
- Alias /forum/admin/media/ /home/turian/envs/osqa/lib/python2.5/site-packages/django/contrib/admin/media/
- #AliasMatch /([^/]*\.css) /home/USERNAME/webapps/osqa_server/projects/MYOSQA/templates/content/style/$1
- <Directory "/home/USERNAME/webapps/osqa_server/projects/MYOSQA/templates/content">
+ Alias /content/ /home/USERNAME/webapps/askbot_server/projects/myaskbot/templates/content/
+ Alias /forum/admin/media/ /home/turian/envs/askbot/lib/python2.5/site-packages/django/contrib/admin/media/
+ #AliasMatch /([^/]*\.css) /home/USERNAME/webapps/askbot_server/projects/myaskbot/templates/content/style/$1
+ <Directory "/home/USERNAME/webapps/askbot_server/projects/myaskbot/templates/content">
# Order deny,allow
# Allow from all
</Directory>
If you want virtual hosts of the admin interface under HTTPS, please
- look at OSQA's install file.
+ look at Askbot's install file.
- Create osqa.wsgi and edit it:
- cp osqa.wsgi.dist osqa.wsgi
+ Create askbot.wsgi and edit it:
+ cp askbot.wsgi.dist askbot.wsgi
- Edit ~/webapps/osqa_server/projects/MYOSQA/deploy/osqa.wsgi as follows::
+ Edit ~/webapps/askbot_server/projects/myaskbot/deploy/askbot.wsgi as follows::
import os
import sys
@@ -323,13 +323,13 @@ Configure Apache2
# add the virtual environment site-packages to the path
from site import addsitedir
- addsitedir('/home/USERNAME/envs/osqa/lib/python2.5/site-packages')
+ addsitedir('/home/USERNAME/envs/askbot/lib/python2.5/site-packages')
sys.path.insert(0, abspath(join(dirname(__file__), "../")))
sys.path.append(abspath(dirname(__file__)))
from django.conf import settings
- os.environ["DJANGO_SETTINGS_MODULE"] = "MYOSQA.settings"
+ os.environ["DJANGO_SETTINGS_MODULE"] = "myaskbot.settings"
#print sys.path
@@ -338,8 +338,8 @@ Configure Apache2
And then you're up and running with:
- ~/webapps/osqa_server/apache2/bin/stop
- ~/webapps/osqa_server/apache2/bin/start
+ ~/webapps/askbot_server/apache2/bin/stop
+ ~/webapps/askbot_server/apache2/bin/start
You should log in to the admin interface (http://DOMAIN.com/admin/),
and go to "Sites > Sites", and change the domain name that is used in