2021/11/29 桜井耕造
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
(1)SELinuxを無効
OSをインストールした後のディフォルトは、SELinuxが有効になっていますので、無効にします。また、firewalldが起動している場合は停止します。
# setenforce 0 # vi /etc/selinux/config SELINUX=disabled # systemctl stop firewalld.service
(2)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 # 権限テーブルをリロード
(3)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)"
(4)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'
(5)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
(6)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)
(7)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
(8)Zunuy初期設定
①ブラウザから次のURLにアクセスしてZnuny初期設定画面を表示させて、「次へ」を押下します。
http://<ホスト名またはIPアドレス>/otrs/installer.pl
②[ライセンスに同意する]を押下します。
③そのまま「次へ」を押下します。
④rootのパスワードを入力して、[データベース設定をチェック]を押下します。
User : root
Password : 設定したパスワード
Host : localhost
Type : MySQL
⑤そのまま「次へ」を押下します。
⑥「次へ」を押下します。
⑦以下を入力して、「次へ」を押下します。
システムID: そのままでOKです。
FQDN: 任意の値を入力します。
管理者メールアドレス: 任意の値を入力
組織: 任意の値を入力
ログモジュール: シスログ
規定の言語: 日本語
MXレコードのチェック: はい
⑧メールの設定は後でやれるので、「この手順を飛ばす」を押下します。
⑨これでインストール完了です。
(9)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弾: ドロップダウン形式のフィールドを抽出表示 →こちら