Book:OTRS 3.0 - Admin Manual (ja)/Chapter 3/2

ソースインストールの準備作業
OTRS をソースからインストールする場合は、まず最初に .tar.gz、.tar.bz2 または .zip ファイル形式のソースアーカイブを http://www.otrs.org/downloads/ からダウンロードします.

アーカイブをディレクトリ  に解凍し、ディレクトリ名を otrs-3.0 から otrs に変更します. tar 形式のアーカイブの例を以下に示します （スクリプト 3.4 参照）.

OTRS を root 権限で動作させるべきではありません. そこで次にすべきことは、OTRS 用に新規ユーザを作成することです. この新規ユーザのホームディレクトリは  でなければなりません. Web サーバが新規 'otrs' ユーザと同じユーザ権限で動作しているのでなければ （ほとんどのシステムでは動作していないでしょう）、新規 'otrs' ユーザを Web サーバユーザグループに追加します （スクリプト 3.5 参照）.

次に、サンプル設定ファイルをコピーします. 後の段階でシステムはこの複写した設定ファイルを使用します. 複写元ファイルの拡張子は .dist で、ディレクトリ  と   にあります （スクリプト 3.6 参照）.

OTRS インストール準備作業の最後のステップは、全てのファイルに正しいアクセス権を設定することです. この作業は、'otrs' ユーザのホームディレクトリ配下の bin ディレクトリにある、スクリプト otrs.SetPermissions.pl を使用して行います. このスクリプトは以下のパラメータを設定して実行します:



もしシステムの Web サーバがユーザ 'otrs' と同じ権限で動作している場合は、正しいアクセス権を設定するコマンドは otrs.SetPermissions.pl /opt/otrs --otrs-user=otrs --web-user=otrs となります. SUSE システムでは Web サーバは ’wwwrun' ユーザの権限で動作しています. Debian 系のシステムでは 'www-data' です. 従って正しいアクセス権を設定するコマンドは、例えば otrs.SetPermissions.pl /opt/otrs --otrs-user=otrs --web-user=wwwrun --otrs-group=nogroup --web-group=www のようになります.

Perl モジュールのインストール
OTRS が動作するためには、表 3-1 に示す Perl モジュールを追加インストールする必要があります. OTRS をソースからインストールする場合には、これらのモジュールを手作業でインストールする必要があります. このインストールは、Linux ディストリビューションのパッケージマネージャ （yast や apt-get 等） を使用するか、または本セクションで説明する、Perl シェルと CPAN を使用するやり方で行います. 例えば Windows 用の ActiveState Perl を使用する場合は、組み込み Perl パッケージマネージャの PPM を使用します. もし可能であれば、パッケージマネージャを使用することを推奨します.

otrs.CheckModules.pl でインストールする必要のあるモジュールを確認できます. このスクリプトは 'otrs' ユーザホームディレクトリ配下の bin ディレクトリにあります （スクリプト 3.7 を参照）.

いくつかのモジュールのインストールはオプションであることに注意してください.

不足しているモジュールは、できる限り Linux ディストリビューションのパッケージ管理システムからインストールすべきです. この方法でインストールすると、バージョンアップやセキュリティーパッチが提供された際に、パッケージが自動的に更新されます. 追加パッケージをインストールする方法については、ディストリビューションのマニュアルを参照してください. パッケージリポジトリに （正しいバージョンの） モジュールがない場合は、CPAN （Comprehensive Perl Archive Network） からインストールすることもできます.

上記のモジュールの一つを CPAN からインストールするには、コマンド perl -e shell -MCPAN を実行します. Perl シェルが対話モードで起動した後、CPAN モジュールがロードされます. 既に CPAN が設定済みの場合は、コマンド install に続けてモジュール名を入力するとモジュールをインストールできます. CPAN は他の Perl モジュールとの依存関係をチェックし、他のモジュールをインストールする必要がある場合は通知します.

さらに、ディレクトリ  に移動しコマンド perl -cw bin/cgi-bin/index.pl および perl -cw bin/otrs.PostMaster.pl を実行します. これらのコマンドの出力が "syntax OK" であれば、Perl は正しく導入されています （スクリプト 3.8 参照）.

Apache Web サーバの設定
本節では、Apache Web サーバと mod_cgi の OTRS 向け設定について説明します. Web サーバは CGI スクリプトが実行可能になっていなければなりません. OTRS は Perl スクリプトが構文解析できないと動作しません. Web サーバの設定ファイルを調べて、CGI モジュールがロードしている行を探してください. 以下のような行があれば、CGI モジュールは既に使用可能になっています.

LoadModule cgi_module /usr/lib/apache2/modules/mod_cgi.so

OTRS の Web インターフェイスに短いアドレスで便利にアクセスできるように、Alias および ScriptAlias エントリを定義する必要があります. 大部分の Apache 導入システムには conf.d ディレクトリがあります. Linux システムでこのディレクトリを探してください （おそらく  または   の配下にあります）. root 権限でログインして  ディレクトリに移動し、code>/opt/otrs/scripts/apache2-httpd.include.conf の中の適切なテンプレートを Apache 設定ディレクトリに   として複写してください.

Web サーバを再起動して新しい設定をロードします. 大部分のシステムではコマンド /etc/init.d/apache2 restart で Web サーバを起動・再起動できます （スクリプト 3.11 参照）.

