Instalação

orphan

A instalação do Galette é um processo baseado na web (após :doc:` a conclusão das etapas de preparação <preparation>). Acesse http://localhost/galette. O processo de atualização <update> está documentado separadamente.

Você deve usar a versão estável mais recente, mas também é possível (se você souber o que está fazendo; para quem não é desenvolvedor, isso é mais complexo!) obtê-la a partir do código-fonte :doc:` (source code <../source_code>).

Enabling the installer

Novo na versão 1.3.0.

For security reasons, the installer does nothing until you tell it to. It stays closed as long as a file named ENABLE_INSTALL is missing from Galette data directory:

Create that empty file on the server, then reload the page:

$ touch /path/to/galette/data/ENABLE_INSTALL

Creating it proves you have an access to the server, which a visitor passing by has not.

Galette removes the file by itself once the installation - or the update - has completed, so the installer closes again behind you. That requires a write access on the data directory itself, which is not among the directories Galette needs to write into. If it is read only for the web server, the last step displays a warning instead: remove the file by hand, the installation is complete all the same.

Nota

It is the absence of the file that closes the installer, and that is on purpose: losing it can only close the installer, it can never open it.

Installation or update?

Alterado na versão 1.3.0: Galette does not ask anymore, and the corresponding step has been removed.

The mode is deduced from the config/config.inc.php file: no configuration file means a new installation, an existing one means an update.

Aviso

To install a brand new instance over an existing one - erasing its data - remove the configuration file first. As long as it is there, Galette will only offer to update.

Checando

Verifique o seguinte se deseja que o Galette seja instalado sem problemas:

• Sua versão do PHP é suficientemente recente,

• O fuso horário do PHP está configurado (obrigatório desde o PHP 5.3),

• Todas as extensões PHP necessárias estão instaladas e carregadas,

• Alguns diretórios exigem permissão de escrita.

Se alguma das extensões obrigatórias estiver faltando ou se o fuso horário não estiver configurado, entre em contato com o administrador do sistema. O Galette não exige nenhuma extensão “exótica”.

O primeiro passo da instalação verificará esses pontos e avisará caso algo dê errado.

Se todas :ref:` as etapas de instalação (<preparação>) foram seguidas corretamente, as ACLs dos diretórios devem estar corretas :ref:`. Consulte a seção de ACLs de arquivos (<droitsfichiers>) e atualize a página no seu navegador.

Banco de dados

Primeiramente, certifique-se de que o banco de dados existe e prepare todas as informações necessárias:

• Nome do host

• Nome de usuário do banco de dados

• Senha do usuário do banco de dados

• Nome do banco de dados

• Tipo de banco de dados (MariaDB/MySQL ou PostgreSQL)

Parâmetros do banco de dados

Nessa tela, selecione o tipo de banco de dados e insira o nome do host, o nome do banco de dados, o nome de usuário e a senha. O prefixo das tabelas é útil se você não tiver um banco de dados dedicado no Galette; a sugestão padrão deve funcionar bem, mas você pode escolher o que preferir :)

Nota

This step is displayed for a new installation only. When updating, everything - password included - is read from the existing configuration file, and the step is skipped. It only comes back if that file cannot be read, or if it is incomplete.

Checando

A próxima tela tentará conectar-se ao banco de dados usando os elementos fornecidos e, em seguida, verificará se as permissões do banco de dados estão corretas (o usuário pode adicionar/remover/alterar tabelas e pode adicionar/remover/editar linhas, etc.).

Se ocorrer um erro de conexão, volte à etapa anterior, corrija sua configuração e tente novamente. Se você encontrar problemas de permissões, resolva-os em seu servidor e use o botão “Atualizar”.

Criar tabelas

Nota

Essas instruções são apenas para instalação. Ao atualizar, um banco de dados já existe.

Se a conexão com o banco de dados for estabelecida e tudo estiver correto, o instalador criará as tabelas e inserirá os valores padrão. Você pode visualizar as tabelas criadas a partir de qualquer ferramenta gráfica ou na linha de comando:

• MariaDB:

  mysql> use mygalette;
  mysql> show tables;
  

• PostgreSQL:

  postgres=# \c mygalette
  postgres=# \dt
  

Parâmetros de administração

Nota

Esta tela é exibida somente durante a instalação. Ao atualizar, o usuário superadministrador já existe.

A próxima tela solicitará informações para criar o usuário superadministrador do Galette. No Galette, você pode definir alguns membros como administradores, mas o usuário criado durante a instalação não é um membro, não pode ser removido e possui alguns privilégios extras.

Telemetria

Para saber mais sobre as instâncias do Galette instaladas, tentamos coletar dados de telemetria anônimos. Você também pode se cadastrar como usuário do Galette :)

Inicializar

The last step will write the configuration file if needed, remove the ENABLE_INSTALL file, and initialize some values in your fresh database, as exemple:

• Adicionar preferências padrão da Galette

• Adicionar contribuições padrão e tipos de status,

• Configuração de campos e permissões,

• Textos para e-mails administrativos,

• Títulos padrão dos membros,

• Modelos PDF padrão

• …

Ao atualizar, somente as preferências ausentes e os novos dados padrão, se houver, serão tratados.

Instalação concluída

A instalação está concluída, parabéns!

Agora você pode acessar o Galette usando as informações de superadministrador que você utilizou durante a instalação. Você também pode acessar o Manual do usuário do Galette.

Feliz Galette!