Ubuntu 22.04にZammadチケッティングシステムをインストールする方法

Zammadは、顧客コミュニケーションを管理するために使用される無料のオープンソースのWebベースのサポート/チケッティングソリューションです。メール、チャット、電話、Twitter、Facebookなど、さまざまなチャネルを介して接続できます。JavaScriptとRubyプログラミング言語で書かれています。REST APIをサポートしており、他のプログラムと簡単にリンクし、すべてのチャネルと操作に関するリアルタイム情報を取得できます。Zammadは、LDAP統合、時間記録、Slack統合、SSO、多言語対応など、非常に便利な機能を提供します。

この記事では、Ubuntu 22.04サーバーにZammadチケッティングシステムをインストールする方法を示します。

要件

Ubuntu 22.04を実行しているサーバー。
サーバーに設定されたrootパスワード。

システムの更新

まず、すべてのシステムパッケージを最新バージョンに更新およびアップグレードする必要があります。次のコマンドを実行することで、すべてを更新できます。

apt update -y   
apt upgrade -y

すべてのシステムパッケージが最新の状態になったら、次のステップに進むことができます。

Java JDKのインストール

まず、サーバーにJava OpenJDKをインストールする必要があります。次のコマンドでインストールできます。

apt install openjdk-17-jdk -y

Javaがインストールされたら、次のコマンドを使用してJavaのバージョンを確認できます。

java -version

次の出力にJavaのバージョンが表示されるはずです。

openjdk version "17.0.5" 2022-10-18
OpenJDK Runtime Environment (build 17.0.5+8-Ubuntu-2ubuntu122.04)
OpenJDK 64-Bit Server VM (build 17.0.5+8-Ubuntu-2ubuntu122.04, mixed mode, sharing)

Javaがインストールされたら、ElasticSearchのインストールに進むことができます。

ElasticSearchのインストール

Zammadは検索機能を提供するためにElasticSearchを使用します。したがって、サーバーにElasticSearchをインストールする必要があります。デフォルトでは、ElasticSearchパッケージはUbuntuのデフォルトリポジトリには含まれていません。したがって、ElasticSearchリポジトリをサーバーに追加する必要があります。

まず、次のコマンドを使用して必要な依存関係をインストールします。

apt install gnupg2 curl -y

次に、次のコマンドを使用してElasticSearchのGPGキーとリポジトリをAPTに追加します。

curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | gpg --dearmor -o /usr/share/keyrings/elastic.gpg  
echo "deb [signed-by=/usr/share/keyrings/elastic.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main" | tee -a /etc/apt/sources.list.d/elastic-7.x.list

次に、次のコマンドを使用してリポジトリキャッシュを更新します。

apt update -y

最後に、次のコマンドを使用してElasticSearchパッケージをインストールします。

apt install elasticsearch -y

ElasticSearchがインストールされたら、次のコマンドを使用してElasticSearchサービスを開始および有効にします。

systemctl enable elasticsearch.service  
systemctl start elasticsearch.service

次のコマンドを使用してElasticSearchを確認できます。

curl -X GET 'http://localhost:9200'

すべてが正常であれば、次の出力が得られます。

{
  "name" : "ubuntu2204",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "V4bBWciDSSWmI-QcwvJdGA",
  "version" : {
    "number" : "7.17.8",
    "build_flavor" : "default",
    "build_type" : "deb",
    "build_hash" : "120eabe1c8a0cb2ae87cffc109a5b65d213e9df1",
    "build_date" : "2022-12-02T17:33:09.727072865Z",
    "build_snapshot" : false,
    "lucene_version" : "8.11.1",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "You Know, for Search"
}

ingest-attachmentプラグインもインストールする必要があります。次のコマンドでインストールできます。

/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

次の出力が得られます。

-> Installing ingest-attachment
-> Downloading ingest-attachment from elastic
[=================================================] 100%   
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@     WARNING: plugin requires additional permissions     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
* java.lang.RuntimePermission accessClassInPackage.sun.java2d.cmm.kcms
* java.lang.RuntimePermission accessDeclaredMembers
* java.lang.RuntimePermission getClassLoader
* java.lang.reflect.ReflectPermission suppressAccessChecks
* java.security.SecurityPermission createAccessControlContext
See https://docs.oracle.com/javase/8/docs/technotes/guides/security/permissions.html
for descriptions of what these permissions allow and the associated risks.

Continue with installation? [y/N]y
-> Installed ingest-attachment
-> Please restart Elasticsearch

次に、変更を適用するためにElasticSearchサービスを再起動します。

systemctl restart elasticsearch

完了したら、Apacheおよびその他の依存関係のインストールに進むことができます。

Apacheおよびその他の依存関係のインストール

まず、次のコマンドを使用してApache Webサーバーパッケージをインストールします。

apt install apache2 -y

次に、サーバーにlibsslをインストールする必要があります。まず、次のコマンドでFocalセキュリティリポジトリを追加します。

echo "deb http://security.ubuntu.com/ubuntu focal-security main" | tee /etc/apt/sources.list.d/focal-security.list

次に、リポジトリを更新し、次のコマンドでlibsslパッケージをインストールします。

apt update -y  
apt install libssl1.1

完了したら、次のステップでZammadをインストールできます。

Zammadチケッティングシステムのインストール

デフォルトでは、ZammadパッケージはUbuntuリポジトリには含まれていません。したがって、Zammadリポジトリをサーバーに追加する必要があります。

まず、次のコマンドでZammadのGPGキーを追加します。

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

次に、次のコマンドでAPTにZammadリポジトリを追加します。

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

次に、次のコマンドを使用してリポジトリキャッシュを更新します。

apt update -y

次に、次のコマンドでZammadパッケージをインストールします。

apt install zammad -y

Zammadがインストールされたら、次のステップに進むことができます。

ZammadのためのApacheの設定

Zammadは、Apache設定ディレクトリに自動的にApache設定ファイルを作成します。ただし、Zammad設定ファイルを編集し、要件に応じて変更する必要があります。

nano /etc/apache2/sites-available/zammad.conf

次の行を変更します。

#ServerTokens Prod
    ServerName your-server-ip
    #RequestHeader unset X-Forwarded-User

ファイルを保存して閉じたら、デフォルトのApache設定ファイルを無効にします。

a2dissite 000-default.conf

次に、変更を適用するためにApacheサービスを再起動します。

systemctl restart apache2

次のコマンドを使用してApacheのステータスを確認できます。

systemctl status apache2

次の出力が得られるはずです。

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2022-12-30 02:49:21 UTC; 8s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 13887 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 13891 (apache2)
      Tasks: 55 (limit: 4579)
     Memory: 5.1M
        CPU: 53ms
     CGroup: /system.slice/apache2.service
             ??13891 /usr/sbin/apache2 -k start
             ??13892 /usr/sbin/apache2 -k start
             ??13893 /usr/sbin/apache2 -k start

Dec 30 02:49:21 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...

完了したら、ZammadのWebインターフェースにアクセスできます。