Установка ARTA Synergy
======================

В данном разделе описан процесс установки платформы ARTA Synergy
с использованием готового виртуального образа.

Платформа распространяется в виде подготовленной виртуальной машины,
которую необходимо импортировать в систему виртуализации.

Поддерживаются два сценария установки:

* Через Oracle VirtualBox (Windows / Linux / macOS Intel)
* Через UTM (macOS Apple Silicon — M1/M2/M3)


====================================================================
Установка через Oracle VirtualBox
====================================================================

Предварительные требования
---------------------------

Перед началом установки убедитесь, что:

* На компьютере установлен **Oracle VirtualBox**
* Доступен файл виртуального образа Synergy (.ova или аналогичный формат)
* Компьютер соответствует минимальным требованиям по RAM и CPU


Импорт виртуального образа
---------------------------

1. Запустите **Oracle VirtualBox**.

2. В верхнем меню выберите:

   **Файл → Импорт конфигураций**

.. figure:: ../resources/img/configuration_import.png

   Импорт конфигурации виртуальной машины

3. В открывшемся окне укажите путь к образу Synergy
   и нажмите **«Далее»**, затем **«Импортировать»**.

.. figure:: ../resources/img/import_window.png

   Выбор файла образа Synergy

После завершения импорта виртуальная машина появится
в списке доступных ВМ.


Запуск виртуальной машины
--------------------------

1. Выберите импортированную виртуальную машину.
2. Нажмите кнопку **«Запустить»**.

После запуска системы появится информационное окно,
содержащее данные для доступа к платформе.

.. figure:: ../resources/img/synergy_vm_start.png

   Информационное окно при запуске Synergy


Доступ к платформе
------------------

После полной загрузки виртуальной машины
в терминале отображаются ссылки для доступа:

* **Synergy** — http://localhost:8080/Synergy
* **Configurator** — http://localhost:8080/Configurator
* **SynergyAdmin** — http://localhost:8080/SynergyAdmin

Обычно запуск приложения занимает от 5 до 10 минут.
После этого платформу можно открыть в браузере,
используя указанные адреса.


====================================================================
Установка на macOS (Apple Silicon / ARM)
====================================================================

Для компьютеров Mac с процессорами M1/M2/M3 используется приложение UTM.


Предварительные требования
---------------------------

* macOS актуальной версии
* минимум 8 ГБ RAM
* свободное место на диске (15+ ГБ)


Шаг 1. Установка UTM
---------------------

1. Перейдите на сайт:

   https://mac.getutm.app/

2. Скачайте и установите приложение.


Шаг 2. Загрузка ARM-образа Synergy
-----------------------------------

Скачайте образ:

https://releases.arta.pro/files/Arta-Synergy.qcow2


Шаг 3. Создание виртуальной машины
-----------------------------------

1. В UTM нажмите **«Создать новую ВМ»**.

2. Выберите режим **«Эмулировать»**.

.. figure:: ../resources/img/emulate.jpg

   Режим эмуляции

3. Выберите **Linux**.

.. figure:: ../resources/img/Linux.jpg

   Выбор ОС

4. Укажите ресурсы:

   * RAM — 4096 MB
   * CPU — 2 ядра

.. figure:: ../resources/img/resources.jpg

   Настройка ресурсов

5. Выберите:

   **Import existing drive**

   И укажите файл ``Arta-Synergy.qcow2``.

.. figure:: ../resources/img/import.jpg

   Импорт существующего диска

Сохраните виртуальную машину.


Дополнительная настройка
--------------------------

Откройте настройки виртуальной машины.


QEMU
~~~~

* Отключите **UEFI загрузку**

.. figure:: ../resources/img/qemu.jpg

   Настройки QEMU


Дисплей
~~~~~~~

* Выберите видеокарту **virtio-vga**

.. figure:: ../resources/img/display.jpg

   Настройки дисплея


Сеть
~~~~

1. Выберите режим **Эмулированный VLAN**
2. Перейдите в раздел «Перенаправление»
3. Добавьте правило:

   * TCP
   * Порт гостя — 8080
   * Порт хоста — 8080

.. figure:: ../resources/img/network.jpg

   Настройка сети

.. figure:: ../resources/img/port.jpg

   Проброс портов


Диск
~~~~

* Интерфейс — **IDE** или **SATA**

.. figure:: ../resources/img/port.jpg

   Настройки диска


Запуск Synergy
---------------

1. Выберите виртуальную машину.
2. Нажмите **«Запустить»**.

После загрузки откройте в браузере:

* http://localhost:8080/Synergy
* http://localhost:8080/Configurator
* http://localhost:8080/SynergyAdmin

Первый запуск может занять от 5 до 10 минут.