Jak zainstalować Zammad 2.0 na Ubuntu 16.04 LTS

• Wymagania wstępne
• Krok 1: Skonfiguruj nazwę FQDN (w pełni kwalifikowana nazwa domeny)
• Krok 2: Zainstaluj pakiety OpenJDK 8
• Krok 3: Zainstaluj Elasticsearch 5 i wtyczkę mapowania załączników
• Krok 4: Zainstaluj Zammad 2.0
• Krok 5: Skonfiguruj reguły SELinuksa i zapory
• Krok 6: Zainstaluj nowy system Zammad z interfejsu internetowego

Zammad to system pomocy / sprzedaży biletów typu open source przeznaczony dla zespołów obsługi klienta. Dzięki Zammad przedstawiciele obsługi klienta mogą łatwo obsługiwać zapytania klientów i skargi z różnych kanałów, w tym z Internetu, formularza, e-maila, czatu, Twittera, Facebooka itp.

Wymagania wstępne

• Świeże Vultr Ubuntu 16.04 LTS 64 przykład serwer o co najmniej 4 GB pamięci. Powiedz, że jego adres IP to 203.0.113.1, a nazwa hosta to helpdesk.
• Domena helpdesk.example.comskonfigurowana tak, aby wskazywała wspomnianą powyżej instancję serwera. Możesz dowiedzieć się więcej na ten temat w innym samouczku Vultr .
• Użytkownik sudo .
• Instancja serwera została zaktualizowana do najnowszej stabilnej wersji .
• W środowisku produkcyjnym zaleca się ustawienie pliku wymiany w celu zoptymalizowania wydajności.

Krok 1: Skonfiguruj nazwę FQDN (w pełni kwalifikowana nazwa domeny)

Zgodnie z wymaganiami Zammad, musisz poprawnie skonfigurować nazwę FQDN na instancji serwera, zanim będziesz mógł uzyskać zdalny dostęp do witryny Zammad.

Użyj viedytora tekstu, aby otworzyć /etc/hostsplik.

sudo vi /etc/hosts

Wstaw następujący wiersz przed istniejącymi wierszami.

203.0.113.1 helpdesk.example.com helpdesk

Zapisz i wyjdź.

:wq!

Użyj hostname -fpolecenia, aby potwierdzić wynik, który będzie wyglądał następująco.

helpdesk.example.com

Krok 2: Zainstaluj pakiety OpenJDK 8

Zgodnie z wymaganiami Zammad, przed zainstalowaniem i uruchomieniem Zammada musisz zainstalować Javę na instancji serwera.

Zainstaluj najnowszą stabilną wersję OpenJDK 8.

sudo apt install -y openjdk-8-jdk

Po zainstalowaniu OpenJDK 8 możesz zweryfikować wynik.

java -version

Wynik będzie wyglądał następująco.

openjdk version "1.8.0_131"
OpenJDK Runtime Environment (build 1.8.0_131-8u131-b11-2ubuntu1.16.04.3-b11)
OpenJDK 64-Bit Server VM (build 25.131-b11, mixed mode)

Na koniec ustaw JAVA_HOMEzmienną środowiskową.

echo "JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")" | sudo tee -a /etc/profile
source /etc/profile

Krok 3: Zainstaluj Elasticsearch 5 i wtyczkę mapowania załączników

Zammad używa Elasticsearch w celu zapewnienia funkcji wyszukiwania. W systemie Ubuntu 16.04 można zainstalować najnowszą stabilną wersję Elasticsearch 5 przy użyciu oficjalnego repozytorium DEB Elasticsearch, jak poniżej.

Najpierw pobierz i zainstaluj publiczny klucz podpisujący Elasticsearch 5.

sudo apt install -y wget
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

Następnie zainstaluj apt-transport-httpspakiet.

sudo apt install -y apt-transport-https

Zapisz definicję repozytorium w /etc/apt/sources.list.d/elastic-5.x.list.

echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list

Następnie zainstaluj Elasticsearch 5.x za pomocą APT.

sudo apt update -y
sudo apt install -y elasticsearch

Na koniec uruchom usługę Elasticsearch i ustaw ją automatycznie podczas uruchamiania.

sudo systemctl daemon-reload
sudo systemctl start elasticsearch.service
sudo systemctl enable elasticsearch.service

Ponadto, aby umożliwić Elasticsearch indeksowanie załączników, musisz zainstalować mapper-attachmentswtyczkę Elasticsearch w następujący sposób.

sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install mapper-attachments

Gdy zostaniesz poproszony o zatwierdzenie dodatkowych uprawnień, wpisz „ Y”, a następnie naciśnij „ Enter”, aby zakończyć instalację.

Uruchom ponownie usługę Elasticsearch, aby załadować nową wtyczkę.

