PT Sandbox Getting Started

Установка

Введение

Театр начинается с вешалки, а работа с продуктом — с его установки. В этой статье вы найдете всю необходимую информацию, чтобы установить PT Sandbox в базовой конфигурации и провести его первичную настройку.

Подготовка

Перед установкой продукта необходимо подготовить виртуальную машину или аппаратную платформу с необходимым количеством выделенных ресурсов. Мы будем использовать виртуальную машину на 16 vCPU, 34 ГБ ОЗУ, 320 ГБ ПЗУ. Эти ресурсы соответствуют требованиям к основному узлу с функцией поведенческого анализа с 2 ВМ на борту. Для расчета аппаратных требований для узла с бОльшим количеством ВМ можно воспользоваться формулами:

  • Количество потоков: Nproc=NVM*3+9 [Шт.]
  • Объем оперативной памяти: VRAM=(NVM*6+19)*1,074 [ГБ].
При использовании PT Sandbox в продуктивной среде не рекомендуется разворачивать узлы с функцией поведенческого анализа в виртуальной среде из-за возникновения вложенной виртуализации. Это может привести к значительному снижению производительности узла.
В качестве ОС поддерживаются Astra Linux SE 1.7, 1.8 (Орел), Debian 11, 12, «ОСнова» 2.11 (Onyx). Мы на нашем стенде будем использовать Debian 12.
Также при использовании ВМ не забываем в настройках процессора включить аппаратную виртуализацию. Соответственно, при использовании аппаратной платформы процессор должен поддерживать подобную технологию (возможно, ее нужно будет включить в BIOS/UEFI).
Сетевой интерфейс нам понадобится всего один. Важно убедиться, что у машины будет доступ в сеть Интернет (как минимум до репозиториев ОС и сервера обновлений PT — update.ptsecurity.com).
Теперь мы готовы приступать к установке.

Установка ОС

Установка ОС довольно стандартная, поэтому мы не будем слишком детально ее рассматривать, а остановимся лишь на отдельных моментах, специфических для PT Sandbox.

Итак, после запуска инсталлятора будут этапы выбора языка установки, местоположения, локали, клавиатуры — выбирайте то, что вам удобно. После идет шаг настройки сети: установщик попытается автоматически сконфигурировать интерфейс по протоколу DHCP. Если в вашей сети DHCP не используется, то автоконфигурация закончится с ошибкой и придется выставить все настройки вручную. Затем указываем имя хоста, домен (можно оставить это поле пустым), пароль для пользователя root. Задаем нового пользователя и пароль для него, выбираем часовой пояс.

И тут мы добираемся до первого этапа, который отличается от стандартной процедуры установки ОС — разбиение диска на разделы. Нам нужно разбить диск согласно программным требованиям к PT Sandbox. Так как мы разворачиваем продукт в тестовой среде, будем опираться на минимальные требования, но в «боевой» инсталляции ориентируйтесь на рекомендованные требования (или обратитесь за помощью в профильные организации).
Требования к разметке дискового пространства

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

После этого необходимо создать загрузочный раздел UEFI. Для этого выбираем нераспределенный участок памяти (сейчас это вся память на диске), создаем на нем новый раздел объемом 512 МБ и помещаем его в начало выбранной свободной области. Выбираем вариант «Use as EFI System Partition» и сохраняем изменения. Новый раздел создан.
Выбираем участок нераспределенной памяти для создания в ней нового раздела
Выбираем действие «Создать новый раздел»
Указываем размер раздела
Выбираем расположение раздела: в начале или в конце участка с нераспределенной памятью
Переходим в параметр «Использовать как»
Выбираем “EFI System Partition”
Завершаем создание раздела
Так выглядит диск после создания первого раздела

Далее создаем оставшиеся разделы по такому же алгоритму. Файловую систему (поле «Use as») везде выбираем ext4. Размеры разделов и точки монтирования приведены на скриншоте ниже.
Так должен выглядеть диск после создания всех разделов

При попытке сохранить изменения появится предупреждение о том, что не был создан раздел подкачки и предложит вернуться и создать его. Но отсутствие разделов и файлов подкачки — это программное требование PT Sandbox, поэтому мы вежливо отказываемся и продолжаем установку.
Отказываемся создавать раздел подкачки (swap-раздел)

