OTRS 安装手册 - 点通软件 Manual/OTRS...Copyright © 2015 -2018 西安点通软件信息技术有限公司 4 / 18 2. 启动 MySQL 数据库服务器使用下面命令，启动

Copyright © 2015 -2018 西安点通软件信息技术有限公司 1 / 18

OTRS 安装手册

OTRS 中国版、OTRS 社区版 5.0.x

操作系统：Centos 7.x

作者：小点

西安点通软件信息技术有限公司

2018 年 01 月 15 日

V2.0.0


目录

1 概述 .................................................................................................................................. 3

2 docker 版安装 ................................................................................................................... 3

2.1 准备 docker 运行环境 ............................................................................................... 3

2.2 准备数据库服务器 ..................................................................................................... 3

2.3 启动 OTRS ............................................................................................................... 4

3 在主机上安装 ..................................................................................................................... 5

3.1 安装并配置 MySQL................................................................................................... 5

3.2 安装并配置 Apache .................................................................................................. 8

3.3 安装 OTRS 中国版或 OTRS 5.0.x ................................................................................ 9

4 系统初始化 ...................................................................................................................... 14


1 概述

此文档通过图文方式，详细讲解了如何在 Linux 系统中搭建环境、安装 OTRS 中国版，OTRS5.0.x 和

安装系统模块等步骤。其中包括两种安装方法：docker 版安装及在主机上直接安装。

2 docker 版安装

2.1 准备 docker 运行环境

注：已有 docker 运行环境，请略过本步。

使用以下命令安装 docker 运行环境，并设置自动启动：

# yum install -y yum-utils device-mapper-persistent-data lvm2

# yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# yum makecache fast

# yum install -y docker-ce

# systemctl start docker

# chkconfig --levels 235 docker on

2.2 准备数据库服务器

注：已有 MySQL 或其他数据库服务器，请直接前往执行 2.3 步

【提示】使用 docker 方式启动 MySQL 数据库需要从 docker hub 上下载镜像，如果下载速度较

慢，可以选择从点通软件服务器上直接下载镜像 tar 包，并导入镜像，再执行下面步骤：

更多版本下载地址请参考 OTRS 中国版论坛：www.otrs-china.org

# wget http://www.dian-tong.com/downloads/mysql-docker-image/mysql-5.7.20-docker-image.tar

# docker load -i mysql-5.7.20-docker-image.tar

1. 获取 MySQL 配置文件

将 OTRS 所需的 MySQL 配置文件 my.cf 文件放到本地目录中，例如：/root/docker- mysql/，把该

文件通过 volumes 挂载到 MySQL 数据库容器中。

# wget http://www.dian-tong.com/downloads/mysql-docker-image/my.cnf

【提示】考虑到数据持久化，建议把数据库容器的数据存储映射到本地磁盘中具体操作可参考：

https://hub.docker.com/_/mysql/

https://download.docker.com/linux/centos/docker-

http://www.otrs-china.org/

http://www.dian-tong.com/downloads/mysql-docker-image/mysql-5.7.20-docker-image.tar%20%20%20%20%20l

https://hub.docker.com/_/mysql/


2. 启动 MySQL 数据库服务器

使用下面命令，启动 MySQL 数据库服务器：

# docker run -itd --restart always --name otrs_mysql \

-v /root/docker-mysql/:/etc/mysql/conf.d/ \

-e MYSQL_ROOT_PASSWORD=[pass] mysql:5.7.20

[pass] 是 MySQL 数据库服务器的 root 密码

2.3 启动 OTRS

【提示】使用 docker 方式启动 OTRS 需要从 docker hub 上下载镜像，如果下载速度较慢，可以选

择从点通软件服务器上直接下载镜像 tar 包，并导入镜像，再执行下面步骤：

更多版本下载地址请参考 OTRS 中国版论坛：www.otrs-china.org

# wget http://www.dian-tong.com/downloads/otrs-china-1.0.12/otrs-china-1.0.12-docker-image.tar

# docker load -i /root/otrs-china-1.0.12-docker-image.tar

1. 如果使用了 MySQL 容器的安装

启动 OTRS 容器时链接 MySQL 容器：

# docker run -itd --restart always -p 80:80 --name otrs_china \

--link otrs_mysql:mysql \

otrschina/otrschina:[tag]

--link otrs_mysql:mysql 链接 MySQL 容器

--restart always 在 docker 启动时，自动重启 OTRS 容器

-p 80:80 将容器内 80 端口映射到宿主机上 80 端口

[tag] 填写中国版的版本号（如：1.0.12）或为空，默认为 latest

2. 如果使用已有数据库服务器：

# docker run -itd --restart always -p 8080:80 --name otrs_china \

otrschina/otrschina:[tag]

完成后转第 4 步进行系统初始化。

http://www.otrs-china.org/


3 在主机上安装

3.1 安装并配置 MySQL

在安装 OTRS 之前需要搭建运行环境，这里需要声明：大部分的操作都是在命令行中。

1. 安装需要的公共模块

yum -y install epel-release wget vim gcc make

2. 安装 MySQL 数据库。输入以下命令进行安装：

# cd /usr/local

# mkdir mysql

# cd mysql

# wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm

# rpm -ivh mysql-community-release-el7-5.noarch.rpm

# yum -y install mysql-server mysql-devel

3. 添加 MySQL 开机自启动并启动：

