Pesquisa de site

Como instalar o sistema de tickets OTRS (CE) no Rocky Linux

Nesta página

  1. Pré-requisitos
  2. Dependências de pacotes de instalação
  3. Instalando dependências Perl
  4. Configurar banco de dados para OTRS
  5. Baixe e configure o OTRS Community Edition
  6. Configurar host virtual Apache para OTRS
  7. Instalação do OTRS
  8. Concluindo a instalação do OTRS
  9. Conclusão

O OTRS Community Edition é um software de helpdesk de código aberto escrito em Perl. O OTRS é um sistema de tíquetes baseado na web para atendimento ao cliente, gerenciamento de serviços de TI e suporte técnico.

OTRS é um sistema flexível de bilhética e processo de gerenciamento de serviços. Ele fornece um portal do agente, um painel de administração e um portal do cliente.

Neste artigo, você aprenderá como instalar o OTRS Community Edition no sistema Rocky Linux. Você instalará o OTRS com o banco de dados MariaDB e o servidor web Apache.

Pré-requisitos

Este é um guia passo a passo, certifique-se de ter os seguintes requisitos:

  • Sistema operacional: Rocky Linux 8.4 (Green Obsidian)
  • Memória: 2 GB (para implantação pequena)
  • Endereço IP: 192.168.1.10
  • Nome de domínio: example.io (para ambiente de produção)

Agora vamos iniciar a instalação.

Instalar Dependências de Pacotes

Primeiro, você instalará algumas dependências básicas de pacotes em seu sistema Rocky Linux. Você instalará o repositório EPEL, Perl, httpd e pacotes MariaDB.

1. Execute o comando DNF abaixo para instalar o repositório EPEL.

sudo dnf install epel-release -y

2. Depois que a instalação do repositório EPEL for concluída, instale os pacotes GCC e Perl.

sudo dnf install gcc expat-devel perl perl-core procmail -y

3. Em seguida, instale o servidor web httpd e o banco de dados MariaDB usando o seguinte comando.

sudo dnf install httpd mariadb-server mod_perl

Digite y para confirmar e pressione Enter para continuar a instalação.

Depois que a instalação do MariaDB for concluída, edite a configuração /etc/my.cnf.d/mariadb-server.cnf usando o editor nano.

nano /etc/my.cnf.d/mariadb-server.cnf

