Откройте файлnlog.configв текстовом редакторе, например, в Блокноте, запущенном от имени администратора, и измените значение параметраminlevelсOffнаTrace:
Перейдите в каталогlogs, расположенный в каталоге сервиса, и удалите существующие логи.
Воспроизведите проблему.
Вернитесь в каталогlogs, расположенный в каталоге сервиса, и убедитесь, что в нем появились подкаталоги с файлами отладочной информации.
Пришлите каталогlogsсо всем его содержимым на адрес службы Технической поддержки с описанием проблемы.
Для отключения логирования измените значение параметраminlevelсTrace наOffи сохраните изменения в файле.
Клиентские компоненты
Утилита CM GetLog предназначена для локального и удаленного сбора программных логов следующих компонентов:
Rutoken KeyBox Middleware;
Rutoken KeyBox Client Tools;
Rutoken KeyBox Agent.
Для работы утилиты CM GetLog необходимы права локального администратора. На операционных системах Windows Vista и выше утилита запускается от имени администратора (Run As Administrator).
Запустите приложениеCm.GetLog.zip из каталога GetLog дистрибутива Rutoken KeyBox. Выполните следующие действия:
Подключитесь к компьютеру. Для этого введитеlocalhostв поле Computerдля подключения к локальному компьютеру или имя/IP-адрес удаленного компьютера для подключения к удаленному компьютеру. Нажмите Connect.
Для установки подключения к удаленному компьютеру под управлением Windows Vista и выше убедитесь, что на удаленном компьютере запущена и не заблокирована служба Инструментарий управления Windows (WMI)(Windows Management Instrumentation).
НажмитеEnable Log, чтобы включить логирование.
Воспроизведите проблему.
Нажмите Disable Log, чтобы отключить логирование.
Нажмите Get Log..., чтобы получить логи.
Укажите каталог для сохранения zip-архива и нажмите Сохранить.
Нажмите Disconnect, чтобы отключиться от компьютера.
Отправьте логи в службу Технической поддержки с подробным описанием действий пользователя и указанием точного времени воспроизведения проблемы.
По умолчанию логи пишутся в каталог C:\Windows\System32\LogFiles\cm. Для доступа к лог-файлам удаленного компьютера по умолчанию используется сетевой каталог ADMIN$\System32\LogFiles\cm. Каталог для записи логов задается опцией Use alternative location в разделе Advanced Settings.
В окнеAdvanced Settingsдоступны следующие настройки:
Настройка
Описание
Max. log size (bytes)
Максимальный размер в байтах всех файлов в каталоге. Значение по умолчанию – 1Гб. При достижении максимального размера содержимое каталога будет автоматически удалено, за исключением файлов логов, время изменения которых не превышает значение поля Max. log file age
Max. log file age (s)
"Возраст" файла лога в секундах. Если размер логов в каталоге превысил значение Max. log size, то из каталога будут удалены все файлы, дата изменения которых старше значения Max.log file age. Например: максимальный размер всех логов в каталогеLogFiles\cmравен 1Гб (Max.log size (bytes) = 1000000000), а возраст файла лога - 24 часа (Max.log file age (s) = 86400). Когда размер папки с логами превысит 1Гб, то из нее удалятся все файлы, кроме тех, что были записаны за последние сутки
Cleaner interval (s)
Интервал проверки размера каталога с логами в секундах. Значение по умолчанию – 1 час (3600 секунд)
Activity checking period (ms)
Интервал проверки активности логирования в миллисекундах. Перед началом записи логов клиентский компонент проверит, включено ли логирование на рабочей станции. По умолчанию интервал проверки составляет 1 минуту (60 000миллисекунд)
Enable log cycling
Режим циклической записи логов. Если опция включена, то логи каждого процесса будут записываться согласно заданным настройкам по количеству файлов и размеру.
-Max. size of a log file (bytes) – максимальный размер лог-файла в байтах. Значение по умолчанию – 10Мб (1000000 байт). При достижении заданного размера содержимое файла перезапишется новыми данными. -Max. number of saved log files – максимальное количество сохраняемых лог-файлов. Значение по умолчанию – 5, без учета текущего записываемого файла. Если установленное количество файлов превышено, самый старый файл удалится, и логи будут записываться в новый файл
Use alternative location
Альтернативный каталог записи логов. Если опция выключена, логи записываются в каталоги по умолчанию: - локальный путь: \WINDOWS\System32\LogFiles\cm, - сетевой путь:ADMIN$\System32\LogFiles\cm
При подключении к удаленному компьютеру:
Ошибка
Причина
Решение
0x800706BA The RPC server is unavailable
На удаленном компьютере под управлением Windows Vista и выше остановлена или заблокирована службаИнструментарий управления Windows(WMI) (Windows Management Instrumentation)
Запустите службу WMI: 1. ВПанели управления(Control Panel) выберитеБрандмауэр Windows(Windows Firewall)→Разрешение взаимодействия с приложением или компонентом в брандмауэре Windows(Allow a program or feature through Windows Firewall). 2. НажмитеИзменить параметры(Change Settings) и включите опциюИнструментарий управления Windows(Windows Management Instrumentation (WMI)
0x000004B3 No network provider accepted the given network path
Удаленный компьютер недоступен по сети
Проверьте параметры сетевого подключения
При подключении к локальному компьютеру:
Ошибка
Причина
Решение
80070005 Access is denied или The network path is not accessible. Access is denied
У пользователя, под учетной записью которого запущена утилита CM GetLog, нет прав на чтение и/или изменение ветки реестра Windows с параметрами записи логов
Предоставьте учетной записи пользователя необходимые права на ветку реестра: 1. ВРедакторе реестраWindows (Registry Editor) раскройте ветку реестраHKEY_LOCAL_MACHINE\SOFTWARE\Cm 2. Выберите узелLogging, вызовите правой кнопкой мыши контекстное меню и выберите пунктРазрешения(Permissions). 3. В диалогеРазрешения на логирование(Permissions for Logging) нажмитеДобавить(Add) и выберите нужную учетную запись. 4. Предоставьте выбранной учетной записи праваПолный контроль(Full Control) иЧтение(Read). 5. НажмитеПрименить(Apply). Чтобы изменения в правах вступили в силу, пользователю необходимо выйти из системы и выполнить повторный вход
У пользователя нет прав на запись в каталог сохранения логов
Предоставьте учетной записи пользователя необходимые права в указанном каталоге
При сохранении логов:
Ошибка
Причина
Решение
0x80070035 The network path was not found
Недоступен сетевой каталог, используемый для доступа к лог-файлам (по умолчанию используется каталогADMIN$\System32\LogFiles)
Проверьте параметры доступа к сетевому каталогу
0x80070003 The system cannot find the file specified
Неверно указан путь к сетевому каталогу для сохранения файлов
Укажите правильный сетевой путь
Логи Rutoken KeyBox Middleware, установленного на ОС Linux, записываются в каталог tmp/cm/logs.
Очистите существующие логи Rutoken KeyBox Middleware в каталоге /tmp/cm/logs.
Воспроизведите проблему.
Отправьте новые логи в службу Технической поддержки с подробным описанием действий пользователя и указанием точного времени воспроизведения проблемы.
Инсталляторы
Все инсталляторы Rutoken KeyBox для ОС Windows представляют собой msi-пакеты. Отладочные логи для msi-пакетов можно получить стандартными средствами Windows Installer, запустив установку через командную строку с определенными параметрами.
Формат команды для запуска msi-пакета с записью логов:
После завершения работы инсталлятора файл с логами с подробным описанием проблемы необходимо передать в службу Технической поддержки.
Примеры запуска
msiexec /i RutokenKeyBox.Client.Tools-<номер версии>.x64.ru-ru.msi /lv log.txt
Данная команда запускает установочный пакет Rutoken KeyBox Client Tools из текущей папки. Логи инсталлятора пишутся в файл log.txt, который расположен в этой же папке.
msiexec /i D:\CM.Client\RutokenKeyBox.Client.Tools-<номер версии>.x64.ru-ru.msi /lv C:\install_log.txt
Данная команда запускает установочный пакет Rutoken KeyBox Client Tools из папки D:\CM.Client. Логи инсталлятора пишутся в файл install_log.txt, который расположен в корне диска C.
Если вам необходимо собрать логи инсталлятора при установке компонента через групповые политики, и у вас нет возможности задать параметры командной строки, включите логи Windows Installer с помощью ключа в реестре:
чтобы включить логирование, в ветке реестраHKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installerсоздайте ключ Reg_SZ: Logging с значением voicewarmupx;
чтобы выключить логирование, задайте пустое значение ключа Logging.
Включить и выключить отладочные логи инсталляторов Rutoken KeyBox можно с помощью файлов REG, которые входят в состав дистрибутива и находятся в папке\GetLog\Regfiles (файлы MSI logs On.reg и MSI logs Off.reg):
чтобы включить запись отладочных логов инсталляторов на рабочей станции, запустите файл MSI logs On.reg;
чтобы выключить запись отладочных логов инсталляторов на рабочей станции, запустите файлMSI logs Off.reg.
Файл с логами сохраняется в папкуTemp. Имя нового файла журнала выбирается произвольно, но начинается с буквMsiи заканчивается расширением LOG. Чтобы определить местоположение папкиTemp, введите в командную строку следующую команду: