Chapter 2. Установка

В качестве базы данных, можно использовать MySQL, PostgreSQL, Oracle or Microsoft SQL Server. Наиболее распостраненной СУБД для использования с OTRS является MySQL. Эта глава описывает шаги необходимые для настройки MySQL на сервер с ОС SUSE. Конечно, вы можете установить СУБД на выделенных сервер баз данных, если это необходимо для масштабируемости или других целей.

Установите MySQL с использованием следующей команды с правами пользователя root:

        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 СУБД, удаления анонимного доступа и удаления тестовой базы данных. Наконец, исполните chkconfig -a mysql для проверки настройки автоматического запуска mysql одновременно со стартом сервера.

Установите OTRS с использованием zypper из командной строки. При этом будут выполнены связанные задачи, такие как установка веб-сервера Apache и ряд модулей Perl. Убедитесь, что 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, вступили в силу - перезагрузите веб-сервер используя команду из Сценария приведенного ниже. Также выполните chkconfig для уверенности в том, что OTRS автоматически стартует при перезагрузке сервера.

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. Вы можете доустановить их вручную. Выяснить, какие дополнительные модули требуются, можно с помощью скрипта bin/otrs.CheckModules.pl размещенного в каталоге /opt/otrs. Некоторые модули требуются только в случае включения дополнительных опций, например для взаимодействия с серверами IMAP(S) или вывода в формате PDF. При использовании SLES необходимо подключить внешнее хранилище для конфигурации zypper для доступа к модулям, требующимся вашей системе. Выберите модуль для вашей версии ОС отсюда: http://download.opensuse.org/repositories/devel:/languages:/perl/. Добавьте репозиторий, например, для SLES 11 SP2:

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

В ОС openSUSE 12.3, внешний репозиторий требуется только для модуля Mail::IMAPClient, который необходим в случае, если вы забираете почту с сервера IMAP с TLS. Соответствующая строка будет выглядеть так:

            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. Наиболее популярной является MySQL. Эта глава показывает необходимые шаги для настройки MySQL на сервер с RHEL. Конечно, вы можете установить СУБД на выделенный сервер баз данных в целях масштабируемости или иных других.

Установите MySQL с использованием следующей команды с правами пользователя root:

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

Будет установлена MySQL со стандартными настройками. Необходимо сделать некоторые изменения, для лучшей совместимости с OTRS. С помощью текстового редактора откройте файл /etc/my.cnf добавьте следующие две строки в секции [mysqld]:

        max_allowed_packet=20M
        query_cache_size=32M
    

Теперь выполните rcmysql restart для рестарта сервера баз данных и включения сделанных изменений. Затем выполните /usr/bin/mysql_secure_installation и следуйте инструкцим на экране для установки пароля для пользователя root СУБД, удаления анонимного доступа и удаления тестовой базы данных. Наконец, исполните chkconfig -a mysql для проверки настройки автоматического запуска mysql одновременно со стартом сервера.

Установите OTRS с использованием yum из командной строки. При этом будут выполнены связанные задачи, такие как установка веб-сервера 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 запущен и будет всегда стартовать при любой презагрузке сервера.

[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. Вы можете доустановить их вручную. Выяснить, какие дополнительные модули требуются, можно с помощью скрипта bin/otrs.CheckModules.pl размещенного в каталоге /opt/otrs. Некоторые модули требуются только в случае включения дополнительных опций, например для взаимодействия с серверами IMAP(S) или вывода в формате PDF. На среверах с Red Hat или CentOS мы рекомендуем устанавливать эти модули из репозитория EPEL, который поддерживается проектом Fedora и производит высококачественные пакеты для RHEL и его ответвлений. Более подробно см. на EPEL web сайт.

Если вы работаете на RHEL 6 или CentOS 6, ниболее свежие пакеты для EPEL можно загрузить с этого сайта. Вы можете добавить этот репозиторий к yum в один шаг, копированием RPM URL, которую вы найдете на этой странице, и выполнив эту команду:

 [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 драйвер для базы данных. Это немного сложнее чем установка других пакетов, т.к. Oracle является проприетарной СУБД и, так же как ни Red Hat ни CentOS, не разрешает публикацию драйверов в своих RPM репозиториях.

Прежде всего необходимо установить gcc, make и CPAN, после чего можно приступить к компиляции и установке драйвера. Ниже приведена команда для CentOS; для других версий она может выглядеть несколько иначе.

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

Следующим шагом является получение и установка клиента базы данных. Для этого надо зарегистрироваться и получить свободный аккаунт на сайте Oracle. Вы можете загрузить драйверы с этой страницы: http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html Выберите версию для Linux x86 или x86-64, в зависимости от вашей системы. Вы можете узнать это с помощью команды uname -i. Это будет 'x86_64' для x86-64 или 'i386' для x86. Загрузите пакеты 'Instant Client Package - Basic', 'Instant Client Package - SQL*Plus', и 'Instant Client Package - SDK'. Сохраните их себе на диск. Теперь, от имени пользователя root вы можете установить пакеты с помощью следующей команды:

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

После этого нужно задать значения двум переменным окружения и скомпилировать 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.
        

Теперь, надо отредактировать файл Kernel/Config.pm для установки параметра ORACLE_HOME. Следующим шагом является настройка OTRS с помощью веб - установщика, как описано в в этом разделе.