Como instalar o Drupal Atrium

 
Introdução:

Atrium é uma distribuição do Drupal voltada ao trabalho colaborativo que, modular, pode ser livremente alterada por meio da inclusão ou exclusão de módulos e temas, assim como o próprio Drupal.


Este tutorial destina-se à instalação local do Atrium, para estudo e desenvolvimento. Como é possível instalar vários CMS em paralelo para tal propósito, cada um deles é instalado sob uma pasta com seu nome, no diretório /var/www. Se seu desejo for instalá-lo no servidor, lembre-se de o fazer no diretório raiz.

Requisitos:

O Atrium utiliza o MySQL e o PHP que, por sua vez, necessita do servidor Apache. Se ainda não os tiver instalado em sua máquina, utilize este tutorial para tanto.

Instalação:

Com o Apache2, o MySQL e o PHP5 instalados e rodando, é possível iniciar a instalação do Atrium.

Comece baixando o sistema clicando no link presente no final desta página. Há duas versões: tar.gz e zip. Este tutorial utiliza a primeira.


Quando este tutorial foi redigido, a versão corrente era a 7.x-2.62 e o arquivo baixado chamava-se openatrium-7.x-2.62-core.tar.gz. Os exemplos seguintes levam em conta esta nomenclatura. Adapte-a segundo sua necessidade.

Copie o arquivo baixado para sua "Pasta pessoal" e digite no Terminal (Ctrl+Alt+T):

tar -xvzf openatrium(+Tab)

Dica: ao apertar a tecla "Tab" ao final do comando acima, o sistema o completará com o nome correto do arquivo a ser descompactado. Apenas certifique-se de que não há mais de uma arquivo que inicie com "openatrium" em sua "Pasta pessoal".

Copie a pasta descompactada para o diretório do servidor, renomeando-a para "atrium":


sudo mv open(+Tab) /var/www/atrium

É preciso duplicar o local padrão do arquivo de configuração, localizado no interior do diretório "sites/default", e criar uma pasta extra sob esta estrutura. Para tanto, use os seguintes códigos, em sequência:

cd /var/www/atrium/sites/default

sudo cp default.settings.php settings.php

sudo mkdir files

Volte para sua pasta pessoal:

cd /home/'seu-login'



Altere as permissões de acesso da pasta atrium:


sudo chown -R www-data:www-data /var/www/atrium/


Mude as permissões de escrita na pasta, para a instalação:


sudo chmod -R 777 /var/www/atrium

Configuração do MySQL:

Agora é necessário criar o banco de dados que será utilizado pelo Atrium. Rode o comando abaixo para acessar o MySQL. Rode o comando abaixo para acessar o MySQL. Será necessário entrar com a senha que foi introduzida no tutorial de instalação do LAMP.

mysql -u root -p

...em seguida, rode o seguinte comando para criar o banco de dados chamado "atriumdb":

CREATE DATABASE atriumdb;


Agora, crie um usuário para este banco de dados, que será chamado "atriumuser", e uma senha para ele. Atenção: não utilize a mesma senha usada na configuração do MySQL (o comando seguinte é de uma linha):


CREATE USER atriumuser@localhost IDENTIFIED BY 'nova_senha_aqui';


Rode o comando seguinte para conferir ao usuário "atriumuser" acesso pleno ao banco de dados atriumdb":

GRANT ALL ON atriumdb.* TO atriumuser@localhost;

Por fim, rode os comandos abaixo, um por vez, para resetar a tabela de permissões e para sair do MySQL:


FLUSH PRIVILEGES;


exit

Arquivo de configuração PHP:

Para configurar o PHP, é preciso alterar o tamanho máximo de upload. Comece abrindo o arquivo de configuração no Gedit com o comando abaixo:


a) PHP 7:

sudo gedit /etc/php/7.0/apache2/php.ini


b) PHP 5:

sudo gedit /etc/php5/apache2/php.ini



c) Ambas as versões:

Procure as linhas "upload_max_filesize" e "post_max_size" e altere os valores para 1G. Nas linhas "max_input_time" e "max_execution_time" altere o tempo para 360000 segundos, o que representa 6 horas.

upload_max_filesize = 64M
post_max_size = 64M
max_input_time = 360000 #The maximum time in seconds a script is allowed to parse input data.
max_execution_time = 360000
memory_limit = 512M

Configuração do Apache:

a) Módulo adicional:

É preciso abilitar o rewrite-module do servidor. Rode o seguinte comando no Terminal (Ctrl+T):

sudo a2enmod rewrite


b) .htaccess:


Altere o arquivo .htacess. Para tanto, digite:

