Kickidler Agent 2.0 для Windows — руководство администратора

Kickidler Agent 2.0 для Windows — руководство администратора


1. Назначение

Этот документ описывает базовые действия администратора при установке, проверке, диагностике и удалении Kickidler Agent на рабочей станции Windows.

Инструкция предназначена для системных администраторов, инженеров технической поддержки и специалистов, которые отвечают за внедрение или обслуживание Kickidler Agent.

В документе описаны:

  • подготовка к установке;
  • установка через MSI-файл;
  • тихая установка через msiexec;
  • добавление в исключения антивируса или Windows Defender;
  • проверка работоспособности после установки;
  • расположение основных файлов и логов;
  • базовая диагностика;
  • удаление агента;
  • данные, которые нужно передать в техническую поддержку.

2. Перед началом

Перед установкой подготовьте:

  • установочный файл Kickidler Agent в формате.msi;
  • актуальный ключ активации из личного кабинета, доступного по адресу https://my.kickidler.ru;
  • доступ к рабочей станции с правами администратора.

Если на компьютере используется корпоративный антивирус, EDR или централизованная политика безопасности, заранее проверьте, разрешено ли временно отключать защиту и добавлять исключения.

3. Установка Kickidler Agent

3.1. Подготовка к установке

Перед запуском установщика убедитесь, что:

  • установочный файл Kickidler Agent скачан на рабочую станцию;
  • ключ активации получен из личного кабинета my.kickidler.ru;
  • пользователь или администратор имеет права локального администратора;
  • антивирус или Windows Defender не блокирует запуск MSI-файла.

Если защита блокирует установку, временно отключите антивирус или Windows Defender, если это разрешено политиками организации. После установки защиту нужно включить обратно.

3.2. Установка через MSI-файл

  1. Запустите установочный файл.msi.
  2. В мастере установки нажмите Далее.
  3. Ознакомьтесь с лицензионным соглашением.
  4. Отметьте необходимые пункты и нажмите Далее.
  5. Введите ключ активации из личного кабинета my.kickidler.ru.
  6. Нажмите Далее.
  7. На этапе выбора версии оставьте доступную версию Time Tracking.
  8. Если требуется скрытая установка, включите параметр Скрытая работа.
  9. Если скрытая установка не требуется, оставьте параметр выключенным.
  10. На этапе выбора центров обновления и лицензирования оставьте параметры по умолчанию, если администратор не указал другие значения.
  11. Оставьте путь установки по умолчанию, если нет отдельного требования использовать другой каталог.
  12. Нажмите Установить.
  13. Если Windows запросит подтверждение контроля учетных записей, нажмите Да.
  14. При необходимости введите пароль администратора.
  15. Дождитесь завершения установки.
  16. После сообщения об успешной установке нажмите Готово.

После этого Kickidler Agent будет установлен на рабочей станции.

4. Тихая установка через msiexec

Тихая установка подходит для массового развертывания, удаленного запуска, установки через RMM, GPO или автоматизированные скрипты.

Перед запуском убедитесь, что:

  • командная строка или PowerShell запущены от имени администратора;
  • установочный файл находится на рабочей станции;
  • используется актуальный ключ активации;
  • для скрытой установки добавлен параметр HIDDEN_MODE=1.

4.1. Переход в папку с установщиком

Если установочный файл находится в папке Загрузки, сначала перейдите в эту папку:

cd "C:\Users\User\Downloads"

Замените путь на фактический путь к папке, где находится MSI-файл.

4.2. Тихая установка в открытом режиме

msiexec /i "Kickidler_Agent_<version>.msi" /qn /norestart ACTIVATION_KEY="ВАШ_КЛЮЧ"

4.3. Тихая установка в скрытом режиме

msiexec /i "Kickidler_Agent_<version>.msi" /qn /norestart ACTIVATION_KEY="ВАШ_КЛЮЧ" HIDDEN_MODE=1

4.4. Описание параметров

Параметр /i

Запускает установку MSI-пакета.

Параметр "Kickidler_Agent_<version>.msi"

