Zammad je vyvíjen v programovacích jazycích Ruby a JavaScript. Jméno Zammad pochází z bavorského dialektu a znamená „společně“.
Krok 1:Ujistěte se, že je váš operační systém aktualizován
Vždy je dobrou praxí zajistit, aby OS měl nejnovější balíčky. Pro aktualizaci použijte tento příkaz:
sudo apt update
sudo apt upgrade
Krok 2:Instalace závislostí balíčků
Dále nainstalujme některé závislosti. Aby budoucí kroky fungovaly, musí být v systému přítomny. Použijte tento příkaz:
sudo apt install wget curl apt-transport-https gnupg
Aby Zammad fungoval správně, váš systém musí používat správné jazykové prostředí.
sudo apt install locales
sudo locale-gen en_US.UTF-8
echo "LANG=en_US.UTF-8" | sudo tee /etc/default/locale
Krok 3:Nastavení elasticsearch
Zammad používá elasticsearch, jeho vyhledávací funkce je založena na Elasticsearch a vyžaduje plugin pro přílohu ingest.
Nainstalujme elasticsearch na server. Nejprve importujte klíč Elasticsearch PGP
Stáhněte a nainstalujte veřejný podpisový klíč pomocí tohoto příkazu:
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg
Poté nastavte úložiště:
echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-8.x.list
Balíček Elasticsearch můžete nainstalovat pomocí tohoto příkazu po aktualizaci repozitářů, protože jsme přidali nové repo:
sudo apt update && sudo apt install elasticsearch
Chcete-li nakonfigurovat, aby se Elasticsearch spustil automaticky při spuštění systému, spusťte následující příkazy:
sudo systemctl daemon-reload sudo systemctl enable elasticsearch
Elasticsearch lze spustit a zastavit následovně:
sudo systemctl start elasticsearch sudo systemctl stop elasticsearch
Ujistěte se, že je spuštěn pomocí příkazu status:
$ sudo systemctl status elasticsearch
● elasticsearch.service - Elasticsearch
Loaded: loaded (/lib/systemd/system/elasticsearch.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2022-03-18 11:06:37 UTC; 3min 3s ago
Docs: https://www.elastic.co
Main PID: 2045 (java)
Tasks: 67 (limit: 4556)
Memory: 2.3G
CGroup: /system.slice/elasticsearch.service
├─2045 /usr/share/elasticsearch/jdk/bin/java -Xshare:auto -Des.networkaddress.cache.ttl=60 -Des.networkaddress.cache.negative.ttl=10 -Djava.security.manager=allow -XX:+AlwaysPreTouch -Xss1m >
└─2335 /usr/share/elasticsearch/modules/x-pack-ml/platform/linux-x86_64/bin/controller
Mar 18 11:06:13 axiobrim systemd[1]: Starting Elasticsearch...
Mar 18 11:06:37 axiobrim systemd[1]: Started Elasticsearch.
Podívejte se, jak nainstalovat a nakonfigurovat Elasticsearch na Ubuntu 20.04.
Krok 4:Nainstalujte Zammad
Konečně můžeme nainstalovat Zammad. Nejprve přidejte klíč gpg
curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | \
gpg --dearmor | tee /etc/apt/trusted.gpg.d/pkgr-zammad.gpg> /dev/null
Poté nastavte úložiště zammad:
echo "deb [signed-by=/etc/apt/trusted.gpg.d/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 20.04 main"| \
tee /etc/apt/sources.list.d/zammad.list > /dev/null
Nakonec aktualizujte úložiště a nainstalujte zammad:
sudo apt update && sudo apt install zammad
Krok 5:Nastavení brány firewall
Zammad bude vystaven jako webová služba. Pokud máte nainstalované a povolené ufw, budete muset povolit porty 80 a 443 pro provoz http a https. Použijte tyto příkazy:
ufw allow 80 ufw allow 443 ufw reload
Správa služeb Zammad
Zammad obecně používá tři služby – ty lze (re)spustit a zastavit pomocí nadřazeného zammad
.
$ # Zammad service to start all services at once $ systemctl (status|start|stop|restart) zammad $ # Zammads internal railsserver $ systemctl (status|start|stop|restart) zammad-web $ # Zammads scheduler - relevant for all delayed- and background jobs $ systemctl (status|start|stop|restart) zammad-worker $ # Zammads websocket server for session related information $ systemctl (status|start|stop|restart) zammad-websocket
Spuštění všech služeb
sudo systemctl start zammad
sudo systemctl start zammad-web
sudo systemctl start zammad-worker
sudo systemctl start zammad-websocket
Potvrďte stav služby pomocí tohoto příkazu:
sudo systemctl status zammad
sudo systemctl status zammad-web
sudo systemctl status zammad-worker
sudo systemctl status zammad-websocket
Krok 6:Konfigurace webového přístupu
Nejnovější služba zammad používá nginx k proxy provozu do služeb. Pokud potřebujete nakonfigurovat fqdn (přístup k doméně) jako zammad.citizix.com
budete muset aktualizovat konfiguraci nginx.
Otevřete nastavení nginx pomocí výchozího editoru
sudo vim /etc/nginx/sites-enabled/zammad.conf
Pak aktualizujte tento řádek na váš fqdn.
server_name localhost;
Takto by to vypadalo s zammad.citizix.com
server_name zammad.citizix.com;
Přejděte do domény (zammad.citizix.com
) a měli byste být schopni systém používat.
Pokud potřebujete zabezpečit svůj web pomocí ssl, podívejte se na Jak zabezpečit Nginx pomocí Letsencrypt na Ubuntu 20.04.