RELATO DA EXPERIÊNCIA DO DAG NA ATUALIZAÇÃO DO SOFTWARE ICA-AtoM DA VERSÃO 1.2 PARA 1.3

Neiva Pavezi

Dhion Carlos Hedlund

(07/03/2013)

A nossa equipe é formada por Arquivistas e não temos conhecimento na programação do ICA-AtoM. Esse foi o principal motivo das nossas dificuldades. No decorrer das atividades executadas ficou bastante evidente a necessidade da participação de um profissional da área de informática, com conhecimento dos comandos do framework Simfony.

Conseguimos migrar os dados da versão 1.2 para a versão 1.3 que já está disponível on-line. O estudo do AtoM é contínuo, nesse momento estamos listando os problemas que vamos encontrando, principalmente nos resultados de busca e importação.

O primeiro passo para a atualização do software foi a instalação da versão 1.3.0 no servidor. O download foi realizado a partir do site <www.ica-atom.org>.

O procedimento de instalação foi realizado de acordo com as instruções de <www.ica-atom.org/doc/Installation> e <www.qubit-toolkit.org/wiki/Installation_-_Setting_directory_and_file_permissions>.

Na primeira tentativa (12/09/2012), o arquivo de configuração da versão 1.3 foi alterado para utilizar a base de dados em que estão todos os dados da descrição da versão 1.2. Isso gerou o erro ao fazer o login:  "Oops! An Error Occurred - The server returned a "500 Internal Server Error".

De acordo com o manual para atualização da versão, deve ser executada a tarefa de atualização da base de dados da versão 1.2, executando o comando: $ php symfony tools:upgrade-sql.

Quando executamos esse comando, apareceu o seguinte erro: impossível abrir symfony. Repetimos esse comando várias vezes, sem sucesso.

Entramos em contato com a equipe da empresa Artefactual e fomos prontamente atendidos por Jesús Garcia Crespo. O esclarecimento que recebemos foi que:

ICA-AtoM 1.3 no es compatible con bases de datos anteriores. El administrador necesita realizar la actualización manualmente. (...)symfony es un script que se encuentra dentro del directorio raíz de ICA-AtoM. Por ejemplo, si tienes ICA-AtoM instalado en /var/www/ica-atom, primero tendrás que cambiar el directorio actual en tu intérprete de comandos:

$ cd /var/www/ica-atom

Una vez hayas realizado el paso anterior, podrás ejecutar el script:

$ php symfony tools:upgrade-sql

Ao realizarmos o procedimento acima, obtivemos a seguinte situação:

pfoto@pfoto-ThinkCentre-xxx:~$ cd '/var/www'

pfoto@pfoto-ThinkCentre-xxx:/var/www$ cd '/var/www/icaatom-1.2.0'

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.2.0$ php symfony tools:upgrade-sql

Task "tools:upgrade-sql" is not defined.

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.2.0$

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.2.0$

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.2.0$

O motivo desse erro foi que rodamos o comando a partir do diretório raiz da versão 1.2.0. É preciso rodar o comando a partir do diretório 1.3.

Realizado o comando corretamente, obtivemos o seguinte resultado:

pfoto@pfoto-ThinkCentre-xxx:~$ cd '/var/www/icaatom-1.3.0/icaatom-1.3.0'

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$ php symfony tools:upgrade-sql

>> backup Backing up database "teste" to db_20130228033846.sql.bak

>> backup Database backup complete!

>> upgrade-sql Upgrading from Release 1.1

>> upgrade-sql Upgrading from Release 1.2

>> upgrade-sql Upgrading from Release 1.3

>> upgrade-sql Already at latest version (92), no upgrades done

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$ cd

pfoto@pfoto-ThinkCentre-xxx:~$ ^C

pfoto@pfoto-ThinkCentre-xxx:~$ ^C

pfoto@pfoto-ThinkCentre-xxx:~$

