16.7 Использование DSTrace

Чтобы использовать утилиту 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 состоит из трех главных частей.

16.7.1 Основные функции

К основным относятся указанные ниже функции 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.

16.7.2 Отладочные сообщения

Когда экран 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

Эта настройка включает группу отладочных сообщений.

16.7.3 Фоновые процессы

Кроме отладочных сообщений, помогающих Вам проверить состояние 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

Нет

Отображает текущие запланированные задачи.