Installation

• [RECOMENDED] Install this web application in a python virtualenv.

  Install virtualenvwrapper:

  $ pip install virtualenvwrapper
  

  Follow this instructions to create a new environment and activate it.

• Install ubuntu dependencies:

  1. libxml2-dev libxslt1-dev (for feedparser)
  2. libqrencode-dev (for qrencoder)
  3. nodejs (for lessc)
  4. libjpeg libjpeg-dev libfreetype6 libfreetype6-dev zlib1g-dev (for PIL, crop images)
  5. uwsgi (o pip install) + libapache2-mod-uwsgi supervisor (for uwsgi)

• Download code:

  git clone gituser@portal.socib.es:repositories/seaboard
  

• Install python dependencies:

  (virtualenv_name) $ pip install -e requirements.txt
  

• Install lessc (via node package manager):

  npm install -g less
  

• [DEPRECATED] Configure new virtualhost in apache:

  <VirtualHost *:80>
  
          DocumentRoot "/var/www/seaboard"
  
          ServerName seaboardtest.socib.es
          ServerAlias *.seaboardtest.socib.es
  
          Alias /static/ /var/www/seaboard/static/
          AliasMatch ^/views/(.*).html /var/www/seaboard/static/widgets/$1/$1.html
  
          WSGIScriptAlias / /var/www/seaboard/seaboard/wsgi.py
          WSGIPythonPath /var/www/seaboard:PATH_TO_VIRTUAL_ENV/lib/python2.7/site-packages
  
          <Directory "/var/www/seaboard">
                  Options Indexes FollowSymLinks MultiViews
                  Allow from all
          </Directory>
  
          ErrorLog /var/log/apache2/seaboard.socib.es.error.log
          LogLevel info
  
          CustomLog /var/log/apache2/seaboard.socib.es.access.log combined
          ServerSignature On
  
  </VirtualHost>
  

• Configure seaboard with uwsgi:

  Note: can't install (or not easy) in Ubuntu 11.04. Try gunicorn
  
  1. Install uwsgi, libapache2-mod-uwsgi and supervisor
  
  2. Prepare uwsgi config folder. Create /etc/uwsgi/apps-enabled
  
  3. Prepare uwsgi log folder. Create /var/log/uwsgi and change owner to www-data
  
  4. Create a symbolic link to uwsgi.ini::
  
          ln -s /path/to/seaboard/seaboard/uwsgi.ini /etc/uwsgi/apps-enabled/seaboard.ini
  
  5. Configure supervisor in order to load uwsgi server with OS. File /etc/supervisor/conf.d/uwsgi.conf::
  
          [program:uwsgi-emperor]
          command=/usr/local/bin/uwsgi --emperor "/etc/uwsgi/apps-enabled/*.ini" --die-on-term --master --uid www-data --gid www-data --logto /var/log/uwsgi/emperor.log --emperor-stats 127.0.0.1:1716
          autostart=true
          autorestart=true
          redirect_stderr=true
  
  
  6. Modify virtualhost in apache::
  
          <VirtualHost *:80>
  
                  DocumentRoot "/var/www/seaboard"
  
                  ServerName seaboardtest.socib.es
                  ServerAlias *.seaboardtest.socib.es
  
                  <Location />
                      SetHandler uwsgi-handler
                      uWSGISocket 127.0.0.1:49152
                  </Location>
  
                  <Location /static>
                      SetHandler none
                  </Location>
  
                  <Location /views>
                      SetHandler none
                  </Location>
  
                  <Directory "/var/www/seaboard">
                  Options Indexes FollowSymLinks MultiViews
                  Allow from all
                  </Directory>
  
                  Alias /static/ /var/www/seaboard/static/
                  AliasMatch ^/views/(.*).html /var/www/seaboard/static/widgets/$1/$1.html
  
                  ErrorLog /var/log/apache2/seaboard.socib.es.error.log
                  LogLevel info
  
                  CustomLog /var/log/apache2/seaboard.socib.es.access.log combined
                  ServerSignature On
  
          </VirtualHost>
  

• Monitor uwsgi:

  1. Install uwsgitop::
  
          pip install uwsgitop
  
  2. Connect uwsgitop to uwsgi stats socket::
  
          - Emperor::
  
                  uwsgitop 127.0.0.1:1718
  
          - Seaboard::
  
                  uwsgitop 127.0.0.1:1717
  

• Configure seaboard with gunicorn:

  1. Install gunicorn::
  
          pip install gunicorn
  
  2. Install supervisor with apt-get or aptitude (before, aptitude install python-meld3 && pip install meld3==0.6.7)
  
  3. Prepare gunicorn log folder. Create /var/log/gunicorn and change owner to www-data
  
  4. Configure supervisor in order to load gunicorn servir with OS. File /etc/supervisor/conf.d/gunicorn-gisservices.conf::
  
          [program:gunicorn-gisservices]
          command=/path/to/virtualenv/bin/gunicorn -c /var/www/gisservices/gunicorn_conf.py seaboard.wsgi:application
          directory=/var/www/seaboard
          user=www-data
          autostart=true
          autorestart=true
          priority=991
          stopsignal=KILL
  
          stdout_logfile=/var/log/gunicorn/seaboard.log
          stdout_logfile_maxbytes=1MB
          stdout_logfile_backups=2
          stderr_logfile=/var/log/gunicorn/seaboard.error.log
          stderr_logfile_maxbytes=1MB
          stderr_logfile_backups=2
  
  5. Run supervisor (reload with new config):
          service supervisor stop
          unlink /var/run//supervisor.sock
          service supervisor start
  
  6. Enable proxy_http module in apache2::
  
          a2enmod proxy_http
  
  7. Modify virtualhost in apache::
  
          <VirtualHost *:80>
  
                  DocumentRoot "/var/www/seaboard"
  
                  ServerName seaboardtest.socib.es
                  ServerAlias *.seaboardtest.socib.es
  
                  ProxyPreserveHost On
                  <Proxy *>
                      Order deny,allow
                      Allow from all
                  </Proxy>
  
                  # Serve static
                  ProxyPass /favicon.ico !
                  ProxyPass /static/ !
                  ProxyPass /views/ !
  
                  # proxy a la resta
                  ProxyPass / http://localhost:49153/
                  ProxyPassReverse / http://localhost:49153/
  
                  Alias /static/ /var/www/seaboard/static/
                  AliasMatch ^/views/(.*).html /var/www/seaboard/static/widgets/$1/$1.html
  
                  <Directory "/var/www/seaboard">
                  Options Indexes FollowSymLinks MultiViews
                  Allow from all
                  </Directory>
  
                  ErrorLog /var/log/apache2/seaboard.socib.es.error.log
                  LogLevel info
  
                  CustomLog /var/log/apache2/seaboard.socib.es.access.log combined
                  ServerSignature On
  
          </VirtualHost>
  

• Gunicorn notes:

  1. Show gunicorn processes::
  
          ps aux | grep gunicorn
  
  2. Reload gunicorn processes::
  
          supervisorctl pid gunicorn-seaboard | xargs kill -HUP
  
          Or::
  
          supervisorctl restart gunicorn-seaboard
  

• Gstats (gunicorn stats):

  1. Install packages:
  
          pip install gstats
          pip install pyzmq
          pip install setproctitle (optional)
  
  2. Modify gunicorn_conf.py (with pre_request and post_request)
  
  3. Init collector::
  
          gstats-collectd -s tcp://127.0.0.2:2345
  
  3. Show stats::
  
          gstatsctl -c tcp://127.0.0.1:2345 stats