Como instalar o Zammad 2.0 no CentOS 7

• Pré-requisitos
• Etapa 1: configurar o FQDN (nome de domínio totalmente qualificado)
• Etapa 2: Instalar pacotes do OpenJDK 1.8
• Etapa 3: Instale o Elasticsearch 5 e o plug-in mapeador-anexos
• Etapa 4: Instale o Zammad 2.0
• Etapa 5: configurar as regras do SELinux e do firewall
• Etapa 6: configurar o novo sistema Zammad a partir da interface da Web

O Zammad é um sistema de helpdesk / ticket de código aberto projetado para equipes de suporte ao cliente. Com o Zammad, os representantes de atendimento ao cliente podem lidar facilmente com consultas e reclamações de clientes de vários canais, incluindo web, formulário, email, bate-papo, Twitter, Facebook e assim por diante.

Pré-requisitos

• Uma nova instância do servidor Vultr CentOS 7 x64 com pelo menos 4 GB de memória. Digamos que seu endereço IP seja 203.0.113.1e seu nome de host seja helpdesk.
• Um domínio helpdesk.example.comconfigurado para apontar para a instância do servidor mencionada acima. Você pode aprender mais detalhes sobre isso em outro tutorial do Vultr .
• Um usuário sudo .
• A instância do servidor foi atualizada para o status estável mais recente .
• Em um ambiente de produção, é recomendável configurar um arquivo de troca para otimizar o desempenho.

Etapa 1: configurar o FQDN (nome de domínio totalmente qualificado)

Conforme exigido pelo Zammad, você precisa configurar corretamente o FQDN na instância do servidor antes de poder acessar remotamente o site do Zammad.

Use o vieditor de texto para abrir o /etc/hostsarquivo.

sudo vi /etc/hosts

Insira a seguinte linha antes de qualquer linha existente.

203.0.113.1 helpdesk.example.com helpdesk

Salve e saia.

:wq!

Use o hostname -fcomando para confirmar o resultado, que será semelhante a este.

helpdesk.example.com

Etapa 2: Instalar pacotes do OpenJDK 1.8

Conforme exigido pelo Zammad, você precisa instalar o Java na instância do servidor antes de poder instalar e executar o Zammad.

Instale a versão estável mais recente do OpenJDK 1.8.

sudo yum install -y java-1.8.0-openjdk-devel

Tendo o OpenJDK 1.8 instalado, você pode verificar o resultado.

java -version

A saída será assim.

openjdk version "1.8.0_144"
OpenJDK Runtime Environment (build 1.8.0_144-b01)
OpenJDK 64-Bit Server VM (build 25.144-b01, mixed mode)

Por fim, configure a JAVA_HOMEvariável de ambiente.

echo "JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")" | sudo tee -a /etc/profile
source /etc/profile

Etapa 3: Instale o Elasticsearch 5 e o plug-in mapeador-anexos

Zammad usa o Elasticsearch para fornecer sua função de pesquisa. No CentOS 7, você pode instalar a versão estável mais recente do Elasticsearch 5 usando o repo oficial do Elasticsearch YUM, conforme abaixo.

Primeiro, instale a chave de assinatura pública do Elasticsearch 5.

sudo rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

Em seguida, configure o repositório Elasticsearch YUM.

cat <<EOF | sudo tee -a /etc/yum.repos.d/elasticsearch.repo
[elasticsearch-5.x]
name=Elasticsearch repository for 5.x packages
baseurl=https://artifacts.elastic.co/packages/5.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=1
autorefresh=1
type=rpm-md
EOF

Em seguida, instale o Elasticsearch usando YUM.

sudo yum install -y elasticsearch

Por fim, inicie o serviço Elasticsearch e inicie-o automaticamente no momento da inicialização.

sudo systemctl start elasticsearch.service
sudo systemctl enable elasticsearch.service

Além disso, para permitir que o Elasticsearch indexe anexos de arquivos, é necessário instalar o mapper-attachmentsplug-in do Elasticsearch .

sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install mapper-attachments

Quando solicitado a aprovar permissões adicionais, digite " Y" e pressione " Enter" para concluir a instalação.

Reinicie o serviço Elasticsearch para carregar o novo plug-in.

sudo systemctl restart elasticsearch

Etapa 4: Instale o Zammad 2.0

Para facilitar o processo de instalação, você pode usar o repositório oficial do Zammad YUM para instalar o Zammad junto com várias dependências, incluindo Nginx, PostgreSQL e mais, ao mesmo tempo.

Faça o download do repositório oficial de Zammad YUM.

sudo wget -O /etc/yum.repos.d/zammad.repo https://dl.packager.io/srv/zammad/zammad/stable/installer/el/7.repo

Instale o Zammad e todas as dependências necessárias.

sudo yum install -y zammad

Tendo o Zammad instalado com sucesso, o serviço Zammad será iniciado automaticamente. Você pode usar o seguinte comando para confirmar o status do serviço Zammad.

sudo systemctl status zammad.service

O status de Zammad será active (running).

Em seguida, use os seguintes comandos para fazer o Zammad funcionar com o Elasticsearch e reconstruir o índice.

sudo zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"
sudo zammad run rake searchindex:rebuild

Adicione espaço de nome extra ao índice do Elasticsearch (opcional).

sudo zammad run rails r "Setting.set('es_index', Socket.gethostname + '_zammad')"

Ignore os tipos comuns de arquivos binários (opcional).

sudo zammad run rails r "Setting.set('es_attachment_ignore', [ '.png', '.jpg', '.jpeg', '.mpeg', '.mpg', '.mov', '.bin', '.exe', '.box', '.mbox' ] )"

Defina o tamanho máximo do anexo (opcional).

sudo zammad run rails r "Setting.set('es_attachment_max_size_in_mb', 50)"

Para permitir que os usuários acessem remotamente o Zammad, você precisa modificar o arquivo de configuração do Zammad Nginx.

sudo vi /etc/nginx/conf.d/zammad.conf

Encontre esta linha.

 server_name localhost;

Substitua localhostpelo FQDN da sua instância do servidor.

server_name helpdesk.example.com;

Salve e saia.

:wq!

Por fim, reinicie o serviço Nginx para aplicar suas modificações.

sudo systemctl restart nginx.service

Etapa 5: configurar as regras do SELinux e do firewall

Use os seguintes comandos para determinar o status do SELinux na sua instância do servidor.

sudo yum install -y policycoreutils
sestatus

Se o SELinux estiver ativado no enforcingmodo em sua máquina, você precisará modificar uma regra do SELinux da seguinte maneira.

sudo yum install -y policycoreutils policycoreutils-python selinux-policy-devel
sudo setsebool httpd_can_network_connect on -P

Se o SELinux estiver desativado ou ativado no permissivemodo, ignore as modificações acima e siga em frente.

Você também precisa modificar as regras de firewall da seguinte maneira.

sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --zone=public --permanent --add-service=https
sudo firewall-cmd --reload

Etapa 6: configurar o novo sistema Zammad a partir da interface da Web

Aponte seu navegador da Web favorito http://helpdesk.example.come você será levado à Zammad getting startedpágina.

Clique no Setup new systembotão para seguir em frente.

Na Administrator Accountjanela, insira o nome, o sobrenome, o email e a senha do administrador (duas vezes) e clique no Createbotão.

Na Organizationjanela, insira o nome da organização e o URL do sistema http://helpdesk.example.com, faça upload do seu logotipo (se houver) e clique no Nextbotão

Na Email Notificationjanela, escolha um método de envio de email adequado e clique no Continuebotão

Na Connect Channelsjanela, clique no Skipbotão para finalizar a configuração inicial. Todos os canais podem ser personalizados posteriormente.

Isso é tudo para configurar um sistema operacional de bilhetagem Zammad. Sinta-se livre para explorar a interface do Zammad e convidar representantes de atendimento ao cliente. Obrigado pela leitura.