sudo gedit /var/www/atrium/.htaccess

No arquivo de texto que se abrem procure por

# Override PHP settings. More in sites/default/settings.php
# but the following cannot be changed at runtime.


e inclua o texto abaixo logo na seção seguinte:


php_value memory_limit             512M

 

 

Em seguida, é necessário editar o arquivo de configuração do Apache para incluir os parâmetros específicos do Atrium e permitir o .htaccess. No nosso exemplo, a instalação é local e o arquivo procurado chama-se apache2.conf, que pode ser localizado com o comando:

find /etc -name apache2*


O resultado é:

/etc/apache2/apache2.conf


Para editar o arquivo, abra-o no Gedit com o comando abaixo:


sudo gedit /etc/apache2/apache2.conf

Aperte a combinação de teclas Ctrl+F, digite "directory" (sem as aspas) no campo de busca, localize a sessão correspondente e inclua as seguintes linhas para o Atrium:

<Directory /var/www/atrium>

             AllowOverride All
</Directory>

Salve o arquivo, feche o Gedit e carregue a alteração na configuração com o seguinte comando:

sudo /etc/init.d/apache2 reload

Nota: o endereço "/var/www/atrium" é o utilizado neste tutorial de instalação do sistema em um servidor local, para desenvolvimento. Adapte-o segundo sua necessidade.


c) Configuração geral do Apache:

Por padrão, o diretório raiz do Apache é var/www/html. Ocorre que o diretório Atrium é instalado diretamente no diretório "www", não sob o diretório "html". Para que o navegador consiga achar o programa, é necessário fazer com que o diretório raiz suba um nível. Para tanto, no Terminal, rode o comando:

sudo gedit /etc/apache2/sites-enabled/000-default.conf

Esse comando abre as configurações gerais do Apache. Procure a linha

'DocumentRoot /var/www/html" e a substitua por:

DocumentRoot /var/www

Salve o arquivo e feche o editor.

Reinicie o Apache:

sudo service apache2 restart

d) Cache de memória com APCu:


Cache de memória é utilizada diretamente pela aplicação web, como o Atrium, para contornar consultas lentas ao banco de dados ou checagens do sistema com a utilização de resultados pré-gravados na memória cache, seja localmente, seja em servidores em cluster. A ocupação da memória por estes caches é normalmente baixa, o que torna seu uso vantajoso. Neste tutorial, será utilizado o APCu.

Provavelmente, o módulo correto já está instalado. Para verificar, já ganhando tempo, rode o seguinte comando no Terminal:


a) PHP 7:


sudo apt-get install php-apcu

Em seguida, rode:

sudo phpenmod apcu

É preciso uma pequena alteração no arquivo de configuração do PHP. Abra-o no editor de texto com o comando:

sudo gedit /etc/php/7.0/mods-available/apcu-cli.ini

Inclua a seguinte linha:

apc.enable_cli = 1

Salve o arquivo de texto, feche o editor e rode o seguinte comando no Terminal:

sudo phpenmod apcu-cli


b) PHP 5:

sudo apt-get install php5-apcu

Em seguida, rode:

sudo php5enmod apcu

É preciso uma pequena alteração no arquivo de configuração do PHP. Abra-o no editor de texto com o comando:

sudo gedit /etc/php5/mods-available/apcu-cli.ini

Inclua a seguinte linha:

apc.enable_cli = 1

Salve o arquivo de texto, feche o editor e rode o seguinte comando no Terminal:

sudo php5enmod apcu-cli


c) Ambas as versões:

Reinicie o servidor:

sudo service apache2 restart

Configuração final do Atrium:

Abra o navegador e insira o endereço abaixo. Em seguida, siga as instruções de configuração fornecidas pelo próprio Atrium. No exemplo presente, seu_domínio.com  deve ser substituído por localhost o comando será:

http://seu_domínio.com/atrium

Na tela inicial, escolha a língia padrão e clique em "next". Na tela seguinte, entre com os dados do servidor:

Database name: atriumdb
Database username: atriumuser
Database password: a senha do banco de dados atriumdb utilizada na configuração do MySQL
Nome do hospedeiro: localhost


Clique em Salvar e continuar.


Na tela seguinte, escolha entre configuração mínima e configuração padrão. Use a mínima, que é recomendada pelo desenvolvedor. Clique em "Save and continue" para preencher as configurações do Site.

Última linha de código:

Por fim, altere as permissões de acesso da pasta do Atrium para conferir um pouco de proteção:


sudo chmod -R 755 /var/www/atrium/


É isso. Não deixe de acompanhar os tutoriais sobre otimização do Drupal: