О программе ↵

Назначение программы

Space Client предназначен для удаленного подключения к виртуальным рабочим столам (ВРС) на базе ОС семейства Windows и Linux по протоколам Spice и RDP, Glint.

Поддерживаемые ОС

Astra Linux Special Edition версия 1.7;
AlterOS 7;
ALT Linux 10;
Ubuntu 16;
Windows 7;
Windows 8;
Windows 10.

Space Client обеспечивает:

воспроизведение видео в разрешении до FullHD в Web-браузере и в отдельном приложении-плеере при удаленном подключении к ВРС;
воспроизведение gif- и flash-анимации без замирания картинки в Web-браузере или приложении для просмотра gif- и flash-анимации при удаленном подключении к ВРС;
комфортную работу САПР Autocad при работе с 3D-графикой при удаленном подключении к ВРС;

Примечание

Выполняется только с предварительной подготовкой виртуальной машины (ВМ) на SpaceVM, включающей подключение к ВМ виртуальной видеокарты nVidia с поддержкой технологии GRID, установку драйверов виртуальной видеокарты, подключение лицензии виртуальной видеокарты и установку приложения Spice-tools при подключении по протоколу Spice.

воспроизведение звука без прерываний при подключении к ВРС;
интеграцию со службой каталогов для хранения учетных записей и данных пользователей (LDAP или AD);
прохождение процедуры авторизации и аутентификации с использованием локальных учетных записей пользователей Space Disp;
прохождение процедуры авторизации и аутентификации на тонком клиенте с использованием учетных записей пользователей на удаленном контролере LDAP (AD);
подключение к ВРС следующих устройств:
- манипулятор типа мышь через интерфейс USB;
- клавиатура через интерфейс USB;
- накопитель flash через интерфейс USB;
- накопитель на жестком диске через интерфейс USB;
- наушники через интерфейс TRS 3,5 mm;
- динамики через интерфейс TRS 3,5 mm;
- микрофон через интерфейс TRS 3,5 mm;
- принтер и сканер;
- Web-камера через интерфейс USB.

Примечание

При наличии соответствующих разъёмов в аппаратной платформе.

проброс принтеров и сканеров в ВРС;
проброс в ВРС нескольких дисков и папок с устройства клиента.

Поддерживаемые ОС

Внимание

Дата выхода обновления ПО зависит от приоритета, начиная с самого высокого - 1. Период между обновлениями с разными приоритетами - 2 месяца.

В таблице 1 приведен список поддерживаемых гостевых ОС для удаленного подключения к ВРС.

ОС	RDP	Spice	Glint Client	Loudplay	Windows Native RDP	Приоритет
Astra 1.7	+	+	+	+		1
AlterOS 7	+	+	+			1
Ubuntu 16	+	+	+	+		1
Alt Linux 10	+	+	+			1
Windows 7	+	+	+	+	+	1
Windows 8	+	+	+	+	+	1
Windows 10	+	+	+	+	+	1
RedOS 7.3	+	+				2
Ubuntu 22	+	+	+	+		2
CentOS 8	+	+				2
Windows 11	+	+	+	+	+	2
Ubuntu 20	+	+	+	+		3
Astra 1.6	+	+				3
Debian 11	+	+				3

/ где + обозначает наличие, 1 приоритет - наивысший, 3 - наименьший.

В таблице 2 приведен список поддерживаемых хостовых ОС для удаленного подключения пользователя к ВРС.

ОС	Glint Server	LoudplayServer	Приоритет
Astra 1.7	+		1
AlterOS 7	+		1
RedOS 7.3	+		1
Windows 7		+	1
Windows 8		+	1
Windows 10		+	1
Windows 11		+	1
Alt Linux 10	+		2
Ubuntu 22	+		2
Ubuntu 16	+		3
Ubuntu 20	+		3

/ где + обозначает наличие, 1 приоритет - наивысший, 3 - наименьший.

Технические требования

Для нормального функционирования Space Client требуется ПЭВМ, технические характеристики которой не должны уступать приведенным ниже:

процессор с частотой - не менее 1 ГГц;
объем оперативной памяти – не менее 1 Гбайт (для 32-bit системы) и не менее 2 Гбайт (для 64-bit системы);
свободное дисковое пространство - не менее 500 Мб;
постоянное запоминающее устройство – не менее 1 Гбайт;
интерфейсы сетевые – не менее 1 Гбит Ethernet, в количестве не менее одного.

ОС Linux

Для нормального функционирования Space Client на ОС Linux требуется наличие общесистемных программных средств среды функционирования прикладных программ ОС Linux семейства Debian/Ubuntu и следующих пакетов:

spice-client-gtk;
libspice-client-gtk-3.0-dev;
libjson-glib-dev;
libxml2-dev;
libsoup2.4-dev;
freerdp2-dev;
libfreerdp-client2-2;
libwinpr2-2;
libwinpr2-dev;

Примечание

Часть перечисленных пакетов устанавливается вместе с графической оболочкой ОС.

При установке Space Client на ОС Linux все необходимые зависимости установятся автоматически из стандартного источника пакетов ОС.

Специалист, производящий установку Space Client, должен иметь навыки работы на ПЭВМ в ОС Linux семейства Debian/Ubuntu.

ОС Windows

Для нормального функционирования Space Client на ОС Windows требуется наличие общесистемных программных средств среды функционирования прикладных программ ОС Windows и Microsoft Visual C++ Redistributable.

Для обеспечения функционирования Space Client на ОС Windows с поддержкой подключения USB устройств к ВРС требуется наличие библиотеки UsbDk.

Специалист, производящий установку Space Client, должен иметь навыки работы на ПЭВМ в ОС Windows.

Перечень принятых сокращений

Сокращение	Описание
ВМ	виртуальная машина
ВРС	виртуальный рабочий стол
ОС	операционная система
ПЭВМ	персональная электронно-вычислительная машина
AD	Active Directory (активный каталог)
LDAP	Lightweight Directory Access Protocol (облегчённый протокол доступа к каталогам)
RDP	Remote Desktop Protocol (протокол удалённого рабочего стола)
Spice	Simple Protocol for Independent Computing Environments (простой протокол для независимой вычислительной среды)
TRS	Tip, Ring, Sleeve (кончик, кольцо, гильза; подразумевается форма контактов на штекере, разъём для передачи аналогового аудиосигнала)
USB	Universal Serial Bus (универсальная последовательная шина)

Ended: О программе

Руководство оператора ↵

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

Space Client предназначен для удаленного подключения к виртуальным рабочим столам (ВРС) на базе ОС семейства Windows и Linux по протоколам Spice и RDP, Glint.

Поддерживаемые ОС

Astra Linux Special Edition версия 1.7;
AlterOS 7;
ALT Linux 10;
Ubuntu 16;
Windows 7;
Windows 8;
Windows 10.

Установка Space Client в операционных системах семейства Windows или Linux возможна:

c CD/DVD диска;
через сеть Интернет с сервера ООО "ДАКОМ М".

Перед началом установки Space Client необходимо войти в операционную систему под учетной записью администратора/суперпользователя.

При возникновении ошибки с сертификатом, необходимо выполнить команду wget --no-check-certificate https://update.spacevm.ru/space-client/linux/space-client-linux-installer.sh

Проверка целостности программы

Непосредственно перед установкой должна быть проверена контрольная сумма установочного компакт-диска Space Client.

OC Linux

Проверка контрольной суммы осуществляется на ЭВМ с установленной ОС Ubuntu 18.04 LTS.

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

включить ПЭВМ с установленной ОС и дождаться запроса входного имени;
войти в ОС под учетной записью суперпользователя (учетная запись root);
дождаться приглашения ввода консоли;
вставить компакт-диск с дистрибутивом Space Client в дисковод DVD-ROM;
смонтировать компакт-диск с помощью команды mount /dev/cdrom;
перейти в каталог точки монтирования компакт-диска (каталог с содержимым компакт-диска) с помощью команды cd /mnt/cdrom.

Примечание

Каталог точки монтирования компакт-диска зависит от настроек рабочего места и может отличаться.

в командной строке набрать команду для подсчета контрольной суммы

find . -type f -exec md5sum {} \; | sort -k2 | md5sum

Примечание

Будьте внимательны при наборе команды.

дождаться окончания выполнения введенной команды и получить на мониторе подсчитанную контрольную сумму;
размонтировать компакт-диск с помощью команды cd /; umount /dev/cdrom;
извлечь компакт-диск из дисковода DVD-ROM.

OC Windows

Проверка контрольной суммы осуществляется на ЭВМ, на которую установлена ОС Windows ⅞.1/10 и средство фиксации и контроля исходного состояния программного комплекса «Фикс».

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

войти в ОС под учетной записью администратора;
вставить компакт-диск с дистрибутивом Space Client в дисковод DVD-ROM;
установить компакт-диск в дисковод DVD ROM;
запустить программу «ФИКС»;
выбрать алгоритм «Уровень-1»;
выбрать в списке проверяемый компакт-диск;
нажать кнопку «Пуск» для вычисления контрольной суммы компакт-диска;
проверить контрольную сумму компакт-диска;
извлечь компакт-диск из дисковода DVD-ROM.

Целостность программы

Программа считается готовой к установке, если контрольная сумма, отображенная на мониторе ЭВМ для установочного компакт-диска, совпала с контрольной суммой этого диска, записанной в формуляре на Space Client.

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

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

Установка Space Client с CD/DVD диска ↵

Установка на операционную систему Linux

Для установки Space Client необходимо выполнить следующие действия:

вставить компакт-диск с инсталляционным файлом в дисковод CD/DVD-ROM;
авторизоваться в системе с правами суперпользователя, имеющего возможность установки пакетов (пользователь должен состоять в группе sudo);
в зависимости от ОС и графической оболочки открыть Менеджер файлов (File Manager или Files, терминал Fly, т.д.);
открыть содержимое носителя;

ОС Astra Linux Special Edition и Astra Linux Common Edition

Открыть Компьютер -> Накопители -> в открывшемся окне выбрать в корневой директории носителя файл space-client-X.X.X-linux.tar (где Х.X.X – номер сборки Space Client).

скопировать файл в домашний каталог пользователя и распаковать архив;
выполнить установку Space Client;

ОС Astra Linux Special Edition и Astra Linux Common Edition

запустить установку Space Client двойным нажатием правой кнопки "мыши" на инсталляционный файл space-client-linux-installer.sh;
дождаться появления окна менеджера приложений, в котором необходимо нажать на кнопку Установить;
после этого в открывшемся окне необходимо ввести пароль для суперпользователя и нажать на кнопку Подтвердить;
дождаться появления меню выбора операционной системы;
в строке приглашения ввести номер, соответствующий выбранной ОС и нажать Enter;
в окне менеджера приложений отобразится автоматическая установка программы.

после завершения установки в верхней части окна появится сообщение о том, что приложение Space Client установлено и готово к использованию.

Примечание

В окне существует возможность отменить процесс установки, нажав кнопку Отменить.

после завершения установки необходимо закрыть окно менеджера приложений;
размонтировать компакт-диск с помощью средств ОС. Для этого в Менеджере файлов (File Manage или Files, терминал Fly, т.д.) одинарным нажатием правой клавиши манипулятора "мышь" вызвать контекстное меню для каталога, в который изначально был смонтирован диск, и выбрать пункт Размонтировать;
извлечь компакт-диск из дисковода CD/DVD-ROM.

Примечание

Во время установки система может запросить пароль для получения привилегий sudo, после ввода которого в отдельном окне будет выполнено обновление системы. После обновления начнется установка Space Client вместе с необходимыми для работы пакетами.

Установка на операционную систему Windows

Для установки Space Client необходимо выполнить следующие действия:

вставить компакт-диск с инсталляционным файлом в дисковод CD/DVD-ROM;
запустить менеджер файлов и перейти в корневую директорию носителя;
запустить инсталляционный файл space-client_X.X.X-x64-installer.exe (где Х.X.X – номер сборки Space Client);
дождаться появления окна мастера установки, с помощью кнопки Обзор выбрать папку, в которую будет производиться установка Space Client. После выбора папки для установки следует нажать кнопку Далее;
в следующем окне мастера установки выбрать папку в меню Пуск, где программа должна создавать ярлыки. Рекомендуется выбрать имя ярлыка и название папки, установленное "по умолчанию" и нажать кнопку Далее. Для выбора другой папки необходимо воспользоваться кнопкой Обзор. Установив маркер рядом с полем Не создавать папку в меню Пуск можно отказаться от создания папки;
в следующем окне мастера установки предлагается определиться с необходимостью создания ярлыка для запуска программы на рабочем столе, выставив маркер или оставив пустым чек-бокс рядом с полем Создать значок на Рабочем столе. Для продолжения процесса установки нажать кнопку Далее;
в следующем окне мастера установки отобразится информация о выбранных настройках, заданных в предыдущих окнах. Для изменения настроек необходимо воспользоваться кнопкой Назад. Для подтверждения начала процесса установки нажать кнопку Установить;
в следующем окне мастера установки отобразится автоматическая установка программы. После завершения процесса установки программы Space Client появиться окно с сообщением о завершении работы мастера установки. В окне существует возможность согласиться с предложением запустить программу после выхода из мастера установки, для этого необходимо установить маркер в чек-боксе рядом с полем Запустить Space Client. Для завершения процесса установки нажать кнопку Завершить;
после завершения установки необходимо извлечь компакт-диск с дистрибутивом из дисковода CD/DVD-ROM.