http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm


# chkconfig --levels 235 mysqld on

# service mysqld start

4. 设置 Mysql 的 root 密码

# mysql_secure_installation （按下 Enter 键，根据提示输入密码）

5. 设置远程连接

# mysql -u root –p

# grant all on *.* to 'user'@'%' IDENTIFIED BY 'password'; （User 为授权的用户 password 为密码）

# FLUSH PRIVILEGES;

# exit


6. 设置 Apache 连接 MySQL

# setsebool httpd_can_network_connect=1

7. 设置 MySQL 允许包的大小

# vim /etc/my.cnf

# max_allowed_packet=64M

# innodb_log_file_size=256M

# query_cache_size=32M

8. 删除 mysql 日志并重启

# rm -rf /var/lib/mysql/ib_*

# service mysqld restart


3.2 安装并配置 Apache

1. 安装 Apache

# yum -y install httpd

2. 添加 Apache 开机自启动并启动

# chkconfig --levels 235 httpd on

# service httpd restart

3. 关闭 SELinux

# vi /etc/selinux/config

# SELINUX=disabled


4. 关闭防火墙

# systemctl disable firewalld

5. 重启 Apache


3.3 安装 OTRS 中国版或 OTRS 5.0.x

下载系统包运行环境搭建完成后，接下来开始安装 OTRS-5.0.1 系统。上传安装包到 opt 目录。

# cd /opt

解压安装包

# tar -xzvf otrs-5.0.1.tar.gz

修改文件名

# mv otrs-5.0.1 otrs

1. 检查所需模块并安装

1) 安装 Perl


# yum install perl

2) 安装 cpan

# yum install cpan

3) 检查所需模块

# cd /opt/otrs/bin

# perl /opt/otrs/bin/otrs.CheckModules.pl

4) 安装所需模块

# yum install "perl(Archive::Tar)"

# yum install "perl(Archive::Zip)"

# yum install "perl(Crypt::Eksblowfish::Bcrypt)"

# yum install "perl(Crypt::SSLeay)"

# yum install "perl(Date::Format)"

# yum install "perl(Encode::HanExtra)"

# yum install "perl(GD)"

# yum install "perl(GD::Text)"

# yum install "perl(GD::Graph)"

# yum install "perl(IO::Socket::SSL)"

# yum install "perl(ModPerl::Util)"

# yum install "perl(Net::DNS)"

# yum install "perl(Net::LDAP)"

# yum install "perl(PDF::API2)"

# yum install "perl(Template)"

# yum install "perl(Template::Stash::XS)"

# yum install "perl(Text::CSV_XS)"

# yum install "perl(Time::HiRes)"

# yum install "perl(Time::Piece)"

# yum install "perl(XML::Parser)"

# yum install "perl(YAML::XS)"

# yum install "perl(DBD::Pg)"

注：如遇到无法安装的文件，请运行下列命令

# yum -y install epel-release

# yum install "perl(Archive::Tar)"（重新使用 yum 命令依次安装 perl 模块）

安装完成后，应达到下图效果。


2. 创建 OTRS 用户

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

3. 激活配置文件

# cd /opt/otrs/Kernel

# cp Config.pm.dist Config.pm

4. 检查重要文件

# perl -cw /opt/otrs/bin/cgi-bin/index.pl

# perl -cw /opt/otrs/bin/cgi-bin/customer.pl

# perl -cw /opt/otrs/bin/otrs.PostMaster.pl


5. 配置 Apache

# vi /etc/httpd/conf/httpd.conf

# Include conf.d/*.conf (在这个底下添加下面这段话，/+“搜索的内容“，可以快速定位)

# Include /opt/otrs/scripts/apache2-httpd.include.conf

# User apache (找个这个内容后，将 apache 修改为 otrs)



6. 文件授权

# perl /opt/otrs/bin/otrs.SetPermissions.pl --web-group=apache

完成后，重启机器。按照文档后续步骤完成安装

# shutdown –r now


4 系统初始化

1) 在浏览器中输入以下地址：

http://HOSTNAME/otrs/installer.pl

2) 按下图顺序初始化系统配置：

http://127.0.0.1:50080/otrs/installer.pl


（注意：若使用 docker 版安装的话，主机写数据库容器名称）



注意：

如果 installer.pl 页面报错，请先查看 apache 日志。

如果 apache 日志错误信息如下图所示的话，请使用下列方法解决问题。

日志信息：

解决方法：

# yum install "perl(Sys::Syslog)"

3) 修改登录密码

如果需要可以通过命令修改登录密码：


# su otrs

# cd /opt/otrs/bin

# ./otrs.Console.pl Admin::User::SetPassword root@localhost 123456

4) 登录界面

Agent 登录界面访问地址：http://HOSTNAME/otrs/index.pl，如下图所示：

西安点通软件信息技术有限公司

http://www.dian-tong.com

http://www.dian-tong.com/

Documents

OTRS 安装手册 - 点通软件 Manual/OTRS...Copyright © 2015 -2018 西安点通软件信息技术有限公司 4 / 18 2. 启动 MySQL 数据库服务器 使用下面命令，启动

OTRS 安装手册 - 点通软件 Manual/OTRS...Copyright © 2015 -2018 西安点通软件信息技术有限公司 4 / 18 2. 启动 MySQL 数据库服务器使用下面命令，启动