Migração do TWiki para Foswiki

OBS: Para melhorar a organização deste tópico, reestruturei ele e movi algumas coisas para MigracaoTWikiToFoswiki_Log.

Introdução

Aqui vamos documentar a migração do TWiki para Foswiki no wiki.softwarelivre.org. A motivação para a migração está documentada em um post anterior do AntonioTerceiro.

Veja que aqui só constará idéias gerais do processo de migração. Alguns detalhes específicos (comandos executados, dúvidas que surgiram durante a migração, etc.) estão disponíveis em MigracaoTWikiToFoswiki_Log na forma de comentários.

Procedimentos realizados

Utilizando o http://foswiki.org/System/UpgradeGuide como base.

1. Instalação básica do Foswiki usando o pacote debian.
2. Configuração do site, LocalSite.cfg, com as mesmas configurações anteriores (usar o /bin/configure no modo expert e habilitar os plugins necessários)
3. Configurar o apache. Deve-se atentar para as novas localizações dos arquivos no servidor e URL's nos redirects.
4. Copiar o arquivo de autenticação de usuários, .htpasswd, da instalação antiga para a nova instalação.
5. Configurar o AdminGroup. Basicamente, adicionar os usuários que estavam no TWikiAdminGroup para AdminGroup.
6. Instalação de plugins extras necessários e habilitá-los. Quanto à configuração, customizações de configuração dos plugins devem ser feitos nas preferências do site que, por sua vez, será tratada mais abaixo.
   1. Em especial, precisei migrar as tags do TagMePlugin salvas em working/work_areas para a nova instalação.
7. Criar um snapshot da instalação anterior TWiki. Isso é importante pois a migração tende a tomar mais que um dia, de forma que com o snapshot podemos verificar as atualizações que ocorreram na instalação original depois que copiamos alguns arquivos e possamos aplicá-las na nova instalação.
8. Migrar as webs não padrões da instalação antiga (excluí-se assim a Main, Trash, Sandbox, TWiki, default e empty). Isso pode ser feito com rsync dos diretórios pub e data, excluindo-se da sincronização as webs padões, sem muitas preocupações.
9. Migrar manualmente as webs padrões: Main, Sandbox, default (arquivos em data e pub). Optou-se por não migrar a Trash e a empty acho que não deveria ter sido modificada na instalação anterior. A web TWiki é uma web do sistema, logo não deve ter sido modificada na instalação anterior; além disso as modificações sofridas pela migração do software TWiki para Foswiki (mudanças em nomes de tópicos, por exemplo) são tratadas pelo plugin TWikiCompatibilityPlugin. A migração manual funcionou da seguinte forma:
   1. Para tópicos que não existiam na instalação padrão do foswiki, simplesmente copiei eles para para tais webs.
   2. Para tópicos que já existiam, verifiquei as diferenças entre eles e caso a diferença tenha sido uma modificação do usuário ela foi repassada à nova instalação.
   3. Em especial, o tópico de usuários (anteriormente TWikiUsers e agora WikiUsers) precisa de uma atenção especial na migração manual.
   4. Deve-se aplicar as preferências do site da instalação anterior para a nova instalação. Em outras palavras, migrar o Main.TWikiPreferences para Main.SitePreferences.
10. Substituir, nos exemplos de uso do webnotify, as ocorrências de TWikiGuest por WikiGuest. Isso é importante para evitar erros de entrega de e-mails nas notificações (o webnotify ignora o WikiGuest mas não o TWikiGuest e tenta entregar mensagem pra example@your.company). Para isso basta modificar a linha correspondente em cada web no %WEB%.WebNotify

Documentos relacionados

• Main.AtualizaçãoParaTWiki04x00x04
• Main.MigraçãoParaDakarRelease
• Main.MigracaoTWikiToFoswiki_Log

Check das webs

OK: 109

-- ItaloValcy - 15 Nov 2009