Ended: Установка Space Client с CD/DVD диска

Установка Space Client по сети Интернет с сервера ООО "ДАКОМ М" ↵

Установка на операционную систему Linux ↵

Автоматическая установка Space Client

Для автоматической установки Space Client с сервера ООО "ДАКОМ М" на любую из поддерживаемых ОС семейства Linux кроме Astra Linux Smolensk необходимо выполнить следующие действия:

Astra Linux Smolensk

Установку Space Client на ОС Astra Linux Smolensk необходимо выполнять согласно cоответствующим разделам документации: Установка Space Client на Astra Linux Smolensk.

запустить терминал;
в терминале запустить универсальный установочный скрипт путем выполнения следующих команд:

wget https://update.spacevm.ru/space-client/linux/space-client-linux-installer.sh

sudo bash space-client-linux-installer.sh
после выполнения команд необходимо выбрать ОС из списка. В случае, если список ОС откроется в графической оболочке, необходимо выбрать ОС и нажать кнопку "ОК". Если список откроется текстом в терминале, необходимо набрать номер ОС из списка и нажать "Enter".

Alt Linux 9

Для установки Space Client с сервера ООО "ДАКОМ М" на Alt Linux 9 выполнить следующие команды:

apt-get update && apt-get install wget -y

wget https://update.spacevm.ru/space-client/linux/apt-rpm/x86_64/RPMS.alt9/space-client-latest.rpm

apt-get install ./space-client-latest.rpm -y

rm -f space-client-latest.rpm

Centos 7, 8

Для установки Space Client с сервера ООО "ДАКОМ М" на Centos 7 / Centos 8 выполнить следующие команды:

sudo tee /etc/yum.repos.d/space-client.repo <<EOF [space-client] name=Space Client repository baseurl=http://update.spacevm.ru//space-client//linux/yum/el\$releasever/\$basearch gpgcheck=1 gpgkey=http://update.spacevm.ru/space-client//linux/yum/RPM-GPG-KEY-space-client enabled=1 EOF

sudo yum install space-client -y

Debian 10, 11 / Ubuntu

Для установки Space Client с сервера ООО "ДАКОМ М" на Debian 10 (Buster) / **Debian 11 (Bullseye) / Ubuntu 16.04 (Xenial) / Ubuntu 18.04 (Bionic) / Ubuntu 20.04 (Focal) / Ubuntu 22.04 (Jammy) выполнить следующие команды:

sudo apt-get update && sudo apt-get install apt-transport-https wget lsb-release gnupg -y sudo wget -O /usr/share/keyrings/space-repo-key.gpg https://update.spacevm.ru/space-repo-key.gpg echo "deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-client/linux/apt $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/space-client.list sudo apt-get update && sudo apt-get install space-client -y

Debian 9

Для установки Space Client с сервера ООО "ДАКОМ М" на Debian 9 (Stretch) выполнить следующие команды:

sudo apt-get update && sudo apt-get install apt-transport-https wget lsb-release -y wget -qO - http://update.spacevm.ru/space-repo-key.gpg | sudo apt-key add -

add stretch-backports repo (for freerdp 2.0)

echo "deb http://deb.debian.org/debian stretch-backports main" | sudo tee /etc/apt/sources.list.d/stretch-backports.list echo "deb http://update.spacevm.ru//space-client/linux/apt $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/space-client.list sudo apt-get update && sudo apt-get install space-client -y sudo rm -f /etc/apt/sources.list.d/stretch-backports.list && sudo apt-get update

Astra Linux Orel 2.12

Для установки Space Client с сервера ООО "ДАКОМ М" на Astra Linux Orel 2.12 выполнить следующие команды:

sudo apt-get update && sudo apt-get install apt-transport-https wget -y wget -qO - https://update.spacevm.ru/space-repo-key.gpg | sudo apt-key add - echo "deb https://update.spacevm.ru/space-client/linux/apt bionic main" | sudo tee /etc/apt/sources.list.d/space-client.list sudo apt-get update && sudo apt-get install space-client -y

RedOS 7.2

Для установки Space Client с сервера ООО "ДАКОМ М" на RedOS 7.2 выполнить следующие команды:

tee /etc/yum.repos.d/space-client.repo <<EOF [space-client] name=Space Client repository baseurl=https://update.spacevm.ru/space-client/linux/yum/el7/\$basearch gpgcheck=1 gpgkey=https://update.spacevm.ru/space-client/linux/yum/RPM-GPG-KEY-space-client enabled=1 EOF yum install space-client freerdp-libs -y

RedOS 7.3

Для установки Space Client с сервера ООО "ДАКОМ М" на RedOS 7.3 выполнить следующие команды:

tee /etc/yum.repos.d/space-client.repo <<EOF [space client] name=Space Client repository baseurl=https://update.spacevm.ru/space-client/linux/yum/redos7.3/\$basearch gpgcheck=1 gpgkey=https://update.spacevm.ru/space-client/linux/yum/RPM-GPG-KEY-space-client enabled=1 EOF dnf install space-client -y

Astra Linux

Smolensk 1.7

Для установки Space Client с сервера ООО "ДАКОМ М" на Astra Linux Smolensk 1.7 необходимо выполнить следующие шаги:

Подключить iso-образ основного диска Astra Linux Smolensk 1.7, выполнить команды для копирования deb-пакетов в систему:

sudo mount /media/cdrom sudo mkdir /opt/main sudo cp -r /media/cdrom/pool /media/cdrom/dists /opt/main/ sudo umount /media/cdrom

Подключить iso-образ devel-диска Astra Linux Smolensk 1.7, выполнить команды для копирования deb-пакетов в систему:

sudo mount /media/cdrom sudo mkdir /opt/devel sudo cp -r /media/cdrom/pool /media/cdrom/dists /opt/devel/ sudo umount /media/cdrom

Настроить локальный apt-репозиторий, привести файл /etc/apt/sources.list к виду:

deb file:///opt/main 1.7_x86-64 contrib main non-free deb file:///opt/devel 1.7_x86-64 contrib main non-free

Обновить списки пакетов командой:
```
sudo apt-get update
```

AlterOS 7.x

Для установки Space Client с сервера ООО "ДАКОМ М" на AlterOS 7.x выполнить следующие команды:

sudo tee /etc/yum.repos.d/space-client.repo <<EOF [space-client] name=Space Client repository baseurl=http://update.spacevm.ru//space-client/linux/yum/alteros7/\$basearch gpgcheck=1 gpgkey=http://update.spacevm.ru/space-client/linux/yum/RPM-GPG-KEY-space-client enabled=1 EOF

sudo yum erase -y freerdp-libs

sudo yum install -y http://mirror.centos.org/centos/7/os/x86_64/Packages/libwinpr-2.1.1-2.el7.x86_64.rpm

sudo yum install -y http://mirror.centos.org/centos/7/os/x86_64/Packages/freerdp-libs-2.1.1-2.el7.x86_64.rpm

sudo yum install -y https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/h/hiredis-0.12.1-2.el7.x86_64.rpm

sudo yum install space-client -y

Ended: Установка на операционную систему Linux

Установка на операционную систему Windows с сервера ООО "ДАКОМ М"

Для установки Space Client необходимо выполнить следующие действия:

открыть в браузере адрес: https://update.spacevm.ru/space-client/windows/latest/;
загрузить установочный exe-файл требуемой разрядности (x64 или x32) в зависимости от типа операционной системы;
запустить установку от имени Администратора;
дождаться появления окна мастера установки, с помощью кнопки Обзор выбрать папку, в которую будет производиться установка Space Client. После выбора папки для установки следует нажать кнопку Далее;
в следующем окне мастера установки выбрать папку в меню Пуск, где программа должна создавать ярлыки. Рекомендуется выбрать имя ярлыка и название папки, установленное "по умолчанию" и нажать кнопку Далее. Для выбора другой папки необходимо воспользоваться кнопкой Обзор. Установив маркер рядом с полем Не создавать папку в меню Пуск можно отказаться от создания папки;
в следующем окне мастера установки предлагается определиться с необходимостью создания ярлыка для запуска программы на рабочем столе, выставив маркер или оставив пустым чек-бокс рядом с полем Создать значок на Рабочем столе. Для продолжения процесса установки нажать кнопку Далее;
в следующем окне мастера установки отобразится информация о выбранных настройках, заданных в предыдущих окнах. Для изменения настроек необходимо воспользоваться кнопкой Назад. Для подтверждения начала процесса установки нажать кнопку Установить;
в следующем окне мастера установки отобразится автоматическая установка программы. После завершения процесса установки программы Space Client появиться окно с сообщением о завершении работы мастера установки. В окне существует возможность согласиться с предложением запустить программу после выхода из мастера установки, для этого необходимо установить маркер в чек-боксе рядом с полем Запустить Space Client. Для завершения процесса установки нажать кнопку Завершить.

Ended: Установка Space Client по сети Интернет с сервера ООО "ДАКОМ М"

Удаление Space Client

Удаление с ОС Linux

перейти в терминал;
из любого доступного каталога необходимо выполнить команду:
```
sudo apt purge space-client -y
```
убедиться в успешном удалении Space Client.

Удаление с ОС Windows

перейти к списку установленных программ;
найти Space Client в списке;
стандартным способом выбрать Удалить и подтвердить удаление;
убедиться в успешном удалении Space Client.

Выполнение программы ↵

Подготовка к работе

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

Если в корпоративной сети настроена автоматическая сквозная авторизация, то параметрами авторизации для входа в Space Client будет имя учетной записи и пароль используемые для входа в ОС.

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

Общие правила при работе с программой

Все действия выполняются одинарным нажатием левой клавиши графического манипулятора (далее по тексту – нажатием клавиши) на объект (его изображение или название), на который в данный момент указывает курсор.

При работе с окнами существует возможность их разворачивания на весь экран при нажатии на кнопку , сворачивание окна при нажатии на кнопку , закрытие окна при нажатии на кнопку .

Для комфортной работы с интерфейсом программы рекомендуется разрешение экрана 1920*1080. При меньшем разрешении экрана часть элементов интерфейса может быть скрыта.

Запуск

Запуск программы на ОС Linux

включить ПЭВМ и авторизоваться в ОС с логином и паролем с правами пользователя, под именем которого будет производиться работа с программой;
открыть главное меню графической оболочки ОС;
в строке поиска необходимо набрать Space Client;
двойным нажатием левой клавиши манипулятора "мышь" запустить найденное приложение Space Client. Также приложение можно найти в меню (в зависимости от ОС) Приложения->Система / Приложения->Сеть / Приложения->Интернет.

Запуск программы на ОС Windows

включить ПЭВМ и авторизоваться в ОС с логином и паролем с правами пользователя, под именем которого будет производиться работа с программой;
запуск программы происходит через меню Пуск или с помощью ярлыка Space Client, расположенного на рабочем столе ОС Windows, если такой был создан во время установки программы.

Окно авторизации пользователя и настройка соединения

В результате запуска программы появляется окно настройки авторизации пользователя, содержащее область ввода параметров авторизации, кнопки Войти и Настройки.

В области ввода параметров авторизации необходимо ввести имя пользователя (Логин) и Пароль, полученные у администратора системы виртуализации или учетные данные пользователя домена. Установка маркера в чек-боксе рядом с переключателем LDAP (Внешняя служба авторизации) сообщает серверу Space Disp о том, что учётная запись пользователя хранится в домене AD (LDAP).

В случае, если для учетной записи включена двухфакторная аутентификация, потребуется ввести Одноразовый пароль 2fa.

При выборе Настройки->Основные открывается окно мастера настройки подключения Space Client к серверу Space Disp. В области ввода параметров подключения необходимо задать следующие данные:

доменное имя или IP-адрес сервера Space VDI (вводится в формате xxx.xxx.xxx.xxx*), к которому будет производиться подключение;
порт сервера Space VDI, через который будет производиться подключение (по умолчанию используется 443);
установка маркера в чек-боксе рядом с переключателем Автоподключение к предыдущему пулу приведет к автоматическому подключению к предыдущему выбранному пулу, минуя окно выбора пула.

При нажатии на кнопку Сохранить происходит сохранение настроек и возврат в окно настройки авторизации пользователя.

После ввода параметров авторизации и настройки соединения необходимо нажать кнопку Войти.

Окно доступных пулов ВМ

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

Главная рабочая область окна содержит список доступных пулов ВМ с предустановленными протоколами подключения к ВРС.

Протоколы подключения к ВРС

Протокол Spice используется тогда, когда подключение к ВМ производится средствами SpaceVM. На стороне SpaceVM на каждом узле, на котором запускаются ВМ, реализован Spice-server. Подключение происходит через контроллер SpaceVM, что требует наличия сетевой доступности контроллера SpaceVM для клиентского устройства, с которого производится подключение к ВМ. При выборе Spice_direct подключение произойдет также по протоколу Spice, но напрямую к узлу, где находится ВМ.
RDP-native вызывает встроенный Windows-клиент mstsc.exe.
RDP использует собственную реализацию RDP-клиента.

