Como instalar o Mautic no CentOS 7

• Pré-requisitos
• Etapa 1: configurar um arquivo de troca (opcional)
• Etapa 2: atualizar o sistema
• Etapa 3: Instalar e configurar o Apache
• Etapa 4: Instale e proteja o MariaDB 10.2.x
• Etapa 5: Instalar e configurar o PHP 7.0.x
• Etapa 6: Instale o Composer e o git
• Etapa 7: Instalar o Mautic

O Mautic é um software de automação de marketing de código aberto poderoso e versátil, escrito em PHP. Com a ajuda da Mautic, os profissionais de marketing on-line podem gerenciar facilmente várias rotinas diárias de marketing em um único local, incluindo engajamento em mídias sociais, contatos, email marketing, formulários, gerenciamento de campanhas, relatórios de análise de dados, etc.

Neste artigo, mostrarei como implantar a versão estável mais recente do Mautic, que estava Mautic 2.9.2no momento em que este artigo foi escrito, em uma instância do servidor Vultr CentOS 7. Obviamente, antes de instalar o Mautic, precisamos configurar uma pilha LAMP / LEMP atualizada e funcional como a infraestrutura do sistema. Para sua informação, instruções para configurar uma pilha LAMP qualificada estão incluídas aqui.

Pré-requisitos

• Recomenda-se uma nova instância do servidor Vultr CentOS 7 com RAM suficiente, 1 GB ou mais de RAM. Digamos que seu endereço IP seja 203.0.113.1e o domínio vinculado a este servidor seja example.com.
• Um usuário sudo .

Etapa 1: configurar um arquivo de troca (opcional)

Primeiro, abra o seu terminal SSH favorito, faça o login na instância do servidor Vultr como um usuário sudo.

Para obter melhor desempenho ao executar tarefas maciças de campanha paralela, você pode configurar um arquivo de permuta usando os seguintes comandos:

sudo dd if=/dev/zero of=/swapfile count=2048 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile   none    swap    sw    0   0' | sudo tee -a /etc/fstab

Nota: o tamanho da troca 2048MBaqui é um valor otimizado para máquinas com 1 GB de RAM. Se a quantidade de RAM da sua máquina for diferente, provavelmente você precisará modificar o valor de acordo.

Etapa 2: atualizar o sistema

Por motivos de segurança, é sempre recomendável atualizar o sistema para o status estável mais recente:

sudo yum install epel-release -y
sudo yum update -y && sudo shutdown -r now

Após a reinicialização do sistema, efetue login novamente como o mesmo usuário sudo.

Etapa 3: Instalar e configurar o Apache

Use o seguinte comando para instalar a versão estável mais recente do Apache, que foi Apache 2.4.6quando eu escrevi este artigo:

sudo yum install httpd -y

Em um ambiente de produção, você precisa remover a página de boas-vindas padrão comentando o /etc/httpd/conf.d/welcome.confarquivo inteiro :

sudo sed -i 's/^/#&/g' /etc/httpd/conf.d/welcome.conf

Ainda por motivos de segurança, você precisa restringir o Apache de exibir URLs de arquivos nos navegadores da Web dos visitantes:

sudo sed -i "s/Options Indexes FollowSymLinks/Options FollowSymLinks/" /etc/httpd/conf/httpd.conf

Agora, você precisa iniciar o serviço Apache e iniciá-lo sempre que o sistema inicializar:

sudo systemctl start httpd.service
sudo systemctl enable httpd.service

Etapa 4: Instale e proteja o MariaDB 10.2.x

4.1 Instalar o MariaDB 10.2.x

Você pode usar os seguintes comandos para instalar e iniciar a versão estável mais recente do MariaDB no seu sistema, que era MariaDB 10.2.8na época em que escrevi este artigo:

curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
sudo yum install MariaDB-server MariaDB-client -y
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

4.2 Proteger a instalação do MariaDB

Para proteger a instalação do MariaDB em seu sistema, você precisa executar o seguinte comando antes de usar o MariaDB:

sudo /usr/bin/mysql_secure_installation

Quando solicitado, responda às perguntas como mostrado abaixo. Certifique-se de usar sua própria senha root do MariaDB em vez da senha de exemplo mostrada aqui:

• Digite a senha atual do root (digite nenhum): basta pressionar o Enterbotão
• Definir senha root? [S / n]:Y
• Nova senha: your-MariaDB-root-password
• Re-introduza a nova palavra-passe: your-MariaDB-root-password
• Remover usuários anônimos? [S / n]:Y
• Proibir o login root remotamente? [S / n]:Y
• Remover banco de dados de teste e acessar a ele? [S / n]:Y
• Recarregar tabelas de privilégios agora? [S / n]:Y

Etapa 5: Instalar e configurar o PHP 7.0.x

5.1 Instalar o PHP 7.0.x

Como o Mautic ainda não é compatível com o PHP 7.1.x, você pode instalar os componentes necessários do PHP 7.0.x usando os repositórios do Webtatic:

sudo rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
sudo yum install -y php70w php70w-mysqlnd php70w-common php70w-cli php70w-xml php70w-mbstring php70w-gd php70w-mcrypt php70w-opcache php70w-imap php70w-process php70w-intl

Tendo esses componentes do PHP 7.0.x instalados corretamente, é necessário modificar várias configurações padrão do PHP editando o /etc/php.iniarquivo. Mas, para evitar erros não intencionais, faça um backup do /etc/php.iniarquivo antes de editá-lo:

sudo cp /etc/php.ini /etc/php.ini.bak

5.2 Configurar o valor do fuso horário

Use o vieditor para abrir o /etc/php.iniarquivo:

sudo vi /etc/php.ini

Para obter números corretos para suas campanhas, é importante configurar um valor razoável de fuso horário para o Mautic.

Encontre a linha:

;date.timezone =

Substitua por:

date.timezone = America/Los_Angeles

_Nota: America/Los_Angelesé o valor de fuso horário adequado para minha máquina. De acordo com o local exato da sua própria instância do servidor, pode ser necessário escolher outro valor de fuso horário. Veja a lista de fusos horários suportados nesta página .

5.3 Aumentar o limite de memória

Para impedir que o Mautic fique sem memória durante a execução de várias tarefas de consumo, como o envio de campanhas de email em massa, você deve aumentar o limite de memória para executar um script PHP.

Ainda no /etc/php.iniarquivo, encontre a linha:

memory_limit = 128M

Substitua por:

memory_limit = 256M

Salve e saia:

:wq!

Etapa 6: Instale o Composer e o git

Para fins de gerenciamento de dependência e controle de versão, você deve instalar o Composer e o git antes de começar a instalar o Mautic.

6.1 Instalar o Composer

O Composer é uma ferramenta de gerenciamento de dependências em PHP, que pode ajudá-lo a gerenciar facilmente dependências do Mautic. Você pode usar os seguintes comandos para instalar Composer 1.5.1, a última versão estável do Composer no momento deste artigo foi escrita:

cd
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '669656bab3166a7aff8a7506b8cb2d1c292f042046c5a994c43155c0be6190fa0355160742ab2e1c88d40d5be660b410') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Nota: As instruções para instalar o Composer podem variar no futuro. Você deve sempre verificar as instruções atualizadas na página oficial de download do Composer .

6.2 Instalar o Git

O Git também é necessário ao implantar o Mautic em sua própria máquina, e você pode instalar facilmente o Git usando o seguinte comando:

sudo yum install git -y

Etapa 7: Instalar o Mautic

7.1 Crie um banco de dados MariaDB e um usuário de banco de dados dedicado para o Mautic

Antes de instalar o Mautic, é necessário criar um banco de dados e um usuário de banco de dados dedicado para manipular todos os dados do Mautic.

Efetue login no shell do MariaDB como MariaDB root:

mysql -u root -p

No shell MySQL / MariaDB, digite os seguintes comandos para criar um banco de dados chamado mautic, um usuário de banco de dados chamado mauticusere a senha deste usuário yourpassword.

Aviso: Por motivos de segurança, ao operar em sua própria instância do servidor, substitua os valores dos parâmetros mencionados acima pelos seus.

CREATE DATABASE mautic;
CREATE USER 'mauticuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON mautic.* TO 'mauticuser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

7.2 Preparar arquivos de instalação do Mautic

Você sempre pode obter a versão estável mais recente do Mautic no repositório do Mautic GitHub. Na época em que escrevi este artigo, a última versão estável do Mautic era Mautic 2.9.2.

cd
wget https://github.com/mautic/mautic/archive/2.9.2.tar.gz

Descompacte este arquivo:

tar -zxvf 2.9.2.tar.gz

Use Git e Composer para instalar dependências para Mautic:

cd mautic-2.9.2
git init
composer install

Para simplificar futuras atualizações, mova todos os arquivos Mautic para /opte, em seguida, crie um arquivo de link virtual /var/www/html/mauticapontando para esse diretório no diretório raiz da web:

sudo mv ~/mautic-2.9.2 /opt
sudo ln -s /opt/mautic-2.9.2 /var/www/html/mautic

Modifique a propriedade do diretório Mautic, permitindo que o Apache acesse arquivos dentro de:

sudo chown -R apache:apache /opt/mautic-2.9.2

7.3 Configurar um host virtual Apache para Mautic

Você pode usar o seguinte segmento de código para configurar um host virtual Apache para executar o Mautic. Basta copiar o segmento de código inteiro no terminal SSH e pressionar o Enterbotão

Nota: Lembre-se de modificar os valores de ServerAdmin, ServerNamee ServerAliasem sua máquina em conformidade.

cat <<EOF | sudo tee -a /etc/httpd/conf.d/mautic.conf
<VirtualHost *:80>
ServerAdmin [email protected]
DocumentRoot /var/www/html/mautic/
ServerName mautic.example.com
ServerAlias www.mautic.example.com
<Directory /var/www/html/mautic/>
Options FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
ErrorLog /var/log/httpd/mautic.example.com-error_log
CustomLog /var/log/httpd/mautic.example.com-access_log common
</VirtualHost>
EOF

Em seguida, reinicie o Apache para efetivar todas as suas alterações:

sudo systemctl restart httpd.service

7.4 Modificar regras de firewall

Para permitir que os visitantes acessem o Mautic a partir de um navegador da web, você precisa modificar as regras do firewall, conforme mostrado abaixo:

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

7.5 Concluir a instalação do Mautic a partir de um navegador da web

Aponte seu navegador da Web favorito para http://203.0.113.1, e então você será direcionado para a interface do instalador da Web Mautic.

Na Mautic Installation - Environment Checkpágina, você verá a Ready to install!mensagem de prompt. Basta clicar no Next Stepbotão para seguir em frente.

Na Mautic Installation - Database Setuppágina, insira todas as informações necessárias do banco de dados, deixando outros campos intocados e clique no Next Stepbotão

Por exemplo, todas as informações necessárias sobre o banco de dados deste guia estão listadas abaixo:

• Driver de banco de dados: MySQL PDO (Recommended)
• Host do banco de dados: localhost
• Nome do banco de dados: mautic
• Nome de usuário do banco de dados: mauticuser
• Senha do banco de dados: yourpassword

Na Mautic Installation - Administrative Userpágina, insira as informações necessárias para o usuário administrador da seguinte forma e clique no Next Stepbotão

Por exemplo, minhas informações administrativas do usuário são:

• Nome de usuário do administrador: <admin>
• Senha do administrador: <mautic-admin-password>
• Primeiro nome: John
• Último nome: Doe
• Endereço de e-mail: [email protected]

Na Mautic Installation - Email Configurationpágina, escolha um método adequado de transporte de mala direta e clique no Next Stepbotão para finalizar o assistente de instalação na web.

Na página de login do Mautic, efetue login com as credenciais do usuário administrativo.

7.6 Manutenção pós-instalação

Para manter o Mautic em funcionamento, é necessário configurar várias tarefas cron para executar tarefas de manutenção em intervalos regulares. Para fins de desempenho, você não deve executar mais de um trabalho cron ao mesmo tempo.

Por exemplo, você pode configurar alguns trabalhos cron para o apacheusuário usando o seguinte comando:

sudo crontab -u apache -e

Pressione ipara entrar no modo de inserção e preencha o arquivo com:

0,15,30,45 * * * * php /opt/mautic-2.9.2/app/console mautic:segments:update
3,18,33,48 * * * * php /opt/mautic-2.9.2/app/console mautic:campaigns:rebuild
6,21,36,51 * * * * php /opt/mautic-2.9.2/app/console mautic:campaigns:trigger
9,24,39,54 * * * * php /opt/mautic-2.9.2/app/console mautic:messages:send

Após a modificação, pressione o Escbotão para sair do modo de inserção.

Salve e saia:

:wq!

No futuro, você pode adicionar mais tarefas Cron Mautic da mesma maneira.

Finalmente, o Mautic está pronto para uso. Você pode tentar criar sua primeira campanha a partir do painel Mautic agora. Aproveite sua nova instância Mautic.