Como instalar o MODX Revolution em um FreeBSD 11 FAMP VPS

• Pré-requisitos
• Etapa 1: adicionar um usuário Sudo
• Etapa 2: Atualizar o sistema FreeBSD 11
• Etapa 3: Instale o Apache
• Etapa 4: Instalar o PHP 7.1
• Etapa 5: Instale o MariaDB (MySQL)
• Etapa 6: Crie um banco de dados para o MODX Revolution
• Etapa 7: Instale os arquivos MODX Revolution
• Etapa 8: 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 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.

Pré-requisitos

• Uma instância limpa do servidor Vultr FreeBSD 11 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

O sudocomando não é instalado por padrão na instância do servidor Vultr FreeBSD 11, portanto, instalaremos primeiro sudo.

pkg install sudo

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

adduser user1

O addusercomando solicitará muitos detalhes para a conta do usuário; basta selecionar os padrões para a maioria deles, quando fizer sentido. Quando lhe for perguntado se Invite user1 into any other groups?você deve entrar, wheeladicione user1-o ao wheelgrupo.

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. Ele será comentado por padrão; portanto, será necessário descomentá-lo e, em seguida, salvar e sair do arquivo.

Podemos verificar a user1participação no grupo com o groupscomando

groups user1

Se user1não for um membro do wheelgrupo, você pode usar este comando para atualizar a user1associação ao grupo.

pw group mod wheel -m 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 /etc/rc.d/sshd restart

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 sudosem 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 FreeBSD 11

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

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

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

Etapa 3: Instale o Apache

Instale o servidor da web Apache 2.4.

sudo pkg install apache24

Digite " y" quando solicitado.

Agora use o sysrccomando para permitir que o serviço Apache seja executado automaticamente no momento da inicialização.

sudo sysrc apache24_enable=yes

O sysrccomando atualiza o /etc/rc.confarquivo de configuração; portanto, se você deseja verificar a atualização da configuração manualmente, basta abrir o /etc/rc.confarquivo com o seu editor de terminal favorito.

vi /etc/rc.conf

Agora inicie o serviço Apache.

sudo service apache24 start

Você pode verificar rapidamente se o apache está em execução visitando o endereço IP ou o domínio da instância do servidor em seu navegador.

http://YOUR_VULTR_IP_ADDRESS/

Você deve ver a página padrão do FreeBSD Apache exibindo o texto.

It works!

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

sudo vi /usr/local/etc/apache24/httpd.conf 

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

DocumentRoot "/usr/local/www/apache24/data"

Agora precisamos ativar o mod_rewritemódulo Apache. Podemos fazer isso pesquisando o arquivo de configuração padrão do Apache para o termo mod_rewrite.

Por padrão, o mod_rewritemódulo Apache será comentado (o que significa que está desativado). A linha de configuração em uma instância limpa do Vultr FreeBSD 11 ficará assim.

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Simplesmente remova o símbolo de hash 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.

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

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 service apache24 restart

Etapa 4: Instalar o PHP 7.1

Agora podemos instalar a versão mais recente do PHP junto com todos os módulos PHP necessários exigidos pelo MODX Revolution CMS.

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib

Precisamos configurar o Apache para realmente usar o PHP, então vamos criar um novo arquivo chamado php.conf" Includes" no diretório Apache .

sudo vi /usr/local/etc/apache24/Includes/php.conf

Digite o seguinte texto no arquivo recém-criado.

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

Salve o arquivo.

Agora, vamos reiniciar o Apache novamente.

sudo service apache24 restart

Etapa 5: Instale o MariaDB (MySQL)

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

Instale a versão mais recente do MariaDB.

sudo pkg install mariadb102-server mariadb102-client

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

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

Proteja a instalação do servidor MariaDB.

sudo mysql_secure_installation

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 6: Crie 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 MySQL quando solicitado.

Execute as seguintes consultas para criar um banco de dados MySQL 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 7: Instale os arquivos MODX Revolution

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

cd /usr/local/www/apache24/data

Seu atual diretório de trabalho agora deve ser: /usr/local/www/apache24/data. 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

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/* /usr/local/www/apache24/data

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

sudo chown -R www:www *

Reinicie o Apache novamente.

sudo service apache24 restart

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

Etapa 8: Instalação Completa do MODX Revolution

É hora de visitar o endereço IP da sua instância do servidor FreeBSD 11 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 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 resumo da instalação. 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 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.