ОС Windows в ВМ должна быть предварительно настроена администратором или средствами Group Policy домена AD на прием подключений по протоколу RDP для пользователя AD, с которым будет подключаться пользователь.

Графическое изображение изменяется в зависимости от состояния, в котором находится пул, может быть помечен текстовыми полями CREATING и FAILED. Если пул создается, то он помечается надписью CREATING. Если пул недоступен, то он помечается красным прямоугольником, содержащим надпись FAILED. Если пул находится в рабочем состоянии, то он активен для выбора пользователем.

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

В окне существует возможность обновить список доступных пулов ВМ с помощью кнопки Обновить.

Выход из окна осуществляется при нажатии на кнопку Выход.

Примечание

Если при попытке подключения к пулу по RDP появилось сообщение Нет соединения ERRCONNECT_LOGON_FAILURE, это значит, что ВМ не добавлена в тот же домен, что и пользователь, либо учетная запись на ВМ не совпадает с учетной записью на VDI диспетчер (логин/пароль).

Окно ВМ

После успешного запуска ВМ пользователю будет представлено окно работы с ВМ, в котором существует возможность настройки ВМ (горизонтальное меню в верхней части экрана), а также форма авторизации в ОС ВМ. Из-за различий в протоколах окна SPICE и RDP имеют некоторые отличия.

Общие элементы управления

Оперативное управление ВМ осуществляется с помощью горизонтального меню, расположенного в верхней части окна ВМ и содержащего горизонтального меню, расположенного в верхней части окна ВМ и содержащего следующие пункты:

Настройки.
Вид.
USB устройства.
Управление.
Послать сочетания клавиш.
Помощь.

При выборе пункта меню Настройки в раскрывающемся списке будут доступны подпункты Скриншот, Общие папки и Закрыть.

При выборе подпункта Скриншот ВМ делает снимок экрана рабочей области и открывает окно сохранения скриншотов. В данном окне существует возможность задать имя файла изображения и выбрать каталог сохранения. При нажатии на кнопку Save файл с заданным именем и расширением .png сохранится в выбранный каталог.

При выборе подпункта Закрыть открывается окно с предложением закрыть сессию. Для закрытия сессии необходимо нажать кнопку OK, а при отмене действия кнопку Cancel. Установка маркера в чек-боксе рядом с переключателем Не спрашивать снова позволяет в дальнейшем не выводить окно с предложением закрыть программу. В результате нажатия кнопки ОК произойдет разрыв соединения с ВМ и завершение сеанса в Space Client.

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

При выборе команды Отключиться произойдет завершение сеанса работы ВМ и автоматическое закрытие окна ВМ. Настройки, заданные во время сессии, не сохранятся. На экране отобразится окно доступных пулов ВМ.

Выбор команды Приостановить приостанавливает работу ВМ, ОС ВМ не выгружается из памяти и не высвобождает ресурсы.

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

При выборе команды Выключить ОС ВМ может вывести сообщение о невозможности самостоятельно завершить работу, например, при наличии открытых приложений. Пользователю будет предложено либо самостоятельно закрыть все удерживающие процессы, либо ОС ВМ сама автоматически завершит работу приложений и выключится. После чего произойдет автоматическое закрытие окна ВМ и на экране отобразится окно доступных пулов ВМ.

При выборе Выключить форсированно ОС ВМ без предупреждения завершит работу приложений, если они открыты, и выключится. Окно ВМ автоматически закроется и на экране отобразится окно доступных пулов ВМ.

При выборе команды Перезагрузить ОС ВМ может вывести сообщение о невозможности самостоятельно осуществить перезагрузку, например, при наличии открытых приложений. Пользователю будет предложено либо самостоятельно закрыть все удерживающие процессы, либо ОС ВМ сама автоматически завершит работу приложений и начнет перезагружаться.

При выборе команды Перезагрузить форсированно ОС ВМ без предупреждения автоматически завершает работу приложений, если они открыты, и начинает процесс перезагрузки.

При выборе пункта меню Послать сочетания клавиш в раскрывающемся списке будут доступны команды: - Ctrl+Alt+Del

Ctrl+Alt+Backspace
Ctrl+Alt+F1
Ctrl+Alt+F2
Ctrl+Alt+F3
Ctrl+Alt+F4
Ctrl+Alt+F5
Ctrl+Alt+F6
Ctrl+Alt+F7
Ctrl+Alt+F8
Ctrl+Alt+F9
Ctrl+Alt+F10
Ctrl+Alt+F11
Ctrl+Alt+F12
PrintScreen

Реакция на передаваемое сочетание клавиш соответствует ОС, установленной в ВМ, к которой подключен пользователь.

При выборе пункта меню Помощь в раскрывающемся списке будут доступны подпункты Официальная страница SpaceVM, Документация и О программе.

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

При выборе пункта меню Документация в браузере будет открыта текущая документация.

При выборе подпункта О программе открывается окно содержащее графический символ программы Space Client, номер версии и ссылку, при нажатии на которую появляется информация об организации осуществившей разработку программы. Для закрытия информационного окна необходимо нажать кнопку Close.

Отключение от работающей ВМ и закрытие программы осуществляется при нажатии на кнопку .

Описание графического интерфейса SPICE

При выборе Настройки -> Общие папки открывается окно настройки общей папки для обмена файлами между тонким клиентом и ОС ВМ. На вкладке с именем протокола подключения необходимо в раскрывающемся списке выбрать имя папки и установить маркер в чек-боксе рядом с переключателем Общая папка. Установка маркера в чек-боксе рядом с переключателем Только для чтения позволяет настроить режим, при котором файлы, находящиеся в общей папке доступны ОС ВМ только для чтения.

Примечание

Для возможности проброса папок по spice необходима предварительная настройка.

При выборе пункта меню Вид в раскрывающемся списке будут доступны подпункты: Полный экран, Масштаб и Displays.

Установка маркера в чек-боксе рядом с переключателем Полный экран вызывает команду перехода окна ВМ в полноэкранный режим. Окно ВМ займет всю область отображения, а окно операционной системы будет располагаться по центру. В полноэкранном режиме становится недоступным горизонтальное меню. Переключить вид окна и получить доступ к меню можно при помощи всплывающей панели инструментов (тулбара) в нижней средней части окна от настроек используем ос. Выход из полноэкранного режима осуществляется при помощи нажатия на соответствующую кнопку, появляющуюся при наведении на середину в верхней границе окна.

При выборе подпункта Масштаб становятся доступны команды Уменьшить, Увеличить и К размеру виртуальной машины. Команды Уменьшить и Увеличить уменьшают или увеличивают размер окна ВМ. При этом разрешение окна ОС ВМ остается постоянным. Для возврата окна ВМ к исходному размеру необходимо выполнить команду К размеру виртуальной машины.

При выборе подпункта Displays открывается окно, в котором существует возможность указать нужный дисплей ВМ, если у нее их несколько.

При выборе пункта меню USB устройства станет доступным подпункт Проброс USB, при нажатии на который открывается окно с приглашением выбрать USB устройства для подключения Selected USB devices to redirect (n free channels), где n – это количество свободных каналов для подключения. При отсутствии возможности подключения USB устройств (значение n равно 0) в окне выводится уведомление The connected VM is not configured for USB redirеction и список переключателей будет недоступен. Если проброс USB устройств в ВМ возможен, то в окне необходимо из предложенного списка выбрать устройство, установив маркер в чек-боксе рядом с его именем. После успешного подключения устройства пользователь увидит уведомление Redirecting USB Device.... Для закрытия окна и подтверждения изменения параметров необходимо нажать на кнопку Close. В чек-боксе рядом с переключателем USB устройства в главном меню установится маркер выбора.

Описание графического интерфейса RDP

"По умолчанию" RDP окно раскрывается на полный экран. Для выхода из режима полного экрана нужно переместить курсор мыши в верхнюю центральную область экрана и нажать на всплывающую кнопку Покинуть полный экран.

При выборе пункта меню Вид в раскрывающемся списке будет доступен подпункт Полный экран. При нажатии на эту кнопку окно перейдет в полноэкранный режим.

При выборе пункта меню USB устройства и нажатии на подпункт Проброс USB откроется окно выбора устройств для перенаправления по протоколу usbredir. Для проброса устройства необходимо поставить маркер напротив соответствующего названия USB. Данный функционал не поддерживается для RDS пула. Используйте перенаправление USB с помощью RemoteFX Выбрать USB для перенаправления.

Сообщения оператору

Сообщения оператору, выдаваемые на экран во время настройки и выполнения программы в виде всплывающих сообщений, информируют о задачах, выполнение которых было прервано.

Ended: Выполнение программы

Обновление Space Client

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

Linux

Debian-based OS

Создайте файл /etc/apt/sources.list.d/space-сlient.list (от имени суперпользователя) и добавьте в него следующие строки:

Для Debian 9:

deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-сlient/linux/apt stretch main

Для Debian 10:

deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-сlient/linux/apt buster main

Для Debian 11:

deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-сlient/linux/apt bullseye main

Для Ubuntu 16.04:

deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-сlient/linux/apt xenial main

Для Ubuntu 18.04:

deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-сlient/linux/apt bionic main

Для Ubuntu 20.04:

deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-сlient/linux/apt focal main

Для Ubuntu 22.04:

deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-сlient/linux/apt jammy main

Для Astra Linux Orel 2.12:

deb [arch=amd64 signed-by=/usr/share/keyrings/space-repo-key.gpg] https://update.spacevm.ru/space-сlient/linux/apt bionic main

Загрузите ключ проверки репозитория командой:

sudo wget -O /usr/share/keyrings/space-repo-key.gpg https://update.spacevm.ru/space-repo-key.gpg

После этого выполните в терминале команду: sudo apt-get update.
Для Centos 7 / Centos 8 cоздайте файл /etc/yum.repos.d/space-сlient.repo (от имени суперпользователя) и добавьте в него следующие строки:

name=Space Client repository baseurl=https://update.spacevm.ru/space-сlient/linux/yum/el$releasever/$basearch gpgcheck=1 gpgkey=https://update.spacevm.ru/space-сlient/linux/yum/RPM-GPG-KEY-space-сlient enabled=1
Для AlterOS 7 cоздайте файл /etc/yum.repos.d/space-сlient.repo (от имени суперпользователя) и добавьте в него следующие строки:

name=Space Client repository baseurl=https://update.spacevm.ru/space-сlient/linux/yum/alteros7/$basearch gpgcheck=1 gpgkey=https://update.spacevm.ru/space-сlient/linux/yum/RPM-GPG-KEY-space-сlient enabled=1
После этого выполните в терминале команду: sudo yum makecache.
Запустите Space Client.
В окне авторизации в верхнем левом углу рядом с номером версии приложения появится знак предупреждения в случае, если была обнаружена новая версия.

Пример

Нажмите Настройки -> Служебные -> Получить обновления.
В открывшемся окне введите пароль sudo.

Пример

Нажмите Ок. После этого, в случае наличия новой версии, произойдет ее загрузка и установка.
Перезапустите Space Client.

Windows

Запустите Space Client.
Нажмите Настройки -> Служебные.
Введите путь к Windows хранилищу обновлений: https://update.spacevm.ru

Нажмите кнопку Получить обновления. После этого, в случае наличия новой версии, произойдет ее загрузка и запуск установщика приложения.
Следуйте инструкциям установщика.
Перезапустите Space Client.

Обновление инфраструктуры при отсутствии доступа к сети Интернет

Вариант 1. Через виртуальный диск формата qcow2.
Вариант 2. Создание локального репозитория.

Вариант 1.

Cделать запрос на виртуальный диск с обновлениями для нужной версии Space Client формата qcow2.
Загрузить диск на ПК, любым удобным способом.
Создать ВМ с этим диском.
Настроить сеть в ВМ (логин root, без пароля).
Прописать репозитории (название дистрибутива уточнить в службе поддержки) на машинах с Space Client, для этого создать файл:
Для deb-based систем - /etc/apt/sources.list.d/space-client.list с содержанием:
```
deb http://{VM_IP_ADDRESS}/space-client {DISTRIB} main
```
Для rpm-based систем - /etc/yum.repos.d/space-client.repo с содержанием:

[space-client] name=Space Client repository baseurl=http://{VM_IP_ADDRESS}/space-client/linux/yum/el$releasever/$basearch gpgcheck=1 gpgkey=http://{VM_IP_ADDRESS}/space-client/linux/yum/RPM-GPG-KEY-space-client enabled=1
Обновить списки пакетов командой:
- Для deb-based систем: apt-get update.
- Для rpm-based систем: yum -y makecache.
Выполнить обновление пакетной базы командой:
- Для deb-based систем: apt-get upgrade -y.
- Для rpm-based систем: yum -y update.

Вариант 2. Cоздание пользователем локального репозитория для обновления SpaceVM без использования ресурсов интернет

Данные действия производятся на ОС Debian версии 9 или 10.

Актуальные адреса и названия для репозиториев можно получить у службы поддержки.

Установить утилиту wget для создания локального зеркала репозитория на выделенный для этого сервер:

apt-get update

apt-get install wget -y
Создать локальное зеркало репозитория. Начнется загрузка пакетов, может занять продолжительное время, в зависимости от скорости вашего канала:

