第2章 インストレーション

異なるデータベース・バックエンドを使用して、OTRSを使用することができます:MySQL、PostgreSQL、オラクルあるいはMicrosoft SQL Server。OTRS上に展開させる最もポピュラーなデータベースはMySQLです。本章は、SUSEベースのサーバ上のMySQLを形成するために取る必要のあるステップを示します。もちろん、もし拡張性あるいは他の目的で必要ならば、データベースを専用データベース・サーバにインストールすることができます。

rootとして次のコマンドを実行しMySQLをインストールします：

        linux:~ # zypper install mysql perl-DBD-mysql
    

デフォルト・オプションが付属したMySQLをシステムにインストールします。それをOTRSに適するようにデフォルトを変更する必要があるでしょう。テキストエディターで、ファイル/etc/my.cnfを開き、コマンドmax_allowed_packetで行を変更し、以下のように一行追加しまう:

        max_allowed_packet=20M
        query_cache_size=32M
    

まず、データベース・サーバを再起動し、かつこれらの変更を活性化するためにrcmysql restartを実行します。次に、/usr/bin/mysql_secure_installationを実行して、データベースrootパスワードをセットし、匿名のアクセスを削除し、テスト・データベースを削除し、スクリーン上の指示に従ってください。最後に、mysqlがサーバ起動時に自動的に開始されることを確かめるためにchkconfig -a mysqlを実行してください。

コマンドzypperを使用するコマンドラインでOTRSをインストールします。これはApacheのウェブサーバおよびいくつかのパール・モジュールのようないくつかの依存性も誘起します。カレント・ディレクトリにOTRS RPMのファイルをコピーしたことを確かめてください。

otrs-sles:~ # zypper install otrs-3.3.*.rpm
....
Retrieving package otrs-3.3.3-01.noarch (1/26), 17.5 MiB (74.3 MiB unpacked)
Installing: otrs-3.3.3-01 [done]
Additional rpm output:
Check OTRS user ... otrs added.

Next steps:

[start database and Apache]
 Make sure your database is running and execute 'rcapache2 restart'.

[install the OTRS database]
 Use a webbrowser and open this link:
 http://myserver.example.com/otrs/installer.pl

[OTRS services]
 Start OTRS 'rcotrs start-force' (rcotrs {start|stop|status|restart|start-force|                                                                                                                     stop-force}).

((enjoy))

 Your OTRS Team
 http://otrs.org/

otrs-sles:~ #
    

図：OTRSをインストールするコマンド

OTRS設置は完了しました。以下のスクリプト中で示されるように、その構成中のOTRS特有の変更をロードするためにウェブサーバを開始してください。さらにサーバのリブート時OTRSが自動的に開始されることを確認するためにchkconfigを実行してください。

otrs-sles:~ # chkconfig -a apache2
apache2                   0:off  1:off  2:off  3:on   4:off  5:on   6:off
otrs-sles:~ # rcapache2 start
Starting httpd2 (prefork) httpd2-prefork: Could not reliably determine the server's fully qualified domain name, using 10.x.x.x for ServerName
                                                                                                                                                                                          done
otrs-sles:~ #

スクリプト：ウェブサーバの開始

OTRSは、RPMによってインストールすることができるモジュールよりさらに幾つか多くのモジュールを必要とします。それらを手動で後からインストールすることができます。/opt/otrsディレクトリーにあるbin/otrs.CheckModules.pl スクリプトを実行して、不足しているのがどのモジュールかをチェックすることができます。いくつかのモジュールは、IMAP(S)サーバーかPDF生成とのコミュニケーションのようなオプションの機能性にだけ必要とされます。SLESではシステムにモジュールを必要とするために外部リポジトリをzypper構成に追加すべきです。OSバージョンに必要とされたモジュールをここから選択してください:http://download.opensuse.org/repositories/devel:/languages:/perl/。SLE 11 SP2用にこのようにリポジトリを追加します。

            zypper ar -f -n perl http://download.opensuse.org/repositories/devel:/languages:/perl/SLE_11_SP2 Perl
        

openSUSE 12.3では、別のリポジトリがMail::IMAPClientモジュールにだけ必要とされます。TLSで安全なIMAPサーバーからメールを集める必要があるときだけ、それを必要とするでしょう。対応する行は以下ご欄ください:

            zypper ar -f -n perl http://download.opensuse.org/repositories/devel:/languages:/perl/openSUSE_12.3/ Perl
        

