Руководство администратора

Общие сведения

Доступно два типа подключения к виртуальной машине:

через систему виртуализации;
через сетевой интерфейс виртуальной машины.

Преимущества и недостатки при подключении через систему виртуализации и через сетевой интерфейс виртуальной машины

Advantages and disadvantages of connection types

Установка и настройка среды для программы

Среда функционирования

Программа является исполняемым файлом. Поддерживаемые операционные системы:

Ubuntu 20.04.3 и выше;
Debian 10 и выше;
Основа (отечественная операционная система).

Разработчики ведут работу над увеличением перечня операционных систем. Актуальный перечень предоставляется по запросу на uvdic@irsural.ru.

Установка программных пакетов

Для работы программы установить программные пакеты.

Выполнить команду:

sudo apt install virt-viewer remmina remmina-plugin-spice remmina-plugin-vnc remmina-plugin-rdp \
grep lsof usbip usbutils iputils-ping procps net-tools openssh-client

Выполнить команду:

sudo apt install virt-viewer remmina remmina-plugin-spice remmina-plugin-vnc remmina-plugin-rdp \
grep lsof linux-tools-$(uname -r) usbutils iputils-ping procps net-tools openssh-client

Создание конфигурации подключения

Указать в файле /usr/local/bin/server.ini параметры подключения. Файл конфигурации имеет формат ini.

Секции файла конфигурации:

для общих сведений — common (фиксированное название);
для подключения к виртуальной машине (произвольное название, количество секций не ограничено).

Поле секции common:

name — текст (до 30 символов), который будет отображаться в окне программы над списком виртуальных машин (выделено на рисунке).

Поля секции для подключения к виртуальной машине:

Поле	Тип	Описание
service `Обязательное`	`Одиночный` 1	Система виртуализации. Допустимые значения: `opennebula` — для подключения к системе виртуализации на базе OpenNebula; `ovirt` — для подключения к системе виртуализации на базе oVirt. Значение по умолчанию: не установлено.
profile `Обязательное`	`Одиночный`	Профиль для подключения пользователей oVirt. Допустимые значения: `internal` — подключение для пользователей внутреннего домена; `<domain>` — подключение для пользователей домена `<domain>`. Значение по умолчанию: не установлено.
address `Обязательное`	`Одиночный`	Адрес сервера системы виртуализации. Допустимые значения: `<service_address[:port]>` — сетевое имя или IP-адрес системы виртуализации. Примечание: oVirt использует 80 или 443 порт, OpenNebula — 2633 порт. Значение по умолчанию: не установлено.
connection_programs	`Одиночный` или `Список` `в порядке` `приоритета` 2	Утилиты для подключения к виртуальной машине. Допустимые значения: `remote-viewer` — использовать для подключения утилиту remote-viewer; `remmina` — использовать для подключения утилиту remmina. Значение по умолчанию: `remmina,remote-viewer`.
protocols	`Одиночный` или `Список` `в порядке` `приоритета`	Протоколы для подключения к виртуальной машине. При указании необходимо руководствоваться настройками системы виртуализации или виртуальной машины. Допустимые значения: `spice[:port1;port2;…]` — использовать для подключения протокол spice; `vnc[:port1;port2;…]` — использовать для подключения протокол vnc; `rdp[:port1;port2;…]` — использовать для подключения протокол rdp. Значение по умолчанию: `spice:5900;5901,vnc:5902,rdp:3389`.
connection_type	`Одиночный` или `Список` `в порядке` `приоритета`	Тип подключения к виртуальной машине. Допустимые значения: `indirect` — подключение через систему виртуализации; `direct` — подключение через сетевой интерфейс виртуальной машины. Значение по умолчанию: `direct,indirect`.
user_connect_scripts	`Одиночный` или `Список` `в порядке` `выполнения` `программ` 3	Программы, которые будут запущены перед подключением к виртуальной машине. Если хотя бы одна из программ завершится с ошибкой, остальные не будут выполнены, подключение к виртуальной машине будет прервано. Допустимые значения: `</path/to/program>` — путь к программе. Значение по умолчанию: не установлено.
user_disconnect_scripts	`Одиночный` или `Список` `в порядке` `выполнения` `программ`	Программы, которые будут запущены после отключения от виртуальной машины. Если хотя бы одна из программ завершится с ошибкой, остальные не будут выполнены. Допустимые значения: `</path/to/program>` — путь к программе. Значение по умолчанию: не установлено.
usb	`Одиночный`	Параметры перенаправления USB-устройств. Допустимые значения: `all` — перенаправление всех USB-устройств; `no_hid` — перенаправление всех USB-устройств кроме устройств класса HID (например, клавиатура, мышь и др.); `disable` — перенаправление USB-устройств отключено. Значение по умолчанию: `no_hid`.
features	`Одиночный`	Дополнительные функции. Допустимые значения: `disable_ping_scanning` — отключает сканирование подсети ping-запросами при подключении через сетевой интерфейс виртуальной машины. Значение по умолчанию: не установлено.

