Mudar para uma versão maior do SPIP

Backup antes da migração

Backup da base de dados
-  Se tiver a possibilidade, é aconselhável fazer um backup da base de dados MySQL através do PHPMyAdmin, disponível em muitos alojamentos web.
-  o SPIP também oferece um sistema de backup

1. escolha um backup comprimido.
2. recupere via FTP o arquivo gerado: formato XML para os SPIP 2, em tmp/dump (ou ecrire/data para um SPIP mais antigo)

Backup dos diretórios pessoais
-  recupere via FTP os diretórios:

• IMG
• config (para os SPIPs mais antigos, muna-se dos seus códigos de base de dados)
• eventualmente squelettes se o seu conteúdo puder ser reutilizado

Com o backup da dua base de dados e o diretório IMG (que contém todos os documentos e imagens vinculadas ao seu site), os seus conteúdos estão salvaguardados. config contém as informações de conexão à base de dados e squelettes as suas personalizações de templates. Note eventualmente a versão específica do SPIP usado (antes desta migração).

Verificação da codificação antes da migração

Se o seu site é suficientemente recente (site em utf-8) ou se a sua codificação já é em utf-8, você pode passar para a etapa seguinte.

Para saber, consulte os seus parâmetros de idioma.

Se a codificação for em iso-8859-1, é aconselhável converter o seu site para utf-8. Um procedimento para isso é oferecido em SPIP 2 (ver ao final da página para o SPIP 3):

• fazer um backup da base de dados (em princípio você já possui uma)
• na página de gestão de idiomas, clique no link para «a página de conversão para utf-8» (URL: ecrire/?exec=convert_utf8)
• aceda e, seguida a página: ecrire/?exec=sql_convert_utf8

Verificação dos plugins

Considere atualizar os seus plugins para reduzir as incompatibilidades.

Para os sites em SPIP 3 ou superior, existe o plugin Verificar os seus plugins que possibilita fazer um balanço dos plugins compatíveis ou não com a versão que deseja instalar.

Os plugins incompatíveis serão desativados durante a instalação da nova versão.

Preparação da migração

Verifique a versão do PHP que roda no seu servidor (via http://www.meusite.org/ecrire/?exec=info por exemplo). O SPIP 3 requer, no mínimo, o PHP na versão 5.1 (enquanto o SPIP 2 ainda funciona com o PHP 4.x). Se necessário, verifique com o seu alojamento como usar uma versão recente do PHP.

Para executar o SPIP 3.2, é necessário, no mínimo, o PHP 5.4.

Em seguida, duas possibilidades:

Solução 1

1. Descarregar a versão mais recente do SPIP (Download do SPIP) descomprimir o ficheiro num diretório spip do seu computador
2. Criar via FTP os diretórios na raiz do seu site, no servidor: /spip e /antigoSpip
3. Transferir via FTP os diretórios e ficheiros contidos no diretório local spip do seu computador para o diretório remoto spip3 que se encontra no site.

O seu diretório /spip deverá conter:

• os ficheiros php: index.php, spip.php
• os diretórios: ecrire ,tmp, local, squelettes-dist, plugins-dist, prive e IMG e config (vazios)
• alguns ficheiros .txt e .png

Solução 2

1. Descarregue o ficheiro spip_loader.php (ou ou apenas copie o seu conteúdo) no seu computador a partir da página Download do SPIP
2. Grave o ficheiro na raiz do seu site, via FTP
3. Não o execute ainda!

Atualização dos ficheiros do site

Transfira os diretórios e ficheiros do seu site SPIP para /antigoSpip (exceto os diretórios a serem conservados obrigatoriamente: IMG et config). Para isso, no FTP:

1. no seu site remoto, selecione tudo (inclusive o diretório /plugins !) EXCEPTO

• ancienSpip,
• spip3,
• IMG,
• config
• e os ficheiros ou diretórios que não pertencem ao SPIP (eventualmente você pode ter documentos ouo outros diretórios no seu site, independentemente do SPIP. Estes diretórios podem ser relativos a outras aplicações como grr, cdt, pmb,…).
• o ficheiro spip_loader.php se optou pela solução 2

2. Arraste o resto da seleção para dentro de /antigoSpip

O seu site, neste momento, não estará mais funcional. Isso não vai durar muito tempo, fique tranquilo ;-) . Ao contrário, é importante substituir/ remover da raiz do servidor os diretórios ecrire, prive, extensions ou plugins-dist, squelettes-dist. Com efeito, estes diretórios contêm ficheiros removidos no SPIP 3 que poderiam causar conflitos se não forem removidos.

se optou pela solução 1

Ainda no FTP:

1. Posicione-se no diretório /spip
2. transfira o conteúdo de /spip para o nível superior (a raiz do site). Para isso:

• Ctrl + a para selecionar todos os elementos de /spip
• arraste a seleção para ..
• o diretório /spip estará vazio, exclua-o.

se optou pela solução 2

1. Visite o seu site usando o seu navegador usual e aceda à página spip_loader.php, num endereço do tipo: http://www.meusite.org/spip_loader.php e siga as instruções.

Atualização da base

Em função do tipo de atualização, um procedimento de atualização ao nível da base de dados será proposto na área restrita, Siga as instroções.

1. Consulte o seu site. Normalmente, ele deveria exibir (usando os templates padrão do SPIP)
2. Conecte-se à interface restrita do SPIP com uma conta de administrador (em caso de dificuldade, aceda a URL /ecrire do site).
3. Siga o procedimento de manutenção proposto.
4. Aceda em seguida à página de gestão dos plugins (em configurações)
5. Verifique se o site funciona.

Em caso de problemas

Se necessário (se não conseguir aceder à área restrita do site, se erros recorrentes são exibidos), pode ser útil reinicializar certos ficheiros temporários do SPIP.

Trata-se de limpar o diretório tmp excepto eventualmente os subdiretórios dump, sessions e visites.

Para esta operação: posicione-se no diretório tmp e apague tudo excepto os diretórios dump e visites. Será preciso, em seguida, reconectar-se.

Instalação dos plugins e templates

Crie os diretórios a seguir, na raiz do seu site:

• /plugins (e, deste diretório, crie o subdiretório auto)
• /lib
• /squelettes

Ajuste os direitos desses diretórios para que o servidor possa escrever neles.

Aceda a interface de gestão dos plugins e, em «repositórios», use o repositório proposto - (importante para a omplementação da nova gestão dos plugins).

Instale os plugins necessários (use o motor de busca para encontrá-los) ao funcionamento do seu site. Verifique se o site público funciona (eventualmente, limpe o cache ouo o diretório tmp comoexplicado acima). Reveja as configurações dos plugins (clique sobre o ícone de configuração após tê-los ativado).

Restabeleça, se necessário, as suas personalizações de templates colocando progressivamente os ficheiros HTML no seu diretório squelettes. Verifique se algum deles produz corretamente o resultado desejado.

Arrumação

Quando tudo terminar:

• verifique se as outras aplicações instaladas no alojamento web funcionam.
• verifique o conteúdo do diretório /antigoSpip. Este só deverá conter diretórios e ficheiros originários do seu antigo SPIP (ecrire, local, tmp, squelettes-dist ou dist, extensions e alguns ficheiros)
• remova finalmente o diretório /antigoSpip.

Atualização corrente do SPIP 3

Para uma simples atualização no mesmo ramo (por exemplo, do SPIP 3.0.N para SPIP 3.0.N+1) use o método do «spip_loader» que é o mais rápido e simples. Este ficheiro é reservado aos webmasters conectados, você pode deixá-lo no seu servidor.

O esquema é bem simples para uma atualização:

• faça um backup antes da atualização (pela interface do Spip)
• realize a atualização (método do spip_loader)
• faça um novo backup após a atualização (pela interface do Spip)

A propósito deste documento

Autores

• Michel Suquet
• Johan Pustoch

Texto original

http://wikitice.ac-versailles.fr/index.php?title=Mise_a_jour_SPIP3, sob licença Creative Commons Attribution.

Adaptações

Coletivo SPIP

Ver também

Ver também em contrib: Mise à jour de SPIP en captures d’écrans