このリポジトリ追加後、はじめてzypperを使用時、そのキーを追加するように促されるでしょう。これで以下のように、不足しているモジュールをインストールすることができます。

otrs-sles:/opt/otrs # zypper install -y "perl(YAML::LibYAML)"
Refreshing service 'susecloud'.
Retrieving repository 'perl' metadata [\]

New repository or package signing key received:
Key ID: DCCA98DDDCEF338C
Key Name: devel:languages:perl OBS Project <devel:languages:perl@build.opensuse.org>
Key Fingerprint: 36F0AC0BCA9D8AF2871703C5DCCA98DDDCEF338C
Key Created: Wed Oct 10 22:04:18 2012
Key Expires: Fri Dec 19 22:04:18 2014
Repository: perl

Do you want to reject the key, trust temporarily, or trust always? [r/t/a/?] (r): a
Retrieving repository 'perl' metadata [done]
Building repository 'perl' cache [done]
Loading repository data...
Reading installed packages...
'perl(YAML::LibYAML)' not found in package names. Trying capabilities.
Resolving package dependencies...

The following NEW package is going to be installed:
  perl-YAML-LibYAML

The following package is not supported by its vendor:
  perl-YAML-LibYAML

Retrieving package perl-YAML-LibYAML-0.38-12.4.x86_64 (1/1), 75.0 KiB (196.0 KiB unpacked)
Retrieving: perl-YAML-LibYAML-0.38-12.4.x86_64.rpm [done (55.7 KiB/s)]
Installing: perl-YAML-LibYAML-0.38-12.4 [done]
        

次のステップではこのセクションで記述されるように、ウェブ・インストーラーを使用して、OTRSを構成します。

異なるデータベースバックエンドを使用して、OTRSを使用することができます:MySQL、PostgreSQL、OracleあるいはMicrosoft SQL Server。OTRSを上に展開させる最もポピュラーなデータベースはMySQLです。本章は、RHELベースのサーバ上のMySQLを構成するために必要なステップを示します。もちろん、拡張性あるいは他の目的に必要ならばデータベースを専用データベース・サーバにインストールすることもできます。

rootとして次のコマンドを実行しMySQLをインストールします：

        [root@otrs-centos6 ~]# yum -y install mysql-server
    

これは、デフォルト・オプションを持つMySQLをシステムにインストールします。それをOTRSに適しているようにデフォルトを変更する必要があります。テキストエディターで、ファイル/etc/my.cnfを開き、[mysqld]セクションの下の次の2行を追加します:

        max_allowed_packet=20M
        query_cache_size=32M
    

ここで、データベース・サーバを再起動し、かつこれらの変更を活性化するためにservice mysqld startを実行します。次に、/usr/bin/mysql_secure_installationを実行して、データベースrootパスワードをセットし、匿名のアクセスを削除し、テスト・データベースを削除し、スクリーン上の指示に従ってください。最後に、mysqlがサーバ開始時に自動開始されることを確認するためにchkconfig mysqld onを実行してください。

コマンドyumを使用するコマンドラインからOTRSをインストールします。これは、さらにApacheウェブサーバおよびいくつかのPerlモジュールのようないくつかの依存性を誘起するでしょう。カレント・ディレクトリにOTRS RPMのファイルをコピーしたことを確認してください。

[root@otrs-centos6 ~]# yum install --nogpgcheck otrs-3.3.*.rpm
...
Dependencies Resolved

================================================================================
 Package                    Arch   Version                Repository       Size
================================================================================
Installing:
 otrs                       noarch 3.3.3-01               /otrs-3.3.3-01.noarch
                                                                           74 M
Installing for dependencies:
 apr                        x86_64 1.3.9-5.el6_2          updates         123 k
 ...
 procmail                   x86_64 3.22-25.1.el6          base            163 k

Transaction Summary
================================================================================
Install      26 Package(s)