1

Одиночный

Допустимое значение — строка. Задание нескольких значений не предусмотрено.

2

Список в порядке приоритета

Допустимые значения могут быть перечислены в порядке приоритета через запятую, без пробелов. Если указаны несколько допустимых значений, программа выберет первый доступный вариант.

Пример:

connection_programs=remote-viewer,remmina

В данном примере в первую очередь будет проверена доступность утилиты remote-viewer.

Если remote-viewer доступен, подключение к виртуальной машине будет произведено через remote-viewer. Если remote-viewer недоступен, будет проверена доступность remmina, и, если remmina доступна, подключение к виртуальной машине будет произведено через remmina.

Если обе утилиты недоступны, программа сообщит об ошибке.

3

Список в порядке выполнения программ

Допустимые значения могут быть перечислены в порядке приоритета через запятую, без пробелов. В таком случае несколько программ будут выполнены последовательно в указанном порядке.

Пример файла /usr/local/bin/server.ini

[common]
name=Виртуальные машины

[opennebula]
service=opennebula
address=192.168.0.66:2633
connection_programs=remote-viewer
protocols=spice,vnc
user_connect_scripts=~/UVDIC/script1.sh,~/UVDIC/script2.sh
user_disconnect_scripts=~/UVDIC/script3.sh
usb=no_hid

Выключение фонового режима работы remmina

Предупреждение

При использовании remote-viewer выполнение пункта можно игнорировать.

Для пользователей, которые будут запускать программу, изменить значение параметра disable_tray_icon в файле $HOME/.config/remmina/remmina.pref.

disable_tray_icon=true

Разрешение на запуск usbip для любого пользователя без аутентификации

Предупреждение

При подключении через систему виртуализации выполнение пункта можно игнорировать.

Выполнить команду:

echo “ALL ALL = (root) NOPASSWD: /usr/sbin/usbip” | sudo tee /etc/sudoers.d/uvdic

Выполнить команду:

echo “ALL ALL = (root) NOPASSWD: /usr/bin/usbip” | sudo tee /etc/sudoers.d/uvdic

Настройка виртуальной машины

Подключение через систему виртуализации

Настройка виртуальной машины не требуется. В виртуальной машине может быть установлена любая операционная система.

Подключение через сетевой интерфейс виртуальной машины

Автоматическая настройка виртуальной машины под управлением операционной системы на базе Linux производится с помощью скрипта vm_install.sh. Последняя версия скрипта предоставляется по запросу на uvdic@irsural.ru.

Скрипт поддерживает операционные системы:

Ubuntu 20.04.3 и выше;
Debian 10 и выше;
Основа (отечественная операционная система).

Разработчики ведут работу над увеличением перечня операционных систем. Актуальный перечень предоставляется по запросу на uvdic@irsural.ru.

В виртуальной машине дополнительно должны быть выполнены настройки:

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