Atualizando

Se você estiver usando uma versão antiga do Galette, é hora de atualizar.

Aviso

Uma atualização geralmente não é algo simples, seus dados podem ser modificados. Portanto, certifique-se de fazer um backup do seu banco de dados atual, ou você poderá perder todos ou parte dos seus dados.

Recomenda-se também fazer um backup de todos os arquivos do Galette, pois isso pode ser útil caso você encontre algum erro que impeça a migração e precise restaurar uma versão anterior;

Nota

A migração de uma versão anterior à 0.7 é teoricamente suportada, mas não foi testada (essas versões têm mais de 10 anos!), e é possível que sua tentativa falhe.

Nada foi realmente feito para permitir uma viagem no tempo desse tipo ;) Se este for o seu caso, você deve primeiro `migrar para o Galette 0.7.8 <https://galette.eu/download/archives/galette-0.7.8.tar.bz2> `_; e depois fazer outra migração para a versão mais recente.

Atualizando arquivos

Primeiro, faça logout da sua instância e certifique-se de usar o modo de manutenção para impedir que outros usuários acessem a instância.

Em seguida, baixe a versão mais recente do Galette e substitua os arquivos. Para obter mais informações sobre a instalação dos arquivos, consulte a seção preparar instalação.

Alguns diretórios armazenam dados e/ou configurações e devem ser copiados de volta para a nova instância:

  • config/config.inc.php. If the file is present, the update reads everything from it - database password included - and never asks you for a credential again. If it is missing, Galette cannot know it is an update: it would offer a brand new installation instead,

  • data/photos fotos e logotipos de seus membros,

  • O diretório data/exports contém exportações em formato CSv,

  • data/files contém arquivos de campos dinâmicos do tipo arquivo,

  • A pasta data/attachments contém documentos anexados à correspondência.

  • plugins seus plugins atuais. É uma boa ideia verificar se novas versões de plugins estão disponíveis ;)

Após a atualização dos arquivos, acesse sua instância do Galette. Ela perguntará se você deseja prosseguir com a atualização do banco de dados.

If so, enable the installer by creating the data/ENABLE_INSTALL file, then visit the install URL /installer.php (ex: https://your.domain.name/installer.php). Galette sees your configuration file and runs an update, you have nothing to choose.

Se não te perguntar nada, já terminou ;)

Atualizando o banco de dados

Aviso

Instalar uma nova versão do Galette não significa necessariamente que será preciso atualizar o banco de dados! Às vezes, basta atualizar os arquivos, mesmo em uma versão principal.

O Galette irá avisar se uma atualização for necessária, não é preciso “forçar” uma atualização.

O processo de atualização é muito semelhante ao processo de :doc: instalação do Galette (<galette>), com algumas etapas diferentes. Tudo é bastante transparente, com informações fornecidas em cada etapa.

Informações do banco de dados

Alterado na versão 1.3.0: Database information are not asked anymore, and neither is the installation type.

The update reads the database type, host, port, name, user, password and table prefix from your configuration file, and goes straight to the access and permissions check. The form only comes back if that file cannot be read or is incomplete - fill it in with the very same information as before, the table prefix included.

Seleção da versão anterior

Alterado na versão 1.3.0: When the version can be read from the database, this step is skipped.

Galette reads the version its database holds and updates from there. The step below is only displayed when that reading is not conclusive - which is the case for a pre 0.7 database, since the table holding the version did not exist yet. Select the version you are coming from, the one Galette guessed is displayed as bold text:

../_images/5_update_version_select.png

The step is also displayed when your database is already up to date, so you get a chance to stop before running the scripts again:

../_images/5bis_already_updated.png

Após a execução dos scripts de atualização, um resumo será exibido.

Nota

The data/ENABLE_INSTALL file is removed once the update has completed.