本页内容

• 准备工作
• 安装 Perl 依赖
• 安装 Apache 与 MariaDB 服务器
• 配置 MariaDB 服务器
• 在 Debian 11 上安装 OTRS
• 为 OTRS 配置 Apache
• 完成 OTRS 网页安装
• 结论

OTRS 是一个开源的工单请求系统（Ticket Request System），可帮助组织处理客户工单与请求。它是最受欢迎的服务管理软件之一，常用于帮助台和客户支持。它提供灵活的基于 Web 的管理面板，可从中心位置跟踪各类与 IT 相关的问题。它使用 Perl 编写，并以 PostgreSQL 和 MySQL 作为数据库后端。如果你正在寻找帮助台、呼叫中心和 IT 服务管理系统，那么 OTRS 是你的最佳选择。

本文介绍如何在 Debian 11 服务器上安装 OTRS。

准备工作

• 一台运行 Debian 11 的服务器。
• 所有服务器均已配置 root 密码。

安装 Perl 依赖

OTRS 是用 Perl 编写的，因此你必须在服务器上安装所有 Perl 依赖。

首先，使用以下命令更新并升级所有系统软件包：

apt update -y
apt upgrade -y

接下来，运行以下命令在服务器上安装所有必需的 Perl 模块：

apt install perl 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 libtext-csv-xs-perl libjson-xs-perl libapache-dbi-perl libxml-libxml-perl libxml-libxslt-perl libyaml-perl libarchive-zip-perl libcrypt-eksblowfish-perl libencode-hanextra-perl libmail-imapclient-perl libtemplate-perl libmoo-perl libauthen-ntlm-perl libjavascript-minifier-xs-perl libdbd-odbc-perl libcss-minifier-xs-perl libdbd-pg-perl libdatetime-perl -y

安装完所有必需的依赖后，你可以进入下一步。

安装 Apache 与 MariaDB 服务器

接下来，你需要在系统上安装 Apache 和 MariaDB 服务器。你可以运行以下命令同时安装这两个软件包：

apt install apache2 mariadb-server mariadb-client -y

安装完这两个软件包后，启动 Apache 和 MariaDB 服务，并设置为开机自启：

systemctl start apache2 mariadb
systemctl enable apache2 mariadb

配置 MariaDB 服务器

首先，你需要加固 MariaDB 安装。可以运行以下脚本来完成安全加固：

mysql_secure_installation

按如下所示回答所有问题：

    Enter current password for root (enter for none):
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

接下来，编辑 MariaDB 配置文件并调整一些设置：

nano /etc/mysql/mariadb.conf.d/50-server.cnf

在 [mysqld] 段落中添加以下配置行：

max_allowed_packet=256M
character-set-server=utf8
collation-server=utf8_general_ci
innodb_buffer_pool_size=4G
innodb_log_file_size=1G

保存并关闭文件，然后重启 MariaDB 服务以使配置生效：

systemctl restart mariadb

在 Debian 11 上安装 OTRS

首先，使用以下命令创建一个专用于运行 OTRS 的用户。

useradd -r -m -d /opt/otrs -c "OTRS User" otrs

接下来，使用以下命令将 OTRS 用户加入 www-data 组：

usermod -aG www-data otrs

接下来，使用以下命令从其官方网站下载最新版本的 OTRS：

wget https://otrscommunityedition.com/download/otrs-community-edition-6.0.38.tar.gz

下载完成后，将下载的文件解压到 OTRS 目录：

tar xvfz otrs-community-edition-6.0.38.tar.gz -C /opt/otrs --strip-components=1

接下来，更改 OTRS 目录的所属权：

chown -R otrs:otrs /opt/otrs

接下来，使用以下命令检查所有必需的 Perl 模块：

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

