本页内容
- 先决条件
- 安装软件包依赖
- 安装 Perl 依赖
- 为 OTRS 配置数据库
- 下载并配置 OTRS 社区版
- 为 OTRS 配置 Apache 虚拟主机
- 安装 OTRS
- 完成 OTRS 安装
- 结论
OTRS 社区版是一款用 Perl 编写的开源帮助台软件。OTRS 是一个基于 Web 的工单系统,用于客户服务、IT 服务管理和帮助台。
OTRS 是一套灵活的工单系统和服务管理套件。它提供服务人员门户、管理仪表盘和客户门户。
在本文中,你将学习如何在 Rocky Linux 系统上安装 OTRS 社区版。你将使用 MariaDB 数据库和 Apache Web 服务器来安装 OTRS。
先决条件
这是一份逐步操作指南,请确保你已满足以下要求:
- 操作系统:Rocky Linux 8.4 (Green Obsidian)
- 内存:2GB(用于小规模部署)
- IP 地址:192.168.1.10
- 域名:example.io(用于生产环境)
现在开始安装。
安装软件包依赖
首先,你将在 Rocky Linux 系统上安装一些基础的软件包依赖。你将安装 EPEL 仓库、Perl、httpd 和 MariaDB 软件包。
1. 运行下面的 DNF 命令来安装 EPEL 仓库。
sudo dnf install epel-release -y
2. EPEL 仓库安装完成后,安装 GCC 和 Perl 软件包。
sudo dnf install gcc expat-devel perl perl-core procmail -y
3. 接着,使用以下命令安装 httpd Web 服务器和 MariaDB 数据库。
sudo dnf install httpd mariadb-server mod_perl
输入 ' y ' 确认并按 ' Enter ' 键继续安装。
MariaDB 安装完成后,使用 nano 编辑器编辑配置文件 ' /etc/my.cnf.d/mariadb-server.cnf '。
nano /etc/my.cnf.d/mariadb-server.cnf
将以下配置复制并粘贴到 '[mysqld]' 段落下。
[mysqld] max_allowed_packet=256M character-set-server=utf8 collation-server=utf8_general_ci innodb_buffer_pool_size=4G innodb_log_file_size=1G
保存配置并退出。
4. 现在使用以下命令启动并启用 httpd 和 MariaDB 服务。
sudo systemctl enable --now httpd
sudo systemctl enable --now mariadb
现在进入下一步,安装额外的 Perl 依赖并设置 MariaDB 数据库。
安装 Perl 依赖
OTRS 项目用 Perl 编写,你必须从 Comprehensive Perl Archive Network (CPAN) 仓库安装一些 Perl 依赖。
要从 CPAN 仓库安装软件包,请使用 cpan 命令。
1. 执行下面的 cpan 命令来安装 OTRS 所需的 Perl 依赖。
sudo cpan Net::DNS Moo Date::Format DateTime Text::CSV_XS XML::Parser XML::LibXML JSON::XS YAML
sudo cpan Crypt::PasswdMD5 CSS::Minifier CGI Template YAML::XS
sudo cpan Crypt::Eksblowfish::Bcrypt
2. 接着,你可以使用下面的 cpan 命令安装一些可选的 Perl 依赖。
sudo cpan DBD::Pg Mail::IMAPClient Authen::SASL XML::LibXSLT
现在进入下一步,设置 MariaDB 数据库,然后安装 OTRS。
为 OTRS 配置数据库
在此步骤中,你将为 MariaDB 设置 root 密码,并为 OTRS 安装创建一个新的数据库和用户。
你可以使用命令 ' mysql_secure_installation ' 来为 MariaDB 服务器配置 root 密码。
1. 使用以下命令设置 MariaDB 的 root 密码。
mysql_secure_installation
为 MariaDB root 用户输入新密码,并输入 ' y ' 确认所有建议的配置。
2. 接着,使用下面的 mysql 命令登录 MariaDB shell。
mysql -u root -p
输入 MariaDB root 用户的密码。
3. 接着,执行以下查询来创建新数据库 ' otrs ' 和用户 ' otrs '。请务必修改密码。
create database otrs;
grant all privileges on otrs.* to otrs@localhost identified by 'PasswordOtrs';
flush privileges;
现在输入 ' exit ' 并按 ' Enter ' 键退出 MariaDB shell。

你已经准备好在系统上安装 OTRS 了。
下载并配置 OTRS 社区版
在此步骤中,你将下载 OTRS 社区版并对其进行安装前的配置。
1. 首先,使用以下命令创建一个新的系统用户 'otrs'。
adduser -M -r -s /sbin/nologin otrs
现在运行下面的命令,将用户 'otrs' 添加到 'apache' 组。
usermod -aG apache otrs
2. 接着,将当前工作目录切换到 '/opt',并使用下面的 wget 命令下载 OTRS 源代码。
cd /opt
wget https://otrscommunityedition.com/download/otrs-community-edition-6.0.32.tar.gz
OTRS 下载完成后,解压 OTRS 源代码并将目录重命名为 'otrs'。
tar -xf otrs-community-edition-6.0.32.tar.gz
mv otrs-community-edition-*/ otrs/
3. 在开始安装 OTRS 之前,请确保系统上已具备 OTRS 所需的所有 Perl 模块和依赖。
将工作目录切换到 '/opt/otrs',并执行 Perl 脚本 'otrs.CheckModules.pl '。
export OTRS=/opt/otrs
cd $OTRS
perl bin/otrs.CheckModules.pl
脚本 ' otrs.CheckModules.pl ' 会对 OTRS 安装所需的所有 Perl 依赖进行系统检查。
确保系统上已安装所有必需的 Perl 模块。你可以按照消息输出中提示的命令安装可选的 Perl 模块。
下面是你将看到的类似输出。
o Apache::DBI......................ok (v1.12) o Apache2::Reload..................ok (v0.13) o Archive::Tar.....................ok (v2.30) o Archive::Zip.....................ok (v1.60) o Crypt::Eksblowfish::Bcrypt.......ok (v0.009) o Date::Format.....................ok (v2.24) o DateTime.........................ok (v1.54) o DateTime::TimeZone.............ok (v2.51) o DBI..............................ok (v1.641) o DBD::mysql.......................ok (v4.046) o DBD::ODBC........................Not installed! To install, you can use: 'cpan DBD::ODBC'. (optional - Required to connect to a MS-SQL database.) o DBD::Oracle......................Not installed! To install, you can use: 'cpan DBD::Oracle'. (optional - Required to connect to a Oracle database.) o DBD::Pg..........................Not installed! To install, you can use: 'cpan DBD::Pg'. (optional - Required to connect to a PostgreSQL database.) o Digest::SHA......................ok (v6.02) o Encode::HanExtra.................Not installed! To install, you can use: 'cpan Encode::HanExtra'. (optional - Required to handle mails with several Chinese character sets.) o IO::Socket::SSL..................ok (v2.066) o JSON::XS.........................ok (v4.03) o List::Util::XS...................ok (v1.49) o LWP::UserAgent...................ok (v6.54) o Mail::IMAPClient.................Not installed! To install, you can use: 'cpan Mail::IMAPClient'. (optional - Required for IMAP TLS connections.) o IO::Socket::SSL................ok (v2.066) o Authen::SASL...................Not installed! To install, you can use: 'cpan Authen::SASL'. (optional - Required for MD5 authentication mechanisms in IMAP connections.) o Authen::NTLM...................Not installed! To install, you can use: 'cpan Authen::NTLM'. (optional - Required for NTLM authentication mechanism in IMAP connections.) o ModPerl::Util....................ok (v2.000011) o Moo..............................ok (v2.005004) o Net::DNS.........................ok (v1.32) o Net::LDAP........................Not installed! To install, you can use: 'cpan Net::LDAP'. (optional - Required for directory authentication.) o Net::SMTP........................ok (v3.11) o Template.........................ok (v3.009) o Template::Stash::XS..............ok (undef) o Text::CSV_XS.....................ok (v1.46) o Time::HiRes......................ok (v1.9758) o XML::LibXML......................ok (v2.0207) o XML::LibXSLT.....................Not installed! To install, you can use: 'cpan XML::LibXSLT'. (optional - Required for Generic Interface XSLT mapping module.) o XML::Parser......................ok (v2.46) o YAML::XS.........................ok (v0.83)
4. 接着,使用以下命令将 OTRS 配置复制到 ' Config.pm ' 文件。
sudo cp $OTRS/Kernel/Config.pm.dist $OTRS/Kernel/Config.pm
5. 现在使用以下命令校验 OTRS 主脚本。
perl -cw $OTRS/bin/cgi-bin/index.pl
perl -cw $OTRS/bin/cgi-bin/customer.pl
perl -cw $OTRS/bin/otrs.Console.pl
确保得到输出消息 ' Syntax OK '。
6. 最后,使用以下命令设置 OTRS 安装目录 '/opt/otrs' 的权限。
perl $OTRS/bin/otrs.SetPermissions.pl
现在确保 OTRS 安装目录 '/opt/otrs' 归属于用户 'otrs' 和组 'apache'。
使用以下命令进行验证。
ls -lah /opt/otrs
ls -lah $OTRS
进入下一步,为 OTRS 设置 httpd 配置。
为 OTRS 配置 Apache 虚拟主机
在此步骤中,你将为 OTRS 创建一个新的虚拟主机配置。在本例中,我们使用域名 'example.io',OTRS 安装将通过路径 URL 'example.io/otrs/' 访问。
1. 首先,将默认的 httpd 配置文件 ' otrs.conf ' 从 OTRS 安装目录复制到 ' /etc/httpd/conf.d ' 目录。
cp $OTRS/scripts/apache2-httpd.include.conf /etc/httpd/conf.d/otrs.conf
2. 接着,使用 nano 编辑器创建一个新的虚拟主机配置 'example.conf'。
cd /etc/httpd/conf.d/
nano example.conf
复制并粘贴以下配置。并确保将域名替换为你自己的域名。
<VirtualHost *:80> ServerAdmin [email protected] ServerName example.io ServerAlias www.example.io ErrorLog /var/log/httpd/otrs_error.log CustomLog /var/log/httpd/otrs_access.log combined </VirtualHost>
保存配置并退出。
OTRS 搭配 Apache HTTPS 的配置如下。请修改域名以及 SSL 证书的路径。
<VirtualHost *:80> ServerAdmin [email protected] ServerName example.io ServerAlias www.example.io Redirect permanent / https://example.io/ </VirtualHost> <VirtualHost *:443> ServerAdmin [email protected] ServerName example.io Protocols h2 http/1.1 SSLEngine On SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem ErrorLog /var/log/httpd/otrs_error.log CustomLog /var/log/httpd/otrs_access.log combined </VirtualHost>
3. 接着,校验 httpd 配置并确保没有错误,然后重启 httpd 服务以应用新配置。
apachectl configtest
sudo systemctl restart httpd
你现在可以通过 Web 浏览器访问 OTRS 安装。
安装 OTRS
1. 要开始安装 OTRS,请打开 Web 浏览器并在地址栏中输入你的 OTRS 域名。
https://example.io/otrs/installer.pl
你将看到 OTRS 社区版的欢迎消息。

