Установка из исходных кодов (Linux, Unix)

Шаг 1: Установите .tar.gz

Если вы решили устанавливать OTRS из исходных кодов, перейдите по ссылке http://www.otrs.com/try/ и загрузите архив с исходными кодами в любом удобном для вас формате: .tar.gz, .tar.bz2, или .zip

Распакуйте архив (например с помощью команды tar) в каталог /opt а затем переименуйте каталог otrs-x.x.x на otrs (см. ниже Сценарий ниже).

shell> tar xzf /tmp/otrs-x.x.x.tar.gz
shell> mv otrs-x.x.x /opt/otrs
        

Шаг 2: Установка дополнительных perl модулей

Используйте следующий скрипт для просмотра всех установленных и требующихся cpan модулей.

shell> perl /opt/otrs/bin/otrs.CheckModules.pl
o CGI..............................ok (v3.60)
o Crypt::PasswdMD5.................ok (v1.3)
o Crypt::SSLeay....................Not installed! (Optional - Required for Generic Interface SOAP SSL connections.)
o CSS::Minifier....................ok (v0.01)
o Date::Format.....................ok (v2.22)
o Date::Pcalc......................ok (v1.2)
...
            

Для установки недостающих модулей Perl можно:

а) Установить пакеты с помощью менеджера пакетов вашего дистрибутива Linux

  • For Red Hat, CentOS, Fedora или совместимые системы:

    shell> yum install "perl(Digest::MD5)"
                            

  • Для SUSE Linux Enterprise Server, openSUSE или совместимых систем: сначала определите имя пакета полученного модуля. Обычно, пакет для My::Module будет называться "perl-My-Module".

    shell> zypper search Digest::MD5
                            

    Затем установите:

    shell> zypper install perl-Digest-MD5
                            

  • Для Debian, Ubuntu или совместимых систем сначала определите имя пакета полученного модуля. Обычно, пакет для My::Module будет называться "libmy-module-perl".

    shell> apt-cache search Digest::MD5
                            

    Затем установите

    shell> apt-get install libdigest-md5-perl
                            

    Возможна ситуация, при которой вы не сможете найти все модули или их требуемые версии в вашем репозитарии, в этом случае вы можете выбрать для установки этих модулей способ через CPAN (смотри ниже).

b) Установите требуемые модули с помощью оболочки CPAN

Обратите внимание, что под Linux необходимо запускать CPAN от имени суперпользователя, потому что модули должны быть доступны через учетную запись OTRS и аккаунт под которым работает веб-сервер.

shell> perl -MCPAN -e shell;
...
install Digest::MD5
install Crypt::PasswdMD5
...
                

Любые дополнительные модули перечисленные в выводе скрипта должны устанавливаться в зависимости от специфических требований системы.

Шаг 3: Создайте пользователя OTRS

Создайте пользователя:

shell> useradd -d /opt/otrs -c 'OTRS user' otrs
            

Добавьте пользователя в группе веб-сервера (если веб-сервер работает не как пользователь OTRS):

shell> usermod -G www otrs
(SUSE=www, Red Hat/CentOS/Fedora=apache, Debian/Ubuntu=www-data)
            

Шаг 4: Активируйте Default Config Files

