株式会社アイオーアーキテクトは、オープンソースなどを活用してシステム運用を最適にご提供します。

2021/11/29　桜井耕造

Tweet

Znuny 6.2.1インストール手順

＜Znuny 6.2.1のインストール手順＞

OTRS Community Editonの後継オープンソースとして、OTOBOというソフトウェアを以前紹介しました。実は、OTOBO以外にも後継オープンソースがリリースされていまして、Znuny（ズーニー）というフォークされたオープンソースがあります。詳しくは、以下のURLをご参照下さい。
Znunyのホームページ　https://www.znuny.org/en
Znunyのマニュアル　https://doc.znuny.org/manual/index.html
ライセンス　GPL v3

Znunyは、OTRS6.0系のメンテンテンスをそのまま継承してサポートしていることも特徴です。OTRSは2020年10月9日の最終版（6.0.30）を最後にメンテナンスが終了しましたが、Znuny LTS 6.0.xとして、セキュリティ脆弱性対応、バグ修正を継続してサポートしています。現時点でも2021年10月27日にZnuny LTS 6.0.38をリリースしています。

Znunyはさらに機能拡張をしており、ここでは、最新版のZnuny 6.2.1（2021年10月27日に公開）のインストールする手順を紹介します。ちなみにOTRSから移行することも可能です。

インストールする環境は、以下の通りです。
＜環境＞
CentOS Stream release 8
MariaDB-server-10.5.5-1
Znuny 6.2.1
httpd-2.4.37-30

（１）SELinuxを無効

OSをインストールした後のディフォルトは、SELinuxが有効になっていますので、無効にします。また、firewalldが起動している場合は停止します。

# setenforce 0
# vi /etc/selinux/config
SELINUX=disabled
# systemctl stop firewalld.service

（２）MariaDB 10.5のインストールと設定
MariDB10.5をインストールと設定をします。

# dnf -y install wget
# wget https://downloads.mariadb.com/MariaDB/mariadb-10.5.5/yum/rhel/mariadb-10.5.5-rhel-8-x86_64-rpms.tar
# tar xvf mariadb-10.5.5-rhel-8-x86_64-rpms.tar
# cd mariadb-10.5.5-rhel-8-x86_64-rpms
# ./setup_repository
# dnf -y install boost-program-options socat lsof rsync libaio libaio-devel
# rpm -ivh galera-4-26.4.5-1.el8.x86_64.rpm
# rpm -ivh MariaDB-common-10.5.5-1.el8.x86_64.rpm MariaDB-shared-10.5.5-1.el8.x86_64.rpm
# dnf -y install "perl(DBI)"
# rpm -ivh MariaDB-server-10.5.5-1.el8.x86_64.rpm MariaDB-client-10.5.5-1.el8.x86_64.rpm
# rpm -qa | grep Maria
MariaDB-common-10.5.5-1.el8.x86_64
MariaDB-shared-10.5.5-1.el8.x86_64
MariaDB-client-10.5.5-1.el8.x86_64
MariaDB-server-10.5.5-1.el8.x86_64

MariaDBの設定変更をします。以下の設定を追記します。

# vi /etc/my.cnf.d/server.cnf
[server]
character-set-server=utf8
max_allowed_packet=128M
query_cache_size=128M
innodb_log_file_size=512M
bind-address = 127.0.0.1

# systemctl start mariadb
# systemctl enable mariadb
# ps -ef | grep mariadb

rootのパスワードを設定するときは、以下の作業をします。

# /usr/bin/mysql_secure_installation
Switch to unix_socket authentication [Y/n] Y
Change the root password? [Y/n] Y　　　　　　　＃rootのパスワードの設定
New password:
Re-enter new password:　#パスワードを再指定
Remove anonymous users? [Y/n] Y　　　　　　　# 匿名ユーザを削除
Disallow root login remotely? [Y/n] Y　　　　　　# root ユーザでのリモートからのログインを禁止
Remove test database and access to it? [Y/n] Y　　# test データベースを削除
Reload privilege tables now? [Y/n] Y　　　　　　　# 権限テーブルをリロード

