Ferramenta dumpNameSpace
Você pode utilizar a ferramenta dumpNameSpace para fazer dump do conteúdo de um espaço de nomes acessado por um servidor de nomes. A ferramenta dumpNameSpace baseia-se em JNDI (Java™ Naming and Directory Interface).
Ao executar a ferramenta dumpNameSpace, o serviço de nomenclatura deve estar ativo. A ferramenta dumpNameSpace não pode fazer dump de espaços de nomes locais para o processo do servidor, como aqueles com esquemas de URL java: e local:. O espaço de nomes local: contém referências a enterprise beans com interfaces locais. Use o utilitário de dump dos espaços de nomes java:, local: e do servidor para fazer dump dos espaços de nomes java: e local:.
A ferramenta faz dump do contexto raiz do servidor para o servidor no host e porta especificados, a menos que você especifique um contexto de início não padrão anterior. A ferramenta não faz dump dos contextos raiz do servidor para outros servidores.

Executando dumpNameSpace
É possível executar a ferramenta de uma linha de comandos ou utilizando a interface de programação. Esta seção descreve chamadas da linha de comandos. Para acessar a ferramenta dumpNameSpace por meio de sua interface de programa, consulte a classe com.ibm.websphere.naming.DumpNameSpace na documentação da API do WebSphere Application Server.
Para executar a ferramenta em uma linha de comandos, digite o comando dumpNameSpace no diretório app_server_root/bin.
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
dumpNameSpace.sh [[-keyword value]...]
![[Windows]](../images/windows.gif)
![[IBM i]](../images/iseries.gif)
dumpNameSpace [[-keyword value]...]
Se você executar a ferramenta dumpNameSpace com a segurança ativada e a propriedade com.ibm.CORBA.loginSource estiver definida no arquivo profile_root/properties/sas.client.props, um prompt de login será exibido.
Se você cancelar o prompt de login, a ferramenta dumpNameSpace continuará a transmissão com uma credencial"UNAUTHENTICATED". Portanto, por padrão, é utilizada uma credencial "UNAUTHENTICATED" equivalente ao critério de autorização de acesso "Everyone". Você pode modificar essa configuração padrão alterando o valor da propriedade com.ibm.CSI.performClientAuthenticationRequired para true no arquivo app_server_root/properties/sas.client.props.
Se você não definir a propriedade com.ibm.CORBA.loginSource no arquivo sas.client.props, a ferramenta dumpNameSpace continuará a saída com o nome do usuário e a senha definidos na credencial.
Se o Kerberos (KRB5) estiver ativado para autenticação administrativa, o authenticationTarget suportará BasicAuth e KRB5. Para utilizar autenticação Kerberos, você deve atualizar os arquivos sas.client.props, soap.client.props e ipc.client.props de acordo com o tipo de conector. Ao utilizar a autenticação do Kerberos, a senha de usuário não flui pela transmissão. Um hash de uma via da senha identifica o cliente.
Parâmetros
As palavras-chave e valores associados para a ferramenta dumpNameSpace estão a seguir:
- -host myhost.company.com
- Indica o host de auto-inicialização ou o host do
WebSphere Application Server cujo espaço de nomes você deseja
descarregar (fazer dump). O valor assume o padrão
localhost.
Especifique um valor para -host, se a
ferramenta não for executada da máquina local. O parâmetro -host
instrui a ferramenta a conectar-se a um servidor em uma máquina remota. Por
exemplo, execute
para exibir o namespace do servidor em execução em myhost.mycompany.com.dumpNameSpace -host myhost.mycompany.com
- -port nnn
- Indica a porta de bootstrap a qual, se não for especificada, assume o padrão de 2809.
- -root {cell | server | node | host | legacy | tree | default}
- Indica o contexto raiz a ser utilizado como o contexto
inicial para o dump. As opções de a aplicáveis e o contexto de raiz padrão
dependem do tipo de servidor de nomes do qual o dump está sendo obtido.
A seguir há descrições das opções -root.
Para servidores do WebSphere Application Server:
Tabela 1. Descrições da Opção -root para Servidores do Produto. O contexto-raiz fornece o contexto inicial para o dump. Opção -root Descrição cell Padrão DumpNameSpace para servidores do produto Versão 5.0 ou posterior. Faz dump da árvore iniciando no contexto raiz da célula. Servidor Faz dump da árvore iniciando no contexto raiz do servidor. Nó Faz dump da árvore iniciando no contexto raiz do nó. tree Faz dump da árvore iniciando no contexto raiz da árvore. Faz dump da árvore iniciando no contexto da raiz dos aplicativos. Para todos os WebSphere Application Server e outros servidores de nomes:
Tabela 2. Descrições da Opção -root para Servidores do Produto e de Não-Produto. O contexto-raiz fornece o contexto inicial para o dump. Opção -root Descrição padrão Faz dump da árvore iniciando no contexto inicial que a JNDI retorna por padrão para esse tipo de servidor. Essa é a única opção -root compatível com servidores de nomes que não são de produto. - -url some_provider_URL
- Indica o valor para a propriedade java.naming.provider.url utilizada para obter o contexto de JNDI inicial. Essa opção pode ser utilizada no lugar das opções -host, -port e -root. Se a opção -url for especificada, as opções -host, -port e -root são ignoradas.
- -factory com.ibm.websphere.naming.WsnInitialContextFactory
- Indica a fábrica de contexto inicial a ser utilizada para obter o contexto inicial da JNDI. Os valores são padronizado como com.ibm.websphere.naming.WsnInitialContextFactory. O valor padrão geralmente não precisa ser alterado.
- -startAt some/subcontext/in/the/tree
- Indica o caminho do contexto raiz do host de bootstrap para o contexto de nível superior no qual o dump deve ser iniciado. A ferramenta faz dump recursivamente de subcontextos sob este ponto. Ela assume como padrão uma cadeia vazia, ou seja, o contexto raiz do host de bootstrap.
- -format { jndi | ins }
Tabela 3. Descrições da Opção -format. As opções incluem jndi e ins. Opção -format Descrição jndi O padrão. Exibe componentes de nomes como cadeias atômicas. ins Mostra os componentes de nome analisados, utilizando as regras de INS (Interoperable Naming Service) (id.kind). - -report { short | long }
Tabela 4. Descrições da Opção -report. As opções incluem short e long. Opção -report Descrição short O padrão. Faz dump do nome de vinculação e o tipo de objeto vinculado. Esta saída é fornecida também por JNDI Context.list(). long Faz dump do nome de ligação, tipo do objeto ligado, tipo do objeto local e representação de cadeia do objeto local (ou seja, os IORs, valores de cadeia e outros valores que são impressos). Para objetos de classes definidas pelo usuário para exibição correta com a opção de relatório longo, é possível que seja necessário incluir os diretórios contidos na lista de diretórios procurados. Defina a variável de ambiente WAS_USER_DIRS em uma linha de comandos. O valor pode incluir um ou mais diretórios.
WAS_USER_DIRS=/usr/classdir1:/usr/classdir2 export WAS_USER_DIRS
set WAS_USER_DIRS=c:\classdir1;d:\classdir2
Todos os arquivos .zip, .jar e .class nos diretórios especificados podem, então, ser resolvidos pelo carregador de classes ao executar a ferramenta dumpNameSpace.
- -traceString "some.package.name.to.trace.*=all=enabled"
- Representa a cadeia de rastreio com o mesmo formato que o gerado pelos servidores. A saída é enviada ao arquivo DumpNameSpaceTrace.out.
Códigos de retorno
A ferramenta dumpNameSpace possui os seguintes códigos de retorno:
Código de retorno | Descrição |
---|---|
0 | Saída do sistema normal. Nenhum erro resultou da execução de dumpNameSpace. |
1 | Erro ao obter o contexto inicial |
2 | Ocorreu outro erro com exceção. A execução de dumpNameSpace resultou em um erro diferente do erro de obtenção do contexto inicial. |
3 | Opção não suportada especificada |