Инсталација пакета

TIP

Да ли сте преуморни од комплексних поставки, подешавања, резервних копија и ажурирања? Дозволите нам да вам помогнемо око тога! 🚀

Најлакши и најчешће најјефтинији начин да имплементирате Zаmmad је наш сервис у облаку. Уверите се преко бесплатне пробне инстанце!

Подржани оперативни системи

За инсталацију пакета, подржане су следеће дистрибуције Linux платформе:

Дистрибуција	Верзија
CentOS/RHEL	8 и 9
Debian	11 и 12
OpenSUSE/SLES	Leap 15.x / 15
Ubuntu	20.04, 22.04, 24.04

Уколико ваша дистрибуција тренутно није подржана, пробајте други метод инсталације или размотрите претплату на Zammad сервис у облаку.

Да бисте пратили кораке инсталације испод, потребни су алати као што су цурл, гнупг и други. Ако их нема на вашем систему, инсталирајте их:

sudo apt install curl apt-transport-https gnupg

Основе

Обезбедите исправан locale

Излистајте ваша тренутна locale подешавања:

locale | grep "LANG="

Уколико горња команда не врати <lang_code>.utf8, ово можете исправити на следећи начин:

sudo apt install locales

sudo locale-gen en_US.UTF-8

echo "LANG=en_US.UTF-8" > sudo /etc/default/locale

Након промене, обавезно поново излистајте подешавање и проверите да ли враћа <lang_code>.utf8. Уколико буде неуспешно, рестартовање може помоћи.

Elasticsearch инсталација

Препоручени метод је да користите званичан Elastic водич за инсталацију Elasticsearch.

Алтернативно, можете погледати наш пример за Elasticsearch 7, који се налази на посебној страници да би упутство остало што прегледније.

Додајте Zammad репозиториј

INFO

Packager.io можда није доступан из окружења са искључиво IPv6 адресама, тако да имајте ово на уму приликом извршавања корака испод.

Инсталирајте кључ репозиторија:

curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | \
gpg --dearmor | sudo tee /etc/apt/keyrings/pkgr-zammad.gpg> /dev/null

Ubuntu 20.04

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 20.04 main"| \
   sudo tee /etc/apt/sources.list.d/zammad.list > /dev/null

Ubuntu 22.04

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 22.04 main"| \
   sudo tee /etc/apt/sources.list.d/zammad.list > /dev/null

Ubuntu 24.04

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 24.04 main"| \
   sudo tee /etc/apt/sources.list.d/zammad.list > /dev/null

Инсталација Zammad-а

sudo apt update

sudo apt install zammad

Управљање Zammad сервисима

Zammad користи три сервиса. Они могу бити (ре)стартовани и стопирани за основним zammad процесом:

• заммад: укључује следеће сервисе
  • Само интерни puma сервис (одговоран за приказ веб апликације):
  • Само позадински процес - одговоран за извршавање свих одложених и задатке у позадини:
  • Само websocker сервис за информације о сесији:

Управљајте сервисима командама start, restart, stop, status програма systemctl.

Пример за покретање Zammad-а са свим под-сервисима:

systemctl старт заммад

Да бисте зауставили или поново покренули сервис или проверили његов статус, прилагодите команду како је наведено горе.

Следећи кораци

• Повежите Zammad са Elasticsearch (основни водич)
• Подесите ваша SELinux правила и firewall (основни водич)
• Подесите веб сервис (основни водич)

Предуслови

Под претпоставком да систем није прилагођен, следећи предуслови ће бити аутоматски инсталирати приликом инсталације Zammad пакета. Додатно, испод можете пронаћи неке информације о Elasicsearch, који неће бити аутоматски инсталиран.

• imlib2
• Node.js
• PostgreSQL
• Nginx
• Redis

Сервис базе података

Zammad чува свој садржај у бази података. Подржани систем база података је PostgreSQL 15 или новији. Ако PostgreSQL сервер није детектован, биће аутоматски инсталиран током инсталације пакета.

WARNING

Уколико користите софтвер за организацију конекција на базу података као што је PgBouncer, обратите пажњу да користите начин организације који је потпуно подржан у оквиру PostgreSQL. Обично је под називом „session connection pooling”. Начин организација на основу трансакција није подржан и може довести до грешака приликом миграције базе података.

Прокси приступа

Следеће опције проксија приступа су подржане:

• Nginx
• Apache

Скрипт за инсталацију покушава да детектује Apache или Nginx током инсталације. У случају да ниједан није пронађен, Nginx се аутоматски инсталира. Основан пример можете наћи у нашем водичу за конфигурацију web сервера.

Redis

За комуникацију у реалном времену преко web сокета потребан је Redis. Zammad захтева Redis 7 или новији. Аутоматски се инсталира (пакет) или је укључен у стацк-у (Docker Compose) са радном конфигурацијом. Међутим, инсталација и конфигурација су изван опсега ове документације. Пратите званичне водиче и осигурајте да га поставите на сигуран начин.

Доступне променљиве окружења за стандардна и Sentinel подешавања су кратко поменуте на страници Redis Варијабле.

INFO

CentOS и RHEL 10 користе Valkey као замену за Redis. Током инсталације Zammad-а на тим дистрибуцијама, аутоматски се инсталира као зависност.

Elasticsearch opciono toplo preporučeno

Elasticsearch се не инсталира аутоматски. Пошто је кључан за исправно подешавање Zammad-а, укључен је у горе наведена упутства за инсталацију. Ако желите да повежете Zammad са већ постојећом Elasticsearch инстанцом, проверите да ли користите подржану верзију и погледајте наш пример конфигурације.

Подржане Elasticsearch верзије су 8.11 - 9.x.

Први кораци са Zammad-ом

Details

Zammad	Elasticsearch
7.2+	>= 8.11, <10
7.0-7.1	>= 7.8, <10
5.2-6.5	>= 7.8, <9
5.0-5.1	>= 7.8, <8
4.0-4.1	>= 6.5, <=7.12
3.4-3.6	>= 5.5, <=7.9
3.3	>= 2.4, <=7.6
3.2	>= 2.4, <=7.5
3.1	>= 2.4, <=7.4
2.0-3.0	>= 2.4, <=5.6

Memcached

Zammad се у великој мери ослања на кеширање за побољшање перформанси. Овај кеш може бити сачуван у фајл систему без ослањања на екстерне сервисе. Међутим, ово је могуће само ако сви Zammad-ови сервиси раде на истом фајл систему!

У свим осталим случајевима попут деплоувања Zammad-а путем контејнера (Docker или Kubernetes) или на одвојеним чворовима кластера, потребан је Memcached сервис за чување кеша и ислуживање свим Zammad инстанцама. Docker и Kubernetes стацк-ови већ укључују овај сервис.

Међутим, чак и локалне инсталације на фајл систему могу имати користи од Memcached-ових побољшања перформанси. Такође бисте могли погледати нашу секцију подешавање перформанси.

Инсталација и конфигурација су изван опсега ове документације. У случају да морате ручно инсталирати Memcached, пратите званичну документацију Memcached-а.

GnuPG opciono

Ако желите да користите PGP интеграцију за слање и примање потписаних и шифрованих емаилова, морате инсталирати GnuPG-алат. Погледајте званичну GnuPG веб страницу.