• V2Deployment

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>
  
    # -- test0 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
4. Bundle install
   1. Use 'sudu gem install' as necessary to install any missing Gems
5. Run rake tasks as necessary
6. Perform any tweeks in the database as necessary. Use the following user/password to access the DB server
   1. mysql -uroot -psqladmin
7. Test the result

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

   2. Or open http://v2.softxs.ch/v2p0