Имя установочного файла. Замените <version> на фактическую версию файла.

Параметр /qn

Выполняет установку без отображения интерфейса мастера установки.

Параметр /norestart

Запрещает автоматическую перезагрузку после установки.

Параметр ACTIVATION_KEY="ВАШ_КЛЮЧ"

Ключ активации из личного кабинета my.kickidler.ru.

Параметр HIDDEN_MODE=1

Включает скрытый режим установки. Используйте только если агент нужно установить скрыто.

ПРИМЕЧАНИЕ

Не передавайте ключ активации в открытом виде в обращениях, скриншотах, логах или переписке.

4.5. Установка с логированием

Если установка завершается с ошибкой или техническая поддержка запросила лог установки, добавьте параметр:

/L*V "agent_install.log"

Пример установки в открытом режиме с логированием:

msiexec /i "Kickidler_Agent_<version>.msi" /qn /norestart /L*V "agent_install.log" ACTIVATION_KEY="ВАШ_КЛЮЧ"

Пример установки в скрытом режиме с логированием:

msiexec /i "Kickidler_Agent_<version>.msi" /qn /norestart /L*V "agent_install.log" ACTIVATION_KEY="ВАШ_КЛЮЧ" HIDDEN_MODE=1

Если команда запущена из папки, где находится установочный файл, лог agent_install.log будет создан в этой же папке.

При обращении в техническую поддержку приложите файл:

agent_install.log

Также укажите команду установки, которую запускали.

5. Добавление Kickidler Agent в исключения антивируса / Windows Defender

После установки рекомендуется добавить папку Kickidler Agent в исключения антивируса или Windows Defender.

Это может потребоваться, если антивирус блокирует:

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

ПРИМЕЧАНИЕ

Не рекомендуется добавлять в исключения весь диск C:\, весь каталог C:\ProgramData, весь профиль пользователя или весь %TEMP%.

5.1. Пути для добавления в исключения

Для открытой установки:

C:\Program Files\TeleLinkSoftV2

Для скрытой установки:

C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}

Если тип установки неизвестен, проверьте наличие этих папок через Проводник Windows или PowerShell. Если определить тип установки не удалось, уточните информацию у администратора или в технической поддержке.

5.2. Добавление исключения через интерфейс Windows Defender

  1. Откройте меню Пуск.
  2. Найдите и откройте Безопасность Windows / Windows Security.
  3. Перейдите в раздел Защита от вирусов и угроз.
  4. В блоке Параметры защиты от вирусов и других угроз нажмите Управление настройками.
  5. Найдите раздел Исключения.
  6. Нажмите Добавление или удаление исключений.
  7. Если Windows запросит подтверждение, нажмите Да.
  8. Нажмите Добавить исключение.
  9. Выберите тип исключения Папка.
  10. Укажите папку Kickidler Agent в зависимости от типа установки.
  11. Проверьте, что добавленный путь появился в списке исключений.

После добавления исключения включите антивирус или Windows Defender обратно, если защита была временно отключена.

5.3. Добавление исключения через PowerShell

Откройте PowerShell от имени администратора.

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

Add-MpPreference -ExclusionPath 'C:\Program Files\TeleLinkSoftV2'

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

Add-MpPreference -ExclusionPath 'C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\'

Проверить текущие исключения можно командой:

Get-MpPreference | Select-Object -ExpandProperty ExclusionPath

5.4. Если используется другой антивирус или EDR

Названия разделов могут отличаться в зависимости от продукта, но обычно нужно найти один из разделов:

  • Exclusions / Exceptions;
  • Allowlist;
  • Trusted applications;
  • Trusted zone;
  • Scan exclusions;
  • Real-time protection exclusions.

Добавьте исключение для директории установки Kickidler Agent.

Для открытой установки:

C:\Program Files\TeleLinkSoftV2

Для скрытой установки:

C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}

Если антивирус управляется централизованно, примените или обновите политику на рабочей станции.

6. Ошибка проверки ключа во время установки

Во время установки может появиться сообщение:

ПРИМЕЧАНИЕ

