Nextool Solutions

A migração do GLPI 10 para o GLPI 11 é um passo importante que traz uma interface modernizada, formulários nativos e melhorias de desempenho. Este guia cobre todo o processo com segurança.

Antes de começar: checklist de pré-migração

• Cópia de segurança completa da base de dados (mysqldump)
• Cópia de segurança dos diretórios /etc/glpi, /var/lib/glpi e /var/www/glpi/plugins
• Verificar a versão atual: deve ser GLPI 10.0.x (última minor release)
• Verificar a compatibilidade de cada plugin instalado com o GLPI 11
• Dispor de um ambiente de homologação para testes
• PHP 8.1 ou superior instalado

1. Plugins: o que muda no GLPI 11

Incorporados no core (remover antes de migrar)

• FormCreator – os formulários são agora nativos do GLPI 11
• GenericObject – os objetos personalizados são nativos

Compatíveis (verificar versão)

• Escalade, Fields, DataInjection, PDF, Tag – têm versões para o GLPI 11
• NexTool – compatível com GLPI 10 e 11

Incompatíveis ou descontinuados

• FusionInventory – substituído pelo inventário nativo (GLPI Agent)
• Plugins que não foram atualizados desde 2023

2. Cópia de segurança completa

# Base de dados
mysqldump -u root -p --single-transaction glpi > /backup/glpi_pre_migration.sql

# Ficheiros
tar -czf /backup/glpi_files_pre_migration.tar.gz /var/www/glpi /etc/glpi /var/lib/glpi

3. Desativar plugins incompatíveis

No GLPI 10, aceda a Configuração > Plugins e desative todos os plugins que não têm versão para o GLPI 11. Remova os diretórios dos plugins incompatíveis.

4. Atualizar os ficheiros do GLPI

cd /tmp
wget https://github.com/glpi-project/glpi/releases/download/11.0.0/glpi-11.0.0.tgz
tar -xzf glpi-11.0.0.tgz

# Substituir ficheiros (preservar configuração e dados)
rsync -av --delete /tmp/glpi/ /var/www/glpi/ --exclude plugins/ --exclude marketplace/
chown -R www-data:www-data /var/www/glpi

5. Executar a migração da base de dados

php /var/www/glpi/bin/console db:update --no-interaction

Este comando aplica todas as migrações de esquema do GLPI 10 para o 11. Acompanhe o resultado – qualquer erro deve ser resolvido antes de prosseguir.

6. Limpar cache e sessões

php /var/www/glpi/bin/console cache:clear
rm -rf /var/lib/glpi/_sessions/*

7. Verificação pós-migração

• Aceda ao GLPI e verifique se o login funciona
• Confirme a versão em Configuração > Geral
• Verifique se os tickets, ativos e utilizadores estão presentes
• Teste a abertura de um novo ticket
• Verifique os logs em /var/log/glpi/ para erros
• Reactive e atualize os plugins compatíveis um a um

8. Problemas comuns

Erro de permissões

Garanta que www-data tem permissão de escrita nos diretórios de dados.

Plugin não carrega

Verifique se a versão do plugin é compatível com o GLPI 11. Plugins antigos podem causar o erro 500.

Formulários do FormCreator

Os formulários do FormCreator não são migrados automaticamente para os formulários nativos do GLPI 11. Será necessário recriá-los manualmente.

Próximo passo

Após a migração, explore as novidades do GLPI 11 e configure os formulários nativos.