点击 ' Next ' 按钮继续。
2. OTRS 社区版采用 GNU GPL 许可证。点击 ' Accept license and continue ' 按钮。

3. 在数据库配置中,选择类型为 ' MySQL ',并勾选 'Use an existing database for OTRS ' 选项,然后再次点击 ' Next ' 按钮。

4. 输入你的 MariaDB 数据库名、用户、密码和主机,然后点击 ' Check database settings ' 按钮。
确保得到输出消息 'Database check successful',然后点击 ' Next ' 按钮。

OTRS 安装程序会导入数据库结构,然后点击 ' Next ' 按钮。

5. 对于 OTRS 的常规配置,保持默认并点击 'Next'。

6. 邮件配置可以稍后再设置。点击 ' Skip this step ' 按钮。

7. OTRS 安装完成后,记下 OTRS 安装程序生成的 URL、用户名和密码。

8. 在地址栏中打开 OTRS 安装 URL。
https://example.io/otrs/index.pl
输入你的用户名和密码,然后点击 ' Login ' 按钮。

9. 现在你将看到如下所示的 OTRS 管理仪表盘。

OTRS 社区版的安装至此完成。
完成 OTRS 安装
通过 Web 安装程序完成 OTRS 安装后,你必须添加如下一些额外配置。
1. 将工作目录切换到 '/opt/otrs' 并启动 OTRS 守护进程脚本。确保 OTRS 守护进程脚本以用户 ' otrs ' 身份运行。
cd /opt/otrs/
su -c "bin/otrs.Daemon.pl start" -s /bin/bash otrs

2. 接着,执行以下所有命令来设置并启动 OTRS 脚本。
cd /opt/otrs/var/cron/
for foo in *.dist; do cp $foo 'basename $foo .dist'; done
su -c "bin/Cron.sh start" -s /bin/bash otrs
至此,Rocky Linux 系统上的 OTRS 安装完成。
结论
恭喜!你已经学习了如何在 Rocky Linux 上结合 MariaDB 数据库和 Apache/Httpd Web 服务器安装 OTRS 帮助台软件。