Como instalar o MODX Revolution em um CentOS 7 LAMP VPS

• Pré-requisitos
• Etapa 1: adicionar um usuário Sudo
• Etapa 2: Atualizar o CentOS 7
• Etapa 3: Instale o Apache
• Etapa 4: Abrir portas do firewall da Web
• Etapa 5: desativar o SELinux (se ativado)
• Etapa 6: Instalar o PHP 5.4
• Etapa 7: Instalar o MariaDB (MySQL)
• Etapa 8: Criar um banco de dados para o MODX Revolution
• Etapa 9: Instalar arquivos MODX Revolution
• Etapa 10: Instalação completa do MODX Revolution

O MODX Revolution é um sistema de gerenciamento de conteúdo (CMS) de nível empresarial, rápido, flexível, escalável, gratuito e de código aberto, escrito em PHP. É particularmente adequado para a construção de sites sofisticados, pois possui recursos avançados multilíngues e é construído desde o início usando princípios de design seguro.

Neste tutorial, instalaremos o MODX Revolution 2.6.0 CMS em um CentOS 7 LAMP VPS.

Pré-requisitos

• Uma instância limpa do servidor Vultr CentOS 7 com acesso SSH

Etapa 1: adicionar um usuário Sudo

Começaremos adicionando um novo sudousuário.

Primeiro, faça login no seu servidor como root.

ssh root@YOUR_VULTR_IP_ADDRESS

Adicione um novo usuário chamado user1(ou seu nome de usuário preferido).

useradd user1

Em seguida, defina a senha para o user1usuário.

passwd user1

Quando solicitado, digite uma senha segura e memorável.

Agora verifique o /etc/sudoersarquivo para garantir que o sudoersgrupo esteja ativado.

visudo

Procure uma seção como esta.

%wheel        ALL=(ALL)       ALL

Essa linha nos diz que os usuários que são membros do wheelgrupo podem usar o sudocomando para obter rootprivilégios. Por padrão, ele deve ser descomentado, para que você possa simplesmente sair do arquivo.

Em seguida, precisamos adicionar user1ao wheelgrupo.

usermod -aG wheel user1

Podemos verificar a user1participação no grupo e verificar se o usermodcomando funcionou com o groupscomando.

groups user1

Agora use o sucomando para alternar para a nova user1conta de usuário sudo .

su - user1

O prompt de comando será atualizado para indicar que você está conectado à user1conta. Você pode verificar isso com o whoamicomando

whoami

Agora reinicie o sshdserviço para que você possa efetuar login sshcom a nova conta de usuário sudo não raiz que você acabou de criar.

sudo systemctl restart sshd

Saia da user1conta.

exit

E saia da rootconta (que desconectará sua sshsessão).

exit

Agora você pode acessar ssha instância do servidor do host local usando a nova user1conta de usuário sudo não raiz .

ssh user1@YOUR_VULTR_IP_ADDRESS

Se você deseja executar o sudo sem precisar digitar uma senha todas as vezes, abra o /etc/sudoersarquivo novamente, usando visudo.

sudo visudo

Edite a seção do wheelgrupo para que fique assim.

%wheel        ALL=(ALL)       NOPASSWD: ALL

Nota: Desabilitar o requisito de senha para o usuário sudo não é uma prática recomendada, mas é incluído aqui, pois pode tornar a configuração do servidor muito mais conveniente e menos frustrante, especialmente durante sessões mais longas de administração de sistemas. Se você estiver preocupado com as implicações de segurança, sempre poderá reverter a alteração na configuração para o original após concluir suas tarefas de administração.

Sempre que você desejar fazer login na rootconta do usuário a partir da sudoconta, você pode usar um dos seguintes comandos.

sudo -i
sudo su -

Você pode sair da rootconta e retornar à sua sudoconta de usuário a qualquer momento.

exit

Etapa 2: Atualizar o CentOS 7

Antes de instalar qualquer pacote na instância do servidor CentOS, primeiro atualizaremos o sistema.

Verifique se você está conectado ao servidor usando um usuário sudo não raiz e execute o seguinte comando.

sudo yum -y update

Etapa 3: Instale o Apache

Instale o servidor da web Apache.

sudo yum -y install httpd

Em seguida, use o systemctlcomando para iniciar e permitir que o Apache seja executado automaticamente no momento da inicialização.

sudo systemctl enable httpd
sudo systemctl start httpd

Verifique seu arquivo de configuração do Apache para garantir que a DocumentRootdiretiva aponte para o diretório correto.

sudo vi /etc/httpd/conf/httpd.conf

A DocumentRootopção de configuração deve ficar assim.

DocumentRoot "/var/www/html"

Agora, vamos garantir que o mod_rewritemódulo Apache esteja carregado. Podemos fazer isso pesquisando no arquivo de configuração dos módulos base do Apache o termo " mod_rewrite".

Abra o arquivo

sudo vi /etc/httpd/conf.modules.d/00-base.conf

