Установка

orphan

Установка Galette - это веб-процесс (после выполнения preparation steps). Перейдите по ссылке http://localhost/galette. Update process документирован отдельно.

Вы должны полагаться на последний стабильный релиз, но также возможно (если вы знаете, что делаете, для не разработчиков это сложнее!) взять его из source code

Enabling the installer

Добавлено в версии 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:

../_images/2_installer_disabled.png

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.

Примечание

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?

Изменено в версии 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.

Предупреждение

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.

Проверки

Если вы хотите, чтобы Galette установилась без проблем, проверьте следующее:

  • версия вашего PHP достаточно высока,

  • Установлен часовой пояс PHP (требуется с версии PHP 5.3),

  • все необходимые расширения PHP установлены и загружены,

  • некоторых каталогов требуется доступ на запись.

Если одно из обязательных расширений отсутствует или не установлен часовой пояс, обратитесь к системному администратору. Galette не требует никаких «экзотических» расширений.

Самый первый шаг установки проверит эти пункты и предупредит вас, если что-то пойдет не так.

../_images/1_checks.png

Если все the installation steps были выполнены правильно, ACL каталогов должны быть корректными, пожалуйста, обратитесь к разделу files ACLs section и обновите страницу в браузере.

База данных

Прежде всего, убедитесь, что БД существует, и подготовьте всю необходимую информацию:

  • имя хоста

  • имя пользователя БД

  • пароль пользователя БД

  • имя БД

  • тип БД (MariaDB/MySQL или PostgreSQL)

Параметры БД

На этом экране выберите тип БД, введите имя хоста, имя БД, имя пользователя и пароль. Префикс Tables полезен, если у вас нет выделенной БД Galette, предложение по умолчанию должно подойти, но вы можете выбрать то, что вам нужно :)

../_images/3_bdd.png

Примечание

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.

Проверки

На следующем экране будет произведена попытка подключения к БД с помощью предоставленных элементов, после чего будет проверено, правильно ли определены права на БД (пользователь может добавлять/удалять/изменять таблицы, добавлять/удалять/редактировать строки, …).

../_images/4_bdd_rights.png

Если произошла ошибка подключения, вернитесь к предыдущему шагу, исправьте настройки и повторите попытку. Если вы видите проблемы с правами, исправьте их на своем сервере и используйте кнопку «Обновить».

Создать tables

Примечание

Эти инструкции предназначены только для установки. При обновлении, БД уже существует.

Если соединение с БД установлено и все в порядке, программа установки создаст таблицы и вставит значения по умолчанию. Вы можете показать созданные таблицы из любого графического инструмента или из командной строки:

  • MariaDB:

    mysql> use mygalette;
mysql> show tables;

  • PostgreSQL:

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

Параметры администратора

Примечание

Этот экран отображается только после установки. При обновлении пользователь super admin уже существует.

На следующем экране вам будет предложено ввести информацию для создания пользователя Galette super admin. Используя Galette, вы можете назначить некоторых пользователей администраторами, но тот, кто создан во время установки, не является членом, не может быть удален и имеет некоторые дополнительные права.

../_images/6_admin.png

Телеметрия

Чтобы узнать больше об установленных экземплярах Galette, мы стараемся собирать анонимные телеметрические данные. Вы также можете зарегистрироваться как пользователь Galette :)

../_images/7_telemetry.png

Инициализация

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:

  • добавить настройки Galette по умолчанию

  • добавить вклады и типы статусов по умолчанию,

  • Конфигурация и разрешения,

  • тексты для административных писем,

  • участники по умолчанию,

  • модели PDF по умолчанию

  • …

При обновлении будут обработаны только отсутствующие параметры и новые данные по умолчанию, если таковые имеются.

../_images/8_initialization.png

Конец установки

Установка завершена, поздравляем!

../_images/9_the_end.png

Теперь вы можете войти в Galette, используя данные администратора, которые вы использовали во время установки. Теперь вы можете перейти к Galette user manual.

../_images/10_login.png

Счастливый Galette!