tellform/docs/setup_sentry_server.md

Installing Sentry Server

Medforms is an opensource form builder that can create stunning forms from PDFs or from scratch

Before You Begin

Make sure you understand what sentry server does. You can view documentation for sentry server here. This document was written for a server running Ubuntu 14.04 LTS server (we used Azure).

Prerequisites

Make sure you have these installed:

• apt-get
• python2.7
• vim

Installation Steps

1. Add non-root user.

sudo adduser sentry
sudo adduser sentry sudo

2. Update all apt-get packages

sudo apt-get update
sudo apt-get dist-upgrade
sudo apt-get autoremove
sudo apt-get install libxml2-dev libxslt1-dev libffi-dev
sudo reboot

3. Install easy_install and pip

wget https://bootstrap.pypa.io/ez_setup.py -O - | sudo python
sudo easy_install pip

4. Install virtualenv and virtualenvwrapper

sudo pip install virtualenv

5. Install Sentry and Setup

# make server directory
mkdir ~/SentryServer; cd ~/SentryServer;
# make virtualenv
virtualenv ./
#activate virtualenv
source ./bin/activate

# install sentry and its postgresql dependencies
pip install -U sentry[postgres]

6. Install postgresql

# install postgres
sudo apt-get install postgresql postgresql-contrib libpq-dev

# install postgres adminpack
sudo -u postgres psql
CREATE EXTENSION "adminpack";
\q

7. Setup postgresql DB

# change postgres password & create database
sudo passwd postgres
sudo su - postgres
psql -d template1 -c "ALTER USER postgres WITH PASSWORD 'changeme';"
createdb sentry
createuser sentry_user --pwprompt
psql -d template1 -U postgres
GRANT ALL PRIVILEGES ON DATABASE sentry to sentry_user;
\q
exit

8. Setup Sentry Configuration

# initialize conf file
sentry init

#edit sentry configuration
vim ~/.sentry/sentry.conf.py

The following are the contents of my sentry.conf.py file (replace name, user and password with your that of your DB)

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'sentry',
        'USER': 'sentry_user',
        'PASSWORD': 'your_password',
        'HOST': 'localhost',
    }
}
# No trailing slash!
SENTRY_URL_PREFIX = 'http://sentry.example.com'

SENTRY_WEB_HOST = '0.0.0.0'
SENTRY_WEB_PORT = 9000
SENTRY_WEB_OPTIONS = {
    'workers': 3,  # the number of gunicorn workers
    'secure_scheme_headers': {'X-FORWARDED-PROTO': 'https'},  # detect HTTPS mode from X-Forwarded-Proto header
}

#CONFIGURE REDIS
SENTRY_REDIS_OPTIONS = {
    'hosts': {
        0: {
            'host': '127.0.0.1',
            'port': 6379,
            'timeout': 3,
            #'password': 'redis auth password'
        }
    }
}

#CONFIGURE OUTGOING MAIL
EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend' 
EMAIL_USE_TLS = True 
EMAIL_HOST = 'smtp.gmail.com' 
EMAIL_PORT = 587 
EMAIL_HOST_USER = 'your_gmail_username@gmail.com' 
EMAIL_HOST_PASSWORD = 'your_gmail_password' 
DEFAULT_FROM_EMAIL = 'testing@testing.com

9. Setup Database and Start Sentry

#install and run redis-server
wget http://download.redis.io/releases/redis-stable.tar.gz
tar xzf redis-stable.tar.gz
cd redis-stable
make
make test
sudo make install
cd utils
sudo ./install_server.sh

#Go back to app directory
cd ~/SentryServer
sudo service redis_6379 start

# set up databse
sentry upgrade

# let's try it out!
sentry start

10. Install nginx

# install nginx
sudo apt-get install nginx

# remove the default symbolic link
sudo rm /etc/nginx/sites-enabled/default

# create a new blank config, and make a symlink to it
sudo touch /etc/nginx/sites-available/sentry
cd /etc/nginx/sites-enabled
sudo ln -s ../sites-available/sentry

# edit the nginx configuration file
sudo vim /etc/nginx/sites-available/sentry

Here are the contents of my nginx file:

server {
    # listen on port 80
    listen 80;

    # for requests to these domains
    server_name yourdomain.com www.yourdomain.com;

    # keep logs in these files
    access_log /var/log/nginx/sentry.access.log;
    error_log /var/log/nginx/sentry.error.log;

    # You need this to allow users to upload large files
    # See http://wiki.nginx.org/HttpCoreModule#client_max_body_size
    # I'm not sure where it goes, so I put it in twice. It works.
    client_max_body_size 0;

    location / {
        proxy_pass http://localhost:9000;
        proxy_redirect off;

        proxy_read_timeout 5m;

        # make sure these HTTP headers are set properly
        proxy_set_header Host            $host;
        proxy_set_header X-Real-IP       $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

11. Start the worker processes

# restart nginx
sudo service nginx restart

#start sentry
sentry celery worker -B

12. Install and Configure supervisord

pip install supervisord
sudo echo_supervisord_conf > ~/SentryServer/etc/supervisord.conf

#Edit yuour supervisord Config
vim /etc/supervisord.conf

Configuration file should look like this

[program:sentry-web]
directory=~/SentryServer/
command=~/SentryServer/bin/sentry start
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=syslog
stderr_logfile=syslog

[program:sentry-worker]
directory=~/SentryServer/
command=~/SentryServer/bin/sentry celery worker -B
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=syslog
stderr_logfile=syslog

13. Run Server (with supervisord)

supervisord