Como instalar o MODX Revolution em um LAMP VPS do Fedora 26

• Pré-requisitos
• Etapa 1: adicionar um usuário Sudo
• Etapa 2: Atualizar o sistema Fedora 26
• Etapa 3: Instale o Apache
• Etapa 4: Abrir portas do firewall da Web
• Etapa 5: Desativar o SELinux
• Etapa 6: Instalar o PHP 7.1
• Etapa 7: Instale o MariaDB
• Etapa 8: Criar 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 FPS 26 LAMP VPS usando Apache, PHP 7.1 e um banco de dados MariaDB.

Pré-requisitos

• Uma instância limpa do servidor Vultr Fedora 26 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.

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

visudo

Procure uma seção como esta.

%wheel        ALL=(ALL)       ALL

Verifique se não está comentado. Essa linha nos diz que os usuários que são membros do wheelgrupo podem usar o sudocomando para obter rootprivilégios.

Depois de editar o arquivo, você pode salvar e sair pressionando " Esc" e depois inserindo " :wq" para "gravar" e "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

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 sistema Fedora 26

Antes de instalar qualquer pacote na instância do servidor Fedora, 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 dnf -y update

Etapa 3: Instale o Apache

Instale o servidor da web Apache.

sudo dnf -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ê 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ê deverá ver a página da web padrão do Apache no seu navegador.

Etapa 5: Desativar o SELinux

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 é ativado por padrão no Fedora 26, mas definitivamente não é essencial para a segurança do servidor, pois muitas distribuições de servidores Linux não são fornecidas com ele instalado ou ativado por padrão.

Para evitar problemas de permissão de arquivo com o MODX Revolution posteriormente, desabilitaremos o SELinux, por enquanto. Entã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 exige uma reinicialização do servidor, para que você possa reiniciar o servidor usando o painel de controle do Vultr ou simplesmente usar o shutdowncomando para desligar e reiniciar o servidor corretamente .

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 o login novamente, verifique o status do SELinux 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 7.1

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

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

Etapa 7: Instale o MariaDB

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

Instale o MariaDB.

sudo dnf -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 sua instalação do MariaDB.

sudo mysql_secure_installation

A rootsenha provavelmente estará em branco, então simplesmente pressione " enter" quando a rootsenha for solicitada .

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

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 sua instância do servidor Fedora 26 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 da revolução MODX, 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 Installation" e deixe as permissões da pasta com seus valores padrão. Clique em " Next" quando 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ê deverá 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ê deve ver um resumo da instalação. Enquanto tudo estiver bem, você pode simplesmente clicar em " Install" para instalar o MODX Revolution na instância do servidor.

• Se a instalação foi bem-sucedida, você verá uma página de confirmação informando Core installation was successful. Basta clicar em " Next" para 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 deve 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.