O objetivo deste tópico é compartilhar as várias experiências e as peculiaridades de migração de dados para o Koha, a partir dos diversos sistemas de gerenciamento de biblioteca. Aqui podem ser esclarecidas dúvidas a respeito de migrações, e compartilhadas as experiências bem-sucedidas de diferentes migrações.
Importação de histórico de circulação no Koha.
A importação do histórico de circulação pode ser feita pelo módulo de circulação offline do Koha, em “Circulação” > “Carregar arquivo de circulação offline (.koc)”, localizado na parte inferior esquerad da tela.
O arquivo a ser importado deve ser criado, com extensão .koc.
As informações inseridas no arquivo devem seguir o padrão para .koc estabelecido para o Koha. Um exemplo de padrão a ser seguido pode ser encontrado no seguinte link:
https://wiki.koha-community.org/wiki/Koha_offline_circulation_file_format
Observe que, para a montagem do arquivo, é necessário dispor das informações requisitadas:
- Data da operação (seguindo o formato AAAA-MM-DD HH:MM:SS ms) (para todas as operações);
- Tipo de operação: issue, return e payment, que correspondem a empréstimo, devolução e pegamento.
- Número de carteirinha (para os casos de empréstimo e pagamento)
- Código de barras do item em questão (para empréstimo e devolução)
- Custo (para pagamentos).
Destaco a importância de manter a ordem cronológica dos dados. O Koha verifica as entradas de uma por uma durante a importação do arquivo, destaca possíveis erros e ignora as entradas incorretas.
Atualização de versão do Koha.
A atualização do Koha é feita em uma sequência simples de comandos, que devem ser executados no servidor do koha em questão. Destaca-se que o termo nomeInstancia usado abaixo deve ser substituido pelo nome da instância ativa do Koha.
- A instalação da nova versão é feita pelo mesmo comando usado para instalar o Koha. Antes de executar, a máquina deve passar pela atualização dos pacotes:
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install koha-common
OBS: Se a nova versão não for encontrada, será preciso atualizar a referência ao repositório da comunidade, considerando o SO utilizado no servidor Koha, da mesma forma feita durante a instalação e descrito em:
https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages
-
Atualizar o esquema das tabelas na base de dados:
$ sudo koha-upgrade-schema nomeInstancia -
Reindexar o zebra:
$ sudo koha-rebuild-zebra -v -f nomeInstancia -
Atualizar o idioma português utilizado (ou outro, caso não seja o inglês):
$ sudo koha-translate --update pt-BR
A indicação da nova versão pode ser vista na interface administrativa do sistema. Para isso, entrar em “Sobre o Koha” no menu superior, e verificar a “Versão do Koha” na aba “Informações do servidor”.
Olá Italo, estávamos com versão 19.05 e tivemos problemas na atualização para versão mais recente do Koha 21.11. Só consegui após realizar os seguintes passos:
Passo 1 - Adicionar um repositório da comunidade Koha para versão estável para qual deseja atualizar o koha
Copie e cole no terminal (semelhante o cmd no windows) o seguinte comando e aperte enter
$ echo ‘deb Debian packages for Koha stable main’ | sudo tee /etc/apt/sources.list.d/koha.list
Passo 2 - Atualize a lista de pacotes:
$ sudo apt-get update
Passo 3 - Adicionar o repositório específico para versão estável para qual deseja atualizar o koha (informe a versão)
$ echo ‘deb Debian packages for Koha 21.11 main’ | sudo tee /etc/apt/sources.list.d/koha.list
Obs: 21.11 é a versão do exemplo
Passo 4 - Atualize a lista de pacotes:
$ sudo apt-get update
Em seguida realizei os demais passos atualizando as tabelas do banco de dados do Koha, Reindexação do Zebra e atualização do idioma português. Deu certo!
Boa tarde.
Estou a iniciar a utilização do Koha.
A organização onde trabalho tem em produção o Koha 16.05 numa máquina com Debian+mariadb, Eu instalei o Koha 24.05.04 numa máquina Ubuntu+mariadb.
Há alguma forma de transferir a informação da versão em produção para a minha versão em testes?
Obrigada.
Bom dia!
Não tenho certeza se ao realizar esse passo a passo que vou enviar o seu Koha de testes vai ficar na mesma versão do de produção, se não ficar você pode atualiza-lo utilizando os comandos do final.
Existe um jeito sim de realizar essa migração, primeiramente garanta que você tenha um cadastro no Koha de produção, após isso você faz o backup da versão de produção usando o seguinte comando no servidor:
sudo mysqldump -uroot -p nome_da_sua_biblioteca | xz > nome_desejado_para_o_arquivo.sql.xz
Após isso no ambiente de testes você usa esses comandos para acessar o banco de dados (tenha muito cuidado para não usar esse comando no ambiente de produção pois ele apaga o banco de dados):
sudo mysql -uroot -p
drop database nome_da_biblioteca_de_testes;
create database nome_da_biblioteca_de_testes;
quit;
Com o banco de dados vazio, você extrai o arquivo do backup e utiliza o seguinte comando (sempre prestando atenção nos nomes dos arquivos desejados e ambiente que está realizando isso):
sudo mysql -uroot -p nome_da_biblioteca_de_testes< nome_desejado_para_o_arquivo.sql
exit
Após isso é só atualizar o Koha e reindexar o zebra:
sudo service memcached restart
sudo koha-upgrade-schema nome_da_biblioteca_de_testes
sudo koha-rebuild-zebra -v -f nome_da_biblioteca_de_testes
Atualização do Koha caso necessário:
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install koha-common
sudo apt-get clean
sudo koha-upgrade-schema nome_da_biblioteca
sudo koha-rebuild-zebra -v -f nome_da_biblioteca
Acredito que realizando esse passo a passo a migração do koha para um servidor de testes ocorra sem problemas. Caso tenha mais dúvidas, fique à vontade para perguntar!