Activation key validation failed: ключ активации отклонен сервером лицензий: INVITE_EXPIRED

В этом случае выполните следующие действия:

  1. Нажмите OK в окне ошибки.
  2. Проверьте, что ключ активации введен без ошибок.
  3. Убедитесь, что используется актуальный ключ из личного кабинета my.kickidler.ru.
  4. Запустите установку повторно с корректным ключом.
  5. Если ключ введен правильно, но ошибка повторяется, обратитесь в техническую поддержку Kickidler и приложите скриншот ошибки.

7. Проверка после установки

После установки проверьте:

  • появились ли службы Kickidler Agent в Windows;
  • нет ли ошибок запуска или подключения в логах агента;
  • появился ли сотрудник в веб-интерфейсе Kickidler;
  • получила ли рабочая станция лицензию в личном кабинете my.kickidler.ru.

7.1. Проверка служб

Откройте PowerShell от имени администратора и выполните:

Get-Service ngs_v2,ngs_updater_v2,tls_v2,tls_updater_v2 -ErrorAction SilentlyContinue

Если службы отображаются и имеют корректный статус, агент установлен на рабочей станции.

Для открытой установки обычно используются службы:

ПРИМЕЧАНИЕ

ngs_v2ngs_updater_v2

Для скрытой установки обычно используются службы:

ПРИМЕЧАНИЕ

tls_v2tls_updater_v2

7.2. Управление службами

Проверить службу открытой установки:

Get-Service ngs_v2

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

Restart-Service ngs_v2

Проверить службу скрытой установки:

Get-Service tls_v2

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

Restart-Service tls_v2


Перезапуск службы может временно прервать отправку данных агентом. Выполняйте это действие только при необходимости.

8. Расположение основных файлов

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

8.1. Открытая установка

Каталог установки

C:\Program Files\TeleLinkSoftV2

Служба

ngs_v2

Файл агента

grabber_v2.exe

Конфигурация

<InstallDir>\config.yaml

Основной лог

Основной лог определяется значением параметра logs.path в конфигурации. Часто он находится внутри каталога установки.

Локальная БД очереди

Локальная БД очереди определяется значением параметра local_db.file в конфигурации. Часто она находится внутри каталога установки.

Раздел реестра

HKLM\Software\Tele Link Software\KickidlerAgent

8.2. Скрытая установка

Каталог установки

C:\ProgramData\{AltGuid}

Служба

tls_v2

Файл агента

tlshost_v2.exe

Конфигурация

<InstallDir>\config.yaml

Основной лог

Основной лог определяется значением параметра logs.path в конфигурации.

Типовой путь скрытой установки

C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}

9. Проверка логов

Логи Kickidler Agent находятся в подпапке logs внутри каталога установки.

9.1. Логи открытой установки

Папка логов:

C:\Program Files\TeleLinkSoftV2\logs

Основные файлы:

C:\Program Files\TeleLinkSoftV2\logs\agent.logC:\Program Files\TeleLinkSoftV2\logs\updater.log

Посмотреть последние строки agent.log:

Get-Content 'C:\Program Files\TeleLinkSoftV2\logs\agent.log' -Tail 80

Посмотреть последние строки updater.log:

Get-Content 'C:\Program Files\TeleLinkSoftV2\logs\updater.log' -Tail 80

9.2. Логи скрытой установки

Папка логов:

C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs

Основные файлы:

C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs\agent.logC:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs\updater.log

Посмотреть последние строки agent.log:

Get-Content 'C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs\agent.log' -Tail 80

Посмотреть последние строки updater.log:

Get-Content 'C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs\updater.log' -Tail 80

9.3. Дополнительные пользовательские логи

Логи sensor и selfcontrol UI находятся во временном каталоге интерактивного пользователя.

Get-Content "$env:TEMP\kickidler-sensor.log" -Tail 80Get-Content "$env:TEMP\kickidler-selfcontrol.log" -Tail 80

10. Базовая диагностика

10.1. Нормальные признаки работы агента

В agent.log могут быть сообщения следующего типа:

