dumpNameSpace 工具

可以使用 dumpNameSpace 工具来转储通过名称服务器访问的名称空间的内容。dumpNameSpace 工具基于 Java™ 命名和目录接口 (JNDI)。

您在运行 dumpNameSpace 工具时,命名服务必须是活动的。dumpNameSpace 工具无法将名称空间本地转储到服务器进程,例如那些带有 java: 和 local: URL 方案的名称空间。local: 名称空间包含对具有本地接口的企业 bean 的引用。使用 java:、local: 和服务器名称空间的名称空间转储实用程序转储 java: 和 local: 名称空间。

该工具转储指定的主机和端口上的服务器的服务器根上下文,除非您指定不包括它的非缺省开始上下文。工具不转储其他服务器的服务器根上下文。

避免故障 避免故障: 如果您的系统具有多个 IP 地址,那么您需要修改在运行 dumpNameSpace 工具期间系统配置名称查找机制过程的顺序。您需要使用 -Dsun.net.spi.nameservice.provider.1=dns,sun 设置(一个 Java 选项)以确保 dumpNameSpace 工具在具有多个 IP 地址的系统上成功运行。gotcha

运行 dumpNameSpace

您可以从命令行或使用它的程序界面运行该工具。本节描述命令行调用。要通过 dumpNameSpace 工具的程序界面来访问此工具,请参阅 WebSphere® Application Server API 文档中的 com.ibm.websphere.naming.DumpNameSpace 类。

要从命令行运行工具,请从 app_server_root/bin 目录中输入 dumpNameSpace 命令。

[AIX][HP-UX][Linux][Solaris][z/OS]
dumpNameSpace.sh [[-keyword value]...]
[Windows][IBM i]
dumpNameSpace [[-keyword value]...]

如果您已启用了安全性且在 profile_root/properties/sas.client.props 文件中设置了 com.ibm.CORBA.loginSource 属性,那么运行 dumpNameSpace 工具时,会显示登录提示。

如果取消登录提示,dumpNameSpace 工具将用“UNAUTHENTICATED”凭证继续运行。因此,缺省情况下,使用“UNAUTHENTICATED”凭证与使用“Everyone”访问授权策略是相同的。可以通过将 app_server_root/properties/sas.client.props 文件中的 com.ibm.CSI.performClientAuthenticationRequired 属性的值设置为 true 来修改此缺省设置。

如果不在 sas.client.props 文件中设置 com.ibm.CORBA.loginSource 属性,那么 dumpNameSpace 工具继续携带在凭证中设置的用户名和密码出站。

如果为管理认证启用了 Kerberos (KRB5),那么 authenticationTarget 对 BasicAuth 和 KRB5 均支持。要使用 Kerberos 认证,您必须按照连接器类型更新 sas.client.propssoap.client.propsipc.client.props 文件。使用 Kerberos 认证时,用户密码不会流向连线。密码的单向散列识别客户机。

参数

下面是 dumpNameSpace 工具的关键字和关联值:

-host myhost.company.com
指示要转储其名称空间的 WebSphere Application Server 主机或引导程序主机。缺省值为 localhost。如果不从本地机器运行该工具,那么为 -host 指定值。-host 参数指示工具连接到远程机器上的服务器。例如,运行
dumpNameSpace -host myhost.mycompany.com 
显示 myhost.mycompany.com 上运行的服务器的名称空间。
-port nnn
表明引导端口,如果不指定,那么缺省值为 2809
-root { cell | server | node | host | legacy | tree | default }
表明要用作转储的初始上下文的根上下文。可应用的根上下文选项和缺省根上下文是由要从那里进行转储的名称服务器的类型确定的。下面是对 -root 选项的描述。

对于 WebSphere Application Server 服务器:

表 1. 产品服务器的 -root 选项描述. 根上下文提供转储的初始上下文。
-root 选项 描述
cell 产品 V5.0 或更高版本的服务器的 DumpNameSpace 缺省值。转储从单元根上下文开始的树。
server 转储从服务器根上下文开始的树。
node 转储从节点根上下文开始的树。
tree 转储从树根上下文开始的树。
applications 转储从应用程序根上下文开始的树。

对于所有 WebSphere Application Server 和其他名称服务器:

表 2. 产品和非产品服务器的 -root 选项描述. 根上下文提供转储的初始上下文。
-root 选项 描述
default 转储从 JNDI 在缺省情况下为该服务器类型返回的初始上下文开始的树。这是与非产品名称服务器一致的唯一的 -root 选项。
-url some_provider_URL
表明用于获取初始 JNDI 上下文的 java.naming.provider.url 属性的值。可以使用此选项代替 -host-port-root 选项。如果指定 -url 选项,那么忽略 -host-port-root 选项。
-factory com.ibm.websphere.naming.WsnInitialContextFactory
表明要用于获取 JNDI 初始上下文的初始上下文工厂。缺省值为 com.ibm.websphere.naming.WsnInitialContextFactory。通常不需要更改缺省值。
-startAt some/subcontext/in/the/tree
表明从引导主机的根上下文到转储应该开始处的顶层上下文的路径。工具递归地转储此位置下的子上下文。缺省为空字符串,即,引导主机根上下文。
-format { jndi | ins }
表 3. -format 选项描述. 选项包括 jndi 和 ins。
-format 选项 描述
jndi 缺省值。作为原子字符串显示名称组件。
ins 显示使用互操作命名服务 (INS) 规则 (id.kind) 解析的名称组件。
-report { short | long }
表 4. -report 选项描述. 选项包括 short 和 long。
-report 选项 描述
short 缺省值。转储绑定名称和绑定的对象类型。JNDI Context.list() 也提供此输出。
long 转储绑定名称、绑定的对象类型、本地对象类型和本地对象的字符串表示法(即,IOR、字符串值和其他输出的值)。

要用长报告选项正确地显示用户定义的类对象,您可能需要将它们包含的目录添加到搜索的目录列表中。在命令行中设置环境变量 WAS_USER_DIRS。值可以包含一个或多个目录。

[AIX][HP-UX][Linux][Solaris]
WAS_USER_DIRS=/usr/classdir1:/usr/classdir2 export WAS_USER_DIRS
[Windows]
set WAS_USER_DIRS=c:\classdir1;d:\classdir2

然后,运行 dumpNameSpace 工具时,类装入器可以解析指定目录中的所有 .zip.jar.class 文件。

-traceString "some.package.name.to.trace.*=all=enabled"
表示跟踪字符串的格式与服务器生成的字符串的格式相同。输出发送到文件 DumpNameSpaceTrace.out

返回码

dumpNameSpace 工具包含以下返回码:

表 5. dumpNameSpace 工具返回码. 返回码 0 表明无错误。返回码 1 到 3 表明错误情况。
返回码 描述
0 正常系统出口。运行dumpNameSpace 未出现错误。
1 获取开始上下文时出错
2 异常出现其他错误。运行 dumpNameSpace 时出现获取开始上下文错误之外的其他错误。
3 不支持指定的选项

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rnam_dump_utility
文件名:rnam_dump_utility.html