Total size: 80 M
Total download size: 6.0 M
Installed size: 88 M
Downloading Packages:
(1/25): apr-1.3.9-5.el6_2.x86_64.rpm                     | 123 kB     00:00
...
(25/25): procmail-3.22-25.1.el6.x86_64.rpm               | 163 kB     00:00
--------------------------------------------------------------------------------
Total                                           887 kB/s | 6.0 MB     00:06
Running rpm_check_debug
Running Transaction Test
Transaction Test Succeeded
Running Transaction
  Installing : apr-1.3.9-5.el6_2.x86_64                               1/26
  ...
  Installing : otrs-3.3.3-01.noarch                                   26/26
Check OTRS user ... otrs added.

Next steps:

[httpd services]
 Restart httpd 'service httpd restart'

[install the OTRS database]
 Make sure your database server is running.
 Use a web browser and open this link:
 http://myserver.example.com/otrs/installer.pl

[OTRS services]
 Start OTRS 'service otrs start' (service otrs {start|stop|status|restart).

((enjoy))

 Your OTRS Team

Installed:
  otrs.noarch 0:3.3.3-01

Dependency Installed:
  ...

Complete!
[root@otrs-centos6 ~]#
    

図：OTRSをインストールするコマンド

OTRS設置は完了しました。ここでApacheが開始し、サーバがリブートする場合は常に、Apacheが開始することを確認すべきです。

[root@otrs-centos6 ~]# chkconfig httpd on
[root@otrs-centos6 ~]# service httpd start
Starting httpd: httpd: Could not reliably determine the server's fully qualified domain name, using 10.x.x.x for ServerName [  OK  ]
[root@otrs-centos6 ~]#

スクリプト：ウェブサーバの開始

OTRSは、RPMによってインストールすることができるよりさらに幾つかのモジュールを必要とします。それらを手動で後でインストールすることができます。/opt/otrsディレクトリーにあるbin/otrs.CheckModules.plスクリプトを実行して、不足しているのがどのモジュールかをチェックすることができます。いくつかのモジュールは、IMAP(S)サーバーかPDF生成とのコミュニケーションのようなオプションの機能性にのみ必要とされます。Red HatまたはCentOSの上でEPELリポジトリからのこれらのモジュールのインストールを推奨します。そのリポジトリは、RHELとそのは派生のための高品質パッケージを供給しているFedora projectによって維持管理されています。より詳細な情報は以下を御覧ください。the EPELウェブサイト。

RHEL 6あるいはCentOS 6をご利用の場合、EPELのために最新のパッケージを得ることができます。このサイトから。このページで見つけたRPM URLをコピーして、このコマンドを実行することによって、このリポジトリをyumに追加できます：

 [root@otrs-centos6 otrs]# yum -y install http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm
Loaded plugins: security
Setting up Install Process
epel-release-6-8.noarch.rpm                                   |  14 kB     00:00
Examining /var/tmp/yum-root-7jrJef/epel-release-6-8.noarch.rpm: epel-release-6-8.noarch
Marking /var/tmp/yum-root-7jrJef/epel-release-6-8.noarch.rpm to be installed
Resolving Dependencies
--> Running transaction check
---> Package epel-release.noarch 0:6-8 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

=====================================================================================
 Package             Arch          Version     Repository                       Size
=====================================================================================
Installing:
 epel-release        noarch        6-8         /epel-release-6-8.noarch         22 k

Transaction Summary
=====================================================================================
Install       1 Package(s)

Total size: 22 k
Installed size: 22 k
Downloading Packages:
Running rpm_check_debug
Running Transaction Test
Transaction Test Succeeded
Running Transaction
  Installing : epel-release-6-8.noarch                                           1/1
  Verifying  : epel-release-6-8.noarch                                           1/1

Installed:
  epel-release.noarch 0:6-8

Complete!
[root@otrs-centos6 otrs]#
        

このリポジトリを追加後、yumの初回使用時、そのキーを加えるように促されます。ここで不足しているモジュールを以下のようにインストールすることができます。

[root@otrs-centos6 otrs]# yum -y install "perl(Text::CSV_XS)"
Loaded plugins: security
Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package perl-Text-CSV_XS.x86_64 0:0.85-1.el6 will be installed
--> Finished Dependency Resolution

Dependencies Resolved

=====================================================================================
 Package                   Arch            Version               Repository     Size
=====================================================================================
Installing:
 perl-Text-CSV_XS          x86_64          0.85-1.el6            epel           71 k

Transaction Summary
=====================================================================================
Install       1 Package(s)

Total download size: 71 k
Installed size: 154 k
Downloading Packages:
perl-Text-CSV_XS-0.85-1.el6.x86_64.rpm                        |  71 kB     00:00
warning: rpmts_HdrFromFdno: Header V3 RSA/SHA256 Signature, key ID 0608b895: NOKEY
Retrieving key from file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-6
Importing GPG key 0x0608B895:
 Userid : EPEL (6) <epel@fedoraproject.org>
 Package: epel-release-6-8.noarch (@/epel-release-6-8.noarch)
 From   : /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-6
Is this ok [y/N]: y
Running rpm_check_debug
Running Transaction Test
Transaction Test Succeeded
Running Transaction
  Installing : perl-Text-CSV_XS-0.85-1.el6.x86_64                                1/1
  Verifying  : perl-Text-CSV_XS-0.85-1.el6.x86_64                                1/1

Installed:
  perl-Text-CSV_XS.x86_64 0:0.85-1.el6

Complete!
[root@otrs-centos6 otrs]#
        

次のステップではこのセクションで記述されるように、ウェブ・インストーラーを使用して、OTRSを構成します。

Oracleデータベース上のOTRSを展開させたければ、DBD::Oracleデータベース・ドライバをコンパイルし、インストールする必要があります。これは他のどのパッケージのインストールよりわずかに複雑です;これはオラクルが所有権のあるデータベースであり、Red HatもCentOSもRPMレポジトリにドライバを配布することが許可されないプロジェクトだからという理由だからです。

まず、ドライバーをコンパイルしインストールできるように、gcc, make 及び CPANをインストールする必要があります。以下、CentOSに関するコマンドを見てみましょう;他のバージョンにおいては、それが少し異なっているように見えるかもしれません。

[root@otrs-centos6 otrs]# yum -y install gcc make "perl(CPAN)"
        

次のステップは、データベース・クライアントを入手しインストールすることです。これについては、オラクルのウェブサイトで無料アカウントのサインアップをする必要があるでしょう。このページからドライバをダウンロードすることができます: http://www.oracle.com/technetwork/database/features/instant-client/index-097480.htmlシステムのアーキテクチャーに対応するLinux x86 か x86-64バージョンを選んでください。コマンドuname -iでこれをチェックすることができます。それは、x86-64のための「x86_64」あるいはx86のための「i386」のいずれかです。以下のパッケージをダウンロードするべきです：'Instant Client Package - Basic', 'Instant Client Package - SQL*Plus', and 'Instant Client Package - SDK'。それらをディスクに保存してください。ここで、rootユーザーとして、次のコマンドを使用して、パッケージをインストールすることができます:

[root@otrs-centos6 otrs]# yum install oracle-instantclient*
        

この後、2つの環境変数をセットし、DBD::Oracleドライバーをコンパイルするべきです。再び、rootユーザとしてこれらのタスクを行なってください。以下にステップを概説します。コマンドが除去されたことで出力行が数行短くなっていることにお気づき下さい。

[root@otrs-centos6 otrs]# export ORACLE_HOME=/usr/lib/oracle/11.2/client64
[root@otrs-centos6 otrs]# export LD_LIBRARY_PATH=$ORACLE_HOME/lib
[root@otrs-centos6 otrs]# cpan
cpan[1]> look DBD::Oracle
...
Fetching with LWP:
  http://www.perl.org/CPAN/authors/id/P/PY/PYTHIAN/CHECKSUMS
Checksum for /root/.cpan/sources/authors/id/P/PY/PYTHIAN/DBD-Oracle-1.62.tar.gz ok
Scanning cache /root/.cpan/build for sizes
DONE
...
Working directory is /root/.cpan/build/DBD-Oracle-1.62-ZH6LNy
[root@localhost DBD-Oracle-1.62-ZH6LNy]# perl Makefile.PL
...
[root@localhost DBD-Oracle-1.62-ZH6LNy]# make
...
[root@localhost DBD-Oracle-1.62-ZH6LNy]# make install
...
cpan[2]> exit
Terminal does not support GetHistory.
Lockfile removed.
        

ここで、ORACLE_HOMEを提供するファイル Kernel/Config.pmを編集するべきです。次のステップはこのセクションで記述されるように、ウェブ・インストーラを使用して、OTRSを構成することです。