Para as instituições que já possuem o AtoM instalado, o próximo passo é migrar os dados antigos para nova instalação da ferramenta. Tal como os procedimentos anteriores, este foi baseado no tutorial oficial.
MIGRAÇÃO DE DADOS
Restauração do backup dos arquivos
Após instalar o AtoM, é necessário realizar a migração de dados da versão anterior. Para isso, deve-se realizar um backup dos arquivos e do banco de dados do servidor de hospedagem anterior. Este backup deve contemplar os arquivos da aplicação e de banco de dados. Para copiar todo o AtoM anterior, pode ser utilizado o seguinte comando (pode ser necessário adaptar os caminhos dos diretórios para a realidade da instituição):
tar -cvzf atom.tgz /usr/share/nginx/atom
O banco de dados, por sua vez, pode ser exportado com o seguinte comando:
mysqldump -uroot -p atom > atom.sql
IMPORTANTE: Esse tutorial considera que esse backup já foi realizado. Os arquivos da aplicação foram compactados em um arquivo .tgz e o banco de dados exportado em um arquivo .sql.
Assim sendo, baixe os arquivos para o servidor que está configurando, usando wget. Antes, porém, certifique-se de que está dentro do diretório /home:
cd /home/fiocruz/
wget https://www.blogbasearch.coc.fiocruz.br/wp-content/uploads/2024/07/atom.tgz
wget https://www.blogbasearch.coc.fiocruz.br/wp-content/uploads/2024/07/atom.sql
Depois de baixar os arquivos, não esqueça de transformar seu usuário em super usuário:
sudo su
Antes de importar o banco, recomenda-se ampliar a memória do MySQL para que o processo ocorra com mais velocidade. Isso pode ser feito acessando o prompt do MySQL:
mysql -uroot -p
E executar o seguinte comando:
SET GLOBAL innodb_buffer_pool_size=2402653184;
Para verificar se a alteração teve efeito, basta rodar a seguinte query, ainda no prompt do Mysql:
SELECT @@innodb_buffer_pool_size/1024/1024/1024;
E depois sair do MySQL:
exit;
Depois, execute os seguintes comandos:
– Para descompactar o arquivo atom.tar:
tar -xvzf atom.tgz
– Para transferir os objetos digitais e inventários:
sudo mv atom/r /usr/share/nginx/atom
sudo mv atom/uploads/* /usr/share/nginx/atom/uploads
sudo mv atom/downloads/* /usr/share/nginx/atom/downloads
– Para remover os jobs anteriores – do outro servidor – que foram copiados anteriormente:
sudo rm -f /usr/share/nginx/atom/downloads/jobs/*
Transferência do backup do banco de dados
Em primeiro lugar, é necessário remover o banco de dados atual (que está vazio, pois foi criado recentemente) com o seguinte comando:
sudo mysql -u root -p -e "DROP DATABASE IF EXISTS atom;"
Depois, deve-se criar um novo banco de dados – vazio:
sudo mysql -u root -p -e "CREATE DATABASE atom CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;"
E então carregar o banco de dados do AtoM anterior, em que foi feito backup:
sudo mysql -u root -p atom < atom.sql
Execução da tarefa de migração
A tarefa de migração foi programada para ser feita a partir do Framework Symfony. Logo, é essencial que seja realizada dentro do diretório da aplicação:
cd /usr/share/nginx/atom
Dentro do diretório, execute o seguinte comando:
sudo php -d memory_limit=-1 symfony tools:upgrade-sql
Configurações adicionais
Como foram feitas cópias de arquivos com o usuário root, devemos redefinir as permissões do diretório para o usuário www-data:
chown -R www-data:www-data /usr/share/nginx/atom
Para que as alterações tenham efeito, é necessário reindexar a pesquisa, considerando os arquivos importados para o banco de dados e limpar o cache do aplicativo, com os comandos:
php -d memory_limit=-1 symfony search:populate
Vamos limpar o cache com nosso script:
./refresh.sh
É necessário também reiniciar outros serviços, para garantir que tudo funcione corretamente, como orienta a documentação oficial do AtoM:
sudo systemctl restart memcached
sudo systemctl restart atom-worker sudo systemctl status atom-worker
Por fim, devemos ajustar a URL base do sistema. Essa URL é usada em exportações e, no nosso caso, pode estar apontando para um local inapropriado. Para ajustar, deve-se acessar a área administrativa do AtoM e no menu principal localizado na barra de cabeçalho, acionar a opção “admin” e selecionar Configurações/Definições. Na aba “Informações do site”, basta conferir se URL base está correta: “127.0.0.1”.