Ubuntu 16.04 LTSにZammad 2.0をインストールする方法

• 前提条件
• 手順1：FQDN（完全修飾ドメイン名）を設定する
• ステップ2：OpenJDK 8パッケージをインストールする
• ステップ3：Elasticsearch 5とmapper-attachmentsプラグインをインストールする
• 手順4：Zammad 2.0をインストールする
• ステップ5：SELinuxとファイアウォールルールを設定する
• 手順6：Webインターフェイスから新しいZammadシステムをセットアップする

Zammadは、カスタマーサポートチーム向けに設計されたオープンソースのヘルプデスク/チケットシステムです。Zammadを使用すると、顧客サービス担当者は、Web、フォーム、電子メール、チャット、Twitter、Facebookなどのさまざまなチャネルからの顧客の問い合わせや苦情に簡単に対処できます。

前提条件

• 4GB 以上のメモリを備えた新しい Vultr Ubuntu 16.04 LTS x64サーバーインスタンス。IPアドレスがで、ホスト名がだとします。203.0.113.1helpdesk
• helpdesk.example.com上記のサーバーインスタンスを指すように構成���れたドメイン。この詳細については、別のVultrチュートリアルをご覧ください。
• sudoのユーザー。
• サーバーインスタンスが最新の安定した状態に更新されました。
• 本番環境では、パフォーマンスを最適化するためにスワップファイルを設定することをお勧めします。

手順1：FQDN（完全修飾ドメイン名）を設定する

Zammadの必要に応じて、Zammadサイトにリモートアクセスする前に、サーバーインスタンスでFQDNを適切に設定する必要があります。

viテキストエディタを使用して/etc/hostsファイルを開きます。

sudo vi /etc/hosts

既存の行の前に次の行を挿入します。

203.0.113.1 helpdesk.example.com helpdesk

保存して終了します。

:wq!

hostname -fコマンドを使用して結果を確認すると、次のようになります。

helpdesk.example.com

ステップ2：OpenJDK 8パッケージをインストールする

Zammadの要件に応じて、Zammadをインストールして実行する前に、サーバーインスタンスにJavaをインストールする必要があります。

OpenJDK 8の最新の安定版リリースをインストールします。

sudo apt install -y openjdk-8-jdk

OpenJDK 8をインストールしたら、結果を確認できます。

java -version

出力は次のようになります。

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)

最後に、JAVA_HOME環境変数を設定します。

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

ステップ3：Elasticsearch 5とmapper-attachmentsプラグインをインストールする

ZammadはElasticsearchを使用して検索機能を提供します。Ubuntu 16.04では、以下の公式Elasticsearch DEBリポジトリを使用して、Elasticsearch 5の最新の安定版リリースをインストールできます。

最初に、Elasticsearch 5公開署名鍵をダウンロードしてインストールします。

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

次に、apt-transport-httpsパッケージをインストールします。

sudo apt install -y apt-transport-https

リポジトリ定義をに保存します/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

次に、APTを使用してElasticsearch 5.xをインストールします。

sudo apt update -y
sudo apt install -y elasticsearch

最後に、Elasticsearchサービスを開始し、ブート時に自動的に開始するようにします。

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

さらに、Elasticsearchで添付ファイルのインデックスを作成できるようにするには、Elasticsearch mapper-attachmentsプラグインを次のようにインストールする必要があります。

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

追加の権限を承認するように求められたら、「Y」と入力し、「」を押しEnterてインストールを終了します。

Elasticsearchサービスを再起動して、新しいプラグインをロードします。

sudo systemctl restart elasticsearch.service

手順4：Zammad 2.0をインストールする

インストールプロセスを容易にするために、公式のZammad DEBリポジトリを使用して、Nginx、PostgreSQLなどを含むさまざまな依存関係とともにZammadをすべて同時にインストールできます。

まず、サーバーインスタンスがUTF-8ロケールを使用していることを確認してください。そうでない場合、PostgreSQLをインストールできません。

locale

以外のロケール設定が見つかった場合はen_US.UTF-8、次のようにそのロケールに切り替える必要があります。

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

ロケールが正しいことを確認した��、公式の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

を使用して、Zammadと必要なすべての依存関係をインストールしますAPT。

sudo apt update -y
sudo apt install -y zammad

Zammadが正常にインストールされると、Zammadサービスが自動的に開始されます。次のコマンドを使用して、Zammadサービスのステータスを確認できます。

sudo systemctl status zammad.service

そのステータスはになりますactive (running)。

次に、以下のコマンドを使用して、ZammadをElasticsearchと連携させ、インデックスを再構築します。

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

Elasticsearchインデックスの名前空間を追加します（オプション）。

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

一般的なバイナリファイルタイプを無視します（オプション）。

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

添付ファイルの最大サイズを設定します（オプション）。

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

ユーザーがZammadにリモートでアクセスできるようにするには、Zammad Nginx構成ファイルを変更する必要があります。

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

行を見つけます。

 server_name localhost;

をlocalhostサーバーインスタンスのFQDNに置き換えます。

server_name helpdesk.example.com;

保存して終了します。

:wq!

最後に、Nginxサービスを再起動して変更を適用します。

sudo systemctl restart nginx.service

ステップ5：SELinuxとファイアウォールルールを設定する

次のコマンドを使用して、サーバーインスタンスのSELinuxのステータスを確認します。

sudo apt install -y policycoreutils
sestatus

enforcingマシンのモードでSELinuxが有効になっている場合は、SELinuxルールを次のように変更する必要があります。

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

モードでSELinuxがdisabled有効になっている場合はpermissive、上記の変更を無視して次に進んでください。

また、UFWファイアウォールルールを次のように変更する必要があります。

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

手順6：Webインターフェイスから新しいZammadシステムをセットアップする

お気に入りのWebブラウザーをにポイントするhttp://helpdesk.example.comと、Zammad getting startedページが表示されます。

Setup new systemボタンをクリックして先に進みます。

ではAdministrator Account、ウィンドウ、入力、管理者の姓、名、電子メール、およびパスワード（2回）、およびクリックCreateボタンを。

ではOrganization、ウィンドウ、入力組織名とシステムのURLはhttp://helpdesk.example.com、（もしあれば）あなたのロゴをアップロードし、[OK]をクリックしますNextボタンを。

ではEmail Notification、ウィンドウ、送信方法、適切な電子メールを選択し、[OK]をクリックしますContinueボタンを。

でConnect ChannelsウィンドウをクリックしSkip、初期設定を完了するためにボタンを。すべてのチャネルは後でカスタマイズできます。

運用可能なZammadチケットシステムをセットアップするためのすべてです。Zammadインターフェースを自由に探索し、カスタマーサービス担当者を招待してください。読んでくれてありがとう。