Skip to Content

Tutoriais

Principais demandas de manutenção – parte 1

18 de julho de 2024

Instalação do tema da Base Arch

sudo su
cd /home/fiocruz
wget https://www.blogbasearch.coc.fiocruz.br/wp-content/uploads/2024/07/arBaseArchPlugin.tgz
tar -xvzf arBaseArchPlugin.tgz
cp arBaseArchPlugin /usr/share/nginx/atom/plugins/ -R
cd /usr/share/nginx/atom/
nano /usr/share/nginx/atom/plugins/arBaseArchPlugin/config/arBaseArchPluginConfiguration.class.php

Acrescentar a palavra “Theme” na variável $sumary

./refresh.sh

 

Arquivos de tradução

 

Comandos de manutenção básicos

Texto

Categories: Tutoriais
Comentários desativados

Migração de dados

18 de julho de 2024

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

Categories: Tutoriais
Comentários desativados

Instalação do AtoM 2.8.2

15 de julho de 2024

Depois de instalar todas as dependências, devemos fazer download do pacote AtoM. Existem duas maneiras de fazê-lo: via download de um pacote em formato tar.gz ou via repositório git. As instruções apresentadas nesse tutorial dizem respeito ao download de arquivo tar.gz. Para informações sobre a instalação via repositório do git, consulte a documentação oficial.

Cabe ressaltar que todos os procedimentos aqui relatados são baseados no processo oficial de instalação do AtoM, fornecido pela Artefactual no blog Access to Memory.
Finish reading Instalação do AtoM 2.8.2

Categories: Tutoriais
Comentários desativados
Comentários desativados
Comentários desativados
Comentários desativados
Comentários desativados
Comentários desativados