Для примера на управляемом устройстве требуется вывести информацию об имени хоста, выполнив команду
hostname
Для этого надо создать обновление с командой hostname, например, для клиента client01, скачав которое Клиент управления и запустит эту команду. Порядок действий следующий:
1. На устройстве с Сервером управления создайте каталог C:\test и в нем сохраните файл update.bat со следующим содержанием:
hostname
2. На Сервере управления выделите клиента client01, в контекстном меню выберите предложение Update.
Рисунок 187
3. После этого будет выдано окно формирования обновления для клиента.
Рисунок 188
В этом окне надо заполнить поле Extended data, которое может иметь следующие значения:
Extended data – каталог, в котором размещены расширенные данные и скрипты обновления. Данный каталог может содержать любые данные с любой вложенностью каталогов. В данном каталоге имеются зарезервированные названия файлов:
Файл cook.bat – пакетный файл, который вызывается перед упаковкой каталога для отсылки Клиенту управления.
Файл может отсутствовать.
Если возвращаемое значение файла отлично от нуля - вся операция подготовки обновления завершается с ошибкой.
Каталогом запуска для файла является каталог, в котором он находится.
Перед вызовом файла cook.bat автоматически выставляются следующие переменные окружения:
UPServerBinDir – каталог Сервера управления, в котором располагаются исполняемые файлы
UPServerDir – каталог Сервера управления, в котором располагаются данные продукта
UPAgentID – идентификатор Клиента управления, для которого готовится обновление
VPNProductType – тип VPN-продукта, установленного на удаленном компьютере (SERVER,CLIENT,GATE)
VPNProductVersionMajor – старшая версия VPN-продукта, установленного на управляемом устройстве (например, 3.1)
VPNProductVersionMinor – младшая версия VPN-продукта, установленного на управляемом устройстве (например, 10330)
VPNProductCryptoProvider – криптопровайдер, используемый VPN-продуктом, который установлен на управляемом устройстве (CP,SC,ST)
UPAgentGroup – идентификатор группы, к которой принадлежит UPAgent
UPAgentOS – тип операционной системы, для которой был собран UPAgent (WIN2K,SOLARIS,LINUXRHEL5, LINUXDEBIAN6)
UPAgentCPU – тип процессора системы, для которой был собран UPAgent (i386,i486,i686)
UPAgentLastActiveTime – время, в которое UPAgent установил соединение с FTP-сервером (dd/mm/yyyy hh:mm:ss)
UPAgentLastIPAddr – сетевой адрес, с которого UPAgent установил соединение с FTP-сервером
VPNProductFireTimeByCert – ближайшая дата истечения срока действия сертификатов Устройства, на котором установлен UPAgent
UPAgentVersionMajor – старшая версия Клиента управления, установленного на управляемый компьютер (1.2 и так далее)
UPAgentVersionMinor – младшая версия Клиента управления, установленного на управляемый компьютер (10330 и так далее)
EX_??? – расширенные переменные, заданные администратором для клиента, посредством окна Properties… в VPN UPServer console.
Файл 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 – каталог продукта CSP VPN Agent, в котором располагаются исполняемые файлы
UPAgentID – идентификатор Клиента управления
UPServerAddr – рабочий адрес Сервера управления
VPNProductType – тип VPN-продукта, установленного на управляемом устройстве (SERVER,CLIENT,GATE,TGATE)
VPNProductVersionMajor – старшая версия VPN-продукта, установленного на управляемом устройстве (например, 3.1)
VPNProductVersionMinor – младшая версия VPN-продукта, установленного на управляемом устройстве (например, 10330)
VPNProductCryptoProvider – криптопровайдер, используемый VPN-продуктом, который установлен на управляемом устройстве (CP,SC,ST)
UPAgentVersionMajor – старшая версия UPAgent, установленного на управляемом устройстве (например, 1.2)
UPAgentVersionMinor – младшая версия UPAgent, установленного на управляемом устройстве (например, 11687)
VPNProductUtilitySuffix – суффикс, используемый для различия имен утилит разных версий VPN-продукта (“_3_1”, “_4_0”, “_4_1”).
4. В поле Extended data внесите каталог C:\test с файлом update.bat и нажмите ОК.
Рисунок 189
5. После нажатия ОК будет создано обновление для клиента client01, которое будет скачено Клиентом управления и применено после получения разрешения.
Рисунок 190
6. Результат применения команды hostname можно увидеть во вкладке UpLog для данного клиента на Сервере управления. В данном примере – это «vpnclient01» (Рисунок 191).
Рисунок 191