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

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

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

Чеки

Будь ласка, перевірте наступне, якщо ви хочете, щоб Galette встановлювався без ускладнень:

  • ваша версія PHP достатньо висока,
  • встановлено часовий пояс PHP (потрібно з PHP 5.3),
  • всі необхідні розширення PHP встановлені та завантажені,
  • деякі каталоги вимагають доступу на запис.

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

Найперший крок установлення перевірить ці пункти та попередить вас, якщо щось піде не так.

../_images/1_checks.png

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

Тип установлення

На наступному екрані вам буде запропоновано вибрати тип установлення. Вам належить вибрати між «Нове встановлення» й «Оновлення». Деякі з наступних кроків залежатимуть від типу, який ви виберете тут.

../_images/2_type_install.png

База даних

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

  • назва хоста
  • ім’я користувача бази даних
  • пароль користувача бази даних
  • назва бази даних
  • тип бази даних (MariaDB/MySQL або PostgreSQL)

Створити базу даних

Примітка

Ніколи не використовуйте кореневого (root) користувача бази даних!

Задля безпеки настійно пораджено покладатися на конкретного користувача для бази даних Galette і надавати йому тільки запитуваний доступ до єдиної бази даних Galette.

Для прикладу ми використовуватимемо базу даних mygalette з користувачем mygaletteuser і mypass в якості пароля.

  • MariaDB

    $ mysql -u root -p
mysql> CREATE DATABASE mygalette;
mysql> GRANT ALL ON magalette.* to
    ->'mygaletteuser'@'localhost' IDENTIFIED BY 'mypass';

  • PostgreSQL

    $ su -
# su - postgres
$ createuser -P mygaletteuser
$ createdb -O mygaletteuser mygalette

Ці команди можуть відрізнятися, будь ласка, зверніться до документації MariaDB чи PostgreSQL або використовуйте графічний засіб:

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

На цьому екрані виберіть тип бази даних, введіть назву хоста, назву бази даних, ім’я користувача і пароль. Префікс таблиць корисний, якщо у вас немає виділеної бази даних Galette, типова пропозиція має бути в порядку, але ви можете вибрати те, що хочете :)

../_images/3_bdd.png

Цей крок однаковий для процесів установлення та оновлення. Якщо файл конфігурації вже існує, Galette візьме відомості для попереднього заповнення форми (не для пароля). Під час оновлення двічі перевірте відповідність наявного префікса.

Чеки

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

../_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
  • додавання типових внесків і типів станів,
  • конфігурація полів та дозволи,
  • тексти для системних листів на е-пошту,
  • типові підписи членів,
  • типові моделі PDF
  • …

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

Кінець установлення

Установлення завершено, вітаємо!

Попередження

Задля безпеки ми радимо вам видалити каталог установлення, якщо він відкритий для мережі, або відмовитися від доступу до нього у вебконфігурації.

../_images/8_the_end.png

Тепер ви можете увійти в Galette, використовуючи дані суперадміністратора, які ви використовували під час установлення. Тепер ви можете перейти до Посібника користувача Galette.

../_images/9_login.png

Щасливого Galette!