これで Web サーバは OTRS 用に設定されました.

もし mod_perl をインストール可能であれば、mod_cgi の替わりに Apache Web サーバを mod_perl を使用する設定にしてパフォーマンスを改善できます. これは以下のように行います:

Please ensure that mod_perl is installed and loaded, in order to take advantage of this feature. Due to the nature of the start-up script, your server will not fail to start if mod_perl is not properly loaded or compiled in your apache web server, unless mod_cgi is also on. Technically speaking you can leave mod_cgi on as well, but you should not.

Search your /etc/apache* directory for mod_perl.so (see Script 3.12 below) to see if the module is already loaded.

When you use the appropriate start script listed above and the module is loaded, the script (when commented in) /opt/otrs/scripts/apache2-perl-startup.pl can be used to load the perl modules into memory one time, saving on load times and increasing performance.

The simple way - Using the web installer (works only with MySQL)
If you use MySQL as the database back-end, you can use the OTRS web installer:

http://localhost/otrs/installer.pl

When the web installer starts, please follow the next steps to setup your system:

  Check out the information about the OTRS offices and click on next to continue (see Figure 3.1 below).



 Read the GNU Affero General Public License (see Figure 3.2 below) and accept it, by clicking the corresponding button at the bottom of the page.



 Provide the username and password of the administrator, the DNS name of the computer which hosts OTRS and the type of database system to be used. After that, check the settings (see Figure 3.3 below).

If the checking was successful, you will get a notification. Press OK to continue (see Figure 3.4 below).



 Create a new database user, choose a name for the database and click on next (see Figure 3.5 below).

If the database and its user were successfully created, you will get a setup notification, as shown in the Figure 3.6. Click next to go to the next screen.



 Provide all the required system settings and click next (see Figure 3.7 below).



 If you want, you can provide the needed data to configure your inbound and outbound mail or skip this step by pressing the right button at the bottom of the screen (see Figure 3.8 below).



 Restart the OTRS service now, to use the new configuration settings shown in the Script 3.13.



 Congratulations! Now the installation of OTRS is finished and you should be able to work with the system (see Figure 3.9 below). To log into the web interface of OTRS, use the address http://localhost/otrs/index.pl in your web browser. Log in as OTRS administrator, using the username root@localhost and the password root. After that you can configure the system for your needs.

</li> </ol>

Installing the OTRS database manually
If you can't use the web installer to setup the OTRS database, you have to set it up manually. Scripts with the SQL statements to create and configure the database are located in scripts/database, in the home directory of the OTRS user (see Script 3.14 below).

To setup the database for the different database back-ends the .sql files must be processed in a special order.

 Create the OTRS database manually step by step 
 * 1) Creating the DB: Create the database, that you want to use for OTRS, with your database client or your database interface.
 * 2) Creating the tables: With the otrs-schema.DatabaseType.sql files (e.g.. otrs-schema.oracle.sql, otrs-schema.postgresql.sql) you can create the tables in your OTRS database.
 * 3) Inserting the initial system data: OTRS needs some initial system data to work properly (e.g. the different ticket states, ticket and notification types). Depending on the type of your database Use one of the files otrs-initial_insert.mysql.sql, otrs-initial_insert.db2.sql, otrs-initial_insert.oracle.sql, otrs-initial_insert.postgresql.sql or otrs-initial_insert.mssql.sql.
 * 4) Creating references between tables: The last step is to create the references between the different tables in the OTRS database. Use the otrs-schema-post.DatabaseType.sql file to create these (e.g. otrs-schema-oracle.post.sql, otrs-schema-post.postgresql.sql).

After you have finished the database setup you should check and set proper access rights for the OTRS database. It should be enough to grant access to one user. Depending on the database server you are using, setting up the access rights differs, but it should be possible either with your database client or your graphical database front-end.

If your database and the access rights are configured properly, you have to tell OTRS which database back-end you want to use and how the ticket system can connect to the database. Open the file Kernel/Config.pm located in the home directory of the OTRS user and change the parameters shown in the Script 3.15 to your needs.

Setting up the cron jobs for OTRS
OTRS needs some cron jobs to work properly. The cron jobs should be run with the same user rights that were specified for the OTRS modules. That means that the cron jobs must be inserted into the crontab file of the OTRS user.

All scripts with the cron jobs are located in var/cron, in the home directory of the OTRS user (see Script 3.16 below).

All scripts are ending in .dist. You should copy them to files with no ending. If you are using bash, you might want to use the command listed in Script 3.17 below.

Table 3-2 describes the different cron jobs and what they do.

To setup all cron jobs the script bin/Cron.sh can be used, which is located in the home directory of the OTRS user. When this script is executed, it needs a parameter to tell if you want to install, remove or reinstall the cron jobs. The following parameters can be used:

Because the cron jobs need to be installed in the crontab file of the OTRS user, you need to be logged in as OTRS user. If you are logged in as root, you can change to the OTRS user with the command su otrs. Execute the commands specified in the Script 3.18 below to install the cron jobs.

The command crontab -l -u otrs, which can be executed as root, shows you the crontab file of the OTRS user and you can check if all entries are right (see Script 3.19 below).