Далее произойдет установка базовых компонентов ОС. Затем отказываемся от предложения отсканировать еще один носитель информации и выбираем репозиторий, с которого будем устанавливать дополнительные компоненты. Рекомендуем выбрать регион РФ, репозиторий deb.debian.org.
Выбираем репозиторий

Далее будет шаг с указанием прокси сервера. Если у вас прямой доступ в интернет, то можете его пропустить. После этого начнется установка дополнительных компонентов ОС. Через небольшой промежуток времени нам предложат отправлять разработчикам статистику об используемых пакетах. Мы обычно вежливо отказываемся, но вы можете и согласиться — на ваше усмотрение. И в какой-то момент времени нам предложат выбрать устанавливаемое ПО. Из всего списка выбираем только SSH-сервер и стандартные системные утилиты.
Выбираем только нужные компоненты

Ожидаем завершения установки и перезагружаем ВМ/сервер. ОС установлена.

Установка PT Sandbox

Для выполнения некоторых команд при установке продукта потребуются права суперпользователя. Вы можете войти в систему под пользователем root или скачать утилиту sudo и добавить в группу sudo вашего пользователя. Мы использовали второй вариант, правда, для его осуществления все равно придется один раз авторизоваться как root-пользователь.
root@ptsb:~# apt install sudo
root@ptsb:~# usermod -aG sudo user
Напомним, что для установки и последующего обновления продукта и его баз знаний необходим доступ до публичного сервера обновлений update.ptsecurity.com. Проверим наличие доступа:
user@ptsb:~$ wget -Sq -O /dev/null update.ptsecurity.com/test
HTTP/1.1 200 OK 
content-type: application/octet-stream
content-length: 0
date: Wed, 10 Dec 2025 11:37:02 GMT
strict-transport-security: max-age=31 536 000; includeSubDomains
x-content-type-options: nosniff
referrer-policy: origin
x-frame-options: SAMEORIGIN
Тут необходимо обратить внимание на код ответа. Если увидели число 200, значит проверка прошла успешно. Убедившись в наличии доступа, переносим дистрибутив продукта на сервер/ВМ и распаковываем его. 
user@ptsb:~$ ls
ptsb.installer.debian-12-amd64.5.24.0.118637.tar.gz
user@ptsb:~$ tar pxf ptsb.installer.debian-12-amd64.5.24.0.118637.tar.gz
user@ptsb:~$ ls
ptsb-installer  ptsb.installer.debian-12-amd64.5.24.0.118637.tar.gz
Переходим в каталог, извлеченный из архива. Так как мы производим установку в базовой конфигурации, то на данном узле будет выполняться поведенческий анализ. Значит, нужно установить гипервизор, который будет управлять виртуальными машинами для проверки файлов. В качестве гипервизора в PT Sandbox используется xen. При установке xen необходимо указать количество создаваемых виртуальных машин. Мы заранее заложили ресурсов согласно требованиям для 2 ВМ. Но всегда можно проверить, какое максимальное количество ВМ позволяют развернуть имеющиеся ресурсы. Для этого выполним специальный скрипт из дистрибутива продукта (при его запуске первый раз, скорее всего, запустится процесс установки необходимых зависимостей — это нормально).
user@ptsb:~$ cd ptsb-installer/
user@ptsb:~/ptsb-installer$ sudo xen/check-system-requirements.sh --get-max-vm
2
Скрипт подтверждает, что больше двух ВМ развернуть не получится. Но при необходимости можно меньше, и в виртуальной среде (как у нас на стенде) рекомендуем воспользоваться этой возможностью — так продукт будет работать стабильнее. Для установки запускаем скрипт с указанием количества ВМ:
user@ptsb:~/ptsb-installer$ sudo xen/install.sh --vm-count 1
INSTALLER_VERSION                     = 5.24.0.118637 (bookworm)

SERVER CONFIGURATION
  RAM                                 = 34816 MiB
  processor threads                   = 16
  boot mode                           = UEFI
  virtualization support              = enabled

INSTALLATION OPTIONS
  maximum number of virtual machines  = 1
  main node                           = y
  skip strict checks                  = n

REQUIREMENTS FOR VIRTUAL MACHINES
  RAM for one virtual machine         = 4096 MiB
  RAM                                 = 4352 MiB (4096 MiB + 256 MiB overhead)
  processor threads                   = 1