[startup] Kickidler Agent v2.0.X.NNN starting[connection] Connecting to server <host>:<port>...[connection] Authentication successful[connection] Connected and authenticated[activity] Heartbeat sent

Такие сообщения обычно означают, что агент запущен, подключается к серверу, прошел аутентификацию и отправляет активность.

10.2. Агент не появляется в веб-интерфейсе

Проверьте:

  • корректность ключа активации;
  • наличие лицензии в личном кабинете my.kickidler.ru;
  • статус служб Windows;
  • наличие ошибок в agent.log;
  • доступность сервера по сети;
  • блокировки со стороны антивируса, EDR или firewall.

10.3. Проверка сетевого подключения к серверу

Если известен адрес Kickidler Server, проверьте доступность порта 16000:

Test-NetConnection -ComputerName <kickidler-server-host> -Port 16000

Замените:

ПРИМЕЧАНИЕ

<kickidler-server-host>

на фактический адрес сервера.

Агент устанавливает исходящие соединения. Обычно на рабочей станции не требуется открывать входящие TCP-порты.

10.4. Частые симптомы

Агент offline в интерфейсе

Проверьте сообщения [connection] и [license] в agent.log, доступность сервера и ключ активации.

Много сообщений Target <host:port> failed

Проверьте сетевую доступность сервера, firewall и корректность адреса сервера.

Нет активности или скриншотов

Проверьте подключение агента, политику сбора, статус пользовательской сессии, сообщения [activity] и [schedule].

Служба не запускается

Проверьте статус службы, ошибки в логах, блокировки антивируса и доступ к каталогу установки.

Ошибки обновления

Проверьте updater.log, сетевой доступ, блокировки антивируса или EDR.

11. Сбор логов для технической поддержки

Для открытой установки можно собрать основные файлы командой:

Compress-Archive -Path 'C:\Program Files\TeleLinkSoftV2\logs\*','C:\Program Files\TeleLinkSoftV2\config.yaml' -DestinationPath "$env:TEMP\kickidler-agent-logs-$(Get-Date -Format yyyy-MM-dd).zip"

Для скрытой установки:

Compress-Archive -Path 'C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs\*','C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\config.yaml' -DestinationPath "$env:TEMP\kickidler-agent-logs-$(Get-Date -Format yyyy-MM-dd).zip"

Перед отправкой в техническую поддержку замаскируйте чувствительные данные в config.yaml, если они присутствуют:

  • ключи;
  • токены;
  • invite-значения;
  • внутренние адреса, если политика компании запрещает их передачу;
  • inline-сертификаты или приватные данные.

12. Удаление Kickidler Agent

Удаление Kickidler Agent выполняется с помощью специального скрипта удаления.

Скрипт удаления необходимо запросить в технической поддержке Kickidler. Не рекомендуется использовать скрипты из неофициальных источников, старых переписок или сторонних файловых хранилищ, так как они могут не соответствовать текущей версии продукта или политике удаления.

12.1. Подготовка к удалению

Перед удалением убедитесь, что:

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

12.2. Удаление через скрипт

  1. Сохраните архив со скриптом удаления на компьютер, например в папку Загрузки.
  2. Нажмите правой кнопкой мыши по архиву и выберите Извлечь все....
  3. Укажите папку для распаковки и нажмите Извлечь.
  4. Откройте распакованную папку.
  5. Найдите файл удаления, например:

delete_grabber.bat
  1. Нажмите по файлу правой кнопкой мыши.
  2. Выберите Запуск от имени администратора.
  3. Если Windows покажет окно контроля учетных записей, нажмите Да.
  4. Дождитесь завершения работы скрипта.

Во время выполнения скрипт может останавливать службы Kickidler Agent, завершать процессы агента, удалять записи служб и очищать оставшиеся каталоги агента.

После появления сообщения:

Cleanup finished successfullyCleanup finished

нажмите любую клавишу в окне консоли, если это требуется.

Если окно уже закрылось после успешного выполнения, дополнительных действий не требуется.

