Skip to content

Latest commit

 

History

History
147 lines (114 loc) · 4.18 KB

README_Install_Ubuntu.md

File metadata and controls

147 lines (114 loc) · 4.18 KB

Installation on Ubuntu 12.04 Server

With Apache mod_proxy / MySQL

Prerequisits

  • apt-get install apt-get install curl git-core patch build-essential bison zlib1g-dev libssl-dev libxml2-dev libxml2-dev sqlite3 libsqlite3-dev autotools-dev libxslt1-dev libyaml-0-2 autoconf automake libreadline6-dev libyaml-dev libtool

Add User

  • useradd zammad -m -s /bin/bash
  • echo -e "export RAILS_ENV=development" >> /home/zammad/.bashrc
  • su zammad
  • cd ~

Install Ruby & Rails

  • curl -L https://get.rvm.io | bash -s stable
  • source /home/zammad/.rvm/scripts/rvm
  • echo "source /home/zammad/.rvm/scripts/rvm" >> /home/zammad/.bashrc
  • rvm install ruby
  • gem install rails therubyracer

Apache Config

  • vi /etc/apache2/sites-available/zammad
<VirtualHost *:80>
    ServerName zammad.example.com
    ServerAdmin [email protected]

    SuexecUserGroup "zammad" "zammad"

    ## don't loose time with IP address lookups
    HostnameLookups Off

    ## needed for named virtual hosts
    UseCanonicalName Off

    ## configures the footer on server-generated documents
    ServerSignature Off

    ProxyRequests Off
    ProxyPreserveHost On

    <Proxy *>
        Order deny,allow
        Allow from localhost
    </Proxy>

    ProxyPass /assets !
    ProxyPass /favicon.ico !
    ProxyPass /robots.txt !
    ProxyPass / http://localhost:3000/

    DocumentRoot "/var/www/zammad/public"

    <Directory />
        Options FollowSymLinks
        AllowOverride None
    </Directory>

    <Directory "/var/www/zammad/public">
        Options FollowSymLinks
        Order allow,deny
        Allow from all
    </Directory>

</VirtualHost>
  • rm /etc/apache2/sites-enabled/000-default
  • ln -s /etc/apache2/sites-available/zammad /etc/apache2/sites-enabled/zammad
  • ln -s /etc/apache2/mods-available/proxy.conf /etc/apache2/mods-enabled/proxy.conf
  • ln -s /etc/apache2/mods-available/proxy.load /etc/apache2/mods-enabled/proxy.load
  • ln -s /etc/apache2/mods-available/proxy_http.load /etc/apache2/mods-enabled/proxy_http.load
  • ln -s /etc/apache2/mods-available/suexec.load /etc/apache2/mods-enabled/suexec.load
  • service apache2 restart

Get Zammad

Edit Gemfile

  • vi Gemfile
    • uncomment
      • gem 'libv8', '~> 3.11.8'
      • gem 'execjs'
      • gem 'therubyracer'

Install zammad

  • bundle install
  • chown -R zammad:zammad /var/www/zammad

Create Database

  • mysql --defaults-file=/etc/mysql/debian.cnf -e "CREATE DATABASE zammad_prod DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci; CREATE USER 'zammad'@'localhost' IDENTIFIED BY 'some_pass'; GRANT ALL PRIVILEGES ON zammad_prod.* TO 'zammad'@'localhost'; FLUSH PRIVILEGES;"
  • vi config/database.yml
  • su zammad
  • cd ~
  • rake db:migrate
  • rake db:seed

Start Server

  • rake assets:precompile
  • puma -p 3000 # application web server
  • script/websocket-server.rb start # non blocking websocket server
  • script/scheduler.rb start # generate overviews on demand, just send changed data to browser

Testinstallation for Developers via RVM / SQLite

Prerequisits

  • apt-get install apt-get install curl git-core patch build-essential bison zlib1g-dev libssl-dev libxml2-dev libxml2-dev sqlite3 libsqlite3-dev autotools-dev libxslt1-dev libyaml-0-2 autoconf automake libreadline6-dev libyaml-dev libtool

Add User

  • useradd zammad -m -s /bin/bash
  • echo -e "export RAILS_ENV=development" >> /home/zammad/.bashrc
  • su zammad
  • cd ~

Install Ruby & Rails

  • curl -L https://get.rvm.io | bash -s stable
  • source /home/zammad/.rvm/scripts/rvm
  • echo "source /home/zammad/.rvm/scripts/rvm" >> /home/zammad/.bashrc
  • rvm install ruby
  • gem install rails therubyracer

Get Zammad

Edit Gemfile

  • vi Gemfile
    • uncomment
      • gem 'libv8', '~> 3.11.8'
      • gem 'execjs'
      • gem 'therubyracer'

Install zammad

  • bundle install
  • rake db:migrate
  • rake db:seed
  • rake assets:precompile
  • puma -p 3000 # application web server
  • script/websocket-server.rb start # non blocking websocket server
  • script/scheduler.rb start # generate overviews on demand, just send changed data to browser