Instalação

A instalação do Galette é um processo baseado na web (uma vez que os preparation steps estejam concluídos). Aceda a http://localhost/galette. Update process está documentado separadamente.

Deve usar a versão estável mais recente, mas também é possível (se souber o que está a fazer, isto é mais complexo para quem não é programador !) obtê-la a partir do source code

Verificações

Por favor, verifique o seguinte se quiser que o Galette seja instalado sem problemas :

  • a sua versão do PHP é suficientemente recente,

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

  • todas as extensões PHP necessárias estão instaladas e ativas,

  • alguns diretórios necessitam de permissões de escrita.

Se faltar alguma das extensões obrigatórias ou se o fuso horário não estiver definido, por favor contacte o administrador do sistema. O Galette não requer nenhuma extensão «exótica».

O primeiro passo da instalação irá verificar esses pontos e avisá-lo se algo estiver errado.

../_images/1_checks.png

Se todos os passos da instalação tiverem sido corretamente seguidos, as permissões (ACLs) dos diretórios deverão estar corretas. Por favor, consulte a secção permissões de ficheiros ACLs e atualize a página no seu navegador.

Tipo de instalação

Next screen ask you for installation type. You’ll choose between «New installation» or «Update». Several of the steps that will follow will be specific to the type you will choose here.

../_images/2_type_install.png

Base de dados

First of all, make sure the database exists, and prepare all required information:

  • nome do anfitrião

  • nome de utilizador da base de dados

  • palavra-passe do utilizador da base de dados

  • nome da base de dados

  • tipo de base de dados (MariaDB/MySQL ou PostgreSQL)

Parâmetros da base de dados

On that screen, select your database type, and enter hostname, database name, user name and password. Tables prefix is usefull if you do not have a Galette dedicated database, default proposal should be ok but you can choose what you want :)

../_images/3_bdd.png

This step is the same for installation and update processes. If a configuration file already exists, Galette will grab the information to pre fill the form (not for the password). When upgrading, double check the prefix fit the existing one.

Verificações

Next screen will try to connect to the database using provided elements, than it will check database rights are correct (user can add/remove/alter tables, and can add/remove/edit rows, …).

../_images/4_bdd_rights.png

If there is a connexion error, go back to previous step, fix your setup and try again. If you see rights issues, get them fixed on your server and use the «Refresh» button.

Criar tabelas

Nota

Those instructions are only for installation. When updating, a database already exists.

If a connection can be established to the database, and all is correct; installer will now create the tables, and insert default values. You can show created tables from any graphical tool or in command line:

  • MariaDB:

    mysql> use mygalette;
mysql> show tables;

  • PostgreSQL:

    postgres=# \c mygalette
postgres=# \dt
../_images/5_tables_creation.png

Parâmetros de administração

Nota

This screen is displayed from installation only. When updating, super admin user is already existing.

Next screen will ask you for information to create the Galette super admin user. Using Galette, you can set some members as administrators, but the one created at installation time is not a member, cannot be removed, and has some extra rights.

../_images/6_admin.png

Telemetria

To know more about Galette installed instances, we try to collect anonymous telemetry data. You can also register as a Galette user :)

../_images/7_telemetry.png

Inicializar

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

  • add Galette default preferences

  • add default contributions and status types,

  • fields configuration and permissions,

  • texts for administrative emails,

  • members default titles,

  • default PDF models

  • …

When updating, only the missing preferences and the new default data if any will be handled.

../_images/8_initialization.png

Installation end

Installation is now finished, congratulations!

../_images/9_the_end.png

You can now login to Galette, using super admin information you used at installation time. You can now go to the Galette user manual.

../_images/10_login.png

Desfrute de Galette!