# Запуск з 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)

android
або AniLabX (opens new window)
android
)

Перший запуск супроводжується створенням необхідних файлів (кеш, налаштування, бази даних) поряд з 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