如果一切正常，你应该看到如下输出：

  o Apache::DBI......................ok (v1.12)
  o Apache2::Reload..................ok (v0.13)
  o Archive::Tar.....................ok (v2.36)
  o Archive::Zip.....................ok (v1.68)
  o Crypt::Eksblowfish::Bcrypt.......ok (v0.009)
  o CSS::Minifier::XS................ok (v0.11)
  o Date::Format.....................ok (v2.24)
  o DateTime.........................ok (v1.54)
    o DateTime::TimeZone.............ok (v2.47)
  o DBI..............................ok (v1.643)
  o DBD::mysql.......................ok (v4.050)
  o DBD::ODBC........................ok (v1.61)
  o DBD::Oracle......................Not installed! (optional - Required to connect to a Oracle database.)
  o DBD::Pg..........................ok (v3.14.2)
  o Digest::SHA......................ok (v6.02)
  o Encode::HanExtra.................ok (v0.23)
  o IO::Socket::SSL..................ok (v2.069)
  o JSON::XS.........................ok (v4.03)
  o JavaScript::Minifier::XS.........ok (v0.13)
  o List::Util::XS...................ok (v1.55)
  o LWP::UserAgent...................ok (v6.64)
  o Mail::IMAPClient.................ok (v3.42)
    o IO::Socket::SSL................ok (v2.069)
    o Authen::SASL...................ok (v2.16)
    o Authen::NTLM...................ok (v1.09)
  o ModPerl::Util....................ok (v2.000011)
  o Moo..............................ok (v2.004004)
  o Net::DNS.........................ok (v1.29)
  o Net::LDAP........................ok (v0.68)
  o Net::SMTP........................ok (v3.11)
  o Template.........................ok (v2.27)
  o Template::Stash::XS..............ok (undef)
  o Text::CSV_XS.....................ok (v1.45)
  o Time::HiRes......................ok (v1.9764)
  o Unicode::Collate.................ok (v1.27)
  o XML::LibXML......................ok (v2.0134)
  o XML::LibXSLT.....................ok (v1.99)
  o XML::Parser......................ok (v2.46)
  o YAML::XS.........................ok (v0.82)

接下来，使用以下命令重命名 OTRS 配置文件：

cp /opt/otrs/Kernel/Config.pm{.dist,}

接下来，运行以下脚本来安装所需的依赖：

perl -cw /opt/otrs/bin/cgi-bin/index.pl
perl -cw /opt/otrs/bin/cgi-bin/customer.pl
perl -cw /opt/otrs/bin/otrs.Console.pl
perl /opt/otrs/bin/otrs.SetPermissions.pl

为 OTRS 配置 Apache

接下来，你需要将 OTRS 的 Apache 配置文件链接到 Apache 的网站根目录，以便通过 Apache 提供 OTRS 服务。你可以使用以下命令完成：

ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/apache2/sites-enabled/

接下来，使用以下命令禁用 Apache 默认站点：

a2dissite 000-default.conf

接下来，使用以下命令启用所需的 Apache 模块：

a2enmod perl version deflate filter headers

接下来，使用以下命令修复 Apache 的权限：

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

最后，重启 Apache 服务以使配置生效：

systemctl restart apache2

你现在可以使用以下命令检查 Apache 服务的状态：

systemctl status apache2

你将看到如下的 Apache 状态输出：

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2023-02-22 12:58:37 UTC; 6s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 11481 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 11488 (/usr/sbin/apach)
      Tasks: 55 (limit: 4675)
     Memory: 95.5M
        CPU: 1.507s
     CGroup: /system.slice/apache2.service
             ??11488 /usr/sbin/apache2 -k start
             ??11491 /usr/sbin/apache2 -k start
             ??11492 /usr/sbin/apache2 -k start

Feb 22 12:58:36 debian11 systemd[1]: Starting The Apache HTTP Server...

完成 OTRS 网页安装

至此，OTRS 已安装并配置完成。现在，打开你的 Web 浏览器，通过 URL http://your-server-ip/otrs/installer.pl 访问 OTRS 网页安装向导。你将在以下界面看到 OTRS 欢迎页面：

点击 Next 按钮。你将看到 OTRS 许可协议界面：

阅读许可协议，然后点击“Accept license and continue”按钮。你将看到数据库选择界面：

选择你的数据库，然后点击 Next 按钮。你将看到 MySQL 配置界面：

输入你的 MySQL root 密码，然后点击 Check database settings。你将看到如下界面：

输入新的数据库用户名和密码，然后点击 Next 按钮。你将看到如下界面：

点击 Next 按钮。你将看到系统设置界面：

设置你所需的参数，然后点击 Next 按钮。你将看到邮件配置界面：

填写你的 SMTP 服务器，或留空并点击 Skip this step 按钮。安装完成后，你将在如下界面看到服务器 URL 以及登录用户名和密码：

点击提供的 URL。你将被重定向到 OTRS 登录界面：

输入你的管理员凭据，然后点击 Login 按钮。你将看到如下的 OTRS 仪表盘界面：

在上述界面中，你可能会看到“OTRS Daemon not runnig error”（OTRS 守护进程未运行）错误。

要解决此错误，请在你的服务器终端上运行以下命令：

sudo -Hiu otrs /opt/otrs/bin/otrs.Daemon.pl start
cp /opt/otrs/var/cron/otrs_daemon{.dist,}
sudo -Hiu otrs /opt/otrs/bin/Cron.sh start

现在，刷新 OTRS 界面。你将看到该错误已经消失。

结论

恭喜！你已成功在 Debian 11 服务器上安装了 OTRS。你现在可以在公司中部署 OTRS，以提升服务管理质量。如果你有任何问题，欢迎随时提问。