154 lines
5.5 KiB
Markdown
Executable File
154 lines
5.5 KiB
Markdown
Executable File
# Windows troubleshooting
|
|
|
|
## Частые проблемы
|
|
|
|
### `Run this script from an elevated PowerShell session`
|
|
|
|
- Откройте PowerShell через `Run as administrator`.
|
|
- Проверьте, что UAC не понизил токен.
|
|
|
|
### Задачи созданы, но watcher'ы не стартуют
|
|
|
|
- Убедитесь, что пользователь реально вошёл в интерактивную сессию.
|
|
- Проверьте задачу `ActivityWatch Launch [...]` в Task Scheduler.
|
|
- Запустите вручную:
|
|
|
|
```powershell
|
|
Start-ScheduledTask -TaskName 'ActivityWatch Launch [CONTOSO_user01]'
|
|
```
|
|
|
|
- Если доменный логон ещё ни разу не происходил на хосте, сначала выполните вход этим пользователем.
|
|
|
|
### Collector не видит URL
|
|
|
|
- Скрипт работает через UI Automation и foreground window.
|
|
- Некоторые браузеры/страницы могут скрывать адресную строку или блокировать UIA.
|
|
- Проверьте лог `C:\ProgramData\AWatch-rus\logs\browser-domains-<user>.log`.
|
|
- Убедитесь, что активное окно — поддерживаемый браузер: Edge, Chrome, Brave, Vivaldi, Opera, Firefox.
|
|
|
|
### Сервер недоступен
|
|
|
|
- Проверьте TCP-доступ:
|
|
|
|
```powershell
|
|
Test-NetConnection aw.example.local -Port 5600
|
|
```
|
|
|
|
- Проверьте локально API:
|
|
|
|
```powershell
|
|
Invoke-WebRequest http://aw.example.local:5600/api/0/info
|
|
```
|
|
|
|
- Если нужен HTTPS reverse proxy, задайте `-ServerScheme https`.
|
|
|
|
### Неправильная категоризация домена
|
|
|
|
- Проверьте содержимое `C:\ProgramData\AWatch-rus\web-category-rules.json`.
|
|
- Пользовательские правила должны быть валидным JSON.
|
|
- Один и тот же домен лучше определять только в одной категории.
|
|
- После изменения правил достаточно перезапустить collector или задачу пользователя:
|
|
|
|
```powershell
|
|
Stop-Process -Name powershell -ErrorAction SilentlyContinue
|
|
Start-ScheduledTask -TaskName 'ActivityWatch Launch [CONTOSO_user01]'
|
|
```
|
|
|
|
### ACL сломаны или пользователи удалили runtime-файлы
|
|
|
|
- Запустите:
|
|
|
|
```powershell
|
|
.\windows\hardening-recovery.ps1 -RepairPackage
|
|
```
|
|
|
|
- Если сервер и пользователи уже есть в `deployment-config.json`, дополнительные параметры не нужны.
|
|
|
|
### Ошибка `InvalidVariableReferenceWithDrive` (в строке `Server: http://...`)
|
|
|
|
Симптом:
|
|
|
|
- деплой падает на выводе URL сервера с ошибкой о недопустимой ссылке на переменную.
|
|
|
|
Решение:
|
|
|
|
- обновить скрипты до версии, где используется `${ServerScheme}` в строке вывода;
|
|
- перезалить `deploy-single-user.ps1` / `deploy-domain-users.ps1` на целевой хост.
|
|
|
|
### Ошибка `LogonType InteractiveToken` при регистрации задач
|
|
|
|
Симптом:
|
|
|
|
- `Register-ActivityWatchUserTasks` падает с ошибкой преобразования enum для `LogonType`.
|
|
|
|
Решение:
|
|
|
|
- использовать версию `ActivityWatch.Windows.Common.psm1`, где `LogonType` задан как `Interactive`;
|
|
- повторно запустить deploy/hardening после обновления модуля.
|
|
|
|
## Диагностика
|
|
|
|
### Standalone service не работает
|
|
|
|
Проверить сервис:
|
|
|
|
```powershell
|
|
Get-Service AWatchRusStandaloneAgent
|
|
sc.exe query AWatchRusStandaloneAgent
|
|
```
|
|
|
|
Перезапуск:
|
|
|
|
```powershell
|
|
Restart-Service AWatchRusStandaloneAgent
|
|
```
|
|
|
|
Лог service wrapper:
|
|
|
|
```powershell
|
|
Get-Content C:\ProgramData\AWatch-rus\logs\standalone-agent-service.log -Tail 200
|
|
```
|
|
|
|
Проверить дочерние collector-процессы:
|
|
|
|
```powershell
|
|
Get-CimInstance Win32_Process |
|
|
Where-Object { $_.Name -eq 'powershell.exe' -and $_.CommandLine -like '*AWatch-rus*collector*.ps1*' } |
|
|
Select-Object ProcessId, SessionId, CommandLine
|
|
```
|
|
|
|
Проверить задачи:
|
|
|
|
```powershell
|
|
Get-ScheduledTask -TaskName 'ActivityWatch*' | Select-Object TaskName, State
|
|
```
|
|
|
|
Проверить процессы в пользовательской сессии:
|
|
|
|
```powershell
|
|
Get-Process aw-watcher-afk, aw-watcher-window -ErrorAction SilentlyContinue |
|
|
Select-Object ProcessName, Id, SessionId, StartTime
|
|
```
|
|
|
|
Проверить collector:
|
|
|
|
```powershell
|
|
Get-CimInstance Win32_Process |
|
|
Where-Object { $_.Name -in 'powershell.exe', 'pwsh.exe' -and $_.CommandLine -match 'browser-domains-native-collector.ps1' } |
|
|
Select-Object ProcessId, SessionId, CommandLine
|
|
```
|
|
|
|
Проверить конфиг:
|
|
|
|
```powershell
|
|
Get-Content C:\ProgramData\AWatch-rus\deployment-config.json -Raw
|
|
```
|
|
|
|
## Когда запускать hardening/recovery
|
|
|
|
- После ручной чистки задач.
|
|
- После неудачного обновления ActivityWatch.
|
|
- После переноса сервера на другой host/port.
|
|
- После обновления списка пользователей.
|
|
- После изменения кастомных правил, если нужен централизованный repair pass.
|