Чтобы использовать утилиту DSTrace в среде Linux выполните следующую команду из командной строки сервера:
/opt/novell/eDirectory/bin/ndstrace
Полный синтаксис команды ndstrace:
ndstrace [-l|-u|-c "command1;......"|--version] [-h <local_interface:port>] [--config-file <configuration_file_path>] [thrd <thread ID>] [svty <severity_level>] [conn <connection_ID>]
Утилита DSTrace состоит из трех главных частей.
К основным относятся указанные ниже функции DSTrace.
Просмотр действий eDirectory и сообщений отладки в Linux.
Инициализация процессов ограниченной синхронизации.
Можно использовать утилиту DSTrace в режиме интерфейса пользователя или в режиме командной строки. По умолчанию DSTrace выполняется в режиме интерфейса пользователя. Чтобы запустить DSTrace в режиме интерфейса пользователя, в командной строке сервера введите следующую команду:
/opt/novell/eDirectory/bin/ndstrace
Чтобы запустить DSTrace в режиме командной строки, в командной строке сервера введите следующую команду:
/opt/novell/eDirectory/bin/ndstrace -l
Для инициализации основных функций DSTrace введите команды с консоли сервера, используя следующий синтаксис:
ndstrace command_option
В следующей таблице перечислены параметры команды, доступные для использования.
|
Параметр |
Описание |
|---|---|
|
ON |
Запуск экрана трассировки eDirectory с отображением основных сообщений трассировки. |
|
OFF |
Запрещение отображения экрана трассировки. |
|
ALL |
Запуск экрана трассировки eDirectory и отображение всех сообщений трассировки. |
|
AGENT |
Запуск экрана трассировки eDirectory с отображением сообщений трассировки, эквивалентных флагам ON, BACKLINK, DSAGENT, JANITOR, RESNAME и VCLIENT. |
|
DEBUG |
Включение предопределенного набора сообщений трассировки, обычно используемых для отладки. Устанавливаются следующие флаги: ON, BACKLINK, ERRORS, EMU, FRAGGER, INIT, INSPECTOR, JANITOR, LIMBER, MISC, PART, RECMAN, REPAIR, SCHEMA, SKULKER, STREAMS и VCLIENT. |
|
NODEBUG |
Оставляет включенным экран трассировки, но выключает все предустановленные сообщения отладки. Эта параметр также позволяет оставить сообщения, установленные командной опцией ON. |
Когда экран DSTrace включен, отображаемая информация базируется на установленном по умолчанию наборе фильтров. Если Вы хотите просматривать больше или меньше, чем это установлено по умолчанию, можно настроить фильтры с помощью установки флагов сообщений отладки. Сообщения отладки полезны при определении статуса eDirectory и проверке правильности функционирования системы.
У каждого процесса eDirectory есть набор сообщений отладки. Для просмотра сообщений отладки конкретного процесса используйте знак плюс (+) и имя процесса или опцию. Для запрещения отображения процесса используйте знак минус (-) и имя процесса или опцию. Далее приводятся некоторые примеры.
|
Сообщение |
Описание |
|---|---|
|
set ndstrace = +SYNC |
Разрешение отображения сообщений синхронизации. |
|
set ndstrace = -SYNC |
Запрещение отображения сообщений синхронизации. |
|
set ndstrace = +SCHEMA |
Разрешение отображения сообщений Схемы. |
Вы можете также комбинировать флаги сообщений отладки с помощью логических операторов & (логическое "И" - "AND") и (логическое "ИЛИ" - "OR"). Далее приводятся примеры синтаксиса, с помощью которого с консоли сервера можно контролировать сообщения отладки.
set ndstrace = <trace_flag> [parameter]
В приведенной ниже таблице описываются флаги трассировки сообщений отладки. Допускается вводить аббревиатуры для каждого из флагов трассировки.
|
Флаг трассировки |
Описание |
|---|---|
|
ABUF |
Сообщения и информация, относящиеся к буферам входящих и исходящих пакетов, которые содержат данные, получаемые в запросах к каталогу eDirectory или в ответах от него. |
|
ALOC |
Сообщения, в которых показано распределение памяти. |
|
AREQ |
Сообщения, связанные со входящими запросами от других серверов или клиентов. |
|
AUTH |
Сообщение и отчеты об ошибках, относящиеся к аутентификации. |
|
BASE |
Отладочные сообщения об ошибках на минимальном отладочном уровне. |
|
BLNK |
Сообщение об обратных ссылках и входящих значениях устаревшего состояния, а также отчеты об ошибках. |
|
CBUF |
Сообщения, относящиеся к исходящим запросам клиента DS. |
|
CHNG |
Сообщения изменения кэша. |
|
COLL |
Отчеты о статусе и ошибках, относящиеся к информации обновления объектов, когда это обновление уже было получено ранее. |
|
CONN |
Сообщения, в которых показана информация о серверах, к которым пытается подключиться ваш сервер, а также об ошибках и истечении времени ожидания, что может служить причиной проблем с подключением сервера. |
|
DNS |
Сообщения о процессах интегрированного с eDirectory сервера DNS. |
|
DRLK |
Сообщения, которые относятся к распределенным справочным ссылкам. |
|
DVRS |
Сообщения, в которых отображаются области драйвера DirXML®, на которых может работать eDirectory. |
|
DXML |
Сообщения, в которых отображается подробная информация о событиях DirXML. |
|
FRAG |
Сообщения от модуля NCP™ fragger, который разбивает сообщения eDirectory на сообщения с размером, пригодным для NCP. |
|
IN |
Сообщения, которые относятся к входящим запросам и процессам. |
|
INIT |
Сообщения, которые относятся к инициализации eDirectory. |
|
INSP |
Сообщения, которые относятся к целостности объектов в локальной базе данных исходного сервера. При использовании этого флага возрастают требования к дисковой подсистеме, памяти и процессору исходного сервера. Включайте этот флаг только в случае, если начали появляться поврежденные объекты. |
|
JNTR |
Сообщения, которые относятся к следующим фоновым процессам: janitor, replica synchronization и flat cleaner. |
|
LDAP |
Сообщения, которые относятся к серверу LDAP. |
|
LMBR |
Сообщения, которые относятся к процессу Limber. |
|
LOCK |
Сообщения, которые относятся к использованию и изменению блокировок локальной базы данных исходного сервера. |
|
LOST |
Сообщения, которые относятся к записям журнала. |
|
MISC |
Сообщения из разных источников в eDirectory. |
|
MOVE |
Сообщения от операций по перемещению раздела или перемещению поддерева. |
|
NCPE |
Сообщения, в которых показан сервер, получающий запросы на уровне NCP. |
|
NMON |
Сообщения, которые относятся к iMonitor. |
|
OBIT |
Сообщения от процесса устаревших состояний. |
|
PART |
Сообщения, которые относятся к операциям с разделом от фоновых процессов или от обработки запросов. |
|
PURG |
Сообщение о процессе очистки. |
|
RECM |
Сообщения, которые относятся к изменению базы данных исходного сервера. |
|
RSLV |
Отчеты, которые относятся к обработке разрешения запросов имени. |
|
SADV |
Сообщения, которые относятся к регистрации имен и разделов дерева с использованием Service Location Protocol (SLP). |
|
SCMA |
Сообщения, которые относятся к процессу синхронизации схемы. |
|
SCMD |
Сообщения, в которых показана подробная информация об операциях, относящихся к схеме. Предоставляется подробная информация как о входящей, так и исходящей синхронизации. |
|
SKLK |
Сообщения, которые относятся к процессу синхронизации реплики. |
|
SPKT |
Сообщения, которые относятся к информации уровня сервера eDirectory NCP. |
|
STRM |
Сообщения, которые относятся к обработке атрибутов с синтаксисом потока. |
|
SYDL |
Сообщения, в которых показан более подробная информация во время процесса репликации. |
|
SYNC |
Сообщения о входящем трафике синхронизации (полученные сервером данные). |
|
TAG |
Показывает строку тега, которая определяет параметр трассировки, вызвавший событие в каждой строке, отображенной процессом трассировки. |
|
THRD |
Сообщения, в которых отображается время начала или завершения любых фоновых процессов (потоков). |
|
TIME |
Сообщения о транзитивных векторах, используемых в процессе синхронизации. |
|
TVEC |
Сообщения, которые относятся к следующим атрибутам: Synchronize Up To, Replica Up To, и Transitive Vector. |
|
VCLN |
Сообщения, которые относятся к установке или удалению подключений к другим серверам. |
Работая с сообщениями отладки в DSTrace, вы убедитесь, что некоторые флаги трассировки более полезны, нежели другие. Одним из любимых настроек DSTrace группы техподдержки NetIQ является ярлык:
set ndstrace = A81164B91
Эта настройка включает группу отладочных сообщений.
Кроме отладочных сообщений, помогающих Вам проверить состояние eDirectory, существует набор команд, которые выполняют принудительный запуск фоновых процессов eDirectory. Для принудительного запуска фонового процесса поместите перед командой звездочку (*). Например:
set ndstrace = *H
Кроме того, Вы можете изменить состояние, синхронизацию нескольких фоновых процессов и управление ими. Для изменения этих параметров поместите восклицательный знак (!) перед командой и введите новый параметр или значение. Например:
set ndstrace = !H 15 (parameter_value_in_minutes)
Ниже представлен синтаксис каждого оператора, управляющего фоновыми процессами eDirectory.
set ndstrace = <trace_flag> [parameter]
В следующей таблице перечислены флаги трассировки для фоновых процессов и требуемые для них параметры, а также приведены описания происходящих при этом процессов.
|
Флаг трассировки |
Параметры |
Описание |
|---|---|---|
|
*A |
Нет |
Сброс кэша адресов на исходном сервере. |
|
*AD |
Нет |
Отключение кэша адресов на исходном сервере. |
|
*AE |
Нет |
Включение кэша адресов на исходном сервере. |
|
*B |
Нет |
Планирует запуск на исходном сервере процесса обратной ссылки (backlink) через одну секунду. |
|
!B |
Время |
Устанавливает интервал (в минутах) для процесса backlink. По умолчанию=1500 минут (25 часов) Диапазон=2 до 10080 минут (168 часов) |
|
*CT |
Нет |
Отображает таблицу исходящих соединений исходного сервера и текущую статистическую информацию для этой таблицы. Эта статистика не дает какой-либо информации о входящих соединениях, поступающих на сервер от других серверов или клиентов. |
|
*CTD |
Нет |
Отображает таблицу (с использованием запятой в качестве разделителя) исходящих соединений исходного севера и текущую статистическую информацию для этой таблицы. Эта статистика не дает какой-либо информации о входящих соединениях, поступающих на сервер от других серверов или клиентов. |
|
*D |
ИД корневого элемента (rootEntry) реплики |
Удаляет указанный ИД локального элемента из списка объекта "Отправить всем" исходного сервера. ИД элемента должен указывать объект корня раздела, относящийся к локальной базе данных сервера. Данная команда обычно используется только в случае, когда процесс "Send All Updates (Отправить обновления всем)" не прекращает попытки показать обновления, которые не удается выполнить из-за недоступности сервера. |
|
!D |
Время |
Устанавливает значение интервала входящей и исходящей синхронизации в соответствии с указанным количеством минут. По умолчанию=24 минуты. Диапазон=от2 до 10080 минут (168 часов) |
|
!DI |
Время |
Устанавливает значение интервала входящей синхронизации в соответствии с указанным количеством минут. По умолчанию=24 минуты Диапазон=от 2 до 10080 минут (168 часов) |
|
!DO |
Время |
Устанавливает значение интервала исходящей синхронизации в соответствии с указанным количеством минут. По умолчанию=24 минуты Диапазон=от 2 до 10080 минут (168 часов) |
|
*E |
Нет |
Повторная инициализация кэша элементов исходного сервера. |
|
!E |
Нет |
Планирует начало запуска процессов входящей и исходящей синхронизации. |
|
!EI |
Нет |
Планирует начало запуска процесса входящей синхронизации. |
|
!EO |
Нет |
Планирует начало запуска процесса исходящей синхронизации. |
|
*F |
Нет |
Планирует запуск на исходном сервере процесса Flat Cleaner, который является частью процесса janitor, через 5 секунд. |
|
!F |
Время |
Устанавливает интервал (в минутах) для процесса Flat Cleaner. По умолчанию=240 минут (4 часа) Диапазон=2 до 10080 минут (168 часов) |
|
*FL |
1-10 |
Задает количество последовательных файлов журнала, которые используются процессом DSTrace. Если задать этому параметру любое значение больше 1, то после того как размер файла ndstrace.log на исходном сервере достигнет настроенного максимального предела, DSTrace переименует файл ndstrace1.log и создать новый файл ndstrace.log. Когда размер файла достигнет максимального, предыдущий файл ndstrace1.log переименовывается в ndstrace2.log, а более новый файл ndstrace.log переименовывается в ndstrace1.log. Этот процесс продолжается до тех пор, пока DSTrace не достигнет максимального количества последовательных файлов журнала, которые задаются этим параметром. После достижения указанного лимита, самые старые файлы журнала будут удалены. Будет поддерживаться только максимальное количество последовательных файлов. Можно настроить не более 10 последовательных файлов журнала. По умолчанию в DSTrace должен использоваться хотя бы 1 последовательный файл журнала. Если задать этому параметру значение 0, DSTrace использует значение 1 в качестве значения параметра. |
|
*G |
ИД корневого элемента (rootEntry) реплики |
Заново создает кэш изменений указанного ИД корневого раздела. |
|
*H |
Нет |
Планирует немедленный запуск процесса синхронизации реплик на исходном сервере. |
|
!H |
Время |
Устанавливает интервал (в минутах) для процесса синхронизации "heartbeat". По умолчанию=30 минут Диапазон=от 2 до 1440 минут (24 часа) |
|
*HR |
Нет |
Удаляет из памяти последний отправленный вектор. |
|
*I |
ИД корневого элемента (rootEntry) реплики |
Добавляет указанный ИД локальной записи в список объекта "Отправить всем" исходного сервера. ИД элемента должен указывать объект корня раздела, относящийся к локальной базе данных сервера. В процессе синхронизации реплик происходит проверка списка объекта "Отправить всем". Если ИД элемента объекта корневого раздела имеется в списке, eDirectory синхронизирует все объекты и атрибуты в разделе, независимо от значения атрибута синхронизации реплики. |
|
!I |
Время |
Устанавливает интервал (в минутах) для процесса синхронизации "heartbeat". По умолчанию=30 минут Диапазон=от 2 до 1440 минут (24 часа) |
|
*J |
Нет |
Планирует запуск на исходном сервере процесса очистки, который является частью процесса синхронизации реплик. |
|
!J |
Время |
Устанавливает интервал (в минутах) для процесса janitor. По умолчанию=2 минуты Диапазон=от 1 до 10080 минут (168 часов) |
|
*L |
Нет |
Планирует выполнение на исходном сервере процесса limber через 5 секунд. |
|
*M |
Байты |
Изменяет максимальный размер файла, используемый файлом журнала ndstrace.log исходного сервера. Эту команду можно использовать независимо от состояния файла отладки. Для данного параметра нужно указать значение между 10000 байтами и 100 МБ. Если указанное значение находится за пределами интервала, изменение не выполняется. |
|
!M |
Нет |
Создает отчет о максимальной памяти, используемой eDirectory. |
|
!N |
0|1 |
Устанавливает формат имени. 0=только шестнадцатиричный формат 1=форма полной точки |
|
*P |
Нет |
Отображение настраиваемых параметров и их значений по умолчанию. |
|
*R |
Нет |
Сбрасывает размер файла ndstrace.log в нуль байт. Данная команда аналогична параметру SET "NDS Trace File Length Set to Zero". |
|
*S |
Нет |
Планирование процесса Skulker, который проверяет, нужно ли синхронизировать какие-либо реплики на сервере. |
|
!SI |
Время |
Устанавливает интервал (в минутах) для процесса входящей синхронизации схемы. По умолчанию=24 минуты Диапазон=от 2 до 10080 минут (168 часов) |
|
!SO |
Время |
Устанавливает интервал (в минутах) для процесса исходящей синхронизации схемы. По умолчанию=24 минуты Диапазон=от 2 до 10080 минут (168 часов) |
|
!SIO |
Время |
Запрещает процесс входящей синхронизации в течение указанного количества минут. По умолчанию=24 минуты Диапазон=от 2 до 10080 минут (168 часов) |
|
!SO0 |
Время |
Запрещает процесс входящей синхронизации в течение указанного количества минут. По умолчанию=24 минуты Диапазон=от 2 до 10080 минут (168 часов) |
|
*SS |
Нет |
Принудительная немедленная синхронизация Схемы. |
|
*SSA |
Нет |
Планирует немедленный запуск процесса синхронизации Схемы и вызывает синхронизацию Схемы на всех целевых серверах, даже если они были синхронизированы в течение последних 24 часов. |
|
*SSD |
Нет |
Сбрасывает список целей синхронизации схемы исходного сервера. Этот список определяет, с какими серверами должен синхронизироваться исходный сервер во время выполнения процесса синхронизации Схемы. Сервер, не содержащий ни одной реплики, отправляет запрос на включение его в целевой список серверов, содержащих реплики с его объектом "Сервер". |
|
*SSL |
Нет |
Отображает список синхронизации Схемы целевых серверов. |
|
*ST |
Нет |
Отображает информацию о статусе фоновых процессов на исходном сервере. |
|
*STX |
Нет |
Отображает информацию о статусе процесса обратной ссылки backlink (внешние ссылки) на исходном сервере. |
|
*STS |
Нет |
Отображает информацию о статусе процесса синхронизации схемы на исходном сервере. |
|
*STO |
Нет |
Отображает информацию о статусе процесса обратной ссылки backlink (значения устаревшего состояния) на исходном сервере. |
|
*STL |
Нет |
Отображает информацию о статусе процесса limber на исходном сервере. |
|
!T |
Время |
Устанавливает интервал (в минутах) для проверки состояния работоспособности севера. По умолчанию=30 минут Диапазон=от 1 до 720 минут (12 часов) |
|
*U |
Дополнительный ИД сервера |
Если команда не содержит ИД элемента, она изменяет статус любого ранее отмеченного сервера с закрытого (down) на открытый (up). Если команда содержит ИД локального элемента, она изменяет статус указанного сервера с выключен на включен. ИД элементов являются специфическими для базы данных исходного сервера и должны указывать на объект, представляющий сервер. |
|
!V |
Список |
Выводит список версий eDirectory, ограниченных для использования. Если ни одна версия не выведена, это означает, что ограничений на использование нет. Каждая версия отделяется запятой. |
|
*Z |
Нет |
Отображает текущие запланированные задачи. |