Zammad

Diese Seite muss überarbeitet werden

Diese Seite wurde als Baustelle gekennzeichnet, weil sie überarbeitet werden muss. Eine Begründung dafür findest du auf der Diskussionsseite. Bitte hilf mit, diese Seite zu verbessern!

Installation

sollte nach einer Hostsharing-Variante der folgenden Beschreibung funktionieren:

• https://docs.zammad.org/en/latest/install/source.html

Installation ruby / ruby env

Prüfe die Version von ruby die zammad benötigt hier.

Für diese Anleitung nehmen wir Version 3.0.5 an für zammad 5.2+.

Die Installationsanleitung für rubyenv und ruby findet sich unter RubyRBEnv.

Verifiziere das die Installation geklappt hat mit

 ruby -v 

dies sollte der herausgesuchten Versionsnummer entsprechen

Installation nodejs

Prüfe die Version von nodejs die zammad benötigt hier.

Für diese Anleitung nehmen wir Version 16.0+ an für zammad 5.2+.

Verifiziere das die Installation geklappt hat mit

 node -v 

dies sollte der herausgesuchten Versionsnummer entsprechen

Installation von Zammad

 wget -O - https://ftp.zammad.com/zammad-latest.tar.gz |tar -xvvz
 cd zammad
 bundle config set --local without 'test development mysql'
 bundle install
 nano config/database.yml

Mit folgendem Inhalt:

 production:
   adapter: postgresql
   host: localhost
   database: xyz00_zammad
   pool: 50
   timeout: 5000
   encoding: utf8
   username: xyz00_zammad
   password: changeme

Der Datenbank user und die Tabelle müssen in HS Admin entsprechend angelegt werden und in der config datei die entsprechenden Namen und Passwörter erstetzt werden. YAML einrückung beachten!

  export RAILS_ENV=production
  rake db:migrate
  rake assets:precompile

Zammad ausliefern

Um via Browser auf zammad zugreifen zu können muss es via Phusion Passenger ausgeliefert werden. Dazu muss die .htaccess wie dort im wiki Artikel beschrieben gesetzt werden. Zusätzlich muss der zammad ordner noch in app-ssl gelinkt werden und der statische content in htdocs-ssl. Optional kann das Domain Template noch um die subdomains bereinigt werden (2. Befehl)

 cd ~/doms/zammad.example.org/
 rm -r subs*
 rm -r htdocs-ssl
 rm -r app-ssl
 ln -s ~/zammad app-ssl
 ln -s ~/zammad/public htdocs-ssl

Durch aufrufen der Domain im Browser sollte das restliche Web-basierte Setup ablaufen.

Zammad Upgrade

killall -u $USER
killall -u $USER 9

cp -a zammad zammad-old
cd zammad
wget -O - https://ftp.zammad.com/zammad-latest.tar.gz |tar -xvvz
bundle install --without test development mysql

	Geht nicht, Ruby 2.2.5 fehlt!

cd
rbenv install 2.5.5

	Geht nicht, Rbenv ist zu alt!

cd ~/.rbenv/plugins/ruby-build
git pull
cd
rbenv install 2.5.5
rbenv global 2.5.5
rbenv local 2.5.5

cd zammad
gem install bundle
gem install bundler
bundle install --without test development mysql

Geht nicht, Bundler 1.17.x wird gebraucht.

gem install bundler==1.17.3

	Geht auch nicht.
	Dann hacken wir das mal versuchsweise ins Lock.

vim Gemfile.lock

bundle install --without test development mysql

	Es fehlen Libs.
	HS bitte installieren...
	[...]
	Danke!

bundle install --without test development mysql
export RAILS_ENV=production
rake db:migrate
rake assets:precompile

/usr/bin/supervisord -c $HOME/supervisor/etc/supervisord.conf