（３）Zunuy前提パッケージをインストール
Znunyをインストールするためには、前提として必須Perlモジュールがあります。まずは、rpmをインストールします。

# dnf -y install gcc
# dnf -y install epel-release
# dnf -y install httpd-devel
# dnf -y install perl-Convert-BinHex
# dnf -y install "perl(DBD::mysql)"
# dnf -y install "perl(Text::CSV_XS)"
# dnf -y install procmail
# dnf -y install perl-core
# dnf -y install "perl(Authen::NTLM)"
# dnf -y install "perl(Authen::SASL)"
# dnf -y install "perl(XML::Parser)"
# dnf -y install "perl(XML::LibXSLT)"
# dnf -y install "perl(Net::LDAP)"
# dnf -y install "perl(Encode::HanExtra)"
# dnf -y install "perl(ModPerl::Util)"
# dnf -y install "perl(Net::SMTP::SSL)"
# dnf -y install "perl(Net::DNS)"

（４）CPANからPerlモジュールをインストール
rpmが存在しないPerlモジュールは、CPANからインストールします。

 
# cpan install 'DateTime' 
# cpan install 'Moo' 
# cpan install 'Mail::IMAPClient' 
# cpan install 'Crypt::Eksblowfish::Bcrypt' 
# cpan install 'JSON::XS' 
# cpan install 'YAML::XS' 
# cpan install 'Template' 
# cpan install 'CSS::Minifier::XS'
# cpan install 'JavaScript::Minifier::XS'
# cpan install 'Jq'
# cpan install 'Spreadsheet::XLSX'

（５）Znuny 6.2.1をインストール
Znuny 6.2.1をインストールします。

# cd /opt
# wget https://download.znuny.org/releases/znuny-latest.tar.gz
# tar zxvf znuny-latest.tar.gz
# cp -r znuny-6.2.1 /opt/otrs
# useradd -d /opt/otrs -c 'Znuny user' -g apache -s /bin/bash -M -N otrs
# cp /opt/otrs/Kernel/Config.pm.dist /opt/otrs/Kernel/Config.pm
# /opt/otrs/bin/otrs.SetPermissions.pl
Setting permissions on /opt/otrs

（６）Perlモジュールのインストール確認
不足しているPerlモジュールがないかを確認します。

# /opt/otrs/bin/otrs.CheckModules.pl -list
o Apache::DBI......................ok (v1.12)
o Apache2::Reload..................ok (v0.13)
o Archive::Tar.....................ok (v2.30)
o Archive::Zip.....................ok (v1.60)
o Crypt::Eksblowfish::Bcrypt.......ok (v0.009)
o CSS::Minifier::XS................ok (v0.13)
o Date::Format.....................ok (v2.24)
o DateTime.........................ok (v1.54)
o DateTime::TimeZone.............ok (v2.51)
o DBI..............................ok (v1.641)
o DBD::mysql.......................ok (v4.046)
o DBD::ODBC........................Not installed! (optional - Required to connect to a MS-SQL database.)
o DBD::Oracle......................Not installed! (optional - Required to connect to a Oracle database.)
o DBD::Pg..........................Not installed! To install, you can use: 'yum install "perl(DBD::Pg)"'. (optional - Required to connect to a PostgreSQL database.)
o Digest::SHA......................ok (v6.02)
o Encode::HanExtra.................ok (v0.23)
o IO::Socket::SSL..................ok (v2.066)
o JavaScript::Minifier::XS.........ok (v0.15)
o Jq...............................ok (v0.01)
o JSON::XS.........................ok (v4.03)
o List::Util::XS...................ok (v1.49)
o LWP::UserAgent...................ok (v6.53)
o Mail::IMAPClient.................ok (v3.43)
o IO::Socket::SSL................ok (v2.066)
o Authen::SASL...................ok (v2.16)
o Authen::NTLM...................ok (v1.09)
o ModPerl::Util....................ok (v2.000011)
o Moo..............................ok (v2.005004)
o Net::DNS.........................ok (v1.15)
o Net::LDAP........................ok (v0.66)
o Net::SMTP........................ok (v3.11)
o Spreadsheet::XLSX................ok (v0.17)
o Template.........................ok (v3.009)
o Template::Stash::XS..............ok (undef)
o Text::Diff::FormattedHTML........ok (v0.08)
o Text::CSV_XS.....................ok (v1.40)
o Time::HiRes......................ok (v1.9758)
o XML::LibXML......................ok (v2.0132)
o XML::LibXSLT.....................ok (v1.96)
o XML::Parser......................ok (v2.44)
o YAML::XS.........................ok (v0.83)