Есть два конфигурационных файла OTRS расположенных в $OTRS_HOME/Kernel/*.dist и $OTRS_HOME/Kernel/Config/*.dist. Скопируйте их без расширения ".dist".

shell> cd /opt/otrs/
shell> cp Kernel/Config.pm.dist Kernel/Config.pm
shell> cp Kernel/Config/GenericAgent.pm.dist Kernel/Config/GenericAgent.pm
    

Шаг 5: Проверьте, что все требуемые модули установлены

shell> perl -cw /opt/otrs/bin/cgi-bin/index.pl
/opt/otrs/bin/cgi-bin/index.pl syntax OK

shell> perl -cw /opt/otrs/bin/cgi-bin/customer.pl
/opt/otrs/bin/cgi-bin/customer.pl syntax OK

shell> perl -cw /opt/otrs/bin/otrs.PostMaster.pl
/opt/otrs/bin/otrs.PostMaster.pl syntax OK
            

"syntax OK" говорит о том, что все обязательные модули perl установлены.

Шаг 6: Настройка веб-сервера Apache

Сначала, вы должны установить веб-сервер Apache2 и mod_perl; это обычно делается с помощью системного менеджера пакетов. Ниже вы найдете команды, необходимые для установки Apache на наиболее распостраненные дистрибутивы Linux.

# rhel / centos:
shell> yum install httpd mod_perl

# suse:
shell> zypper install apache2-mod_perl

# debian/ubuntu:
shell> apt-get install apache2 libapache2-mod-perl2
        

To access the web interface of OTRS via a short URL, Alias and ScriptAlias entries are needed. Most Apache installations have a conf.d directory included. On Linux systems you can usually find this directory under /etc/apache or /etc/apache2. Log in as root, change to the conf.d directory and link the appropriate template in /opt/otrs/scripts/apache2-httpd.include.conf to a file called zzz_otrs.conf in the Apache configuration directory (to make sure it is loaded after the other configurations)..

Перестартуйте ваш веб-сервер для применения новых настроек. На большинстве систем рестарт веб-сервера выполняется командой /etc/init.d/apache2 restart.

Теперь веб-сервер полностью настроен для работы OTRS.

Шаг 7: Права доступа к файлам

Права доступа к файлам должны быть скорректированы, чтобы OTRS мог читать и писать файлы:

otrs.SetPermissions.pl [ --otrs-user= пользователь OTRS, по умолчанию - 'otrs' ] { --web-group= группа пользователей веб-сервера }

Например:

  • Web server работающий как пользователь OTRS:

    shell> bin/otrs.SetPermissions.pl --web-user=otrs
                    

  • Webserver с пользователем wwwrun (например в SUSE):

    shell> bin/otrs.SetPermissions.pl --web-group=wwwrun
                    

  • Webserver с пользователем apache (например, Red Hat, CentOS):

    shell> bin/otrs.SetPermissions.pl --web-group=apache
                    

  • Webserver с пользователем www-data (например, Debian, Ubuntu):

    shell> bin/otrs.SetPermissions.pl --web-group=www-data
                    

Шаг 8: Настройка СУБД и базовые настройки системы

Используйте веб установщик http://yourhost/otrs/installer.pl (замените "yourhost" именем вашего OTRS хоста) для установки вашей СУБД и выполнения базовых настроек системы, таких как почтовые учетные записи.

Шаг 9: Первый вход в систему

Теперь вы готов ко входу в систему по ссылке http://yourhost/otrs/index.pl с учетной записью созданной в веб установщике (пользователь: root@localhost).

На этом, начальная установка системы закончена.

Шаг 10: Первое электронное письмо

Чтобы проверить прием электронной почты, вы можете направить письмо непосредственно в /opt/otrs/bin/otrs.Postmaster.pl:

shell> cat /opt/otrs/doc/sample_mails/test-email-1.box | /opt/otrs/bin/otrs.PostMaster.pl
    

Шаг 11: Cronjobs для пользователя OTRS

В OTRS есть несколько стандартных заданий cron в файле /opt/otrs/var/cron/*.dist. Для их применения скопируйте их в файл, опустив в окончании его имени расширение ".dist".

shell> cd var/cron
shell> for foo in *.dist; do cp $foo `basename $foo .dist`; done
    

Для применения этих cronjobs в вашей системе можно использовать скрипт Cron.sh. Убедитесь, что вы запускаете от имени пользователя OTRS !

Первичное размещение заданий cronjobs:

shell> /opt/otrs/bin/Cron.sh start
    

Обновление заданий cronjobs, если вы делали изменения:

shell> /opt/otrs/bin/Cron.sh restart
    

Остановка cronjobs (полезно при техобслуживании):

shell> /opt/otrs/bin/Cron.sh stop
    

Обратите внимание: с версии OTRS 3.3.7 OTRS Scheduler/Планировщик использует cronjob для запуска и поддержки. Убедитесь, что scheduler_watchdog задание cronjob активировано.

Шаг 12: Дополнительная информация

Мы советуем вам ознакомиться с раздел настройки производительности.

При обнаружении проблем при установке, вы можете послать сообщение на наш otrs@otrs.org (http://lists.otrs.org/).

Вы, также, можете послать запрос в OTRS Group на помощь в планировании или развертывании OTRS или проверки установленной системы. Наши профессиональные услуги предназначены для того, чтобы помочь вам быстрее развернуть систему и получить наибольшую выгоду от OTRS.