Check the Installed Python Version
python --version
You should see the following output:
Python 2.7.3
Install Prerequisites
apt-get install python-setuptools python-pip python-virtualenv virtualenvwrapper
Install Prerequisites for Pyramid Speedups
apt-get install gcc cpp libc6-dev python2.7-dev
Install nginx
apt-get install nginx nginx-full nginx-common
Create a wwwuser that waitress (the web server) will run as
useradd wwwuser -d /home/wwwuser -k /etc/skel -m -s /bin/bash -U
Setup the Virtual Environment
mkdir -p /var/www/delixus.com
mkdir /var/www/environments
cd /var
chown -R wwwuser:wwwuser www
We are now going to change users to wwwuser user.
su - wwwuser
cd /var/www/environments
virtualenv env_delixus
Install Pyramid
You must perform the following steps as the wwwuser user.
cd /var/www/environments/env_delixus
source bin/activate
You should see the environment name as the prefix in the command prompt, such as:
(env_delixus)wwwuser@ws2:
easy_install Pyramid
pip install waitress
Checkout the Pyramid Project
cd /var/www/delixus.com
Change the SVN checkout command to something that matches your server. If you use git, then change appropriately.
svn checkout https://repo.company.com/source/delixus/tags/1.0 .
Install the delixus.com Pyramid project
cd /var/www/delixus.com/delixus
vi production.ini
Under [app:main], add a [server:main] configuration as follows:
# http://docs.pylonsproject.org/projects/waitress/en/latest/arguments.html
[server:main]
use = egg:waitress#main
host = 127.0.0.1
port = %(http_port)s
# default # of threads = 4
threads = 8
url_scheme = http
I don’t think you need to install the development version of the site, but it seems to be the only way that I get everything to work while debugging…go figure.
python setup.py develop
pserve development.ini
Then open the site in a text-based web browser.
links http://localhost:6543
You should be able to view your site at this point.
Now, let’s install the production version of the site.
python setup.py install
Start Waitress
First we’re going to start and test waitress, then we’ll start it as a deamon.
pserve production.ini http_port=5000
links http://localhost:5000
Again, you should be able to view your site.
pserve production.ini start --daemon --pid-file=/var/www/5000.pid \ --log-file=/var/www/5000.log --monitor-restart http_port=5000
pserve production.ini start --daemon --pid-file=/var/www/5001.pid \ --log-file=/var/www/5001.log --monitor-restart http_port=5001
Check the waitress process.
ps -ef | grep pserve
You should see the pserve process running.
Configure nginx as a Proxy for Waitress
The following steps must be performed as root.
cd /etc/nginx/sites-available
vi delixus
Paste the following into the delixus.conf file.
upstream delixus-site {
server 127.0.0.1:5000;
server 127.0.0.1:5001;
}
server {
listen 80;
server_name localhost www.delixus.com delixus.com;
access_log /var/log/nginx/delixus.com-access.log;
location / {
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 10m;
client_body_buffer_size 128k;
proxy_connect_timeout 60s;
proxy_send_timeout 90s;
proxy_read_timeout 90s;
proxy_buffering off;
proxy_temp_file_write_size 64k;
proxy_pass http://delixus-site;
proxy_redirect off;
}
location /static {
root /var/www/delixus.com/delixus/delixus;
expires 30d;
add_header Cache-Control public;
access_log off;
}
}
rm /etc/nginx/sites-enabled/default
ln -s /etc/nginx/sites-available/delixus /etc/nginx/sites-enabled/delixus
service nginx stop
service nginx start
A good next step at this point is to setup Supervisor to control pserve/waitress.
