V2 Deployment

V2Master

• Contents

  1. V2 Deployment
  2. Introduction
  3. Installation on V2 Server
     1. Environment
     2. Apache Configuration
     3. Procedure

Introduction

This pages describe how to install V2 and MAPS on public beta and production systems.

Installation on V2 Server

Environment

The V2 server is a virtual host on the zg-3.softxs.ch server.

The server has following software systems:

1. FreeBSD 9.0-RELEASE FreeBSD 9.0-RELEASE #0
2. Apache Server version: Apache/2.2.23 (FreeBSD)
3. Phusion Passenger apache module
4. Ruby: ruby 1.9.3p327 (2012-11-10 revision 37606) [amd64-freebsd9]
5. Rails 3.2.11
6. mysql Ver 14.14 Distrib 5.5.28, for FreeBSD9.0 (amd64) using 5.2
7. And many Gems

The installation location for Rails applications:

1. /v01/local/www/rails

For each application two items are required:

1. In the rails directory the following is required:
   1. A directory with the path {app}-app where the git repository is cloned
   2. A symbolic link {app} which points to the {app}-app/public directory

2. In /usr/local/etc/apache22/httpd.conf there must be a RackBaseUri defined. See below

Example directory structure for the V2pp and MAPS installations:

1. Note that the V2p0 and MAPS applications are currently configured for the development environment

   • $ cd /v01/local/www/rails
     $ ls -l
     lrwxr-xr-x   1 alan  www    16 Jan 24 13:00 maps -> maps-app/public
     drwxrwxr-x  13 root  www    21 Jan 24 13:00 maps-app
     lrwxr-xr-x   1 root  www    15 Jan 17 16:20 v2p0 -> v2p0-app/public
     drwxrwxrwx  15 alan  www    23 Jan 24 17:14 v2p0-app

Apache Configuration

The following is configured in usr/local/etc/apache22/httpd.conf

• ## ====== Rails ======
  
  LoadModule passenger_module /usr/local/lib/ruby/gems/1.9/gems/passenger-3.0.17/ext/apache2/mod_passenger.so
  PassengerRoot /usr/local/lib/ruby/gems/1.9/gems/passenger-3.0.17
  PassengerRuby /usr/local/bin/ruby19
  
  <VirtualHost *:80>
    DocumentRoot  /v01/local/www/rails
    ServerName    v2.softxs.ch
    <Directory /v01/local/www/rails>
      Allow from all
    </Directory>
  
    # -- v2p0 app
  
    RackBaseURI   /v2p0
    <Directory /v01/local/www/rails/v2p0>
      RailsEnv    development
      Options     -MultiViews
    </Directory>
  
    # -- maps app
  
    RackBaseURI   /maps
    <Directory /v01/local/www/rails/maps>
      RailsEnv    development
      Options     -MultiViews
    </Directory>
  
    # -- test0 app
  
    RackBaseURI   /test0
    <Directory /v01/local/www/rails/test0>
      RailsEnv    development
      Options     -MultiViews
    </Directory>
  
    # -- test1 app
  
    RackBaseURI   /test1
    <Directory /v01/local/www/rails/test1>
      RailsEnv    test
      Options     -MultiViews
    </Directory>
  </VirtualHost>

Procedure

1. Log into zg-3.softxs.ch
   1. You must be a member of group www
2. cd to the {app}-app dircetory
3. Git pull/fetch. Typically:

   • git pull origin master

4. Bundle install

   • bundle install

     Use 'sudu gem install' as necessary to install any missing Gems. Note that it appears that bundle install detects the presence of sudo and asks for a password for the bundle install if new gems must be installed. If any Gems are installed then you need to restart Apache:

     • cd /usr/local/etc/rc.d
       sudo ./apache22 restart

     Then check in /var/log/httpd-error.log to make sure there were no errors when Apache restarted.
5. Run rake tasks as necessary. The typical list of rake tasks is:

   • rake db:drop
     rake db:create
     rake db:migrate
     rake db:seed_fu
     rake db:populate

6. If you need to perform any tweaks in the database, use the following user/password to access the DB server:

   • mysql -uroot -psqladmin

7. Test the result. Links:

   1. MAPS http://v2.softxs.ch/maps

   2. V2p0 http://v2.softxs.ch/v2p0