# Запуск з Jar файлу
# Установка Java
Для роботи Atsumeru
необхідна встановлена Java версії 8+ (1.8+). Підійде як Oracle Java (opens new window), так і OpenJDK (opens new window)
Дізнатися чи встановлена Java та її версію можна за допомогою команди java -version
Встановіть Java для вашої системи:
# Windows
Завантажте та встановіть інсталяційний набір із сайту Oracle (opens new window)/OpenJDK (opens new window)
# Linux/MacOS
Завантажте OpenJDK (opens new window) з репозиторію або встановіть його вручну з deb/rpm/tar.gz пакету
Найчастіше, актуальні Linux системи постачаються з OpenJDK 11+ у комплекті і додаткове встановлення не потрібне
# Запуск
Запустити Atsumeru
можна самостійно з jar
файлу. Актуальну версію можна завантажити із секції Releases (opens new window) в GitHub репозиторії
Для запуску сервера можна використовувати таку команду (замініть x.y.z
на версію завантаженного файла):
java -jar Atsumeru-x.y.z.jar
На Windows системах можна використовувати javaw
замість java
для запуску сервера без відображення вікна командного рядка
На Windows системах іноді потрібно обов'язково після скачування Розблокувати jar
файл у його властивостях
Після запуску, сервер буде доступний для управління з Atsumeru Manager (opens new window) і читання з підтримуваних додатків (наприклад, Atsumeru (opens new window)
Перший запуск супроводжується створенням необхідних файлів (кеш, налаштування, бази даних) поряд з jar
файлом. Також, створюється користувач Admin
з випадковим паролем, який один раз буде відображено в консолі. Рекомендується змінити цей пароль або створити нового Адміністратора, видаливши стандартного
Для створення нового користувача Admin
достатньо зупинити сервер, видалити базу даних за шляхом /database/users.db
і запустити сервер
Ця операція видаляє всіх раніше створених користувачів, тому її не рекомендується проводити за їх наявності
# Збільшення лімітів пам'яті
Сервер використовує досить мало оперативної пам'яті навіть із великими бібліотеками. Змінюйте ліміти пам'яті тільки в крайньому випадку, якщо сервер явно видає помилки про її нестачу, інакше ви можете зіткнутися з різного роду проблемами, якщо некоректно вкажете цей параметр!
За усталеним налаштуванням, java
процес отримує обмежену максимальну кількість оперативної пам'яті (ОЗП/RAM), яку він може використовувати під час роботи. Найчастіше, це ~1 Гб
. У разі виникнення проблем у роботі сервері або появи помилок на кшталт OutOfMemoryException
в консолі/логах, найімовірніше, потрібно збільшити максимальну кількість пам'яті, яку Atsumeru
може використовувати
Для цього необхідно додати агрумент -Xmx<розмір>
до команди запуску сервера, де <розмір>
може бути будь-яким значенням за типом 2048m
(Мегабайти), 3g
(Гігабайти) і так далі. Наприклад, для запуску сервера з використанням до 3 Гб
пам'яті, потрібно використовувати таку команду:
java -jar -Xmx3072m Atsumeru-x.y.z.jar
або
java -jar -Xmx3g Atsumeru-x.y.z.jar
# Оновлення
Для оновлення сервера його потрібно зупинити і заново запустити з використанням останньої версії jar