Для примера на управляемом VPN устройстве требуется вывести информацию об имени хоста, выполнив команду:
hostname
Для этого надо создать обновление с командой hostname, например, для управляемого VPN устройства “client01”, скачав которое Клиент управления и запустит эту команду. Порядок действий следующий:
1. На устройстве с Сервером управления создайте произвольную директорию и в ней сохраните файл update.bat со следующим содержанием:
hostname
2. Переместите директорию с файлом в хранилище Сервера управления в директории /storage/EXTENDED_DATA (Рисунок 314). Для этого администратор должен соответствующее разрешение. Если его нет, перейдите в меню консоли С-Терра КП Tools - User editor (Рисунок 50) и для учетной записи администратора поставьте флажок Allow write extended data.
Рисунок 314
3. В консоли С-Терра КП выделите учетную запись client01, в контекстном меню выберите предложение Update (Рисунок 315).
Рисунок 315
4. После этого будет выдано окно формирования обновления для управляемого VPN устройства (Рисунок 316).
Рисунок 316
В этом окне надо заполнить поле Extended data.
Extended data - директория, в которой размещены данные и скрипты для расширенного обновления. Директория может содержать любые данные с любой вложенностью директорий. Имеются зарезервированные названия файлов директории:
• Файл cook.bat - пакетный файл, который вызывается перед упаковкой директории для отсылки Клиенту управления. Файл может отсутствовать.
Если возвращаемое значение файла отлично от нуля - вся операция подготовки обновления завершается с ошибкой. Перед вызовом файла cook.bat автоматически выставляются следующие переменные окружения:
• UPServerBinDir - директория Сервера управления, в которой располагаются исполняемые файлы
• UPServerDir - директория Сервера управления, в которой располагаются данные Продукта
• UPAgentID - идентификатор Клиента управления, для которого готовится обновление
• VPNProductType - тип VPN-продукта, установленного на управляемом VPN устройстве (SERVER, CLIENT, GATE)
• VPNProductVersionMajor - старшая версия VPN-продукта, установленного на управляемом VPN устройстве (например, 4.3)
• VPNProductVersionMinor - младшая версия VPN-продукта, установленного на управляемом VPN устройстве (например, 10330)
• VPNProductCryptoProvider - криптобиблиотека, используемая VPN-продуктом (CP, ST)
• UPAgentGroup - идентификатор группы, к которой принадлежит учетная запись управляемого VPN устройства
• UPAgentOS - тип операционной системы, для которой был собран Клиент управления (WIN2K, SOLARIS, LINUXRHEL5, LINUXDEBIAN6, LINUXDEBIAN7, LINUXDEBIAN9, LINUXNLM)
• UPAgentCPU - тип процессора системы, для которой был собран Клиент управления (i386, i486, i686)
• UPAgentLastActiveTime - время, в которое Клиент управления установил соединение с FTP-сервером (dd/mm/yyyy hh:mm:ss)
• UPAgentLastIPAddr - сетевой адрес, с которого Клиент управления установил соединение с FTP-сервером
• VPNProductFireTimeByCert - ближайшая дата истечения срока действия сертификатов управляемого VPN устройства, на котором установлен Клиент управления
• UPAgentVersionMajor - старшая версия Клиента управления, установленного на управляемое VPN устройство (4.3 и так далее)
• UPAgentVersionMinor - младшая версия Клиента управления, установленного на управляемое VPN устройство (10330 и так далее)
• EX_??? - расширенные переменные, заданные администратором для управляемого VPN устройства посредством окна Properties в консоли С-Терра КП.
• Файл backup.bat (backup.sh) - пакетный файл, который вызывается на Клиенте управления перед запуском процедуры обновления. Файл может отсутствовать.
Если возвращаемое значение файла отлично от нуля - вся операция обновления завершается с ошибкой.
• Файл update.bat (update.sh) - пакетный файл, который вызывается на Клиенте управления в процессе обновления. Файл может отсутствовать.
Если возвращаемое значение файла отлично от нуля - вся операция обновления завершается с ошибкой.
• Файл restore.bat (restore.sh) - пакетный файл, который вызывается на Клиенте управления в случае неудачи во время процедуры обновления или при завершении с ошибкой выполнения пакетного файла update.bat. Файл может отсутствовать.
Строго не рекомендуется возвращать значение, отличное от нуля, так как Клиент управления будет периодически вызывать этот скрипт, пока он не завершится успехом.
Перед вызовом файлов backup.bat (backup.sh), update.bat (update.sh), restore.bat (restore.sh) автоматически выставляются следующие переменные окружения:
• UPAgentBinDir - директория Клиента управления, в которой располагаются исполняемые файлы
• UPAgentDir - директория Клиента управления, в которую можно сохранять данные
• VPNProductBinDir - директория VPN-продукта, в которой располагаются исполняемые файлы
• UPAgentID - идентификатор Клиента управления
• UPServerAddr - рабочий адрес Сервера управления
• VPNProductType - тип VPN-продукта, установленного на управляемом VPN устройстве (SERVER, CLIENT, GATE)
• VPNProductVersionMajor - старшая версия VPN-продукта, установленного на управляемом VPN устройстве (например, 4.3)
• VPNProductVersionMinor - младшая версия VPN-продукта, установленного на управляемом VPN устройстве (например, 10330)
• VPNProductCryptoProvider - криптобиблиотека, используемая VPN-продуктом, который установлен на управляемом VPN устройстве (CP, SC, ST)
• UPAgentVersionMajor - старшая версия Клиента управления, установленного на управляемом VPN устройстве (например, 1.2)
• UPAgentVersionMinor - младшая версия Клиента управления, установленного на управляемом VPN устройстве (например, 11687)
• VPNProductUtilitySuffix - суффикс, используемый для различия имен утилит разных версий VPN-продукта (“_3_1”, “_4_0”, “_4_1”, “_4_2”, “_4_3”)
5. В поле Extended data пропишите путь до директории /storage/EXTENDED_DATA с файлом update.bat и нажмите ОК (Рисунок 317).
Рисунок 317
6. После нажатия ОК будет создано обновление для управляемого VPN устройства “client01”, которое будет скачено Клиентом управления и применено после получения подтверждения (Рисунок 318).
Рисунок 318
7. Результат применения команды hostname можно увидеть во вкладке UPLog для данного клиента в консоли С-Терра КП. В данном примере - это «client01» (Рисунок 319).
Рисунок 319