우분투 22.04에 Zammad 티켓팅 시스템 설치하는 방법

Zammad는 고객 커뮤니케이션 관리를 위해 사용되는 무료, 오픈 소스, 웹 기반 지원/티켓팅 솔루션입니다. 이메일, 채팅, 전화, 트위터 또는 페이스북과 같은 다양한 채널을 통해 연결할 수 있습니다. 자바스크립트와 루비 프로그래밍 언어로 작성되었습니다. REST API를 지원하여 다른 프로그램과 쉽게 연결하고 모든 채널과 작업에 대한 실시간 정보를 얻을 수 있습니다. Zammad는 LDAP 통합, 시간 기록, 슬랙 통합, SSO, 다국어 지원 등 매우 유용한 기능을 제공합니다.

이 게시물에서는 우분투 22.04 서버에 Zammad 티켓팅 시스템을 설치하는 방법을 보여드리겠습니다.

요구 사항

우분투 22.04를 실행하는 서버.
서버에 구성된 루트 비밀번호.

시스템 업데이트

먼저, 모든 시스템 패키지를 최신 버전으로 업데이트하고 업그레이드해야 합니다. 다음 명령어를 실행하여 모두 업데이트할 수 있습니다.

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 패키지는 우분투 기본 저장소에 포함되어 있지 않습니다. 따라서 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 웹 서버 패키지를 설치합니다.

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 패키지는 우분투 저장소에 포함되어 있지 않습니다. 따라서 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

다음으로, 다음 명령어로 Zammad 저장소를 APT에 추가합니다.

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 웹 인터페이스에 접근할 수 있습니다.