Copie e cole a seguinte configuração na seção [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

Salve a configuração e saia.

4. Agora inicie e habilite os serviços httpd e MariaDB usando o seguinte comando.

sudo systemctl enable --now httpd
sudo systemctl enable --now mariadb

Agora vá para a próxima etapa para instalar dependências Perl adicionais e configurar o banco de dados MariaDB.

Instalando dependências do Perl

O projeto OTRS é escrito em Perl, você deve instalar algumas dependências Perl do repositório Comprehensive Perl Archive Network (CPAN).

Para instalar pacotes do repositório CPAN, use o comando cpan.

1. Execute o comando cpan abaixo para instalar dependências Perl para OTRS.

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. Em seguida, você pode instalar algumas dependências Perl opcionais usando o comando cpan abaixo.

sudo cpan DBD::Pg Mail::IMAPClient Authen::SASL XML::LibXSLT

Agora vá para a próxima etapa para configurar o banco de dados MariaDB e, em seguida, instalar o OTRS.

Banco de dados de configuração para OTRS

Nesta etapa, você configurará a senha root para MariaDB e criará um novo banco de dados e usuário para a instalação do OTRS.

Você pode usar o comando mysql_secure_installation para configurar a senha root para o servidor MariaDB.

1. Configure a senha root do MariaDB usando o seguinte comando.

mysql_secure_installation

Digite uma nova senha para o usuário raiz do MariaDB e digite y para confirmar todas as configurações sugeridas.

2. Em seguida, faça login no shell MariaDB usando o comando mysql abaixo.

mysql -u root -p

Digite a senha para o usuário root do MariaDB.

3. Em seguida, execute a seguinte consulta para criar um novo banco de dados otrs e o usuário otrs. Certifique-se de alterar a senha.

create database otrs;
grant all privileges on otrs.* to  identified by 'PasswordOtrs';
flush privileges;

Agora digite exit e pressione Enter para sair do shell MariaDB.

Você está pronto para instalar o OTRS em seu sistema.

Baixe e configure o OTRS Community Edition

Nesta etapa, você fará o download da edição da comunidade OTRS e a configurará para instalação.

1. Primeiro, crie um novo usuário do sistema otrs usando o seguinte comando.

adduser -M -r -s /sbin/nologin otrs

Agora execute o comando abaixo para adicionar o usuário otrs ao grupo apache.

usermod -aG apache otrs

2. Em seguida, altere seu diretório de trabalho atual para /opt e baixe o código-fonte OTRS usando o comando wget abaixo.

cd /opt
wget https://otrscommunityedition.com/download/otrs-community-edition-6.0.32.tar.gz

Se o processo de download do OTRS for concluído, extraia o código-fonte do OTRS e renomeie o diretório para otrs.

tar -xf otrs-community-edition-6.0.32.tar.gz
mv otrs-community-edition-*/ otrs/

3. Antes de iniciar a instalação do OTRS, certifique-se de que todos os módulos Perl e dependências para OTRS estejam disponíveis em seu sistema.

Altere o diretório de trabalho para /opt/otrs e execute o script Perl otrs.CheckModules.pl.

export OTRS=/opt/otrs
cd $OTRS

perl bin/otrs.CheckModules.pl

O script otrs.CheckModules.pl executará a verificação do sistema para todas as dependências do Perl para a instalação do OTRS.

Certifique-se de que todos os módulos Perl essenciais estejam instalados em seu sistema. Você pode instalar módulos Perl opcionais usando o comando sugerido na saída da mensagem.

Abaixo está a saída semelhante que você verá.

  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. Em seguida, copie a configuração do OTRS para o arquivo Config.pm usando o seguinte comando.

sudo cp $OTRS/Kernel/Config.pm.dist $OTRS/Kernel/Config.pm

5. Agora verifique o script principal do OTRS usando o seguinte comando.

perl -cw $OTRS/bin/cgi-bin/index.pl
perl -cw $OTRS/bin/cgi-bin/customer.pl
perl -cw $OTRS/bin/otrs.Console.pl

Certifique-se de obter a mensagem de saída Sintaxe OK.

6. Por fim, configure a permissão do diretório de instalação do OTRS /opt/otrs usando o seguinte comando.

perl $OTRS/bin/otrs.SetPermissions.pl

Agora certifique-se de que o diretório de instalação do OTRS /opt/otrs pertença ao usuário otrs e ao grupo apache.

Verifique usando o seguinte comando.

ls -lah /opt/otrs
ls -lah $OTRS

Vá para a próxima etapa para definir a configuração do httpd para OTRS.

Configurar Apache Virtual Host para OTRS

Nesta etapa, você criará uma nova configuração de host virtual para OTRS. Neste exemplo, estamos usando o nome de domínio example.io e a instalação do OTRS estará disponível no caminho URL example.io/otrs/.

1. Primeiro, copie a configuração padrão do httpd otrs.conf do diretório de instalação do OTRS para o diretório /etc/httpd/conf.d.

cp $OTRS/scripts/apache2-httpd.include.conf /etc/httpd/conf.d/otrs.conf

2. Em seguida, crie um novo exemplo de configuração de host virtual.conf usando o editor nano.

cd /etc/httpd/conf.d/
nano example.conf

Copie e cole a seguinte configuração. E certifique-se de alterar o nome de domínio com o seu domínio.

<VirtualHost *:80>
   ServerAdmin 

   ServerName example.io
   ServerAlias www.example.io
   
   ErrorLog /var/log/httpd/otrs_error.log
   CustomLog /var/log/httpd/otrs_access.log combined
</VirtualHost>

Salve a configuração e saia.

Para a configuração OTRS com Apache HTTPS conforme abaixo. Altere o nome de domínio e o caminho do caminho dos certificados SSL.

<VirtualHost *:80>
   ServerAdmin 

   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. Em seguida, verifique a configuração do httpd e certifique-se de que não há nenhum erro, então reinicie o serviço httpd para aplicar a nova configuração.

apachectl configtest
sudo systemctl restart httpd

A instalação do OTRS pode ser acessada no navegador da web.

Instalação OTRS

1. Para iniciar a instalação do OTRS, abra seu navegador da Web e digite seu nome de domínio OTRS na barra de endereço.

Você verá a mensagem de boas-vindas do OTRS Community Edition.

Clique no botão Avançar para continuar.

2. O OTRS Community Edition vem com licença GNU GPL. Clique no botão Aceitar licença e continuar.

3. Para a configuração do banco de dados, selecione o tipo como MySQL e escolha a opção Usar um banco de dados existente para OTRS, em seguida clique no botão Avançar novamente.

4. Digite o nome, usuário, senha e hosts do banco de dados MariaDB e clique no botão Verificar configurações do banco de dados.

Certifique-se de obter a mensagem de saída Verificação do banco de dados bem-sucedida e clique no botão Avançar.

O instalador do OTRS importa o esquema do banco de dados e, em seguida, clique no botão Avançar.

5. Para a configuração geral do OTRS, deixe como padrão e clique em Avançar.

6. Para a configuração de correio, você pode configurá-lo posteriormente. Clique no botão Ignorar esta etapa.

7. Quando a instalação do OTRS for concluída, anote a URL, nome de usuário e senha gerados pelo instalador do OTRS.

8. Abra o URL de instalação do OTRS na barra de endereço.

Digite seu nome de usuário e senha e clique no botão Login.

9. Agora você verá o painel de administração do OTRS conforme abaixo.

A instalação do OTRS Community Edition agora está concluída.

Finalizando a instalação do OTRS

Depois de concluir a instalação do OTRS por meio do instalador da Web, você deve adicionar algumas configurações adicionais conforme abaixo.

1. Altere o diretório de trabalho para /opt/otrs e inicie o script daemon OTRS. Certifique-se de que o script daemon OTRS esteja sendo executado como um usuário otrs.

cd /opt/otrs/
su -c "bin/otrs.Daemon.pl start" -s /bin/bash otrs

2. Em seguida, execute todos os comandos a seguir para configurar e iniciar o script 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

E a instalação do OTRS no sistema Rocky Linux é concluída.

Conclusão

Parabéns! Você aprendeu a instalação do software OTRS Helpdesk no Rocky Linux com banco de dados MariaDB e servidor web Apache/Httpd.

Artigos relacionados: