Nextool Solutions

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

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

• Backup completo do banco de dados (mysqldump)
• Backup dos diretórios /etc/glpi, /var/lib/glpi e /var/www/glpi/plugins
• Verificar versão atual: deve ser GLPI 10.0.x (última minor release)
• Verificar compatibilidade de cada plugin instalado com GLPI 11
• Ter ambiente de homologação para teste
• PHP 8.1 ou superior instalado

1. Plugins: o que muda no GLPI 11

Incorporados ao core (remover antes de migrar)

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

Compatíveis (verificar versão)

• Escalade, Fields, DataInjection, PDF, Tag – possuem versões para 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. Backup completo

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

# Arquivos
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, vá em Configuração > Plugins e desative todos os plugins que não têm versão para GLPI 11. Remova os diretórios dos plugins incompatíveis.

4. Atualizar os arquivos 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 arquivos (preservar config 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 do banco

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

Este comando aplica todas as migrações de schema do GLPI 10 para o 11. Acompanhe a saída – 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

• Acesse o GLPI e verifique se o login funciona
• Confira a versão em Configuração > Geral
• Verifique se chamados, ativos e usuários estão presentes
• Teste a abertura de um chamado novo
• Verifique os logs em /var/log/glpi/ para erros
• Reative e atualize os plugins compatíveis um a um

8. Problemas comuns

Erro de permissão

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 GLPI 11. Plugins antigos podem causar 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.