Repetimos o procedimento e tivemos a seguinte situação, com um pequeno progresso em relação à tentativa anterior:

pfoto@pfoto-ThinkCentre-xxx:~$ cd '/var/www/icaatom-1.3.0/icaatom-1.3.0'

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$ php symfony tools:upgrade-sql

>> backup Backing up database "teste" to db_20130301073614.sql.bak

>> backup Database backup complete!

>> upgrade-sql Upgrading from Release 1.1

>> upgrade-sql Upgrading from Release 1.2

PHP Fatal error: Class QubitTerm contains 4 abstract methods and must therefore be declared abstract or implement the remaining methods (ArrayAccess::offsetExists, ArrayAccess::offsetGet, ArrayAccess::offsetSet, ...) in /var/www/icaatom-1.3.0/icaatom-1.3.0/lib/model/QubitTerm.php on line 30

Fatal error: Class QubitTerm contains 4 abstract methods and must therefore be declared abstract or implement the remaining methods (ArrayAccess::offsetExists, ArrayAccess::offsetGet, ArrayAccess::offsetSet, ...) in /var/www/icaatom-1.3.0/icaatom-1.3.0/lib/model/QubitTerm.php on line 30

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$

A partir dessa situação, Crespo nos orientou a apagar o diretório do cache, da seguinte forma:

Anyways, that errors is related to the cache but. It gets fixed by running the following commands form the AtoM directory:

$ rm -rf cache/*

$ php symfony cc

And then you can run the command:

$ php symfony tools:upgrade-sql

That's in the user manual by the way :P

A informação acima está disponível no Manual do usuário!

Sucesso!

pfoto@pfoto-ThinkCentre-xxx:~$ cd '/var/www/icaatom-1.3.0/icaatom-1.3.0'

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$ rm -rf cache/*pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$ php symfony ccpfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$ php symfony tools:upgrade-sql

>> backup Backing up database "teste" to db_20130305042607.sql.bak

>> backup Database backup complete!

>> upgrade-sql Upgrading from Release 1.1

>> upgrade-sql Upgrading from Release 1.2

>> upgrade-sql Upgrading from Release 1.3

>> upgrade-sql Successfully upgraded to Release 1.3 v92

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$ ^C

pfoto@pfoto-ThinkCentre-xxx:/var/www/icaatom-1.3.0/icaatom-1.3.0$

Depois de conseguirmos rodar a base na versão 1.3 (06/03/2013), foi necessário reconstruir o sistema de busca. De acordo com Crespo:

Don't forget to rebuild the search engine!

php symfony search:populate QubitSearch

Foram 6 meses de trabalho e estudo que nos renderam bastante conhecimento introdutório na área de informática. O pronto atendimento que recebemos da empresa Artefactual foi imprescindível. Apesar das nossas limitações (pessoas, máquinas, tempo) os resultados obtidos são importantes e servirão de subsídio para o intercâmbio de informações com os demais usuários dessa ferramenta.

A partir de agora, iniciamos os testes de busca e exportação na versão 1.3 do AtoM.

Esperamos que a versão 2.0 seja lançada em breve, pois de acordo com o site oficial, esta terá algumas mudanças significativas em relação à versão 1.3, principalmente em relação ao motor de busca, confira algumas:

·       Substituição do motor padrão de busca escrito em PHP (Zend Lucene) para um novo baseado em Java (Lucene/ElasticSearch);

·       Mudança nos resultados da busca, passando a exibir os resultados de forma hierárquica;

·       Busca popular;

·       Amigável a aparelhos móveis (Iphone, Android) – CSS para aparência de busca básica (em vez de Java, para diminuir o tempo de carregamento da página nos dispositivos móveis);

·       Mais opções para personalizar a template, como esquema de cores, background e logo a partir do painel de controle;

·       Adicionar esquema de metadados “Canadiana Metadata Repository” para exportação em XML; e outros.

Confira outros recursos que serão implementados na versão 2.0 em http://www.accesstomemory.org/wiki/Main_Page

Atualizando o ICA-AtoM

Recomendações do site do ICA para realizar a atualização do software:

Considerações preliminares

Este guia explica como fazer a atualização de versão 1.1 ou 1.2 para a versão 1.3. Se o cenário é diferente, por favor, consulte a documentação de atualização Qubit. No entanto, recomendamos nossos usuários a instalar a versão mais recente, porque é mais seguro, mais rápido, mais estável e inclui todos os tipos de novas funcionalidades e melhorias.

Enquanto nós tentamos fazer este documento utilizável pelos leitores com uma ampla gama de conhecimentos técnicos, pode ser muito complexo, se você não tem nenhuma experiência anterior com a instalação de aplicativos Web ou utilizando a linha de comando do Linux.

Além disso, considere desabilitar seu site durante a atualização. Redirecionar seus usuários para uma página temporária "em manutenção", usando o redirecionamento do servidor. O link a seguir explica como fazer isso usando Apache e mod_rewrite: http://davidwalsh.name/htaccess-maintenance-page-redirect.

Verificar Requisitos

Por favor, consulte a página de requisitos mínimos para se certificar de que o sistema atenda a todos os requisitos.

Leia as notas de lançamento

Esta é a oportunidade de descobrir o que mudou na nova versão, há novos recursos, melhorias e correções de bugs que podem ser de interesse para você e sua organização.

Fazer backup de arquivos e banco de dados existentes

Antes de prosseguir com a atualização, por favor, faça um backup completo de todos os seus dados seguindo nossas instruções: backup de dados.

Descompacte os arquivos novos

Se você deseja instalar no mesmo diretório como sua versão anterior, você deve remover o diretório de instalação do antigo primeiro. Mover o diretório existente, em vez de excluí-la, preserva os objectos digitais, arquivos personalizados ou traduções para a transferência para a nova versão do aplicativo. Por exemplo:

$ Mv / var / www / icaatom / var / www / icaatom_old

Baixe o último tarball ICA-AtoM e extraí-lo em um novo diretório raiz do seu web. Por exemplo, para extrair o tarball icaatom-1.3.0.tgz ao / var/www/icaatom-1.3.0 diretório, digite:

$ Tar xvzf icaatom-1.3.0.tgz-C / var / www

Agora, por favor, defina o arquivo e as permissões de diretório como explicado.

Execute o programa de instalação

Consulte Instalação para obter instruções sobre a execução do instalador de aplicações web-based. Lembre-se de criar um novo banco de dados para esta instalação, você não quer usar a antiga, pois o instalador irá apagar todos os dados.

Copiar os dados

Neste ponto, você deve ter uma instalação ICA-AtoM funcional usando o banco de dados novo, fresco. Agora vamos copiar o conteúdo do diretório uploads de idade, bem como o banco de dados:

rsync é uma solução de sincronização robusta diretório que podemos usar para copiar o conteúdo de seu diretório envios antigo para o novo, mesmo quando ambos os diretórios estão na mesma máquina:

$ Rsync-av / var / www / icaatom_old / uploads / var/www/icaatom-1.3.0/uploads

Alternativamente, você pode simplesmente usar cp:

$ Cp-r / var / www / icaatom_old / uploads / var/www/icaatom-1.3.0/uploads

Despejar o conteúdo de seu banco de dados antigo para um arquivo temporário:

$ Mysqldump-u username-p old_database> / tmp / database.sql

Agora, carregar o conteúdo para o novo banco de dados:

$ Mysql-u username-p new_database </ tmp / database.sql

[Editar] executar a tarefa de atualização

Altere o diretório atual:

$ Cd / var/www/icaatom-1.3.0

Agora, execute a tarefa de atualização-sql:

$ Php symfony ferramentas: upgrade-sql

Esta é a etapa mais crítica neste guia de atualização. Se você receber um erro, por favor leia nosso FAQ abaixo para resolver quaisquer problemas.

Migrar traduções

Seus metadados traduzido (descrições arquivísticas, registros de autoridade, instituições arquivísticas, etc) é armazenada no banco de dados, e será restaurado a partir do seu despejo de dados.

Se você tiver feito as traduções personalizados da interface do usuário, eles serão armazenados no diretório apps/qubit/i18n. Copiá-las a partir do seu diretório de aplicativos velho para o novo:

$ Cp-r / var/www/icaatom_old/apps/qubit/i18n / var/www/icaatom-1.3.0/apps/qubit/i18n

Reconstruir índice de pesquisa

Devido a alterações de dados durante o processo de atualização, você vai precisar para reconstruir o índice de pesquisa após a atualização:

$ Busca php symfony: preencher QubitSearch

Limpar cache

Limpe seu cache para remover todos os dados desatualizados, a partir da aplicação,

$ Php symfony cc

Veja Limpar cache para instruções mais detalhadas.

Perguntas mais frequentes

Por que eu recebo um "QubitActor classe abstrata contém quatro métodos" erro?

Se você estiver executando uma linha de comando (CLI) tarefa (por exemplo, reconstruir o índice de pesquisa) e você terá um erro como

Erro fatal: QubitActor Classe contém quatro métodos abstratos e deve, portanto, ser declarada abstrata ou implementar os métodos restantes ...

Você precisa [qubit: Limpar cache | limpar o cache] duas vezes seguidas.

$ Php symfony cc && cc php symfony

Em seguida, re-executar a sua tarefa CLI.

Por que eu recebo um "A tarefa falhou ao tentar atualizar para ..." erro?

Algo deu errado durante a atualização. O novo ICA-AtoM script de atualização 1.3 foi testado novamente mais de 20 locais diferentes, mas ele pode falhar devido a erros desconhecidos. Por favor, entre em contato conosco através da lista de discussão da ICA-AtoM Usuários.

É especialmente importante que você envie-nos a mensagem de erro impressa pelo script de atualização.

O que devo fazer se receber um erro que não é descrito aqui?

Primeiro, verifique o nosso FAQ principal. Além disso, tente procurar a lista de discussão de usuários ICA-AtoM para posts anteriores que pode responder a sua pergunta.

Se você não consegue encontrar quaisquer posts anteriores que são relevantes, por favor, iniciar um novo tópico na lista de discussão da ICA-AtoM usuários, e não se esqueça de incluir:

A linha de assunto que descreve brevemente o problema ("Erro ao tentar executar ferramentas: sql-upgrade", por exemplo)

Uma descrição detalhada de como reproduzir o problema. Envie-nos uma imagem do erro, e anexá-lo à sua mensagem. Qual versão do PHP você está usando?

Para fazer pesquisa no ICA-AtoM

Vale a pena conferir as novidades no sistema de busca do ICA-Atom, que foram implementados pelo Arquivo da Cidade de Vancouver. Confira no Blog do Arquivo da Cidade de Vancouver.

Disseminação do ICA-AtoM

Curso de capacitação realizado na UPF

A UPF inicia o treinamento de seus funcionários para o uso do Software de descrição e difusão do seu acervo no Arquivo Central. Participaram também os funcionários do Arquivo Histórico Regional, Museu Histórico e Museu de Artes.

Instalação do MySql Admin para gerenciar a base de dados de fotografias no ICA-AtoM

"Como instalar o MySql Administrator no Sistema Operacional Linux Ubuntu 11.10 e as suas funcionalidades básicas na administração de uma base de dados MySql (versão 5.0.6)"

A necessidade de otimizar a inserção e edição das informações referentes à descrição de fotografias no âmbito deste projeto, resultou em novas ideias e sugestões que aos poucos compartilhamos aqui.
A partir de um considerável número de registros em uma base de dados, é preferível utilizar um sistema administrador desse banco de dados em que esta base está inserida, visando agilizar e facilitar o serviço, ao invés de utilizar os cansativos comandos no terminal dos sistemas Linux. Nesta versão do Ubuntu, há algumas desvantagens (por exemplo a notável ausência do Java da Sun/Oracle) e claro, mais vantagens em relação às versões anteriores. Nesse post iremos mostrar um modo simples de instalar um ambiente de administração do MySql e apresentar as funcionalidades básicas dele (criar tabelas, inserir, editar e excluir registros), na versão 11.10 do Sistema Operacional Ubuntu.

Para instalar este administrador do MySql não tem mistério, o modo mais simples é acessar a Central de Programas do Ubuntu (no lançador de aplicativos do sistema operacional no canto superior esquerdo da área de trabalho) e pesquisar por “MySql admin”. Procure o software chamado “Administrador MySql” na página de resultados (cfe. a imagem abaixo) e clique em instalar.

Após concluir a instalação, vamos executá-lo. Vá ao menu novamente e procure por ele (cfe. imagem abaixo).

Será requisitada a senha do BD e os dados referentes ao usuário e servidor para autenticação. Após autenticar-se você verá a tela inicial do ambiente de administração de seu banco de dados. Há um menu lateral esquerdo com várias opções (informações sobre seu servidor, controle de serviço, parâmetros de inicialização, administração de usuários, computadores conectados, saúde do servidor e do BD, registro de eventos e erros, criação e restauração de backups e enfim: as bases de dados. Clicando em ‘Catalogs’, será listada logo abaixo, as bases de dados existentes. Ao selecioná-las, as suas respectivas tabelas serão listadas ao lado com as informações referentes à sua estrutura. Mais abaixo, há opções de criação, edição, manutenção (reparação, otimização, etc.) e atualização de tabelas. A imagem abaixo mostra a estrutura das tabelas nativas do MySql na base de dados “information_schema”.

Para visualizar os registros nas tabelas, clique com o botão direito do mouse sobre a tabela desejada e depois em “Edit data table”. Suas informações de acesso serão novamente requisitadas. Após autenticar-se você terá uma tela listando o conteúdo da tabela. Logo na parte superior há um campo destinado a escrever suas consultas em sql, que na minha opinião é um dos principais motivos para a instalação do Administrator MySql, já que quase todas as outras opções também podemos realizar no terminal, porém essa em especial por proporcionar uma visão mais clara e ampla do universo informacional em que estamos trabalhando e claro, esteticamente mais bonito e ajustado.. haha É nesse campo onde serão executadas as consultas de inserção, edição e exclusão dos registros. As consultas digitadas anteriormente no terminal do Ubuntu, agora podem ser digitadas neste campo, respeitando a sintaxe da linguagem SQL desse gerenciador.

E para simplificar, há também como alterar informações de um registro específico (que não é muito utilizado, pois normalmente isto é feito através do software de apresentação dos dados), sem escrever em sql. Há o botão “Start editing”. Clique nele para começar as edições. Depois vá ao campo desejado, clique com o botão direito e selecione a opção “Edit field in popup editor”. Será aberta uma janela para alteração dos dados. Feita as alterações, clique em OK. E para finalizar, clique no botão “Apply changes”. Segue uma imagem de exemplo:

Quanto à manutenção das tabelas, há as opções de otimizar, checar e reparar as tabelas. Para saber mais sobre estas opções, leia este artigo http://dev.mysql.com/doc/refman/4.1/en/repair-table.html. 

A imagem abaixo mostra o botão de manutenção das tabelas.

Bom, é isso por enquanto. Opiniões, críticas e sugestões são bem vindas. Abraço e até a próxima!

--

Dhion C. Hedlund

Produtos finais

As atividades realizadas no âmbito deste projeto oportunizaram aos alunos a vivência do exercício profissional no que se refere principalmente ao processo descritivo.

A descrição é uma função arquivística diretamente relacionada à difusão do acervo e a qualidade da sua realização influencia diretamente a qualidade da resposta do sistema à busca realizada pelo usuário. A reformatação do material original foi imprescindível para a realização desse projeto e obedeceu às recomendações internacionais.

Sendo assim, a digitalização, a análise documentária, o controle do vocabulário e a descrição de acordo com as normas ISAD(g), foram as principais atividades realizadas e que culminaram com a elaboração de produtos que servirão de referência para a continuidade das atividades:

- Manual de procedimentos para a digitalização de negativos fotográficos na HP Scanjet 5590;

- Manual de procedimentos para a descrição arquivística dos negativos fotográficos no Microsoft Access;

- Vocabulário controlado para a descrição arquivística;

- Base de dados em ACCESS para descrição de arquivos fotográficos;

- Acervo Fotográfico da UFSM disponível para consulta on-line no ICA-AtoM;

- Produção bibliográfica submetido em periódicos científicos especializados com corpo editorial;

- Comunicações em anais de congressos.

Apresentação na 26ª Jornada Acadêmica Integrada da UFSM

No dia 21 de outubro de 2010 apresentamos os resultados parciais do projeto na 26ª Jornada Acadêmica Integrada da UFSM.

Resumo do relatório parcial enviado ao SigProj

Projeto realizado com o apoio do PROEXT 2010 - MEC/SESu

O material solicitado no projeto ainda está em processo licitatório. Estamos trabalhando apenas com um scanner para negativos 35mm. 

Essa situação dificulta o atingimento da meta estabelecida de 5% do acervo total.

Os atividades realizadas até setembro apresentam os resultados demonstrados no quadro e no gráfico que seguem abaixo:

Digitalização realizada até dia 1° de setembro

Até o ano de 1972 produzimos 1083 representantes digitais.
Se considerarmos o total de 3461 negativos existentes, significa que digitalizamos 31,3% do acervo de negativos 35mm até dia 1°/Set.

Acompanhe a quantidade de negativos 35mm existentes (3.461) e a quantidade de arquivos digitais produzidos (1.083) , por ano, no gráfico abaixo:

Atividades de abril a julho/2011

1 - Digitalização e descrição dos negativos fotográficos 35mm.  

O computador e scanner para negativos de médio formato ( 6x6cm) ainda não foram licitados e não há previsão para o recebimento desse equipamento. Isso significa que não foram digitalizados os negativos 6x6.

Estamos trabalhando com apenas um scanner que já existia no DAG (para negativos 35mm).
 

O acervo possui 1.631 negativos 35mm referentes ao período de 1959 a 1970.

No período de 7 de abril até 30 de julho foram digitalizados e descritos 559 negativos.

O equivalente a 34% do acervo de 1959 a 1970 está digitalizado e descrito na base Access.

O quadro e o gráfico abaixo indicam o total de negativos 35mm existente no acervo fotográfico e o total de arquivos digitais produzidos, por ano.

Ano	Arq. Digitais	Total 35mm	% Concluída
1959	6	52	100
1961	2	23	100
1962	11	51	100
1963	17	81	100
1964	1	3	100
1965	20	78	100
1966	38	51	100
1967	1	14	100
1968	29	144	100
1969	221	556	100
1970	213	578	100
Total	559	1631	100%

2- Pesquisa de conteúdo para a descrição de fotografias na base de dados.

Estamos pesquisando informações para completar a descrição das fotografias no arquivo permanente do Departamento de Arquivo Geral (DAG). 

Estamos lendo a documentação textual das séries: Promoção de Eventos, Assessoria de Divulgação e Ensino, Pesquisa e Extensão. referentes ao período de 1954 a 1973.

Estamos consultando também os relatórios anuais e outras publicações da UFSM.