Para usar o utilitário DSTrace em um ambiente Linux, execute o seguinte comando no prompt do servidor:
/opt/novell/eDirectory/bin/ndstrace
A sintaxe completa do comando ndstrace é a seguinte:
ndstrace [-l|-u|-c "command1;......"|--version] [-h <local_interface:port>] [--config-file <configuration_file_path>] [thrd <thread ID>] [svty <severity_level>] [conn <connection_ID>]
O utilitário DSTrace tem três partes principais:
As funções básicas do DSTrace destinam-se a:
Visualizar a atividade interna do eDirectory e mensagens de depuração no Linux.
Iniciar processos de sincronização imediata.
Você pode usar o utilitário DSTrace no modo UI ou no modo de linha de comando. Por padrão, o DSTrace é executado em modo UI. Para reiniciar o DSTrace no modo de UI, digite o comando a seguir no prompt de comando:
/opt/novell/eDirectory/bin/ndstrace
Para iniciar o DSTrace no modo de linha de comando, digite o seguinte no prompt de comando:
/opt/novell/eDirectory/bin/ndstrace -l
Para iniciar as funções básicas do DSTrace, digite os comandos no prompt do servidor usando a seguinte sintaxe:
ndstrace command_option
A tabela a seguir lista as opções de comando que podem ser digitadas.
Opção |
Descrição |
---|---|
ATIVADO |
Inicia a tela de rastreio do eDirectory com mensagens básicas de rastreio. |
DESATIVADO |
Desabilita a tela de seguimento. |
TODAS |
Inicia a tela de rastreio do eDirectory e exibe todas as mensagens de rastreio. |
AGENT |
Inicia a tela de rastreio do eDirectory com as mensagens de seguimento equivalentes aos flags ON, BACKLINK, DSAGENT, JANITOR, RESNAME e VCLIENT. |
DEBUG |
Ativa uma configuração predefinida das mensagens de seguimento usadas geralmente para depurar. Os flags configurados são ON, BACKLINK, ERRORS, EMU, FRAGGER, INIT, INSPECTOR, JANITOR, LIMBER, MISC, PART, RECMAN, REPAIR, SCHEMA, SKULKER, STREAMS e VCLIENT. |
NODEBUG |
Habilita a tela do seguimento, mas desabilita todas as mensagens de depuração configuradas anteriormente. Esta opção também deixa as mensagens configuradas para a opção de comando ON. |
Quando a tela DSTrace for habilitada, as informações exibidas terão base em uma configuração padrão de filtros. Se você quiser ver mais ou menos que o padrão, pode manipular os filtros usando os flags de mensagem de depuração. As mensagens de depuração ajudam a determinar o status do eDirectory e verificar se tudo está funcionando bem.
Cada processo do eDirectory tem um conjunto de mensagens de depuração. Para ver as mensagens de depuração em um determinado processo, use um sinal de mais (+) e o nome ou a opção do processo. Para desabilitar a exibição de um processo, use um sinal de menos (-) e o nome ou a opção do processo. Veja a seguir alguns exemplos:
Mensagem |
Descrição |
---|---|
set ndstrace = +SYNC |
Habilita as mensagens de sincronização. |
set ndstrace = -SYNC |
Desabilita as mensagens de sincronização. |
set ndstrace = +SCHEMA |
Habilita as mensagens de esquema. |
Você pode também combinar os flags de mensagem de depuração usando os operadores Booleanos & (que significa E) e &; (que significa OU). A sintaxe para controlar as mensagens de depuração no console do servidor são as seguintes:
set ndstrace = <trace_flag> [parameter]
A tabela a seguir descreve os flags de seguimento das mensagens de depuração. É possível inserir abreviações para cada flag de seguimento.
Flag do Seguimento |
Descrição |
---|---|
ABUF |
Mensagens e informações relacionadas a buffers do pacote de entrada e de saída que contêm os dados que são recebidos em conjunto com, ou em resposta a, uma solicitação do eDirectory. |
ALOC |
Mensagens mostrando detalhes da alocação de memória. |
AREQ |
Mensagens relacionadas a solicitações de entrada de outros servidores ou clientes. |
AUTH |
Mensagens e relatórios de erro relacionados à autenticação. |
BASE |
Mensagens de erro de depuração no nível de depuração mínimo. |
BLNK |
Backlink, mensagens de obituário de entrada e relatórios de erro. |
CBUF |
Mensagens relacionadas a solicitações de cliente DS de saída. |
CHNG |
Mensagens de cache de alteração. |
COLL |
Relatórios de status e erro relativos às informações de atualização de um objeto quando a atualização tiver sido recebida anteriormente. |
CONN |
Mensagens que mostram informações sobre os servidores com os quais você está tentando se conectar e sobre os erros e tempo de espera que podem fazer com que o servidor não seja conectado. |
DNS |
Mensagens sobre os processos do servidor DNS integrado ao eDirectory. |
DRLK |
Mensagens de link de referência distribuída. |
DVRS |
Mensagens para mostrar áreas específicas do driver DirXML® nas quais o eDirectory pode estar trabalhando. |
DXML |
Mensagens que mostram detalhes de eventos DirXML. |
FRAG |
Mensagens do fragmentador NCP™ que quebra as mensagens do eDirectory em mensagens com tamanho do NCP. |
IN |
Mensagens relacionadas a solicitações e processos de entrada. |
INIT |
Mensagens relacionadas à inicialização do eDirectory. |
INSP |
Mensagens relacionadas à integridade de objetos no banco de dados local do servidor de origem. O uso desse flag aumenta as demandas no processador, na memória e no sistema de armazenamento em disco do servidor de origem. Não deixe esse flag habilitado, a menos que os objetos estejam sendo corrompidos. |
JNTR |
Mensagens relacionadas aos seguintes processos em segundo plano: janitor, sincronização de réplica e limpeza. |
LDAP |
Mensagens relacionadas ao servidor do LDAP. |
LMBR |
Mensagens relacionadas ao processo de limber. |
LOCK |
Mensagens relacionadas ao uso e manipulação de bloqueios do banco de dados local do servidor de origem. |
LOST |
Mensagens relacionadas às entradas perdidas. |
MISC |
Mensagens de diferentes origens no eDirectory. |
MOVE |
Mensagens das operações mover partição ou mover subárvore. |
NCPE |
Mensagens para mostrar as solicitações de nível NCP recebidas pelo servidor. |
NMON |
Mensagens relacionadas ao iMonitor. |
OBIT |
Mensagens do processo obituário. |
PART |
Mensagens relacionadas a operações de partição de processos em segundo plano e de processamento de solicitação. |
PURG |
Mensagens sobre o processo de purga. |
RECM |
Mensagens relacionadas à manipulação do banco de dados do servidor de origem. |
RSLV |
Relatórios relacionados ao processamento das solicitações de resolução de nome. |
SADV |
Mensagens relacionadas ao registro de nomes de árvore e partições com o SLP (Service Location Protocol). |
SCMA |
Mensagens relacionadas ao processo de sincronização de esquema. |
SCMD |
Mensagens mostrando os detalhes de operações relacionadas ao esquema. Fornecem detalhes da sincronização de entrada e de saída. |
SKLK |
Mensagens relacionadas ao processo de sincronização de réplica. |
SPKT |
Mensagens relacionadas a informações no nível do servidor de NCP do eDirectory. |
STRM |
Mensagens relacionadas ao processamento de atributos com sintaxe de fluxo. |
SYDL |
Mensagens mostrando mais detalhes durante o processo de replicação. |
SYNC |
Mensagens sobre o tráfego de sincronização de entrada (que é recebido pelo servidor). |
TAGS |
Exibe a string de tag que identifica a opção de rastreio que gerou o evento em cada linha exibida pelo processo de rastreio. |
THRD |
Mensagens mostradas quando algum processo em segundo plano (threads) for iniciado e encerrado. |
TIME |
Mensagens sobre vetores transitivos que são utilizados durante o processo de sincronização. |
TVEC |
Mensagens relacionadas aos seguintes atributos: Sincronizar até, Replicar até e Vetor transitivo. |
VCLN |
Mensagens relacionadas ao estabelecimento ou exclusão de conexões com outros servidores. |
Assim que usar as mensagens de depuração no DSTrace, você verá que alguns dos flags de seguimento são mais úteis que outros. Uma das configurações favoritas do DSTrace do suporte técnico da NetIQ é um atalho:
set ndstrace = A81164B91
Esta configuração habilita um grupo de mensagens de depuração.
Além das mensagens de depuração que ajudam a verificar o status do eDirectory, há um conjunto de comandos que força a execução dos processos em segundo plano no eDirectory. Para forçar a execução do processo de background, coloque um asterisco (*) antes do comando. Por exemplo:
set ndstrace = *H
É possível também mudar o status, a sincronização e controlar alguns processos de background. Para mudar estes valores, coloque um ponto de exclamação (!) antes do comando e insira um parâmetro ou valor novo. Por exemplo:
set ndstrace = !H 15 (parameter_value_in_minutes)
Veja a seguir a sintaxe de cada demonstração que controla os processos de background do eDirectory:
set ndstrace = <trace_flag> [parameter]
A tabela a seguir lista os flags de seguimento dos processos de background, qualquer parâmetro necessário e o processo que os flags de seguimento irão exibir.
Flag do Seguimento |
Parâmetros |
Descrição |
---|---|---|
*A |
Nenhum |
Redefine o cache do endereço no servidor de origem. |
*AD |
Nenhum |
Desabilita o cache do endereço no servidor de origem. |
*AE |
Nenhum |
Habilita o cache do endereço no servidor de origem. |
*B |
Nenhum |
Programa o processo de backlink para iniciar a execução no servidor de origem em um segundo. |
!B |
Horário |
Define o intervalo (em minutos) para o processo backlink. Padrão=1500 minutos (25 horas) Intervalo=2 a 10080 minutos (168 horas) |
*CT |
Nenhum |
Exibe a tabela de conexão de saída e as informações estatísticas atuais do servidor de origem para a tabela. Essas estatísticas não fornecem nenhuma informação sobre as conexões de entrada de outros servidores ou clientes para o servidor de origem. |
*CTD |
Nenhum |
Exibe, em formato delimitado por vírgula, a tabela de conexão de saída e as informações estatísticas atuais do servidor de origem para a tabela. Essas estatísticas não fornecem nenhuma informação sobre as conexões de entrada de outros servidores ou clientes para o servidor de origem. |
*D |
Réplica rootEntry ID |
Remove o ID de entrada local especificado da lista do servidor de origem Enviar todos os objetos. O ID de entrada deve especificar um objeto Raiz da partição que seja específico para o banco de dados local do servidor. Esse comando é utilizado geralmente quando o processo Enviar todas as atualizações estiver tentando infinitamente mostrar atualizações e falha porque um servidor não pode ser acessado. |
!D |
Horário |
Define o intervalo de sincronização de entrada e saída para o número especificado de minutos. Padrão=24 minutos. Intervalo=2 a 10080 minutos (168 horas) |
!DI |
Horário |
Define o intervalo de sincronização de entrada para o número especificado de minutos. Padrão=24 minutos Intervalo=2 a 10080 minutos (168 horas) |
!DO |
Horário |
Define o intervalo de sincronização de saída para o número especificado de minutos. Padrão=24 minutos Intervalo=2 a 10080 minutos (168 horas) |
*E |
Nenhum |
Reinicializa o cache de entrada do servidor de origem. |
!E |
Nenhum |
Programa os processos de sincronização de entrada e saída para iniciar a execução. |
!EI |
Nenhum |
Programa o processo de sincronização de entrada para iniciar a execução. |
!EO |
Nenhum |
Programa o processo de sincronização de saída para iniciar a execução. |
*F |
Nenhum |
Programa o processo de limpeza, que faz parte do processo janitor, para iniciar a execução do servidor de origem em cinco segundos. |
!F |
Horário |
Define o intervalo (em minutos) para o processo de limpeza. Padrão=240 minutos (4 horas) Intervalo=2 a 10080 minutos (168 horas) |
*FL |
1-10 |
Define o número de arquivos de registro sequenciais usados pelo DSTrace. Se você definir este parâmetro para qualquer valor maior que 1, após o arquivo ndstrace.log do servidor de origem atingir o tamanho de arquivo máximo configurado, o DSTrace renomeia o arquivo como ndstrace1.log e cria um novo ndstrace.log. Quando o arquivo atinge seu tamanho máximo, o ndstrace1.log anterior é renomeado como ndstrace2.log e o ndstrace.log mais recente é renomeado como ndstrace1.log. Este processo continua até que o DSTrace atinja o número máximo de arquivos de registro sequenciais definido por esta opção. Após o limite especificado ser atingido, os arquivos de registro mais antigos são excluídos e apenas o número máximo especificado de arquivos sequenciais será mantido. É possível configurar um máximo de 10 arquivos de registro sequenciais. Por padrão, o DSTrace deve usar pelo menos 1 arquivo de registro sequencial. Se este parâmetro for definido para 0, o DSTrace usa 1 como valor de parâmetro. |
*G |
Réplica rootEntry ID |
Reconstrói o cache de mudança do ID da partição raiz especificada. |
*H |
Nenhum |
Programa o processo de sincronização da réplica para iniciar a execução imediatamente no servidor de origem. |
!H |
Horário |
Define o intervalo (em minutos) para o processo de sincronização de heartbeat. Padrão=30 minutos Intervalo=2 a 1440 minutos (24 horas) |
*HR |
Nenhum |
Apaga o último vetor enviado da memória. |
*I |
Réplica rootEntry ID |
Adiciona o ID de entrada local especificado à lista do servidor de origem Enviar todos os objetos. O ID de entrada deve especificar um objeto Raiz da partição que seja específico para o banco de dados local do servidor. O processo de sincronização de réplica verifica a lista Enviar todos os objetos. Se o ID de entrada de um objeto Raiz da partição estiver na lista, o eDirectory sincronizará todos os objetos e atributos na partição, independente do valor do atributo Sincronizado até. |
!I |
Horário |
Define o intervalo (em minutos) para o processo de sincronização de heartbeat. Padrão=30 minutos Intervalo=2 a 1440 minutos (24 horas) |
*J |
Nenhum |
Programa o processo de purgação que faz parte do processo de sincronização de réplica para iniciar a execução no servidor de origem. |
!J |
Horário |
Define o intervalo (em minutos) para o processo janitor. Padrão=2 minutos Intervalo=1 a 10080 minutos (168 horas) |
*L |
Nenhum |
Programa o processo limber para iniciar a execução no servidor de origem em cinco segundos. |
*M |
Bytes |
Muda o tamanho máximo do arquivo utilizado pelo arquivo ndstrace.log do servidor de origem. O comando pode ser utilizado, independente do estado do arquivo de depuração. Os bytes especificados deve ser um valor decimal entre 10000 bytes e 100 MB. Se o valor especificado for superior ou inferior à faixa especificada, nenhuma mudança ocorrerá. |
!M |
Nenhum |
Relata a memória máxima utilizada pelo eDirectory. |
!N |
0|1 |
Define o formato do nome. 0=apenas hexagonal 1=formulário de ponto completo |
*P |
Nenhum |
Exibe os parâmetros tunable e sua configuração padrão. |
*R |
Nenhum |
Reinicia o tamanho do arquivo ndstrace.log para zero byte. Este comando é o mesmo que o parâmetro SET NDS Trace File Length Set to Zero. |
*S |
Nenhum |
Programa o processo de Skulker, que verifica se alguma das réplicas no servidor precisa ser sincronizada. |
!SI |
Horário |
Define o intervalo (em minutos) para o processo de sincronização de esquema de entrada. Padrão=24 minutos Intervalo=2 a 10080 minutos (168 horas) |
!SO |
Horário |
Define o intervalo (em minutos) para o processo de sincronização de esquema de saída. Padrão=24 minutos Intervalo=2 a 10080 minutos (168 horas) |
!SIO |
Horário |
Desabilita o processo de sincronização de esquema de entrada para o número especificado de minutos. Padrão=24 minutos Intervalo=2 a 10080 minutos (168 horas) |
!SO0 |
Horário |
Desabilita o processo de sincronização de esquema de entrada para o número especificado de minutos. Padrão=24 minutos Intervalo=2 a 10080 minutos (168 horas) |
*SS |
Nenhum |
Força a sincronização imediata do esquema. |
*SSA |
Nenhum |
Programa o processo de sincronização do esquema a ser iniciado imediatamente e força a sincronização do esquema com todos os servidores de destino, mesmo se tiverem sido sincronizados nas últimas 24 horas. |
*SSD |
Nenhum |
Redefine a lista Sincronização do esquema de destino do servidor de origem. Essa lista identifica os servidores com os quais o servidor de origem deve sincronizar durante o processo de sincronização de esquema. Um servidor que não mantém nenhuma réplica envia uma solicitação a ser incluída na lista de destino de um servidor que contém uma réplica com seu objeto Servidor. |
*SSL |
Nenhum |
Imprime a lista de sincronização de esquema dos servidores de destino. |
*ST |
Nenhum |
Exibe informações de status para os processos em segundo plano no servidor de origem. |
*STX |
Nenhum |
Exibe informações de status para os processos de backlink (referências externas) no servidor de origem. |
*STS |
Nenhum |
Exibe informações de status para os processos de sincronização de esquema no servidor de origem. |
*STO |
Nenhum |
Exibe informações de status para o processo de backlink (obituários) no servidor de origem. |
*STL |
Nenhum |
Exibe informações de status para o processo limber no servidor de origem. |
!T |
Horário |
Define o intervalo (em minutos) para verificar o estado ATIVO do servidor. Padrão=30 minutos Intervalo=1 a 720 minutos (12 horas) |
*U |
ID opcional do servidor |
Se o comando não incluir um ID de entrada, mude o status de qualquer servidor que tenha sido identificado anteriormente como inativo para ativo. Se o comando incluir um ID de entrada local, mude o status do servidor especificado de inativo para ativo. Os IDs de entrada são específicos para o banco de dados do servidor de origem e devem fazer referência a um objeto que representa um servidor. |
!V |
Uma lista |
Lista as versões restritas do eDirectory. Se nenhuma versão for relacionada, não haverá restrições. Cada versão é separada por uma vírgula. |
*Z |
Nenhum |
Exibe as tarefas atualmente programadas. |