REQUIREMENTS FOR HOST SYSTEM
  RAM, minimum                        = 21248 MiB
  RAM, reserved                       = 30464 MiB
  processor threads, minimum          = 11
  processor threads, reserved         = 16

CHECK STATUS: OK
Installing Xen packages...

[Много строк с логами]

done
Press [Enter] to reboot...
После завершения установки нажимаем Enter и перезапускаем систему. После чего загрузится установленный ранее Debian  «поверх» только что установленного Xen, и можно приступать к установке непосредственно PT Sandbox. Для этого переходим в каталог с распакованным дистрибутивом и запускаем установщик, выбираем язык установки.
user@ptsb:~$ cd ptsb-installer/
user@ptsb:~/ptsb-installer$ sudo ./wizard
Select language | Gurnama ussasynyň dilini saýlaň | Выберите язык мастера установки:
  English
  Türkmençe
> Русский
Выбираем получать обновления напрямую с сервера обслуживания.
Выберите удобный для вас вариант получения обновлений:
> Напрямую с сервера обслуживания (https://update.ptsecurity.com:443)
  С сервера обслуживания через прокси-сервер
  С локального сервера обновлений
Пройдет ряд проверок, далее необходимо ввести серийный номер лицензии, состоящий из 10 блоков по 6 символов (на примере ниже и далее по тексту он скрыт звездочками).
Разрешение доменного имени источника обновлений УСПЕХ
Проверка доступности источника обновлений УСПЕХ
Проверка подлинности источника обновлений УСПЕХ
Разрешение доменного имени сервера Docker Registry УСПЕХ
Проверка доступности сервера Docker Registry УСПЕХ
Проверка подлинности сервера Docker Registry УСПЕХ

Серийный номер лицензии (без кавычек):
****** - ****** - ****** - ****** - ****** - ****** - ****** - ****** - ****** - ******
Лицензия будет проверена, затем будет предложено указать виртуальный IP-адрес (VIP) для отказоустойчивого кластера. Для односерверной инсталляции можно оставить поле пустым.
Поиск лицензии с введенным серийным номером УСПЕХ
Скачивание файла лицензии УСПЕХ
Проверка лицензии УСПЕХ
Получение информации о последней версии продукта УСПЕХ
Если вы устанавливаете конфигурацию с отказоустойчивым кластером, введите виртуальный IP-адрес кластера:
Затем проверяем введенные данные, читаем предупреждение о сборе данных и начинаем установку (выбранный вариант отображен заглавной буквой).
Источник обновлений https://update.ptsecurity.com:443
Серийный номер лицензии (без кавычек) ****** - ****** - ****** - ****** - ****** - ****** - ****** - ****** - ****** - ******
Версия                  5.24.0.120735
Продукт                 Sandbox
Редакция                -
Лицензия действительна до 2026-09-02 20:59:59.0 +00:00:00

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

Начать установку? [Y/n]
В самом начале установки он проверит соответствие аппаратным и программным требованиям, в том числе разбиение диска на разделы. Можно заметить предупреждения, что размеры разделов не соответствуют рекомендуемым значениям, но все же больше минимальных требований. Если бы размеры разделов были меньше минимальных, то установка бы не началась.
Установка займет достаточно продолжительное время, обычно около одного часа.
Начать установку? yes
INSTALLER_VERSION        = 5.24.0.118637 (bookworm)

Configuration:

  required node type     = master

  allow swap             = n
  no checks              = n
  proxy url              =
  proxy CA certificate   =

  RAM total              = 30462 MiB
  CPU cores              = 16
  Control group fs type  = cgroup2fs


Running pre-installation checks.

Checking swap is disabled...
OK
Checking for enough RAM (12288 MiB)...
OK
Checking for enough CPUs (4 cores)...
OK
Checking for enough HDD space available...

MOUNT POINTS
  ---------------------------------------------------------
  Data type              Directory              Mount point
  ---------------------------------------------------------
  System                 /                      /
  Software modules       /opt/ptms              /opt
  File storage           /opt/ptms/var/minio    /opt/ptms/var/minio

DISK SPACE*
  ------------------------------------------
  Data type              Min     Recommended
  ------------------------------------------
  System                 120     220
  Software modules       75      900
  File storage           66      900

* Values are in GiB (2^30 bytes)

[WARN] System: available disk space (144 GiB) is less than recommended (220 GiB).
System: reserved 120 GiB out of 144 GiB available in /.

[WARN] Software modules: available disk space (80 GiB) is less than recommended (900 GiB).
Software modules: reserved 75 GiB out of 80 GiB available in /opt.

[WARN] File storage: available disk space (71 GiB) is less than recommended (900 GiB).
File storage: reserved 66 GiB out of 71 GiB available in /opt/ptms/var/minio.

[Очень много строк с логами]
Version 5.24.0.120735 successfully installed.
Address: https://10.10.41.200/
To use product CLI interface, run
  # ptmsctl -h
If license was installed you can try to install product manually or wait auto-upgrading
To see list of product versions:
  # ptmsctl product upgrade versions
To install the version:
  # ptmsctl product upgrade apply <version>
To use Kubernetes CLI interface, run
  # export KUBECONFIG=/etc/kubernetes/admin.conf
  # kubectl -h

Продукт установлен.

Действия после установки

Хотя сам продукт и его компоненты установлены, необходимо выполнить первичную настройку продукта. Во-первых, необходимо активировать функцию поведенческого анализа на узле — по умолчанию данная функция отключена. Сначала посмотрим все узлы в нашей инсталляции.
user@ptsb:~/ptsb-installer$ sudo ptmsctl sandbox nodes list

Node

Status

ptsb

Ready for behavioral analysis to be enabled. For this, run the command: ptmsctl sandbox nodes acquire ptsb

Ожидаемо, видим только один узел. Сообщение в графе с состоянием узла говорит, что функция поведенческого анализа может быть активирована на данном узле, и даже подсказывает команду, чтобы это сделать. Воспользуемся данной подсказкой.
user@ptsb:~/ptsb-installer$ sudo ptmsctl sandbox nodes list

Result

Behavioral analysis is now enabled on the node "ptsb"

Однако даже сейчас на данном узле все еще нельзя выполнять проверку файлов поведенческим анализом. Все потому, что в продукте пока не установлены образы ВМ. С некоторой долей упрощения можно сказать, что образ ВМ — это операционная система, которая будет устанавливаться на ВМ и в которой будут проверяться файлы. Про образы ВМ более подробно расскажем в одной из следующих статей цикла. Запускаем процесс установки образов ВМ.
user@ptsb:~/ptsb-installer$ sudo ptmsctl sandbox force-generate-images

Result

Sandbox images are now being installed

Теперь вводим в браузере IP-адрес PT Sandbox и подключаемся к веб-интерфейсу продукта. Для входа используем логин Administrator и пароль P@ssw0rd. Сразу после входа потребуется задать новый пароль, а затем принять лицензионное соглашение (конечно, его еще нужно перед этим прочитать, но предполагается, что с ним вы уже ознакомились).

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

Также может быть такая ситуация, что версия дистрибутива «отстает» от актуальной версии продукта. Например, у нас был дистрибутив с версией продукта 5.24, тогда как на момент написания данной статьи актуальная версия 5.28. О наличии обновлений также будет подсказка в панели состояния продукта.
Информация о состоянии продукта

Чтобы обновиться, переходим в раздел «Система → Обновления» и запускаем обновление до актуальной версии, нажав на кнопку «Обновить сейчас» рядом с нужной версией. Иногда при большом разрыве в версиях сразу обновиться до актуальной версии нельзя, нужно это делать пошагово — несколько раз обновиться до максимально доступной версии, которую предлагает сам PT Sandbox. Например, в нашей инсталляции можно обновиться сразу только до версии 5.25.1, потом до версии 5.26.0 и 5.27.0, и только на четвертой итерации обновляемся до версии 5.28.0.
Доступные обновления сразу после установки
Обновление до 5.26

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

Заключение

Если вы выполнили все шаги из этой статьи, то ваш продукт готов к использованию. Следующим шагом после установки идет заведение источников в продукт, но рассказываем мы про это в четвертой статье данного цикла. А следующую статью мы решили посвятить обзору веб-интерфейса продукта, ведь все дальнейшее взаимодействие с PT Sandbox происходит именно через него (в том числе и заведение источников).
Может быть интересно