> For the complete documentation index, see [llms.txt](https://kb.pvhostvm.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/transports/loudplay/vgpu.md).

# Использование vGPU

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

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

**Платформа виртуализации:**

1. Хост с установленной видеокартой, поддерживающей vGPU;
2. Установленный драйвер с поддержкой vGPU:\
   \* - Для HOSTVM Node версии 4.4 – NVIDIA-GRID-RHEL-8.5-510.47.03-511.65\
   \* - Для HOSTVM Node версии 4.5 – NVIDIA-GRID-RHEL-8.9-535.154.02-535.154.05-538.15
3. Развернутый сервер FastAPI-DLS

**Виртуальное рабочее место (далее - ВМ):**

1. Установленный сервер Loudplay версии 0.17 (имя дистрибутива: Loudplay\_server\_0.17.0).

**Рабочее место пользователя (далее - Клиент):**

1. Установленный клиент HOSTVM VDI с поддержкой Loudplay (скачивается из раздела "Клиент UDS" в веб-интерфейсе брокера);
2. Установленный клиент LoudPlay-streaming-1.14.0-Windows-x64 (настройка данного клиента описана в [статье по настройке транспорта Loudplay](/hostvm-vdi/hostvm-vdi-admin-guide/transports/loudplay.md)).

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

## Настройка ВМ

1\. Прикрепите к виртуальной машине профиль vGPU графического ускорителя, для этого нужно выключить ВМ (либо выключить и включить ВМ после применения изменений) и перейти в меню параметров ВМ на вкладку Host Devices -> Manage vGPU), в открывшемся окне выбрать необходимый профиль.

2\. Установите драйвер видеокарты.

3\. Получите токен клиента с сервера FastAPI-DLS.

### Получение токенов

#### Linux

Скачайте client-token и поместить по следующему пути */etc/nvidia/ClientConfigToken*:

```
curl --insecure -L -X GET https://<dls-hostname-or-ip>/-/client-token -o /etc/nvidia/ClientConfigToken/client_configuration_token_$(date '+%d-%m-%Y-%H-%M-%S').tok
# или
wget --no-check-certificate -O /etc/nvidia/ClientConfigToken/client_configuration_token_$(date '+%d-%m-%Y-%H-%M-%S').tok https://<dls-hostname-or-ip>/-/client-token
```

Перезапустите службу nvidia-gridd:

```
service nvidia-gridd restart
```

Проверьте статус лицензии:

```
nvidia-smi -q | grep "License"
```

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

```
vGPU Software Licensed Product
    License Status                    : Licensed (Expiry: YYYY-M-DD hh:mm:ss GMT)
```

#### Windows

Запустите Powershell от имени администратора

Скачайте client-token и поместите его по пути *C:\Program Files\NVIDIA Corporation\vGPU Licensing\ClientConfigToken:*

```
curl.exe --insecure -L -X GET https://<dls-hostname-or-ip>/-/client-token -o "C:\Program Files\NVIDIA Corporation\vGPU Licensing\ClientConfigToken\client_configuration_token_$($(Get-Date).tostring('dd-MM-yy-hh-mm-ss')).tok"
```

Перезапустите сервис *NvContainerLocalSystem:*

```
Restart-Service NVDisplay.ContainerLocalSystem
```

Проверьте статус лицензии:

```
& 'nvidia-smi' -q  | Select-String "License"
```

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

```
vGPU Software Licensed Product
    License Status                    : Licensed (Expiry: YYYY-M-DD hh:mm:ss GMT)
```

## Подключение к сервису брокера

С машины-Клиента выполните подключение к развернутому сервис-пулу ВМ (при подключении пользователю будет доступно меню Loudplay в верхнем правом углу экрана):

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/loudplay.png" alt=""><figcaption></figcaption></figure>

## Примечание

### Аппаратное ускорение

При включенном в настройках транспорта Loudplay параметре 'Аппаратное ускорение' используются ресурсы графического ускорителя машины-Клиента. При такой конфигурации профиль vGPU должен быть откреплён от ВМ для корректной работы транспорта.

{% hint style="info" %}
**Предупреждение:** сессия с включенным аппаратным ускорением не поддерживает работу с приложениями, требующими наличие графического ускорителя на стороне ВМ.
{% endhint %}

### Консоль ВМ

При использовании административной консоли гипервизора на портале платформы виртуализации для подключения к ВМ с прикреплённым профилем графического ускорителя рекомендуется использовать протокол VNC. При использовании протокола SPICE для подключения консоли ВМ с активированным профилем vGPU и установленным драйвером NVIDIA возможны проблемы с отображением курсора указателя.

### Полезные ссылки

1\. [Список](https://docs.nvidia.com/vgpu/index.html) версий ПО NVIDIA;

2\. [Перечень](https://docs.nvidia.com/vgpu/latest/grid-vgpu-release-notes-red-hat-el-kvm/index.html#hypervisor-software-versions) поддерживаемых систем для версии драйвера;

3\. [Инструкция](https://docs.nvidia.com/vgpu/14.0/grid-vgpu-user-guide/index.html#install-update-vgpu-red-hat-el-kvm) по установке пакета Virtual GPU Manager;

4\. [Инструкция](https://docs.nvidia.com/vgpu/14.0/grid-vgpu-user-guide/index.html#installing-grid-vgpu-display-drivers) по установке драйвера vGPU в клиентскую машину;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/transports/loudplay/vgpu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.