（７）Znunyの設定、起動

Znunyのコンフィグをコピーします。

# cp /opt/otrs/scripts/apache2-httpd.include.conf /etc/httpd/conf.d/zzz_otrs.conf
# cd /etc/httpd/conf.modules.d/
# cp -ip 00-mpm.conf 00-mpm.conf.org 
#　sed -i '/^LoadModule mpm_event_module modules\/mod_mpm_event.so/s/^/#/' /etc/httpd/conf.modules.d/00-mpm.conf
# sed -i '/^#LoadModule mpm_prefork_module modules\/mod_mpm_prefork.so/s/^#//' /etc/httpd/conf.modules.d/00-mpm.conf

Apache、Znunyを起動します。

# systemctl restart httpd
# systemctl enable httpd
# systemctl list-unit-files -t service | grep enabled

（８）Zunuy初期設定
①ブラウザから次のURLにアクセスしてZnuny初期設定画面を表示させて、「次へ」を押下します。

http://<ホスト名またはIPアドレス>/otrs/installer.pl

②[ライセンスに同意する]を押下します。

③そのまま「次へ」を押下します。

④rootのパスワードを入力して、[データベース設定をチェック]を押下します。

User : root
Password : 設定したパスワード
Host : localhost
Type : MySQL

⑤そのまま「次へ」を押下します。

⑥「次へ」を押下します。

⑦以下を入力して、「次へ」を押下します。

システムID: そのままでOKです。
FQDN: 任意の値を入力します。
管理者メールアドレス: 任意の値を入力
組織: 任意の値を入力
ログモジュール: シスログ
規定の言語：　日本語
MXレコードのチェック: はい

⑧メールの設定は後でやれるので、「この手順を飛ばす」を押下します。

⑨これでインストール完了です。

（９）Znunyにログイン

ブラウザから次のURLにアクセスして、ログイン画面が表示される。

http://<ホスト名またはIPアドレス>/otrs/index.pl

次の初期管理者IDとデフォルトのパスワードでログインできることを確認する。
ID: root@localhost
パスワード: ※先ほど生成されたパスワードでログインします。

（10）Znunyデーモンを起動

# su - otrs
// otrsデーモンを起動
$ /opt/otrs/bin/otrs.Daemon.pl start
// otrsユーザーのcronを登録
$ /opt/otrs/bin/Cron.sh start

これまでZunuyについて以下の解説をしてきました。
第1弾：　Znuny 6.2.1インストール手順　→こちら
第2弾：　Znunyの様々なWebインターフェース　→こちら
第3弾：　Znunyの顧客ユーザーのユーザー管理　→こちら
第4弾：　Znunyの開発ロードマップ　→こちら
第5弾：　Znunyのアドオンのインストール　→こちら
第6弾：　高機能なZnunyのメール送受信機能　→こちら
第7弾：　チケット管理のメール送受信の設定　→こちら
第8弾：　チケット管理のキューの設定　→こちら
第9弾：　ノンプログラミングでフィールドを追加　→こちら
第10弾：　テンプレートの作成　→こちら
第11弾：　メール通知の設定　→こちら
第12弾：　ドロップダウン形式のフィールドを抽出表示　→こちら