mkdir -p /opt/repo wget --recursive --no-parent --no-host-directories --reject='index.html*' -l 0 -P /opt/repo update.spacevm.ru/space-сlient/
Установить nginx на тот же самый сервер:
```
apt-get install nginx -y
```
Провести конфигурацию /etc/nginx/sites-enabled/default к виду:

server { listen 80 default_server; root /opt/repo; server_name _; location / { try_files $uri $uri/ =404; autoindex on; } }
Обновить конфигурацию nginx:
```
nginx -s reload
```
Прописать репозитории (название дистрибутива уточнить в службе поддержки) на машинах с Space Client, для этого создать файл:
- Для deb-based систем - /etc/apt/sources.list.d/space-сlient.list с содержанием:
```
deb http://{LOCAL_REPO_IP_ADDRESS}/space-сlient {DISTRIB} main
```
- Для rpm-based систем - /etc/yum.repos.d/space-сlient.repo с содержанием:
  
  [space-сlient] name=Space Clientrepository baseurl=http://{LOCAL_REPO_IP_ADDRESS}/space-сlient/linux/yum/el$releasever/$basearch gpgcheck=1 gpgkey=http://{LOCAL_REPO_IP_ADDRESS}/space-сlient/linux/yum/RPM-GPG-KEY-space-сlient enabled=1
Обновить списки пакетов командой:
- Для deb-based систем: apt-get update.
- Для rpm-based систем: yum -y makecache.
Выполнить обновление пакетной базы командой:
- Для deb-based систем: apt-get upgrade -y.
- Для rpm-based систем: yum -y update.

Настройки ↵

Основные настройки

В поле Адрес сервера задается сетевой адрес Space Disp.
В поле Порт сервера задается порт подключения к Space Disp (80 - без SSL, 443 - c SSL).
При включенной опции Автоподключение при запуске приложение подключится к пулу, к которому производились подключения в последний раз. При отсутствии данных о предыдущем пуле приложение покажет окно выбора пулов.
При включенной опции Сохранить пароль пароль будет сохранен в файл настроек приложения.
При включенной опции Перенаправлять временную зону временная зона тонкого клиента будет установлена на удаленной машине.

Настройки Spice

Spice

При включенной опции Показывать клиентский курсор клиентский курсор "мыши" не будет скрыт.
При выборе пункта Полный экран приложение раскроется на полный экран.
Список пар отображений гостевых дисплеев на клиентские мониторы (через точку с запятой). Например, чтобы отобразить гостевые дисплеи 0 и 1 на клиентские мониторы 0 и 1, используйте 0:0;1:1. Список должен содержать id всех дисплеев от 0 до последнего желаемого, т. е. 2:2 это невалидный параметр, так как отсутствуют отображения для дисплеев 0 и 1. Данный параметр имеет эффект только в режиме ПОЛНОГО ЭКРАНА. Требуется ПЕРЕЗАПУСК приложения, чтобы применить изменения. Количество дисплеев ВМ задается в Web-интерфейсе SpaceVM. Чтобы узнать идентификаторы (номера) текущих клиентских мониторов, нажмите на знак "вопроса".
Строка "Фильтр", используемая для задания, какие USB-устройства должны быть автоматом проброшены при их (физическом) подключении к компьютеру-тонкому клиенту и при успешной установке подключения по Spice.

Настройки RDP

Описание настроек клиента

RDP

Формат изображения определяет количество используемых цветов. Рекомендуется BGRA32.
Параметр FPS задает частоту обновления экрана. Обновляются только изменившиеся области изображения. Параметр влияет на загрузку процессора клиента и не влияет на сетевой трафик.
При выборе пункта Полный экран приложение раскроется на полный экран.
При включенной опции Мультимониторность приложение использует до 3 доступных мониторов. Рекомендуется, чтобы на всех мониторах была задана одинаковая высота изображения.
Выбранные мониторы. Указать, какие клиентские мониторы должны использоваться для отображения удаленного рабочего стола. Мониторы должны иметь общие стороны. Параметр задается как список id мониторов через запятую. Например: 0,1 - использовать мониторы с id 0 и 1. Чтобы узнать идентификаторы (номера) текущих клиентских мониторов, нажмите на знак "вопроса". Для использования более одного монитора должна быть активирована опция Мультимониторность.
Формат запуска приложения (RDS) определяет вид строкового идентификатора приложения для запуска на RDS.
Если указать сетевое подключение, то RDP-сервер будет адаптировать параметры подключения в зависимости от выбранного режима для достижения оптимального использования сетевого трафика.
При включенной опции Перенаправлять принтеры сетевые принтеры будут перенаправлены в ВМ.
При включенной опции Сжатие видеопотока будет использован указанный cтандарт сжатия видео. Поддерживаются AVC420/AVC444/RemoteFX на Linux и AVC420/RemoteFX на Windows.
При нажатии на кнопку Выбрать USB для перенаправления откроется диалог выбора USB-устройств, которые будут перенаправлены. Сервер RDP должен поддерживать технологию RemoteFX USB Redirection. На клиенте у текущего пользователя должны быть права на открытие конкретных USB-устройств.
Поле Перенаправляемые папки предназначено для задания списка папок, которые будут перенаправлены в ВМ. Перечислите папки через точку с запятой либо выберите их с помощью селектора Добавить папку.
При включенной опции Логировать отладочную информацию будет сохраняться в файл отладочная информация при подключении по RDP. Активизация данной опции может замедлить работу приложения.

Настройки RDP для достижения минимальной полосы пропускания сети

Действия на сервере Microsoft Server 2008, Windows 7

Запустить gpedit.msc.
Перейти к пункту Конфигурация компьютера > Административные шаблоны > Компоненты Windows > Служба удаленных рабочих столов > Узел сеансов удаленных рабочих столов > Среда удаленных сеансов.
Включить опцию Наибольшая глубина цвета, выбрать 16 бит.
Включить опцию Настройки RemoteFX.
Включить опцию Оптимизация внешнего вида при использовании RemoteFX. В параметрах задать: Частота захвата кадров - самая низкая, качество экранного изображения - минимальное.
Включить опцию Задание алгоритма сжатия RDP. Выбрать алгоритм сжатия Оптимизация использования полосы пропускания сети.
Выполнить в терминале и затем перезапустить сервер:
```
gpupdate /force
```

Действия на сервере Microsoft Server 2012-2019, Windows 10

Запустить gpedit.msc.
Перейти к пункту Конфигурация компьютера > Административные шаблоны > Компоненты Windows > Служба удаленных рабочих столов > Узел сеансов удаленных рабочих столов > Среда удаленных сеансов.
Включить опцию Настройки RemoteFX.
Включить опцию Оптимизация визуальных эффектов при использовании RemoteFX. В параметрах задать: Скорость захвата кадров - самая низкая, качество экранного изображения - самое низкое.
Выполнить в терминале и затем перезапустить сервер:
```
gpupdate /force
```

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

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

Включение удаленного доступа на Windows 10

Ввести в поиске SystemPropertiesAdvanced.
В открывшемся окне перейти на вкладку Удаленный доступ.
Выбрать пункт Разрешить удаленный доступ.
Если AD не используется, то пользователь, под которым будет производится вход, должен быть добавлен в список разрешенных. Перейти к SystemPropertiesAdvanced->Удаленный доступ. Выбрать пользователей и нажать кнопку Добавить. Затем ввести имя локального пользователя.

Настройки GLINT

Общее описание

GLINT — протокол подключения пользователя к удаленному рабочему столу. Позволяет работать из любой точки мира с минимальной задержкой.

Имеет ряд преимуществ:

возможность подключения в любой момент;
использование кодека h264 — стандарт сжатия видео, предназначенный для достижения высокой степени сжатия при сохранении высокого качества;
лимитирование занимаемой полосы пропускания, задаваемое пользователем, позволяет подключаться к удаленному рабочему столу на каналах с пропускной способностью от 1 Мбит/c;
передача сигналов управления от пользовательских устройств на сервер для любых ресурсоемких программ и приложений.

Подготовка

Для работы протокола GLINT необходимо установить на ВМ glint_server.

Подключение по протоколу GLINT возможно только на ВМ с ОС Linux.

Space Client для Linux версии 2.0.0 и выше.

Установить iso-образ glint_server
Подключить образ к ВМ.

Выполнить последовательно команды:

sudo mount /dev/cdrom /mnt
sudo bash /mnt/install.sh
sudo umount /mnt

Запустить сервер из консоли Space VM в терминале ВМ, командой:
```
glint-server -auth
```
Запуск сервера не рекомендуется осуществлять из под sudo.

Лимитирование занимаемой полосы пропускания

Для настройки ограничения полосы пропускания необходимо перейти в Space Client-GLINT и задать значения:

Bitrate h264, по умолчанию установлено 10 000 000 бит/сек.
Frame rate h264, по умолчанию установлено 30.

Для работы звука необходимо перейти в Space Client-GLINT и задать значения:

Частота дискретизации звука - 44100.
Звуковой канал - 2.
Режим аудио - Воспроизводить локально.

Разрешение экрана

glint_server передает разрешение клиентской машине равное установленному на удаленной машине.

Настройки

Loudplay - протокол удаленного доступа на основе RDP.

Подготовка на стороне удаленной машины

Установите сервер Loudplay согласно инструкции производителя.

Подготовка на стороне тонкого клиента

Установите клиент Loudplay.
Перейдите в Настройки Space Client на вкладку LOUDPLAY и укажите путь к установленному клиенту.

Для подключения по протоколу Loudplay после подключения по протоколу RDP необходимо перезапустить ВМ с сервером Loudplay.

Служебные настройки

При нажатии на кнопку Архивировать логи будет создан архив с логами приложения (log.tar.gz) и показан путь-расположение архива. Реализовано для ОС Windows 10 и Linux.
При нажатии на кнопку Получить обновления будет запущен сценарий обновления приложения.
При нажатии на кнопку Открыть документацию будет открыта документация в браузере по умолчанию.
Режим приложения определяет к какому серверу должен подключаться клиент (диспетчера VDI /контроллер/напрямую к ВМ). После смены режима нужно заново ввести логин, пароль, адрес и порт подключения.
Время ожидание ВМ из пула - это максимальное время (тайм-аут), в течение которого будет ожидаться ВМ при ее запросе из пула. При достижении тайм-аута запрос ВМ завершится с ошибкой.
Опция Single-instance application определяет, возможно ли запустить более одного экземпляра Space Client.

Настройка двухфакторной аутентификации

Примечание

При включении двухфакторной аутентификации при каждой авторизации будет требоваться одноразовый пароль, генерируемый приложением-аутентификатором (система тестировалась с приложениями: Яндекс.Ключ, Google Authenticator).

Включение

Авторизируйтесь в Space Client, введя имя пользователя/пароль и нажав Войти.
После успешной авторизации нажмите кнопку Настройки профиля.
В открывшемся окне активируйте пункт Двухфакторная аутентификация.
Нажмите кнопку Сгенерировать новый код.
Отсканируйте QR-код c помощью аутентификатора (система тестировалась с приложениями: Яндекс.Ключ, Google Authenticator).
Нажмите Применить.

Отключение

Зайдите в Настройки профиля и деактивируйте пункт Двухфакторная аутентификация.
Нажмите Применить.

Перенаправление папок по Spice

Текущий пользователь должен иметь право на перенаправление папок (Задается администратором в Web-интерфейсе Разрешения).

Space Client запущен на хосте с Linux/Windows. На ВМ установлен Linux

На ВМ установлен файловый менеджер с поддержкой технологии WebDAV (например, nautilus)

В гостевой ВМ установить spice-webdavd service командой sudo apt install spice-webdavd.
Запустить сервис командой sudo spice-webdavd -p 8000.
Перезапустить ВМ.
С Space Client подключиться к ВМ.
В меню Настройки выбрать Общие папки. В открывшемся окне выбрать папку для перенаправления.
Поставить "галочку" Общая папка. Закрыть окно.
В сетевых папках ВМ появится пункт Spice client folder. Нажать на него, чтобы открыть общую папку.

На ВМ установлен файловый менеджер без поддержки технологии WebDAV (например, fly-fm)

Вариант 1

В гостевой ВМ установить spice-webdavd service командой sudo apt install spice-webdavd.
Запустить сервис командой sudo spice-webdavd -p 9843.
В Space Client в меню Настройки выбрать Общие папки. В открывшемся окне выбрать папку для перенаправления.
Поставить "галочку" Общая папка. Закрыть окно.
В гостевой ВМ установить davfs2, выполнив команду sudo apt-get install davfs2.
Создать директорию для монтирования, например sudo mkdir /home/m.
Монтировать папку: sudo mount -t davfs http://127.0.0.1:9843 /home/m
В папке /home/m отобразится содержимое проброшенной папки.

Вариант 2

Установить файловый менеджер nautilus.
Отключить IPv6, выполнив в терминале команды:

sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1

sudo sysctl -w net.ipv6.conf.default.disable_ipv6=1

sudo sysctl -w net.ipv6.conf.lo.disable_ipv6=1

Далее следовать инструкции для файлового менеджера с поддержкой технологии WebDAV.

Space Client запущен на хосте с Linux/Windows. На ВМ установлен Windows

В гостевой ВМ установить spice-webdavd-x64-latest.
Открыть командную строку, перейти в папку C:\Program Files\SPICE webdavd и выполнить скрипт map-drive.bat.
С Space Client подключиться к ВМ.
В меню Настройки выбрать Общие папки. В открывшемся окне выбрать папку для перенаправления.
Поставить "галочку" Общая папка. Закрыть окно.
В ВМ появится новый сетевой диск Spice client, на котором будет содержимое общей папки.

Перенаправление USB

Общие требования

Текущий пользователь должен иметь право на перенаправление USB (Задается администратором в Web-интерфейсе Разрешения).
Если Space Client запущен на Linux, то пользователь должен иметь разрешение на открытие USB (Выполнить chmod 666 для устройства / добавить пользователя в группу, владеющую устройством / изменить разрешения устройства).
Если Space Client запущен на машине с ОС Windows, то там необходимо установить UsbDk.
В Web-интерфейсе SpaceVM у ВМ должен быть добавлен USB-контроллер nec-xhci (USB3.0) (ВМ -> USB-устройства -> Подключить USB-устройства).
Если удаленная машина работает под управлением ОС Windows 7 или Windows Server 2008, то для корректной работы на этих машинах должен быть установлен драйвер NEC USB 3.0 Driver.

Spice

В Web-интерфейсе SpaceVM у ВМ должен быть добавлен USB Spice канал (USB-устройства -> Подключить -> Добавить SPICE USB канал -> ОК ).
После запуска Space Client и подключения по протоколу Spice выберите в меню пункт Проброс USB.
В открывшемся окне выберите USB-устройство для перенаправления.

RDP

При подключении по RDP USB-устройство может быть проброшено с помощью технологий RemoteFX USB и usbredir Spice.

RemoteFX USB

Примечание

Перенаправление flash-накопителей не поддерживается: используйте перенаправление папок.

Примечание

RemoteFX USB - единственный способ перенаправления USB для RDS-пула.

Виртуальная машина должна быть размещена на хосте с поддержкой RemoteFX (Windows Server 2008 R2 SP1 и новее).
Если Space Client запущен на машине с ОС Windows, то там должна быть включена опция Разрешить перенаправление других поддерживаемых USB-устройств RemoteFX c данного компьютера. Для этого введите gpedit в терминале. В открывшемся окне перейдите по пути Конфигурация компьютера - Административные шаблоны - Компоненты Windows - Службы удаленных рабочих столов - Клиент подключения к удаленному рабочему столу - Перенаправление USB-устройств RemoteFX. Кликните 2 раза на пункт Разрешить перенаправление.... В открывшемся окне, в котором выберите пункт Включено и параметр Администраторы и пользователи. Нажмите Применить и перезагрузите компьютер.

Разрешение перенаправления

После запуска Space Client перейдите в Настройки -> RDP и нажмите на кнопку Выбрать USB для перенаправления.

В открывшемся окне выберите необходимое USB-устройство и нажмите Закрыть -> Сохранить.

Для автоматического перенаправления USB необходимо установить флаг "Запоминать перенаправленные USB"

USBREDIR (Spice)

Примечание

Для перенаправления USB осуществляется подключение по Spice c созданием канала SPICE_USBREDIR_CHANNEL.

В Web-интерфейсе SpaceVM у ВМ должен быть добавлен USB Spice канал (USB-устройства -> Подключить).
В Web-интерфейсе SpaceVM у ВМ должен быть включен удаленный доступ (при штатной работе это происходит при создании пула на VDI диспетчере).
После запуска Space Client и подключения по протоколу RDP выберите в меню USB-устройства -> USBREDIR SPICE
В открывшемся окне выберите USB-устройство для перенаправления.

Для автоматического перенаправления USB необходимо установить флаг "Запоминать перенаправленные USB".

Запрещен проброс клавиатуры и "мыши", т.к. необходим иной механизм.

Запрет проброса USB устройств (USBREDIR)

Откройте в текстовом редакторе конфигурационный файл client_settings.ini.
Для подключения по Spice создайте поле show_usb_filter в группе SpiceSettings.
Для подключения по RDP создайте поле spice_show_usb_filter в группе RDPSettings.
В созданном поле укажите фильтр USB устройств, представляющий собой группу правил формата class,vendor,product,version,allow, соединенных символом |. Например, если указать фильтр 0x08,-1,-1,-1,0|-1,-1,-1,-1,1, то на графическом интерфейсе в окне выбора USB для проброса не будут показаны устройства класса 0x08, то есть флеш накопители. Если указать фильтр -1,0x0951,0x1603,-1,0|-1,-1,-1,-1,1, то на графическом интерфейсе в окне выбора USB для проброса не будет показано устройство с vendor id 0x0951 и product id 0x1603.

Настройка мультимониторности

1. Создать или модифицировать существующую ВМ для поддержки мультимониторов

Создание новой ВМ

Необходимо создать ВМ в среде SpaceVM согласно документации.
При создании в разделе Видео карта нажать Дополнительно и в раскрывшемся списке выбрать количество мониторов.

Пример:

Внимание

Для использования ВМ автоматическим пулом необходимо перевести В режим шаблона.

Модификация существующей ВМ

Необходимо в среде SpaceVM открыть подробную информацию о ВМ и выключить питание. Перейти в раздел Информация - Графический адаптер.
Нажать Дополнительно и в раскрывшемся списке выбрать количество мониторов.

Пример:

2. Создать пул ВРС

Необходимо создать пул ВРС в среде Space Disp согласно документации.
После создания пула необходимо добавить пользователя, для этого необходимо перейти к подробной информации о пуле и в разделе Пользователи выбрать пользователя или группу для удаленного подключения.

3. Настроить Space Client

Открыть Space Client и перейти в настройки Spice.
Установить параметр Полный экран и указать количество мониторов.

Пример:

Если на физической машине ТК 2 монитора, в ВМ тоже 2, необходимо 1 к 1, то соответствие будет выглядеть 0:0;1:1.

Если на физической машине ТК 3 монитора, в ВМ 2, необходимо 0 (первый) к 2 (третий) физический монитор, то соответствие будет выглядеть 0:0;1:2.

Примечание

Порядковые номера начинаются с 0 и не допускают пропусков.

Для того чтобы узнать идентификаторы (номера) текущих клиентских мониторов, необходимо нажать на справа от параметра Отображение.

Пример:

Сохранить настройки и перезапустить Space Client.

Ended: Настройки

Ended: Руководство оператора

Тонкие клиенты ↵

Документация по тонким клиентам

Установка ТК на ОС Astra Linux в режиме киоска

Установка Astra Linux Common Edition.
Создание пользователя (Например: kiosk).
Установка ТК Space Client, используя установщики.
Перевод рабочего стола в режим киоска.
Запуск приложения ТК Space Client в режиме kiosk.

Установка ОС Astra Linux CE на ТК Dell Wyse, используя образ

Действия, которые необходимо выполнить для установки ОС: 1. Загрузить программу установки ОС с носителя. 2. Выбрать настройки программы установки и оборудования. 3. Активировать (если есть) подключение к сети Ethernet. 4. Создать учетную запись и пароль администратора. 5. Настроить время. 6. Создать и смонтировать дисковые разделы, на которые будет установлена ОС (Метод разметки выбираем авто - использовать весь диск). 7. Выбрать и установить необходимое программное обеспечение (ПО) (Выбираем: Базовые средства, Рабочий стол Fly). 8. Выбрать и установить дополнительные настройки ОС. 9. Установить и настроить системный загрузчик GRUB. 10. Загрузить установленную ОС в первый раз.

Создание пользователя kiosk

Пуск → Системные → Терминал Fly.
Переходим к привилегированному режиму командой sudo su.
Запускаем Управление политикой безопасности - локальная политика командой fly-admin-smc.
В запущенном окне переходим к разделу Пользователи.
В верхней части окна нажимаем на +, будет запущен мастер создания пользователя, в котором указываем Имя (Например:kiosk).
В верхней части окна нажимаем на кнопку Применить изменения.
В разделе Пользователи будет создана учётная запись kiosk.

Настройка графического входа для пользователя kiosk

Для настройки графического входа в терминале от суперпользователя вводим команду fly-admin-dm.
В запущенном окне переходим к вкладке Дополнительно.
Во вкладке Дополнительно нажимаем на Разрешить автоматический вход в систему, в раскрывающемся списке Пользователи выбираем пользователя kiosk.
В поле Автоматически выбирать пользователя выбираем раскрывающийся список Указанный и выбираем пользователя kiosk.
В поле Разрешить вход без пароля нажимаем на одноимённую кнопку и выбираем пользователя kiosk.
Нажимаем Применить.
Появится предупреждающее окно Требуется перезагрузка, "нажимаем закрыть".
Окно Настройка графического входа закрываем.

Перевод пользователя в Режим графического kiosk

В терминале от суперпользователя вводим команду fly-admin-smc.
Во вкладке Пользователи выбираем пользователя kiosk.
В окне текущего пользователя переходим во вкладку Графический киоск fly, где нажимаем на Режим графического киоска (ограниченный набор приложений).
Нажимаем на раскрывающийся список Приложение на рабочем столе и выбираем Режим одного приложения.
В текущем окне нажимаем на +, будет запущен мастер Добавить приложение, в котором необходимо указать путь к программе /opt/space-client/start_vdi_client.sh.
Нажимаем на кнопку Да.
Мастер Добавить приложение будет закрыт и в окне Управление политикой безопасности — Настройки киоска пользователя:kiosk необходимо применить изменения, нажав на кнопку .

Запуск ТК Space Client в режиме киоска

После выполненных действий ОС Astra Linux CE будет загружаться в режиме Одного приложения от пользователя kiosk без пароля.

GM Smart System с Space Client ↵

Общая информация

GM Smart System — это решение Enterprise уровня для создания единого рабочего окружения конечных пользователей и обеспечения унифицированного безопасного доступа к виртуальной инфраструктуре, телефонной связи и видеоконференциям, а также централизованного управления пользовательским компьютерным оборудованием и сервисами.

SpaceVM и Space VDI имеют полную программную совместимость и обеспечивают корректную работу с линейкой продуктов GM Smart System.

Внимание!

Для получения доступа к указанным ниже документам и файлам необходимо иметь учетную запись на сайте lk.getmobit.ru (логин и пароль от личного кабинета следует запрашивать в отделе технической поддержки ООО «Гетмобит»)

Документация необходимая для работы с GM Smart System (наиболее актуальные версии документов доступны на вкладке "Документы" в личном кабинете пользователя Getmobit):

Руководство администратора;
Руководство пользователя;
Требования к инфраструктуре.

Программные продукты используемые в работе с GM Smart System (наиболее актуальные версии файлов доступны на вкладке "Файлы" в личном кабинете пользователя Getmobit):

Сервер управления (GM Server);
Система мониторинга (GM Server Monitoring);
Программное обеспечение GM-Box (GM-OS);
Приложение Space Client в формате SDApp.

Файл лицензии, необходимый для работы, следует скачать из личного кабинета пользователя Getmobit или получить у дистрибьютора продукции GM Smart System.

Подготовка окружения

Инфраструктура Space

Для начала использования системы на базе решения GM-Box из линейки продуктов GM Smart System необходимо подготовить следующее:

Развернуть и настроить облачную платформу SpaceVM согласно руководству.
Развернуть и настроить диспетчер подключений Space VDI – Space Disp согласно руководству.

Подготовка виртуальных машин (ВМ)

Используя подготовленную инфраструктуру Space создать ВМ для установки GM Server. Параметры ВМ должны соответствовать следующим рекомендованным аппаратным требованиям (актуальные данные доступны в документе "Требования к инфраструктуре"):
- Минимум 2 vCPU (ядра процессора)
- Минимум 16 GB RAM
- 100 GB HDD
На виртуальную машину, выполняющую роль сервера управления, следует установить операционную систему Ubuntu 16.04 LTS (64bit) либо иную Linux систему, имеющую менеджер deb-пакетов и обладающую поддержкой пакета docker версии не ниже 17.09.0.
Для вышеуказанной виртуальной машины необходим статический IP-адрес.
Аналогично первому пункту создать необходимое количество ВМ и установить на них операционные системы (ОС), которые планируется использовать в качестве гостевых. Подробнее о подготовке ВМ и установке некоторых ОС читайте в соответствующих разделах руководства, для Windows и для Linux.

Подготовка сети для работы с GM-Box

Для работы с устройствами GM-Box в сети рекомендуется развернуть или настроить сервер DHCP, предоставляющий подключаемым устройствам следующую информацию:

IP-адрес подключенного устройства;
название домена;
IP-адрес шлюза по умолчанию;
IP-адрес сервера имён (DNS);
IP-адрес сервера точного времени (NTP);
для автоматического поиска сервера управления GM Server необходимо указать локальный домен в DHCP option 119 — 'Domain Search List'.

Также крайне желательно обеспечить наличие A-записи в DNS, связывающей IP-адрес сервера управления GM Server с именем getmobit.example.site

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

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

Установка и запуск

Установка сервера управления GM Server

Установка сервера управления осуществляется согласно "Руководству администратора".

Внимание!

Для выполнения работ по инсталляции, обновлению, перезапуску Сервера управления, установки TLS/SSL сертификатов и настройки параметров операционной системы, необходим доступ к виртуальной машине по ssh (openssh, PUTTY и др. программы) с правами суперпользователя (root). Штатная эксплуатация Сервера управления осуществляется только с использованием веб-консоли Сервера управления.

Установите Docker CE согласно руководству
Установите пакет сервера управления пользователем с правами суперпользователя (root):
```
sudo dpkg -i gmserver_[VERSION]_amd64.deb
```
где [VERSION] — номер версии.

Внимание!

Все действия выполняются пользователем с правами суперпользователя (root). Для выполнения команд и настроек с правами суперпользователя (root) рекомендуется использовать команду sudo. Пароль для суперпользователя (root) должен формироваться, храниться и меняться в соответствии с парольными политиками, принятыми в организации.

Установка системы мониторинга GM Server Monitoring

Установка сервера управления осуществляется согласно "Руководству администратора".

Установите пакет сервиса мониторинга:
```
dpkg -i gmserver-monitoring_[VERSION]_amd64.deb
```
где [VERSION] — номер версии.
Отредактируйте файл /usr/local/etc/getmobit/docker/config.env следующим образом:
```
ELASTIC_HOST=getmobit.example.site
FLUENTD_HOST=getmobit.example.site
...
JWT_SECRET_KEY=<Произвольная строка>
```
Первые две строки необходимо добавить: они содержат DNS-имя сервера, на котором запущен сервис мониторинга. <Произвольная строка> — это набор символов длиной до 1024 элементов. Их следует задать самостоятельно. Чем длиннее строка, тем ключ надежнее.

Первичный запуск сервера

Запустите сервер управления GM Server выполнив следующую команду:

systemctl start gmserver

Загрузка может занимать до 5 минут. После запуска сервера необходимо выполнить его настройку руководствуясь пунктом Настройка сервера управления GM Server настоящего руководства.

Настройка сервера управления GM Server

Производится с помощью веб-интерфейса GM Server. Для перехода к последнему следует открыть с помощью браузера страницу, расположенную по IP-адресу виртуальной машины, на которую был установлен сервер управления, либо, при наличии A-записи в DNS, по адресу getmobit.example.site

В открывшейся форме следует ввести логин и пароль, значения по умолчанию:

Login: superadmin

Password: superadmin

Важно

В целях обеспечения безопасности и контроля доступа к серверу управления, после первого входа в веб-интерфейс следует изменить и запомнить пароли по умолчанию путем редактирования файла /usr/local/etc/getmobit/docker/config.env

Например, следующим образом:

LDAP_USER_LOGIN=admin
LDAP_USER_PASSWORD=mail123#
LDAP_SUPER_USER_LOGIN=superadmin
LDAP_SUPER_USER_PASSWORD=mail123#

Совет

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

Установка Discovery адреса для GM Server

В веб-интерфейсе GM Server, используя пункт меню Организации, с помощью двойного щелчка по полю Адрес, необходимо задать корректный Первичный discovery адрес, соответствующий DNS-имени сервера управления — http://getmobit.example.site

Внимание

Обязательно задавать полный URI-адрес с указанием http:// или https://

Обходной путь

Если нет возможности задать DNS-имя или сервер DNS временно неисправен, можно указать ip-адрес сервера управления, следующим образом — http://192.168.0.1

Установка лицензионного файла

Для использования сервера управления GM Server необходимо активировать лицензию. Она определяет набор разрешенных к использованию функций, а также количество GM-Box, подключаемых к серверу.

В веб-интерфейсе GM Server через меню Настройки – Лицензия следует загрузить имеющийся файл лицензии. Если всё в порядке, параметры примененной лицензии отобразятся на этой же странице.

Информация

Файл лицензии необходимо скачать из личного кабинета или получить у дистрибьютора.

Добавление пользователя

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

Создание нового пользователя производится из меню сервера управления GM Server Пользователи – Добавить.

В появившемся окне Пользователь необходимо заполнить следующую информацию:

Учетная запись : gm_user
Пароль : gm_pass
Роль : USER
Режим GM-Box : Space
VDI хост : IP-адрес Space Disp
VDI пользователь : space_user
VDI пароль : space_pass

Таким образом, пользователь GM-Box gm_user будет ассоциирован с пользователем Space VDI space_user, что позволит после входа в GM-Box миновать окно авторизации Space Client, так как учётные данные для последнего будут подставлены автоматически.

Рекомендация

При использовании учетной записи AD следует указать логин и пароль аналогично вышеуказанному, в полях VDI пользователь и VDI пароль. Так как именно эти данные будут переданы в окно входа приложения Space Client, и, для авторизации, останется отметить checkbox LDAP. При последующих входах авторизация будет происходить автоматически, так как состояние checkbox'a LDAP сохранится.

Рекомендации по настройке работы систем со службой каталогов AD находятся в разделе Использование для авторизации службы каталогов AD

Начало работы с устройством GM-Box

Информация

В зависимости от конкретной модели используемого устройства панель разъемов может иметь те или иные порты и коннекторы. Для присоединения внешних приборов и устройств необходимо следовать указаниям из раздела "Подключение устройства" из "Руководства пользователя".

Подключение устройства:

Присоедините к панели разъемов все необходимые устройства (клавиатуру, мышь, монитор(ы)).
Подключите GM-Box к сети, в зависимости от модели устройства и архитектуры сети это может быть проводная или беспроводная сеть.
Присоедините адаптер питания согласно руководству пользователя.

Обновление программного обеспечения GM-Box

Выполняется согласно указаниям из раздела "Настройка и управление GM-Box" из документа "Руководство администратора":

В веб-интерфейсе GM Server через Обновления – Добавить следует загрузить скачанный файл "Программное обеспечение GM-Box (GM-OS)" — mainline_[VERSION].swu.
Далее, используя Задания – Добавить, ввести:
- Название задания: обновление GM-Box
- Назначить на: выбрать подключенное устройство
- Однократно
- Команда: Device Update & Reboot
- ID обновления: mainline_[VERSION].swu
Нажать Сохранить и дождаться перезапуска устройства.

Установка программного обеспечения Space Client

В веб-интерфейсе GM Server через Приложения – Добавить следует загрузить скачанный файл "Приложение Space Client в формате SDApp (SD App Dacom Space)" — Dacom-Space_[VERSION].swu.
Далее используя Задания – Добавить ввести:
- название задания : установка Space Client
- Назначить на: выбрать подключенное устройство
- Однократно
- Команда : Install Application & Reboot
- ID обновления: Dacom-Space_[VERSION].swu
Нажать Сохранить и дождаться перезапуска устройства.

После включения GM-Box и загрузки системы на экране монитора появится окно для авторизации Вход в систему. Для входа следует использовать следующие данные:

Имя пользователя : gm_user

Пароль : gm_pass

В случае, если вход не происходит, следует проверить настройки согласно разделу "Подключение к сети" из "Руководства пользователя".

Если после успешного входа откроется окно авторизации Space Client следует проверить/ввести верные данные для учётной записи Space Disp и/или установить/снять отметку с checkbox LDAP.

После выполнения вышеуказанных действий откроется окно Space Client, предоставляющее выбор ВМ для подключения. Операции с данным окном выполняются согласно руководству с описанием "Окна доступных пулов ВМ".

Использование AD совместно с GM

Совет

В целях упрощения процессов, связанных с управлением учётными записями пользователей, рекомендуется использовать одну и ту же службу каталогов AD для синхронизации с Space Disp и с GM Server.

GM Smart System

Более подробно о настройке синхронизации данных с корпоративной службой каталогов можно прочесть в "Руководстве Администратора".

В веб-панели управления GM Server используя Настройки – Синхронизация с AD заполнить следующие поля:
- AD Сервер: IP-адрес сервера AD
- AD Порт: порт для подключения к серверу AD (по умолчанию 389)
- Логин: имя пользователя AD
- Пароль : пароль пользователя AD
После ввода данных нажать кнопку проверить.
Обновить страницу браузера и убедиться, что Статус изменился на Синхронизация запущена.

Space VDI

Настройка работы Space Disp со службой каталогов производится согласно указаниям.

Ended: GM Smart System с Space Client

Нулевые клиенты ↵

Нулевой клиент

Нулевой клиент VDI - это образ ОС на базе линукс с предустановленным ПО Space Client в режиме киоска, который предназначен для сетевой загрузки с помощью PXE на бездисковых компьютерах АРМ.

PXE - это среда загрузки компьютера с помощью сетевой карты и без использования локальных носителей данных. Получить образ live-space-connect можно по данной ссылке

Принцип сетевой загрузки

Сетевую загрузку можно разделить на 7 стадий, а именно:

Получение IP адреса в сети сетевой картой, а также получение адреса TFTP-сервера
Загрузка PXE загрузчика. На этом этапе происходит загрузка PXE загрузчика по протоколу TFTP.
Загрузка и запуск ядра ОС и начальной файловой системы. Начальная файловая система подгружается в ОЗУ. Она содержит необходимые утилиты, скрипты и драйвера для получения доступа к корневой файловой системе.
Получение IP адреса ядром ОС по протоколу DHCP.
Монтирование корневой файловой системы. Оно может происходить по протоколу NFS или путем предварительной выгрузки в ОЗУ по протоколам FTP и HTTP.
Запуск ОС

Таким образом для осуществления успешной сетевой загрузкой необходимо обеспечить сетевую связанность между Сервером сетевых загрузок и компьютеров АРМ, настроить DHCP сервер, TFTP сервер, загрузчик pxelinux, и сервер раздающий корневую файловую систему, например NFS.

Системные требования

Для успешного запуска ОС на базе Linux с предустановленным ПО Space Client необходимо, чтобы компьютер АРМ и иная инфраструктура обладала следующими характеристиками:

Компьютер АРМ

Центральный процессор с архитектурой х86-64
Объем оперативной памяти не менее 1Gb
Поддержка компьютером сетевой загрузки PXE
Сетевой интерфейс со скоростью не менее 100мб/с

совместимость проверена со следующими устройствами

Lenovo ThinkCenter M90n-1
HP t430 Thin Client
ТОНК TN2800

Требования к инфраструктуре

Настроеный DHCP
Сетевая связанность между TFTP сервером и компьютерами АРМ
TFTP сервер
Настроенный NFS, FTP и HTTP сервер

Настройка DHCP

Для получения компьютером АРМ адреса, к которому необходимо обращаться для загрузки PXE загрузчика и ядра ОС с стартовой файловой системой необходимо указать его в конфигурации DHCP сервера.

Пример конфигурации DHCP

Установите на сервер DHCP программу dhcpd, которая будет использоваться в качестве DHCP сервера.
Приведите файл конфигурации программы dhcpd /etc/dhcp/dhcpd.conf к следующему виду:

option domain-name-servers 8.8.8.8; #DNS сервера

server-name "space-pxe"

subnet 192.168.135.0 netmask 255.255.255.0 #Ваша сеть { next-server 192.168.135.1; #адрес tftp сервера filename "pxelinux.0"; #путь до файла начиная от директории настроенной в TFTP pxelinux.0 option root-path "/srv/public/netinst/current"; #Если nfs сервер находится на одном сервере с tftp. option domain-name "comp-core-processor-3688be"; default-lease-time 3600; max-lease-time 3600; range 192.168.135.100 192.168.135.200; #Диапазон ip адресов для раздачи }

Настройка TFTP

Для осуществления сетевой загрузки необходимо настроить TFTP на сервере, адрес которого указан в конфигурации DHCP.

Пример настройки TFTP

Установите TFTP-сервер и Xinetd на ваш сервер, выполнив следующую команду:
Для дистрибутивов, использующих менеджер пакетов apt
```
sudo apt-get install tftp-server xinetd
```
Для дистрибутивов, использующих менеджер пакетов yum
```
sudo yum tftp-server xinetd
```
Приведите файл конфигурации /etc/xinetd.d/tftp TFTP сервера к виду