Pesquise o termo " mod_rewrite".

Se o mod_rewritemódulo Apache estiver carregado, você deverá encontrar uma linha de configuração semelhante a esta.

LoadModule rewrite_module modules/mod_rewrite.so

Se a linha acima começar com um ponto e vírgula, você precisará remover o ponto e vírgula para remover o comentário da linha e carregar o módulo. Isso, é claro, também se aplica a outros módulos necessários do Apache.

Reiniciaremos o Apache no final deste tutorial, mas reiniciar o Apache regularmente durante a instalação e configuração é certamente um bom hábito, então vamos fazê-lo agora.

sudo systemctl restart httpd

Etapa 4: Abrir portas do firewall da Web

Agora precisamos abrir o padrão HTTPe as HTTPSportas, pois eles serão bloqueados firewalldpor padrão.

Abra as portas do firewall.

sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --permanent --add-port=443/tcp

Recarregue o firewall para aplicar as alterações.

sudo firewall-cmd --reload

Você deve ver a palavra successexibida no seu terminal após cada comando de configuração de firewall bem-sucedido.

Podemos verificar rapidamente se a HTTPporta Apache está aberta, visitando o endereço IP ou o domínio da instância do servidor em um navegador.

http://YOUR_VULTR_IP_ADDRESS/

Se tudo estiver configurado corretamente, você verá a página da web padrão do Apache no seu navegador.

Etapa 5: desativar o SELinux (se ativado)

SELinux significa "Security Enhanced Linux". É um aprimoramento de segurança para Linux que permite aos usuários e administradores mais controle sobre o controle de acesso. Ele está desativado por padrão nas instâncias do Vultr CentOS 7, mas abordaremos as etapas para desativá-lo, caso você não esteja iniciando a partir de uma instalação limpa e ela foi ativada anteriormente.

Para evitar problemas de permissão de arquivo com o MODX Revolution CMS, precisamos garantir que o SELinux esteja desativado.

Primeiro, vamos verificar se o SELinux está ativado ou desativado com o sestatuscomando

sudo sestatus

Se você vir algo como: SELinux status: disabledentão ele está definitivamente desativado e você pode pular diretamente para a Etapa 6. Se você vir outra mensagem, será necessário concluir esta seção.

Abra o arquivo de configuração do SELinux com o seu editor de terminal favorito.

sudo vi /etc/selinux/config

Mude SELINUX=enforcingpara SELINUX=disablede salve o arquivo.

Para aplicar a alteração na configuração, o SELinux requer uma reinicialização do servidor, para que você possa reiniciar o servidor usando o painel de controle do Vultr ou simplesmente usar o shutdowncomando

sudo shutdown -r now

Quando o servidor reiniciar, sua sessão SSH será desconectada e você poderá ver uma mensagem reclamando 'broken pipe'ou informando você 'Connection closed by remote host'. Não se preocupe, basta aguardar 20 segundos ou mais e voltar a fazer o SSH novamente com seu próprio nome de usuário e domínio.

ssh user1@YOUR_DOMAIN

Ou com seu próprio nome de usuário e endereço IP.

ssh user1@YOUR_VULTR_IP_ADDRESS

Depois de fazer login novamente, verifique o status do SELinux novamente com o sestatuscomando para garantir que ele esteja desativado corretamente.

sudo sestatus

Você deve ver uma mensagem dizendo SELinux status: disabled. Se você SELinux status: enabledvir uma mensagem dizendo (ou algo semelhante), será necessário repetir as etapas acima e garantir que você reinicie corretamente o servidor.

Etapa 6: Instalar o PHP 5.4

Agora podemos instalar o PHP 5.4 junto com os módulos PHP necessários exigidos pelo MODX Revolution CMS.

sudo yum -y install php php-mbstring php-gd php-common php-pdo php-pecl-imagick php-mysqlnd

Etapa 7: Instalar o MariaDB (MySQL)

O CentOS 7 usa como padrão o MariaDB, que é um substituto aprimorado, totalmente aberto e desenvolvido pela comunidade, para o MySQL.

Instale o MariaDB.

sudo yum -y install mariadb-server

Inicie e ative o MariaDB para executar automaticamente no momento da inicialização.

sudo systemctl enable mariadb
sudo systemctl start mariadb    

Proteja a instalação do servidor MariaDB.

sudo mysql_secure_installation

A rootsenha ficará em branco, então pressione " enter" quando solicitado root.

Quando solicitado a criar um rootusuário MariaDB / MySQL , selecione " Y" (para sim) e digite uma rootsenha segura . Basta responder " Y" a todas as outras perguntas sim / não, pois as sugestões padrão são as opções mais seguras.

Etapa 8: Criar um banco de dados para o MODX Revolution

Efetue login no shell do MariaDB como o rootusuário do MariaDB executando o seguinte comando.

sudo mysql -u root -p

Para acessar o prompt de comando do MariaDB, basta digitar a rootsenha do MariaDB quando solicitado.

Execute as seguintes consultas para criar um banco de dados MariaDB e um usuário de banco de dados para o MODX Revolution.

CREATE DATABASE modx_data CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'modx_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON modx_data.* TO 'modx_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Você pode substituir o nome do banco de dados modx_datae o nome de usuário modx_userpor algo mais ao seu gosto, se preferir. (Observe que o tamanho máximo padrão para nomes de usuário no MariaDB no CentOS 7 é de 16 caracteres). Além disso, certifique-se de substituir " UltraSecurePassword" por uma senha realmente segura.

Etapa 9: Instalar arquivos MODX Revolution

Altere seu diretório de trabalho atual para o diretório da web padrão.

cd /var/www/html/

Se você receber uma mensagem de erro dizendo algo parecido 'No such file or directory', tente o seguinte comando.

cd /var/www/ ; sudo mkdir html ; cd html

Seu diretório de trabalho atual deve ser agora /var/www/html/. Você pode verificar isso com o pwdcomando (imprimir diretório de trabalho).

pwd

Agora use wgetpara baixar o pacote zip de instalação do MODX Revolution.

sudo wget https://modx.com/download/direct?id=modx-2.6.0-pl.zip

Observação: você deve definitivamente verificar a versão mais recente visitando a página de download do MODX Revolution .

Liste o diretório atual para verificar se você fez o download do arquivo com sucesso.

ls -la

Instale rapidamente unzippara poder descompactar o arquivo.

sudo yum -y install unzip

Vamos dar ao pacote um nome mais simples.

sudo mv direct\?id\=modx-2.6.0-pl.zip modx.zip

Agora descompacte o pacote zip.

sudo unzip modx.zip

Mova todos os arquivos de instalação para o diretório raiz da web.

sudo mv modx-2.6.0-pl/* /var/www/html

Altere a propriedade dos arquivos da web para evitar problemas de permissão.

sudo chown -R apache:apache * 

Reinicie o Apache novamente.

sudo systemctl restart httpd

Agora estamos prontos para avançar para a etapa final.

Etapa 10: Instalação completa do MODX Revolution

É hora de visitar o endereço IP da instância do servidor CentOS 7 no seu navegador. Ou, se você já definiu as configurações de DNS do Vultr (e deu tempo suficiente para se propagar), pode simplesmente visitar seu domínio.

Para acessar a página de instalação do MODX Revolution, digite o endereço IP da instância do Vultr, seguido pela /setupbarra de endereços do navegador.

http://YOUR_VULTR_IP_ADDRESS/setup

A maioria das opções de instalação é auto-explicativa, mas aqui estão algumas dicas para ajudá-lo.

Selecione sua lingua.

Clique no Nextbotão para continuar a instalação.

Selecione New Installatione deixe as permissões da pasta com seus valores padrão. Clique em Nextquando estiver pronto para avançar para a próxima etapa

Defina as seguintes opções de banco de dados.

Database type:          mysql
Database host:          localhost
Database login name:    modx_user (or your previously selected name)
Database password:      UltraSecurePassword (or your previously chosen password)
Database name:          modx_data (or your previously selected name)
Table prefix:           modx_

Depois de inserir as opções de banco de dados acima, clique no link abaixo para Test database server connection and view collations. Você verá uma mensagem que diz Connecting to database server: Success!. Se houver algum erro, volte e verifique se todas as opções do banco de dados estão corretas.

Você pode deixar o conjunto de caracteres e as opções de agrupamento com seus valores padrão. Eles devem ficar assim.

Connection character set:   utf8
Collation:                  utf8_general_ci

Quando estiver satisfeito com as opções de instalação selecionadas, você pode clicar no link abaixo para Create or test selection of your database.

Você será solicitado a inserir os detalhes do administrador, que serão usados ​​para fazer login no CMS. Preencha-os conforme mostrado abaixo e clique em Next.

Administrator name:         <your_prefered_admin_name>
Administrator email:        <your_admin_email>
Administrator password:     <a_secure_password
Confirm password:           <the_same_secure_password>

Você verá um Installation Summary. Enquanto tudo estiver bem, você pode simplesmente clicar Installpara instalar o MODX Revolution na instância do servidor.

Você verá uma página de confirmação que diz Core installation was successful. Basta clicar Nextpara continuar.

Agora você pode fazer login no painel de administração do MODX Revolution usando os detalhes de login inseridos anteriormente durante a instalação.

Observação: durante a instalação e o login, você pode ver algumas mensagens de aviso sobre diretórios e arquivos. Simplesmente siga as instruções mostradas nas páginas de aviso e as mensagens de aviso desaparecerão.

Se você ainda não configurou o seu Vultr DNS, provavelmente esse será o seu próximo passo.

Agora você pode começar a adicionar seu conteúdo e começar a configurar a aparência do seu site. Verifique os excelentes documentos do MODX Revolution para obter mais orientações sobre como criar e configurar seu site.