sudo systemctl restart elasticsearch.service

Krok 4: Zainstaluj Zammad 2.0

Aby ułatwić proces instalacji, możesz użyć oficjalnego repozytorium DEB Zammad, aby zainstalować Zammad wraz z różnymi zależnościami, w tym Nginx, PostgreSQL i innymi, jednocześnie.

Przede wszystkim upewnij się, że instancja serwera używa UTF-8ustawień regionalnych, w przeciwnym razie PostgreSQL nie będzie mógł zostać zainstalowany.

locale

Jeśli znajdziesz ustawienia regionalne inne niż en_US.UTF-8, musisz przełączyć się na te ustawienia regionalne w następujący sposób.

sudo apt install -y locales
sudo locale-gen en_US.UTF-8
echo "LANG=en_US.UTF-8" | sudo tee /etc/default/locale

Po upewnieniu się, że ustawienia regionalne są prawidłowe, pobierz oficjalne repozytorium Zammad DEB.

wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/16.04.repo

Zainstaluj Zammad i wszystkie wymagane zależności za pomocą APT.

sudo apt update -y
sudo apt install -y zammad

Po pomyślnym zainstalowaniu Zammad usługa Zammad uruchomi się automatycznie. Możesz użyć następującego polecenia, aby potwierdzić status usługi Zammad.

sudo systemctl status zammad.service

Będzie to miało status active (running).

Następnie użyj następujących poleceń, aby Zammad działał z Elasticsearch i odbudował indeks.

sudo zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"
sudo zammad run rake searchindex:rebuild

Dodaj dodatkową przestrzeń nazw indeksu Elasticsearch (opcjonalnie).

sudo zammad run rails r "Setting.set('es_index', Socket.gethostname + '_zammad')"

Zignoruj ​​popularne typy plików binarnych (opcjonalnie).

sudo zammad run rails r "Setting.set('es_attachment_ignore', [ '.png', '.jpg', '.jpeg', '.mpeg', '.mpg', '.mov', '.bin', '.exe', '.box', '.mbox' ] )"

Ustaw maksymalny rozmiar załącznika (opcjonalnie).

sudo zammad run rails r "Setting.set('es_attachment_max_size_in_mb', 50)"

Aby umożliwić użytkownikom zdalny dostęp do Zammad, musisz zmodyfikować plik konfiguracyjny Zammad Nginx.

sudo vi /etc/nginx/sites-available/zammad.conf

Znajdź linię.

 server_name localhost;

Zamień localhostna FQDN twojej instancji serwera.

server_name helpdesk.example.com;

Zapisz i wyjdź.

:wq!

Na koniec uruchom ponownie usługę Nginx, aby zastosować zmiany.

sudo systemctl restart nginx.service

Krok 5: Skonfiguruj reguły SELinuksa i zapory

Użyj poniższych poleceń, aby określić status SELinuksa na instancji serwera.

sudo apt install -y policycoreutils
sestatus

Jeśli SELinux jest włączony w enforcingtrybie na twoim komputerze, musisz zmodyfikować regułę SELinux w następujący sposób.

sudo apt install -y selinux selinux-basics selinux-utils selinux-policy-ubuntu setools
sudo setsebool httpd_can_network_connect on -P

Jeśli SELinux jest disabledwłączony lub włączony w tym permissivetrybie, zignoruj ​​powyższe modyfikacje i przejdź dalej.

Musisz także zmodyfikować reguły zapory UFW w następujący sposób.

sudo ufw app list
sudo ufw allow OpenSSH
sudo ufw allow in "Nginx Full"
sudo ufw enable

Krok 6: Zainstaluj nowy system Zammad z interfejsu internetowego

Wskaż swoją ulubioną przeglądarkę internetową http://helpdesk.example.com, a zostaniesz przeniesiony na Zammad getting startedstronę.

Kliknij Setup new systemprzycisk, aby przejść dalej.

W Administrator Accountoknie wprowadź imię i nazwisko administratora, nazwisko, adres e-mail i hasło (dwa razy), a następnie kliknij Createprzycisk.

W Organizationoknie wprowadź nazwę organizacji i systemowy adres URL http://helpdesk.example.com, prześlij swoje logo (jeśli istnieje), a następnie kliknij Nextprzycisk.

W Email Notificationoknie wybierz właściwą metodę wysyłania wiadomości e-mail, a następnie kliknij Continueprzycisk.

W Connect Channelsoknie kliknij Skipprzycisk, aby zakończyć wstępną konfigurację. Wszystkie kanały można później dostosować.

To wszystko na potrzeby uruchomienia działającego systemu biletowego Zammad. Zapoznaj się z interfejsem Zammad i zaproś przedstawicieli obsługi klienta. Dziękuje za przeczytanie.