service tftp { disable = no socket_type = dgram protocol = udp wait = yes user = root server = /usr/sbin/in.tftpd server_args = -u tftp -s /var/lib/tftpboot #путь до директории, где будет находится загрузчик pxelinux и его конфигурация, а также ядро и начальная файловая система. }

Настройка pxelinux

Пример настройки pxelinux

Примонтируйте образ Live-CD с установленным Space Client к системе командой:

mount live-veil-connect-<version>.iso /mnt/
Скопируйте файл загрузчика pxelinux в директорию, указанную в конфигурациях TFTP и DHCP (в данном примере '/var/lib/tftpboot/'), выполнив команду:

cp /mnt/syslinux/pxelinux.0 /var/lib/tftpboot/pxelinux.0
Скопируйте файл конфигурации загрузчика syslinux в директорию, указанную в конфигурации TFTP и DHCP, выполнив следующую команду:

mkdir /var/lib/tftpboot/pxelinux.cfg && cp /mnt/syslinux/isolinux.cfg /var/lib/tftpboot/pxelinux.cfg/default
Скопируйте директорию alt0, содержащую ядро ОС и начальную файловую систему, выполнив команду:

cp -r /mnt/syslinux/alt0 /var/lib/tftpboot/pxelinux.cfg/
Отмонтировать образ командой:

umount /mnt/
Привести файл конфигурации загрузчика pxelinux '/var/lib/tftpboot/pxelinux.cfg/default' к виду:

default live timeout 100 totaltimeout 100 label live menu label ^LiveCD (no hard disk needed) kernel alt0/vmlinuz append initrd=alt0/full.cz fastboot live changedisk stagename=live ramdisk_size=490013 showopts lowmem vga=normal quiet CONFIG_FILE=http://192.168.135.1/veil_client_settings.ini automatic=method:nfs,network:dhcp tz=Europe/Moscow lang=ru_RU

где kernel - путь до ядра ОС относительно пути, указанного в конфигурациях TFTP и DHCP,

initrd - путь к начальной файловой системе относительно пути, указанного в конфигурации TFTP и DHCP,

automatic=method:nfs,network:dhcp - способ загрузки корневой файловой системы, если NFS и TFTP сервер находятся на одном сервере. Если NFS и TFTP находятся на разных серверах следует использовать

automatic=method:nfs,network:dhcp,server:192.168.135.1,directory:/srv/public/netinst/1.img

CONFIG_FILE=http://192.168.135.1/veil_client_settings.ini - путь до файла конфигурации veil-connect. Его можно разместить в сети, используя любой удобный способ, например, веб-сервер apache.

Файл конфигурации можно взять из настроенной системы, он располагается по адресу ~/.config/SpaceClient/client_settings.ini.

Возможные варианты публикации основной файловой системы

automatic=method:nfs,network:dhcp,server:192.168.135.1,directory:/srv/public/netinst/1.img automatic=method:ftp,network:dhcp,server:mashtab.org,directory:/srv/public/netinst/ automatic=method:ftp,network:dhcp,server:companyserver,directory:/altlinux,user:XXX,pass:XXX automatic=method:ftp,interface:eth1,network:dhcp,... automatic=method:http,network:dhcp,server:192.0.2.2,directory:/netinst/

Настройка NFS

Установить программу nfs-utils командой:
Для дистрибутивов использующих менеджер пакетов apt
```
sudo apt-get install nfs-utils
```
Для дистрибутивов использующих менеджер пакетов yum
```
sudo yum install nfs-utils
```
Добавить в файл конфигурации программы nfs-utils '/etc/exports' следующую строку, содержащую путь к публикуемой директории, содержащий образ ISO.

/srv/public -ro,insecure,no_subtree_check,fsid=1 *
Перенести образ ISO в директорию, указанною в конфигурации NFS командой:

mv /patch-to-iso/live-veil-connect-<version>.iso /srv/public/

Ended: Нулевые клиенты

Ended: Тонкие клиенты

Cписок изменений ↵

Основные изменения Space Client 2.0.х

Совместим с:

- SpaceVM 6.0 и выше
- Space Disp 5.0 и выше

Space Client 2.0.0

Обновлены библиотеки зависимости для Windows клиента.
Реализован бесшовный(seamless) запуск приложений для Linux клиента.

Space Client 2.0.1

Возможность "сохранения в памяти" проброшенных USB устройств.
Буфер обмена файлов для RDP (с клиента на ВМ).

Space Client 2.0.2

Исправлена ошибка: отрисовка окна ТК после завершения процесса Loudplay.
При закрытии окна управления Loudplay, либо при нажатии кнопки "Остановить", процесс Loudplay гарантировано завершен.
При завершении подключения по протоколу RDP не отображается окно с кодом завершения, если отключение было выполнено пользователем целенаправленно.

Space Client 2.0.3

Исправлено падение (crash) тонкого клиента при подключении по протоколу RDP.

Space Client 2.0.4

Перевод GUI.
Задан правильный путь для Loudplay с правами на запись.
Добавлена иконка Windows.

Space Client 2.0.5

В релиз для Windows добавлены корректные плагины для работы звука (Spice).

Space Client 2.0.6

Исправлены случайные разрывы соединения при подключении GLINT.

Space Client 2.0.7

GLINT Server принимает для подключения только GLINT Client.
GLINT Client подключается только к GLINT Server.

Space Client 2.0.8

Исправлены ошибки RDP соединений.
Совместимость с сервером VDI.

Space Client 2.0.9

Исправлены ошибки со стороны графического интерфейса (RDP).
Добавлена кнопка Выйти из полноэкранного режима на всех окна (RDP).
Добавлена кнопка Свернуть все окна (RDP).
Исправлена ошибка сохранения настроек ограничения битрейта и частоты кадров (GLINT).

Space Client 2.0.10

Исправлен выбор автопроброса сохраненных USB.

Space Client 2.0.11

Обновлены пути для Loudplay клиента.

Space Client 2.0.12

Реализована синхронизация протоколов подключения и настройки в зависимости от ОС.

Space Client 2.0.13

Реализован выбор кодека сжатия AVC420 для протокола подключения GLINT.

Space Client 2.0.14

Обновлены настройки дополнительных параметров для Loudplay.

Space Client 2.0.15

Исправлена ошибка при отключении RDP с проброшенным USB-устройством.
Исправлена ошибка сквозной kepberos авторизации (SSO).

Space Client 2.0.16

Исправлена ошибка работы "мыши" при подключении по GM-BOX.
Исправлена ошибка исчезающей верхней панели меню при подключении по RDP.

Space Client 2.0.17

Улучшен механизм передачи движения(прокрутки) колеса "мыши" при подключении по RDP.
Добавлены дополнительные 32-битные форматы изображений для протоколов подключения RDP и GLINT.

Space Client 2.0.18

Исключена возможность сохранения пароля со стороны пользователя.

Space Client 2.0.19

Исправлена проблема с динамическим разрешением при подключении по RDP для сборки на Ubuntu 16.
Решены мелкие проблемы GUI для сборки на Ubuntu 16.
Исправлена проблема с некорректным отображением процента потерь при подключении.
Нажатие F11 переводит окно подключения к ВМ в полный экран.
Изменен путь записи логов на /home/SpaceClient для Linux.

Space Client 2.0.20

Возможность выбрать протокол http/https на GUI.

Основные изменения Space Client 2.1.х

Совместим с:

- SpaceVM 6.0 и выше
- Space Disp 5.0 и выше

Space Client 2.1.0

Адаптация клиента для использования физического пула.

Space Client 2.1.1

Реализована возможность отправлять на RDP сервер полное доменное имя.

Space Client 2.1.2

Возможность запретить проброс USB устройств согласно фильтру.

Space Client 2.1.3

Исправлена ошибка связанная с параметрами протокола Loudplay.

Основные изменения Space Client 2.2.х

Совместим с:

- SpaceVM 6.2
- Space Disp 5.0 и выше

Space Client 2.2.0

Реализована возможность задавать разрешение картинки для протокола Glint.
Отслеживание активности пользователей при подключении по протоколу Windows Native RDP.
Добавлены подсказки с возможными способами решения проблемы при возникновении ошибок подключения по протоколу RDP.
Исправлена ошибка возникающая при разрыве соединения по протоколу RDP при выборе USB.
Исправлена ошибка подключения по протоколу Loudplay.
Исправлен вывод текстовых сообщения.

Space Client 2.2.1

Исправлена ошибка постоянной проверки ТК доступности диспетчера подключений.
Оптимизирован графический интерфейс.

Space Client 2.2.2

Исправлена ошибка при подключении по протоколу RDP копирования файлов на удаленную машину.
Реализован функционал drag and drop для протокола Spice.
Улучшена работа GUI.

Ended: Cписок изменений

Приложение ↵

Loudplay

Loudplay - протокол удаленного доступа на основе RDP.

Совместимость

Space Client поддерживает удаленное подключение к ВРС по протоколу Loudplay при установке на следующие операционные системы:

Astra Linux Special Edition 1.7;
Ubuntu 20;
Windows 7;
Windows 8;
Windows 10.

Space Client обеспечивает удаленное подключение к ВРС со следующими ОС по протоколу Loudplay:

Windows 7;
Windows 8;
Windows 10;
Windows 11.

Настройка

Информация о настройке доступна по ссылке.

Лицензирование

В разделе лицензирования указано доступное количество подключений по протоколу Loudplay. При достижении лимита будет отправлено сообщение об ошибке.

Конфигурационные файлы приложения ↵

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

Текущая конфигурация Space Client для пользователя хранится в файле настроек. Если файл настроек отсутствует, он будет автоматически создан при первом запуске Space Client и будет содержать в себе стандартные настройки. Изменять конфигурацию можно в приложении Space Client или путем редактирования файла настроек с последующим перезапуском приложения Space Client для применения новых настроек.

В данном разделе описаны параметры и их значения в конфигурационном файле Space Client.

В операционных системах семейства Linux конфигурационные файлы находятся по адресу:

/home/{текущий пользователь}/.config/SpaceClient

В операционных системах семейства Windows конфигурационные файлы находятся по адресу:

C:\Users\{текущий пользователь}\AppData\Local\SpaceClient

Файлы настроек:

client_settings.ini. Файл настроек приложения в стандартном ini формате.
rdp_data/rdp_file.rdp. Файл настроек RDP. Автоматически создается в момент подключения по протоколу Native RDP для использования нативным клиентом. (ОС Windows и MacOS).

Настройка Space Client в окне программы

Подробная информация о настройке приложения Space Client в окне программы содержится в разделе Настройки.

Описание логирования

Примечание

На Linux логи пишутся по пути /home/{текущий пользователь}/SpaceClient/log (с версии 2.0.19 и выше) и по пути /opt/thin-client/log (до версии 2.0.18 включительно). На Windows - в папку C:\Users{текущий пользователь}\AppData\Local\SpaceClient\log.

Структура логов

При каждом запуске приложения создается папка с именем - датой старта по шаблону:

{год}_{месяц}_{день}___{час}_{минута}_{секунда}

Данная папка может содержать файлы stdout.txt, stderr.txt, clipboard.txt, backtrace.txt. На Windows также возможно создание минидампа при аварийном завершении приложения.

В stdout.txt пишется stdout-вывод.

В stderr.txt пишется stderr-вывод.

В clipboard.txt логируется буфер обмена между клиентом и удаленной машиной. Файл присутствует, если осуществлялись операции с буфером обмена.

Файл backtrace.txt будет создан, если произошло аварийное завершение приложения.

Группа настроек General

В таблице представлены описания основных настроек и их возможные значения.

Параметр	Описание	Возможные значения
cur_remote_protocol_index	Протокол подключения, который будет использоваться при подключении к сохраненному пулу	Число. 0 - SPICE, 1 - SPICE_DIRECT, 2 - RDP, 3 - RDP_NATIVE.
log_output_to_file	Писать ли вывод процесса в лог-файлы	1/0
to_save_pswd	Сохранять ли пароль в ini файл	1/0

Примечание

Чтобы не создавался файл с логами, а выход процесса шел в stdout/stderr, General/log_output_to_file должен иметь значение 0.

Группа настроек RemoteViewerConnect

В таблице представлены описания секции настроек RemoteViewerConnect и их возможные значения.

Параметр	Описание	Возможные значения
ip	Адрес подключения	строка
username	Логин	строка
password	Пароль	строка
port	Порт	Число 1-65535
domain	Доменное имя. Может быть пустым	строка
is_ldap	Используется ли LDAP	1/0
connect_to_pool	Подключаться ли к выбранному пулу (pool_id) при старте приложения	1/0
pool_id	id пула в VDI диспетчере, к которому будет производиться подключение, если connect_to_pool равен 1	id пула типа 2affd5d-eaf2-4c7e-9b19-887cb9a0a862
to_save_pswd	Сохранять ли пароль в ini файл	1/0

Примечание

Для автоподключения к определенному пулу при старте приложения RemoteViewerConnect/connect_to_pool должен быть равен 1,

в RemoteViewerConnect/pool_id должен быть указан id пула, в General/cur_remote_protocol_index должен быть указан протокол подключения.

Группа настроек SpiceSettings

В таблице представлены описания настроек Spice и их возможные значения.

Параметр	Описание	Возможные значения
is_spice_client_cursor_visible	Отображать ли клиентский курсор	1/0
full_screen	Активен ли режим полного экрана. Требуется перезапуск приложения	1/0
monitor-mapping	Список пар отображений гостевых дисплеев на клиентские мониторы. Требуется перезапуск приложения	Список пар id гостевого дисплея:id клиентского монитора. Пример 0:1;1:2
show_usb_filter	Фильтр, определяющий какие USB устройства будут показана на ГУИ для выбора пользователем	Текстовый фильтр

Примечание

Конфигурация мониторов для Spice определяется параметром SpiceSettings/monitor-mapping. Это список пар отображений гостевых дисплеев на клиентские мониторы. Например, чтобы отобразить гостевые дисплеи 0 и 1 на клиентские мониторы 1 и 2, используйте 0:1;1:2. Список должен содержать id всех дисплеев от 0 до последнего желаемого, т. е. 2:2 это невалидный параметр, так как отсутствуют отображения для дисплеев 0 и 1. Данный параметр имеет эффект только в режиме ПОЛНОГО ЭКРАНА.
Требуется ПЕРЕЗАПУСК приложения, чтобы применить изменения.

Группа настроек RDPSettings

В таблице представлены описания настроек RDP и их возможные значения.

Параметр	Описание	Возможные значения
rdp_fps	Частота обновления картинки (Перерисовки экрана)	Число 1-60
is_rdp_vid_comp_used	Использовать ли сжатие видеопотока	1/0
rdp_vid_comp_codec	Используемый кодек. Учитывается только если is_rdp_vid_comp_used равно 1	AVC420/AVC444/RemoteFX
rdp_shared_folders	Перенаправляемые папки. Пути, перечисленные через точку с запятой без пробелов	строка
is_multimon	Мультимониторность	1/0
full_screen	Активен ли режим полного экрана	1/0
selectedmonitors	Указать, какие клиентские мониторы должны использоваться для отображения удаленного рабочего стола. Мониторы должны иметь обшие стороны.	Параметр задается как список id мониторов через запятую. Пример 0,1
redirect_printers	Перенаправлять ли принтеры	1/0
is_rdp_network_assigned	Указывать ли тип сети	1/0
rdp_network_type	Тип сети. Учитывается только если is_rdp_network_assigned равно 1	modem/broadband/broadband-low/broadband-high/wan/lan/auto
disable_rdp_decorations	Выключить ли оформления окон	1/0
disable_rdp_fonts	Выключить ли гладкие шрифты	1/0
disable_rdp_themes	Выключить ли Windows темы	1/0
rdp_pixel_format	Формат изображения	BGRA16/BGRA32
rdp_args	Список параметров freerdp	Список параметров freerdp через запятую
spice_show_usb_filter	Фильтр, определяющий какие USB устройства будут показана на ГУИ для выбора пользователем	Текстовый фильтр

Примечание

Конфигурация мониторов для RDP определяется параметром RDPSettings/selectedmonitors.

Указывает, какие клиентские мониторы должны использоваться для отображения удаленного рабочего стола. Мониторы должны иметь обшие стороны. Параметр задается как список id мониторов через запятую. Например: 0,1 - использовать мониторы с id 0 и 1. - Для сквозной передачи параметров FreeRDP используется параметр RDPSettings/rdp_args.

Пример файла настроек Space Client

Ниже представлен пример файла настроек приложения Space Client.

[General] cur_remote_protocol_index=0 log_output_to_file=0

[RemoteViewerConnect] ip=192.168.11.145 port=443 username=user2 password=12345678 is_ldap=0 domain= connect_to_pool=1 pool_id=2affd5d-eaf2-4c7e-9b19-887cb9a0a862

[SpiceSettings] is_spice_client_cursor_visible=0 full_screen=1 monitor-mapping=0:1;1:2

[RDPSettings] rdp_pixel_format=BGRA16 rdp_fps=30 is_rdp_vid_comp_used=1 rdp_shared_folders= is_multimon=0 full_screen=1 selectedmonitors=0 redirect_printers=1 is_remote_app=0 remote_app_program= remote_app_options= is_sec_protocol_assigned=0 sec_protocol_type=nla is_rdp_network_assigned=0 rdp_network_type=auto disable_rdp_decorations=0 disable_rdp_fonts=0 disable_rdp_themes=0 allow_desktop_composition=0 usb_devices= use_rdp_file=0 rdp_settings_file= rdp_args=+menu-anims,+home-drive

Ended: Конфигурационные файлы приложения

Ended: Приложение

FAQ ↵

Протоколы удаленного рабочего стола

Spice

Протокол предназначен для отображения и контроля рабочего стола удаленной машины в рамках виртуальной среды. При подключении Space Client к виртуальной машине диспетчера VDI запрашивает у соответствующего контроллера порт для подключения к ВМ. Затем Space Client подключается к ВМ по адресу контроллера и полученному порту. В случае Spice Direct диспетчер VDI запрашивает у контроллера адрес сервера, на котором находится ВМ, после чего Space Client подключается напрямую к данному серверу, минуя контроллер. Подробности о Spice.

Перенос файлов между ВМ и клиентской системой (Spice)

Для подключения по протоколу Spice реализован общий буфер обмена между клиентской машиной и ВМ.

Текст и файлы копируются путем copy paste.

Передача файлов возможна только с клиентской машины на ВМ.

RDP

Проприетарный протокол прикладного уровня, использующийся для обеспечения удалённой работы пользователя с сервером на основе операционных систем Microsoft Windows, на котором запущен сервис терминальных подключений. По умолчанию используется порт TCP 3389. В Space Client при выборе протокола RDP и подключении к пулу диспетчера VDI запрашивает у контроллера адрес ВМ и передает его тонкому клиенту, который в свою очередь подключается к ВМ. В случае выборы Native RDP для подключения будет использовано стороннее приложение - встроенный Windows клиент RDP (mstsc). Подробности о RDP.

Перенос файлов между ВМ и клиентской системой (RDP)

Для подключения по протоколу RDP реализован общий буфер обмена между клиентской машиной и ВМ для обмена текстом.

Файлы копируются путем drag and drop.

Передача файлов возможна только с клиентской машины на ВМ.

Информация, необходимая для исправления ошибки

В случае обнаружения ошибки при подключении с помощью Space Client передайте разработчикам следующую информацию:

Описание проблемы и условий, при которых она наблюдается.
Тип и версия операционной системы, где запущен Space Client.
Тип и версия операционной системы, установленной на удаленной машине.
Тип подключения к удаленной машине (Spice, RDP,..).
Тип пула, к которому производится подключение.
Логи Space Client. Логи пишутся на Linux по пути /home/{текущий пользователь}/SpaceClient/log (с версии 2.0.19 и выше), на Windows - C:\Users{текущий пользователь}\AppData\Local\SpaceClient\log.
При обнаружении проблемы при подключении по RDP:
- в Space Client зайдите в Настройки -> RDP;
- активизируйте пункт Логировать отладочную информацию;
- перезапустите приложение;
- воспроизведите ошибку.
Файл настроек Space Client. Файл находится на Linux по пути /home/{текущий пользователь}/.config/SpaceClient/client_settings.ini. На Windows - C:\Users{текущий пользователь}\AppData\Local\SpaceClient\client_settings.ini. Предварительно удалить из файла свой пароль, если он сохранен (поле password).
Информация о сетевое соединение (интернет/локальная сеть, качество связи, наличие прокси-серверов и др.)

Возможные ошибки

Ошибка авторизации

RDP

Решение:

Проверьте, доступен ли (пингуется) IP-адрес диспетчера.
Зайдите в Web-интерфейс диспетчера и проверьте, существует ли указанный пользователь, активирован ли он и корректен ли вводимый пароль.
Если используется внешняя служба авторизации, проверьте, присутствует ли соответствующая учетная запись в домене Active Directory

В пуле нет свободных машин

Решение:

Если пул динамический, то в Web-интерфейсе диспетчера увеличьте максимальный размер пула. При следующем подключении тонкого клиента пул начнет расширение. Либо запустите расширение вручную, нажав на кнопку Расширить пул.
Если пул статический, то добавьте в него ВМ из существующих на SpaceVM.

Превышен лимит тонких клиентов

Решение:

Проверьте наличие лицензии. Зайдите в Web-интерфейс во вкладку Настройки -> Лицензирование.
Проверьте количество подключенных тонких клиентов. Их не должно быть больше, чем максимум, указанный в лицензии.

Не удалось получить ВМ из пула

Данное сообщение указывает на проблемы, связанные с ВМ либо со SpaceVM.

Решение:

Проверьте статус SpaceVM.
Проверьте статус ВМ в Web-интерфейсе SpaceVM. При обнаружении проблем действуйте в соответствии с документацией SpaceVM.

Space Client аварийно закрывается при попытке пробросить USB-устройство (Windows)

Решение:

Зайдите в Установка и удаление программ, удалите UsbDk Runtime Libraries, удалите Space Client и установите его заново. При установке поставьте "галку" установить UsbDk.

Ошибка при установке на ubuntu/astralinux: server certificate verification failed. CAfile: /etc/ssl/certs/ca-certificates.crt CRTfile: none

Решение:

Способ 1

Выполнить:

sudo sed -i '/mozilla\/DST_Root_CA_X3.crt/s/^/#/' /etc/ca-certificates.conf

sudo update-ca-certificates --fresh

Способ 2

Поставить пакет с игнорированием SSL, выполнив:

sudo apt-get update -o Acquire::https::update.spacevm.ru::Verify-Peer=false

sudo apt-get -o Acquire::https::update.spacevm.ru::Verify-Peer=false install space-client

Ошибка при установке Space Client

Пример проблемы:

Err:6 https://update.spacevm.ru/space-client/linux/loudplay jammy Release
404 Not Found [IP: 91.142.92.218 443]
E: The repository 'https://update.spacevm.ru/space-client/linux/loudplay jammy Release' does not have a Release file.

Решение:

rm -rf /etc/apt/sources.list.d/*
sudo apt purge space-client -y
sudo rm -rf /opt/thin-client

Выполнить установку заново (с использованием скрипта space-client-linux-installer.sh).

Возможные ошибки при подключении по RDP

Виртуальная машина не поддерживает RDP. Контроллер не передал адрес ВМ

Данное сообщение может быть следствием проблем с гостевым агентом ВМ.

Решение:

Убедитесь, что на ВМ активен гостевой агент (Web-интерфейс SpaceVM -> Виртуальные машины -> Имя текущей машины -> Информация -> Статусы служб агента).
Перезагрузите ВМ. При штатной работе агент должен начать работу в течение минуты после старта ВМ.

Ошибка ERRCONNECT_LOGON_FAILURE

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

Решение:

При использовании локальных учетных записей убедитесь, что учетная запись пользователя на Space Disp (VDI диспетчере) совпадает с учетной записью на ВМ (логин/пароль).
Если используется учетная запись AD, убедитесь, что ВМ в том же домене.
Убедитесь, что пользователю, либо его группе открыт удаленный доступ на подключение к ВМ.

Ошибка ERRCONNECT_AUTHENTICATION_FAILED

Решение:

Попробуйте выбрать TLS в качестве протокола безопасности (Настройки -> RDP -> Указать протокол безопасности).

Ошибка ERRCONNECT_CONNECT_TRANSPORT_FAILED

Данное сообщение может говорить о том, что ВМ выключена или недоступна в сети. При штатной работе Space Disp (VDI диспетчера) ВМ включается перед выдачей тонкому клиенту.

Решение:

Подождите 30 секунд и подключитесь повторно.
В Web-интерфейсе Space Disp во вкладке Пулы -> Виртуальные машины выберите соответствующую ВМ и нажмите на кнопку Запуск.
Убедитесь, что ВМ доступна в сети.
Убедитесь, что пользователю либо его группе открыт удаленный доступ на подключение к ВМ.

Ошибка ERRINFO_DISCONNECTED_BY_OTHER_CONNECTION

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

Ошибка ERRCONNECT_SECURITY_NEGO_CONNECT_FAILED

Данное сообщение говорит о проблеме, связанной с протоколом безопасности.

Решение:

В Настройки -> RDP активизируйте пункт Указать протокол безопасности и выберите NLA. Нажмите Сохранить.
Установите последние обновления Windows на удаленной машине.
В качестве крайней меры отключите требование NLA (Network Level Authentication) на удаленной машине. Для этого в cвойствах системы, на вкладке Удалённый доступ снимите "галку" Разрешить подключения только с компьютеров, на которых работает удалённый рабочий стол с проверкой подлинности на уровне сети.

Example

Ошибка удаленного приложения (Remote application error)

Example

Данная ошибка возникает, если формат запуска приложения не был принят сервером.

Решение:

В настройках Space Client перейдите на вкладку RDP и смените формат запуска приложения (RDS).

Изображение имеет многочисленные артефакты и искажения

Причинной данной проблемы может быть некорректная работа декодера h264 в текущей системе.

Решение:

Откройте Настройки -> RDP. Попробуйте сменить кодек (AVC420, AVC444). Если это не помогло, то деактивируйте пункт h264.

Не удалось добавить TCP USB-устройство к виртуальной машине

!!! example

Данное сообщение будет показано в случае, если SpaceVM не смог добавить TCP USB-устройство текущей ВМ.

Решение:

Убедитесь, что машина, где запущен Space Client, доступна (пингуется) с узла, где находится ВМ.
Убедитесь, что на машине, где запущен Space Client, открыты на прием TCP-соединений порты 17777-17782.

См. Настройки для возможности перенаправления USB (Spice и RDP).

Не удалось открыть USB-устройство. Нет прав? Попробуйте chmod 666 /dev/bus/usb/0xx/0xx

Данное сообщение будет показано при перенаправлении USB, если у Space Client нет прав на открытие USB.

Решение:

Выполните в терминале команду: sudo chmod 666 /dev/bus/usb/0xx/0xx

При использовании TESLA/распределения потоков GRID не удается подключиться к ВМ по RDP (Space Client запущен на ОС Windows)

Решение:

Попробуйте переустановить Space Client, выбрав в установщике сборку FreeRDP на основе OpenH264.

Возможные ошибки при подключении по Spice

Ошибка The connected VM is not configured for USB redirection

Решение:

В Web-интерфейсе SpaceVM соответствующей ВМ необходимо добавить USB Spice канал и USB контроллер nec-xhci (USB3.0) См. Настройки для возможности перенаправления USB (Spice и RDP).