Herramienta dumpNameSpace
Puede utilizar la herramienta dumpNameSpace para volcar el contenido de un espacio de nombres al que se accede mediante un servidor de nombres. La herramienta dumpNameSpace se base en JNDI (Java™ Naming and Directory Interface).
Cuando se ejecuta la herramienta dumpNameSpace, el servicio de denominación debe estar activo. La herramienta dumpNameSpace no puede volcar los espacios de nombres que son locales para el proceso del servidor como, por ejemplo, aquéllos con esquemas URL java: y local:. El espacio de nombres local: contiene referencias a enterprise beans con interfaces locales. Utilice el programa de utilidad de volcado de espacio de nombres para los espacios de nombres java:, local: y server para volcar los espacios de nombres java: y local:.
La herramienta vuelca el contexto de raíz de servidor del servidor situado en el host y puerto especificados, a menos que especifique un contexto inicial que no sea el asignado de manera predeterminada que lo impida. La herramienta no vuelva los contextos de raíz de servidor de otros servidores.

Ejecución de dumpNameSpace
Puede ejecutar la herramienta desde una línea de mandatos o mediante la interfaz del programa. Esta sección describe las invocaciones de línea de mandatos. Para acceder a la herramienta dumpNameSpace a través de la interfaz del programa, consulte la clase com.ibm.websphere.naming.DumpNameSpace en la documentación de la API WebSphere Application Server.
Para ejecutar la herramienta desde la línea de mandatos, escriba el mandato dumpNameSpace desde el directorio raíz_servidor_aplicaciones/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]...]
Si ejecuta la herramienta dumpNameSpace con la seguridad habilitada y la propiedad com.ibm.CORBA.loginSource está establecida en el archivo raíz_perfil/properties/sas.client.props, aparece un indicador de inicio de sesión.
Si cancela el indicador de inicio de sesión, la herramienta dumpNameSpace continúa dirigiéndose a la salida con una credencial "UNAUTHENTICATED". Por lo tanto, se utiliza una credencial "UNAUTHENTICATED" que es equivalente a la política de autorización de acceso "Everyone". Puede modificar este valor por omisión modificando el valor de la propiedad com.ibm.CSI.performClientAuthenticationRequired en true en el archivo raíz_servidor_aplicaciones/properties/sas.client.props.
Si no establece la propiedad com.ibm.CORBA.loginSource en el archivo sas.client.props, la herramienta dumpNameSpace continúa dirigiéndose a la salida con el nombre de usuario y contraseña establecidos en la credencial.
Si Kerberos (KRB5) está habilitado para la autenticación administrativa, authenticationTarget soporta BasicAuth y KRB5. Para utilizar la autenticación Kerberos, debe actualizar los archivos sas.client.props, soap.client.props y ipc.client.props según el tipo de conector. Al utilizar la autenticación Kerberos, la contraseña de usuario no fluye por la red. Un hash unidireccional de la contraseña identifica el cliente.
Parámetros
Las palabras clave y los valores asociados para la herramienta dumpNameSpace son los siguientes:
- -host mihost.miempresa.com
- Indica el host del programa de arranque o el host de WebSphere Application Server cuyo espacio de nombres se desea volcar. El valor que se toma de manera predeterminada es localhost.
Especifica un valor para -host, si la herramienta no se ejecuta
desde una máquina local. El parámetro -host indica a herramienta
que debe conectarse a un servidor en un máquina remota. Por ejemplo, ejecute
para visualizar el espacio de nombres del servidor que se está ejecutando en myhost.mycompany.com.dumpNameSpace -host mihost.miempresa.com
- -port nnn
- Indica el puerto de rutina de carga; si no se ha especificado, se toma el valor predeterminado 2809.
- -root {cell | server | node | host | legacy | tree | default}
- Indica el contexto raíz que se utilizará como contexto inicial del vuelco. Las opciones raíces aplicables y el contexto de raíz predeterminado dependen
del tipo de servidor de nombres desde el que se obtendrá el vuelco.
Las siguientes son las descripciones de las opciones -root.
Para servidores WebSphere Application Server:
Tabla 1. Descripción de la opción -root para servidores del producto. El contexto raíz proporciona el contexto inicial del vuelco. Opción -root Descripción cell Valor predeterminado de DumpNameSpace para los servidores del producto de la versión 5.0 o posterior. Vuelca el árbol comenzando por el contexto de raíz de célula. server Vuelca el árbol comenzando por el contexto de raíz de servidor. node Vuelca el árbol comenzando por el contexto de raíz de nodo. tree Vuelca el árbol comenzando por el contexto de raíz de árbol. applications Vuelca el árbol empezando en el contexto de raíz de aplicaciones. Para todos los servidores WebSphere Application Server y otros servidores de nombres:
Tabla 2. Descripción de la opción -root para los servidores de producto y servidores que no son de producto. El contexto raíz proporciona el contexto inicial del vuelco. Opción -root Descripción predeterminado Vuelca el árbol comenzando en el contexto inicial que se devuelve JNDI de manera predeterminada para dicho tipo de servidor. Esta es la única opción -root que es compatible con los servidores de nombres que no son del producto. - -url cualquier_proveedor_URL
- Indica el valor de la propiedad java.naming.provider.url que se utiliza para obtener el contexto JNDI inicial. Esta opción se puede utilizar en lugar de las opciones -host, -port y -root. Si se especifica la opción -url, se ignoran las opciones -host, -port y -root.
- -factory com.ibm.websphere.naming.WsnInitialContextFactory
- Indica la fábrica de contexto inicial que ha de utilizarse para obtener el contexto inicial de JNDI. El valor que se toma de manera predeterminada es com.ibm.websphere.naming.WsnInitialContextFactory. Generalmente, no es necesario cambiar el valor predeterminado.
- -startAt some/subcontext/in/the/tree
- Indica la vía de acceso desde el contexto de directorio raíz del host de rutina de carga hasta el contexto del nivel superior desde donde debe iniciarse el vuelco. La herramienta vuelca de forma recursiva los subcontextos que se encuentran por debajo de este punto. De forma predeterminada toma una serie vacía, es decir, el contexto de directorio raíz del host de rutina de carga.
- -format { jndi | ins }
Tabla 3. Descripción de la opción -format. Las opciones incluyen jndi e ins. Opción -format Descripción jndi El valor predeterminado. Visualiza los componentes de nombres como series de átomos. ins Muestra los componentes de nombre analizados mediante las reglas de INS (Interoperable Naming Service) (id.kind). - -report { short | long }
Tabla 4. Descripción de la opción -report. Las opciones incluyen short y long. Opción -report Descripción short El valor predeterminado. Vuelca el nombre de enlace y el tipo de objeto enlazado. Esta salida también la proporciona Context.list() de JNDI. long Realiza un volcado del nombre de enlace, el tipo de objeto de enlace, el tipo de objeto local y una representación de la serie del objeto local (es decir, los IOR, los valores de serie y otros valores que se imprimen). Para que los objetos de las clases definidas por el usuario se visualicen correctamente con la opción de informe largo (long), puede que sea necesario añadir sus directorios de contenido a la lista de directorios compartidos. Establezca la variable de entorno WAS_USER_DIRS en una línea de mandatos. El valor puede incluir uno o más directorios.
WAS_USER_DIRS=/usr/classdir1:/usr/classdir2 export WAS_USER_DIRS
set WAS_USER_DIRS=c:\classdir1;d:\classdir2
Todos los archivos .zip, .jar y .class de los de los directorios especificados pueden resolverse entonces mediante el cargador de clases cuando se ejecute dumpNameSpace.
- -traceString "some.package.name.to.trace.*=all=enabled"
- Representa la serie de rastreo con el mismo formato que el que han generado los servidores. La salida se envía al archivo DumpNameSpaceTrace.out.
Códigos de retorno
La herramienta dumpNameSpace tiene los siguientes códigos de retorno:
Código de retorno | Descripción |
---|---|
0 | Salida normal del sistema. No se ha generado ningún error al ejecutar dumpNameSpace. |
1 | Error al obtener el contexto de inicio |
2 | Se ha producido otro error con excepción. La ejecución de dumpNameSpace ha generado un error distinto al error producido al obtener el contexto de inicio. |
3 | Opción no soportada especificada |