Если скрипт сообщил об ошибке или окно закрылось до завершения, перезагрузите компьютер и повторите запуск скрипта от имени администратора. Если ошибка повторяется, обратитесь в техническую поддержку Kickidler.

13. Проверка после удаления

Откройте PowerShell от имени администратора и выполните:

Get-Service ngs_v2,ngs_updater_v2,tls_v2,tls_updater_v2 -ErrorAction SilentlyContinue

Если команда не выводит службы Kickidler Agent, службы агента удалены.

Дополнительно проверьте наличие типовых каталогов.

Для открытой установки:

Test-Path 'C:\Program Files\TeleLinkSoftV2'

Для скрытой установки:

Test-Path 'C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\'

Ожидаемый результат:

  • каталог C:\Program Files\TeleLinkSoftV2 отсутствует;
  • каталог C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce} отсутствует;
  • службы ngs_v2, ngs_updater_v2, tls_v2, tls_updater_v2 не отображаются.

14. Когда обращаться в техническую поддержку

Обратитесь в техническую поддержку Kickidler, если:

  • установка Kickidler Agent завершается с ошибкой;
  • ключ активации не принимается, хотя он введен корректно;
  • агент установлен, но сотрудник не появляется в веб-интерфейсе;
  • агент не получает лицензию в my.kickidler.ru;
  • службы агента не запускаются;
  • антивирус или Windows Defender продолжает блокировать агент после добавления исключений;
  • скрипт удаления завершается с ошибкой;
  • после удаления остаются службы или каталоги агента;
  • в логах есть повторяющиеся ошибки подключения, лицензирования, запуска или обновления.

При обращении рекомендуется приложить:

  • скриншот ошибки;
  • описание выполненных действий;
  • версию установочного файла;
  • дату и время возникновения проблемы;
  • статус служб;
  • файл agent_install.log, если установка выполнялась с логированием;
  • архив логов агента;
  • config.yaml с замаскированными чувствительными данными;
  • информацию о версии Windows;
  • сведения об антивирусе, EDR или корпоративной политике безопасности, если они могут влиять на работу агента.

15. Завершение

После установки или удаления Kickidler Agent администратор должен проверить фактический результат:

  • после установки - службы запущены, агент подключается, сотрудник отображается в веб-интерфейсе;
  • после удаления - службы и каталоги агента отсутствуют;
  • при проблемах - собраны логи, скриншоты и описание выполненных действий.

Если базовая проверка не помогает определить причину проблемы, передайте собранные данные в техническую поддержку Kickidler.


    • Related Articles

    • Kickidler Server 2.0 для Linux — руководство администратора

      1. Назначение Этот документ описывает основные административные действия по установке, проверке, диагностике и удалению Kickidler Server на Linux-серверах семейства Debian. Руководство предназначено для системных администраторов, инженеров ...

    • Kickidler Agent 2.0 для Windows — удалённая и массовая установка

      1. Назначение Этот документ описывает базовый порядок удалённой установки Kickidler Agent 2.0 на рабочие станции Windows. Инструкция предназначена для системных администраторов, которые выполняют массовое развёртывание через: групповые политики ...

    • Kickidler Agent 2.0 для Windows — быстрый старт по установке

      1. Назначение Этот документ поможет быстро установить Kickidler Agent на компьютер с Windows. 2. Перед установкой Подготовьте: установочный файл Kickidler Agent; ключ активации из личного кабинета my.kickidler.ru; доступ к компьютеру с правами ...

    • Быстрый старт по установке и удалению Kickidler Server 2.0 на Windows

      1. Назначение Этот документ поможет быстро установить и удалить Kickidler Server на компьютере с Windows. 2. Перед установкой Подготовьте: установочный файл Kickidler Server; ключ сервера из личного кабинета my.kickidler.ru; доступ к компьютеру с ...

    • Kickidler Agent 2.0 для macOS — быстрый старт

      1. Назначение В этой статье описана быстрая установка Kickidler Agent на компьютер с macOS. 2. Перед установкой Подготовьте: установочный файл Kickidler Agent в формате .dmg; ключ активации из личного кабинета my.kickidler.ru; доступ к Mac с правами ...