Установка OTRS

Подробное описание установки и настройки очень хорошо описано в штатной документации.

Официальная документация: http://otrs.github.io/doc/

Установка OTRS на системы Debian или Ubuntu

Установите OTRS из исходного кода, и не используйте предоставленные Debian/Ubuntu пакеты для OTRS.

 

Установка требуемых модулей Perl:

apt-get install libapache2-mod-perl2 libdbd-mysql-perl libtimedate-perl libnet-dns-perl libnet-ldap-perl libio-socket-ssl-perl libpdf-api2-perl libdbd-mysql-perl libsoap-lite-perl libgd-text-perl libtext-csv-xs-perl libjson-xs-perl libgd-graph-perl libapache-dbi-perl

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

Шаг 1: Загрузите архив .tar.gz

Перейдите по ссылке http://ftp.otrs.org/pub/otrs/, выберите нужную версию и скопируйте ссылку. В командной строке выполните:

# cd /tmp
# wget http://ftp.otrs.org/pub/otrs/otrs-x.x.x.tar.gz

Или перейдите по ссылке http://www.otrs.com/try/ и загрузите архив с исходными кодами в любом удобном для вас формате: .tar.gz, .tar.bz2, или .zip
Распакуйте архив (например с помощью команды tar) в каталог /opt а затем переименуйте каталог otrs-x.x.x на otrs.

# cd /opt
# tar xzf /tmp/otrs-x.x.x.tar.gz
# mv otrs-x.x.x /opt/otrs

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

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

# 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

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

# apt-cache search Digest::MD5

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

# apt-get install libdigest-md5-file-perl

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

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

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

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

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

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

# useradd -d /opt/otrs/ -c 'OTRS user' otrs

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

# usermod -G www-data 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".

# cd /opt/otrs/
# cp Kernel/Config.pm.dist Kernel/Config.pm
# cp Kernel/Config/GenericAgent.pm.dist Kernel/Config/GenericAgent.pm

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

# perl -cw /opt/otrs/bin/cgi-bin/index.pl
/opt/otrs/bin/cgi-bin/index.pl syntax OK
# perl -cw /opt/otrs/bin/cgi-bin/customer.pl
/opt/otrs/bin/cgi-bin/customer.pl syntax OK
# perl -cw /opt/otrs/bin/otrs.PostMaster.pl
/opt/otrs/bin/otrs.PostMaster.pl syntax OK

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

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

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

# apt-get install apache2 libapache2-mod-perl2

Для доступа к OTRS по короткому URL скопируйте в директорию /etc/apache2/conf.d или /etc/apache2/conf-available необходимый шаблон /opt/otrs/scripts/apache2-httpd.include.conf в файл zzz_otrs.conf (что бы он загружался последним).
Если используется Apache 2.4 и соответственно путь /etc/apache2/conf-available, выполните:

# a2enconf zzz_otrs.conf

Перегрузите ваш веб-сервер для применения новых настроек:

# service apache2 reload

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

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

Права доступа к файлам должны быть скорректированы, чтобы OTRS мог читать и писать файлы:
otrs.SetPermissions.pl [ --otrs-user= пользователь OTRS, по умолчанию - 'otrs' ] { --web-group= группа пользователей веб-сервера }
Например:
Webserver с пользователем www-data (например, Debian, Ubuntu):

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

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

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

На этом этапе должен быть установлен MySQL сервер. Понадобится пароль от учетной записи root.

Если нужно дать разрешение пользователю root на удаленный вход, а не только с локального хоста, например, для входа в phpmyadmin, войдите в консоль mysql

# mysql -u root -p

и выполните команду:

mysql> GRANT  ALL PRIVILEGES ON *.* TO 'root'@'%';

выход:

\q

После ввода пароля учетной записи пользователя MySQL в веб форме установщика нажмите кнопку "Check database settings". Если все нормально, жмите NEXT.

Может возникнуть ошибка:
Error: Please make sure your database accepts packages over 20 MB in size (it currently only accepts packages up to 16 MB). Please adapt the max_allowed_packet setting of your database in order to avoid errors.

В этом случае отредактируйте файл настроек MySQL /etc/mysql/my.cnf и поставьте значение

max_allowed_packet    = 50M

Перезагрузите MySQL:

service mysql restart

При появлении ошибки:
Error: Please set the value for innodb_log_file_size on your database to at least 256 MB (current: 5 MB, recommended: 512 MB). For more information, please have a look at http://dev.mysql.com/doc/refman/5.6/en/innodb-data-log-reconfiguration.html.

Войдите в консоль MySQL под root'ом

# mysql -u root -p

и выполните:

mysql> SET GLOBAL innodb_fast_shutdown = 1;

Остановите MySQL сервер:

# service mysql stop

Переместите файлы ib_logfile0, ib_logfile1, ib_logifleN из /var/lib/mysql в другую директорию, на всякий случай или просто удалите их.

Отредактируйте файл настроек MySQL /etc/mysql/my.cnf и добавьте значение:

innodb_log_file_size    = 512M

Запустите MySQL:

service mysql start

После устранения всех замечаний нажмите NEXT.

Укажите все необходимые настройки системы и почты и нажмите кнопку 'Далее'
OTRS-installation

Сохраните пароль от учетной записи в надежном месте.

OTRS-install-fin

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

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

Если все нормально вы увидите что-то вроде этого:

OTRS-inst-ok

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

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

# 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":

# cd /opt/otrs/var/cron
# for foo in *.dist; do cp $foo `basename $foo .dist`; done

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

# /opt/otrs/bin/Cron.sh start www-data

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

# /opt/otrs/bin/Cron.sh restart www-data

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

# /opt/otrs/bin/Cron.sh stop

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

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

Ознакомьтесь с разделом настройки производительности http://otrs.github.io/doc/manual/admin/4.0/ru/html/performance-tuning.html

Вход в интерфейс пользователя "Личный кабинет" по ссылке: http://yourhost/otrs/customer.pl
Но для этого сначала нужно создать пользователей или подключить базу данных с пользователями.

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

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

 

Закладка Постоянная ссылка.

Добавить комментарий

Ваш e-mail не будет опубликован.

*