Experiências de migração no Koha

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.

1 curtida

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.

3 curtidas

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.

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

  1. Atualizar o esquema das tabelas na base de dados:
    $ sudo koha-upgrade-schema nomeInstancia

  2. Reindexar o zebra:
    $ sudo koha-rebuild-zebra -v -f nomeInstancia

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

2 curtidas

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!

2 curtidas

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!

2 curtidas