Como instalar o Zammad 2.0 no Ubuntu 16.04 LTS

• Pré-requisitos
• Etapa 1: configurar o FQDN (nome de domínio totalmente qualificado)
• Etapa 2: Instalar pacotes do OpenJDK 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, chat, Twitter, Facebook, etc.

Pré-requisitos

• Uma nova instância do servidor Vultr Ubuntu 16.04 LTS 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 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 8.

sudo apt install -y openjdk-8-jdk

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

java -version

A saída será assim.

openjdk version "1.8.0_131"
OpenJDK Runtime Environment (build 1.8.0_131-8u131-b11-2ubuntu1.16.04.3-b11)
OpenJDK 64-Bit Server VM (build 25.131-b11, 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 a função de pesquisa. No Ubuntu 16.04, você pode instalar a versão estável mais recente do Elasticsearch 5 usando o repo oficial do Elasticsearch DEB, conforme abaixo.

Primeiro, faça o download e instale a chave de assinatura pública do Elasticsearch 5.

sudo apt install -y wget
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

Em seguida, instale o apt-transport-httpspacote.

sudo apt install -y apt-transport-https

Salve a definição de repositório em /etc/apt/sources.list.d/elastic-5.x.list.

echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list

Em seguida, instale o Elasticsearch 5.x usando o APT.

sudo apt update -y
sudo apt install -y elasticsearch

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

sudo systemctl daemon-reload
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 da seguinte maneira.

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.service

Etapa 4: Instale o Zammad 2.0

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

Primeiro, verifique se a instância do servidor está usando um UTF-8código de idioma, caso contrário, o PostgreSQL não poderá ser instalado.

locale

Se você encontrar outras configurações de localidade en_US.UTF-8, precisará mudar para esse local da seguinte maneira.

sudo apt install -y locales
sudo locale-gen en_US.UTF-8
echo "LANG=en_US.UTF-8" | sudo tee /etc/default/locale

Depois de garantir que a localidade esteja correta, faça o download do repositório oficial de Zammad DEB.

wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/16.04.repo

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

sudo apt update -y
sudo apt 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

Seu status 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/sites-available/zammad.conf

Encontre a 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 apt 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 apt install -y selinux selinux-basics selinux-utils selinux-policy-ubuntu setools
sudo setsebool httpd_can_network_connect on -P

Se o SELinux estiver disabledativado ou ativado permissive, ignore as modificações acima e siga em frente.

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

sudo ufw app list
sudo ufw allow OpenSSH
sudo ufw allow in "Nginx Full"
sudo ufw enable

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

Aponte seu navegador da Web favorito para 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.