====== RUBY & ZAMMAD ======

Achtung: die Ubuntu Pakete sind veraltet, besser ist die Installation lokal pro User über rbenv. Die Anleitung für Zammad ist auch veraltet und stellenweise falsch, man muss also mischen.

===== Ruby Installation für einen User mit rbenv und ruby-build =====

[[https://www.digitalocean.com/community/tutorials/how-to-install-ruby-on-rails-with-rbenv-on-ubuntu-18-04|https://www.digitalocean.com/community/tutorials/how-to-install-ruby-on-rails-with-rbenv-on-ubuntu-18-04]]

[[https://gorails.com/setup/ubuntu/18.04#ruby-rbenv|https://gorails.com/setup/ubuntu/18.04#ruby-rbenv]]
<code>

cd
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"'>> ~/.bashrc
echo 'eval "$(rbenv init -)"'>> ~/.bashrc
exec $SHELL

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"'>> ~/.bashrc
exec $SHELL

</code>

Danach mit rbenv install -l die möglichen versionen anzeigen und mit rbenv install eine davon installieren.

''rbenv install 2.6.6 ''

''rbenv global 2.6.6. ''

''ruby -v''

Danach komtm der bundler

 ''gem install bundler''

===== ZAMMAD =====

Grundsätzliche Zammad Source Installation:

[[https://docs.zammad.org/en/latest/install/source.html|https://docs.zammad.org/en/latest/install/source.html]]

Zammad Installationspaket holen
<code>

sudo wget https://ftp.zammad.com/zammad-latest.tar.gz
$ sudo tar -xzf zammad-latest.tar.gz -C zammad

Falsche Permissions korrigieren

chown -R zammad:zammad zammad

</code>

==== Alles Weitere wird im User zammad erledigt ====

<code>
$ sudo su - zammad

</code>

==== rbenv Installationsumgebung für ruby ====

command prefixed

<code -pre>
git clone https://github.com/rbenv/rbenv.git ~/.rbenv

echo 'export PATH="$HOME/.rbenv/bin:$PATH"'>> ~/.bashrc
echo 'eval "$(rbenv init -)"'>> ~/.bashrc
source ~/.bashrc


</code>

==== ruby build plugin ====

command prefixed

<code -pre>
''git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build''
</code-pre>

==== Liste installierbarer Versionen ====

<code>
rbenv install -l

rbenv install 2.6.5


</code>

global setzen

<file>
rbenv global 2.6.5

</file>

verifizieren mit ruby -v. Dabei Versionskonflikt auflösen durch editieren von .ruby-version

<code>
zammad@develd:~$ ruby -v
rbenv: version `2.5.5' is not installed (set by /opt/zammad/.ruby-version)
zammad@develd:~$ ruby -v

nano .ruby-version

</code>

ggf. richtige Version installieren.

==== GEMS ====

<code>
echo "gem: --no-document"> ~/.gemrc

gem install bundler

</code>

check

<code>
zammad@develd:~$ gem env home
/opt/zammad/.rbenv/versions/2.5.8/lib/ruby/gems/2.5.0

</code>

Wechsel auf ZAMMAD Installation

<code>
gem install rake rails

</code>

Für mysql:

<code>


</code>

<code>
bundle install --without test development postgres

</code>

==== Datenbank konfigurieren ====

database.yml

<code>
#### mysql config #####

 adapter: mysql2
 username: zammad
 password: 4JrdEyqYzkLw7kqT

 # If the database server is not on localhost, you can set hostname and port:
 host: 10.10.10.16
 port: 3306

</code>

Datenbank erstellen

<code>
bundle exec rake db:create

</code>

Datenbank befüllen

<code>
bundle exec rake db:migrate

</code>

Wiederholte Installation wenn Ruby schon für den User installiert ist:

<code>
echo 'export PATH="$HOME/.rbenv/bin:$PATH"'>> ~/.bashrc
zammad@develd:~$ echo 'eval "$(rbenv init -)"'>> ~/.bashrc
zammad@develd:~$ source ~/.bashrc
zammad@develd:~$ type rbenv

</code>

<code>
zammad@develd:~$ bundle config set without 'test development postgres'

</code>

(ersetzt

<code>
bundle install --without
test development postgres

</code>

Datenbank neu anlegen

<code>
bundle exec rake db:create
zammad@host $ bundle exec rake db:migrate
zammad@host $ bundle exec rake db:seed

</code>

Danach precompile

<code>
bundle exec rake assets:precompile

</code>

==== Aktivierung per systemd ====

<code>
zammad@develd:~$ cd script/systemd/
zammad@develd:~/script/systemd$ ls
install-zammad-systemd-services.sh  zammad.env  zammad-rails.service  zammad-scheduler.service  zammad.service  zammad-websocket.service
zammad@develd:~/script/systemd$ sudo ./install-zammad-systemd-services.sh
[sudo] password for zammad:
zammad@develd:~/script/systemd$

</code>