Настройка HWID

Агент использует Уникальный идентификатор диска (HWID) для регистрации на сервере и взаимодействия с сервисом мониторинга.

С версии Staffcop Enterprise 5.5 для Windows-агентов с версии 5.8.2583 добавлены новые параметры, которые позволяют:

• выбирать тип HWID, который будет использоваться при установке;

• удалять текущий HWID из реестра и устанавливать новый.

Примечание

Параметры HWID опциональны. По умолчанию установится HWID на основе уникальных аппаратных данных компьютера.

Передача параметров происходит двумя способами:

• через управление командой msiexec в командной строке — используйте этот способ при Тихой установке и установки из Active Directory;

• изменение названия MSI-файла — используйте при установке через Утилиту удаленной установки и Локальную установку.

Параметры HWID

• hwid — значение HWID, которое зависит от выбранного типа: HWID, HWID-FQDN или FQDN.

• use_fqdn — тип HWID, который может принимать следующие значения:

  • 0 (или отсутствие параметра) — HWID – идентификатор на основе уникальных аппаратных данных компьютера в формате GUID, например: 076ee660-54b6-49c3-baaf-b0f8bb81f9e1. Сохраняется в реестре, не изменяется при смене имени или настроек сети. При удалении генерируется повторно.

  • 1 — HWID-FQDN – использует полное доменное имя компьютера (FQDN) в нижнем регистре. Сохраняется в реестре и не меняется. При удалении из реестра генерируется повторно.

  • 2 — FQDN – полное доменное имя компьютера (FQDN), не сохраняется и не читается из реестра. Это значение генерируется при каждом запуске агента. При удалении из реестра заново не создается.

Примечание

Тип и значение HWID хранятся в ветке реестра: HKEY_LOCAL_MACHINESYSTEMSCHWID.

Передача параметров через команду msiexec

Для команды установки агента msiexec добавлены два новых параметра:

• DROPHWID:

  • DROPHWID=1 — удаляет текущий HWID и генерирует новое значение.

  • DROPHWID=0 — не удаляет текущий идентификатор.

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

• HWIDMODE:

  • HWIDMODE=HWID, HWIDMODE=HWIDFQDN, HWIDMODE=FQDN — задает тип HWID. При некорректном значении в логе будет сообщение об ошибке.

Пример команды, которая удалит текущий HWID и установит HWID-FQDN:

msiexec.exe /norestart /l*vx install.log /qn /i "C:\Windows\agent.msi" GATE_URL="staffcop_server" GATE_URL2="staffcop_server_reserve" GATE_PORT=port GATE_PORT2=port2 ALLUSERS=1 REBOOT=ReallySuppress DROPHWID=1 HWIDMODE=HWIDFQDN

Примечание

Если параметры указаны и в названии MSI-файла, и в командной строке, приоритет будет у параметров командной строки.

Передача параметров при отложенной установке

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

Пример команды, которая сбросит HWID и применит параметр HWID-FQDN после перезагрузки системы:

msiexec.exe /i "Agent.msi" /qn /l*vx "install.log" GATE_URL="main.server.url" ALLUSERS=1 REBOOT=ReallySuppress REINSTALLMODE=amus DROPHWID=1 HWIDMODE=HWIDFQDN AGENT_FORCE_REBOOT=delayed

Передача параметров через название MSI-файла

Начиная с версии агента 1.2.0.18 утилита удаленной установки поддерживает передачу параметров HWID через название MSI-файла.

Перед запуском утилиты добавьте в название файла подстроки:

• drophwid — удаляет текущий HWID из реестра и генерирует новое значение;

• hwidmode=hwid, hwidmode=hwidfqdn или hwidmode=fqdn — указывает тип HWID.

Правила указания параметров:

• параметры можно указывать в любом порядке и в любом регистре;

• один или оба параметра могут отсутствовать;

• если параметр не указан или указан некорректно, тип идентификатора не изменится, а в логе инсталлятора появится сообщение о некорректном значении;

• сервер берет параметры HWID из названия файла, но игнорирует URL серверов в имени MSI-файла  — они берутся из настроек утилиты.

Пример названия файла, которое заменит старый HWID на HWID-FQDN:

Agent[main.server.url{reserve.server.url}]-drophwid-hwidmode=hwidfqdn.msi

где знак «минус» (-) — разделительный символ.

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

Не используйте переименованный MSI-файл для операции Repair, если у него тот же Product Code. Операция завершится с ошибкой, потому что Windows Installer не сможет найти правильный установочный файл по исходному имени.

Repair (Восстановление) — это функция Windows Installer, которая позволяет восстановить или исправить установленную программу, если она работает некорректно или какие-то файлы были удалены или повреждены.

ProductCode — уникальный идентификатор (GUID) для каждого MSI-пакета, который использует Windows Installer для распознавания и управления установленными программами. Позволяет системе отличать одну версию программы от другой, особенно при обновлении, восстановлении или удалении. Если у разных MSI-пакетов один и тот же ProductCode, Windows считает их одной и той же программой.