Встановлення

orphan

Установлення Galette - це вебпроцес (після виконання: підготовчих кроків). Перейдіть на http://localhost/galette. Оновлення документоване окремо.

Ви повинні покладатися на останній сталий випуск, але також можливо (якщо ви знаєте, що робите, це складніше для НЕ розробників!) взяти його з джерельного коду

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

Якщо всі кроки встановлення були виконані правильно, ACL (списки прав доступу) каталогів повинні бути правильними, будь ласка, зверніться до розділу файлів ACL (списків контролю доступу) і оновіть сторінку в вашому мережевому оглядачі.

База даних

Перш за все, переконайтесь, що база даних існує, і підготуйте всі необхідні дані:

  • назва хоста

  • ім’я користувача бази даних

  • пароль користувача бази даних

  • назва бази даних

  • тип бази даних (MariaDB/MySQL або PostgreSQL)

Параметри бази даних

На цьому екрані виберіть тип бази даних, введіть назву хоста, назву бази даних, ім’я користувача і пароль. Префікс таблиць корисний, якщо у вас немає виділеної бази даних 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

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

Створити таблиці

Примітка

Ці вказівки відносяться тільки до встановлення. Під час оновлення база даних уже наявна.

Якщо з’єднання з базою даних установлене і все в порядку, установник створить таблиці та вставить в них типові значення. Ви можете показати створені таблиці з будь-якого графічного засобу або з командного рядка:

  • MariaDB:

    mysql> use mygalette;
mysql> show tables;

  • PostgreSQL:

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

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

Примітка

Цей екран відображається лише з установлення. Під час оновлення користувач суперадміністратора вже наявний.

На наступному екрані вам буде запропоновано ввести відомості для створення користувача-суперадміністратора Galette. Використовуючи 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.

../_images/10_login.png

Щасливого Galette!