Tool dumpNameSpace

Mit dem Tool "dumpNameSpace" können Sie den Inhalt eines Namespace, auf den Sie über einen Namensserver zugreifen, ausgeben. Das Tool "dumpNameSpace" basiert auf Java™ Naming and Directory Interface (JNDI).

Beim Ausführen des Tools "dumpNameSpace" muss der Namensservice aktiv sein. Das Tool "dumpNameSpace" kann keine lokalen Namespaces des Serverprozesses ausgeben, wie beispielsweise Namespaces mit den URL-Schemata java: und local:. Der local:-Namespace enthält Referenzen auf Enterprise-Beans mit lokalen Schnittstellen. Verwenden Sie das Speicherauszugsdienstprogramm für java:-, local:- und Server-Namespaces, um einen Speicherauszug für java:- und local:-Namespaces zu erstellen.

Das Tool erstellt einen Speicherauszug mit dem Serverstammkontext für die angegebene Host/Port-Kombination, sofern Sie keinen, den Stammkontext ausschließenden anderen Anfangskontext angeben. Für die Stammkontexte anderer Server wird kein Speicherauszug erstellt.

Fehler vermeiden Fehler vermeiden: Wenn Ihr System mehrere IP-Adressen hat, müssen Sie die Reihenfolge, in der das vom System konfigurierte Verfahren für Namenssuche während der Ausführung des Tools "dumpNameSpace" abläuft, ändern. Sie müssen die Einstellung -Dsun.net.spi.nameservice.provider.1=dns,sun, eine Java-Option, verwenden, um sicherzustellen, dass das Tool "dumpNameSpace" auf Systemen mit mehreren IP-Adressen fehlerfrei ausgeführt wird. gotcha

dumpNameSpace ausführen

Sie können das Tool über die Befehlszeile oder die Programmschnittstelle des Tools ausführen. In diesem Artikel werden Aufrufe über die Befehlszeile beschrieben. Wenn Sie das Tool "dumpNameSpace" über seine eigene Programmschnittstelle aufrufen möchten, lesen Sie die Informationen zur Klasse com.ibm.websphere.naming.DumpNameSpace in der API-Dokumentation zu WebSphere Application Server.

Wenn Sie das Tool über die Befehlszeile aufrufen möchten, müssen Sie den Befehl dumpNameSpace im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin eingeben.

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

Wenn Sie das Tool "dumpNameSpace" ausführen und die Sicherheit aktiviert und die Eigenschaft "com.ibm.CORBA.loginSource" in der Datei Profilstammverzeichnis/properties/sas.client.props gesetzt ist, wird ein Anmeldedialog angezeigt.

Wenn Sie den Anmeldedialog abbrechen, setzt das Tool "dumpNameSpace" die Verarbeitung für abgehende Anforderungen mit einem Berechtigungsnachweis des Typs "UNAUTHENTICATED" (nicht authentifiziert) fort. Deshalb wird standardmäßig ein Berechtigungsnachweis vom Typ "UNAUTHENTICATED" verwendet, der der Zugriffsberechtigungsrichtlinie "Alle" entspricht. Sie können diese Standardeinstellung ändern, indem Sie den Wert der Eigenschaft com.ibm.CSI.performClientAuthenticationRequired in der Datei Stammverzeichnis_des_Anwendungsservers/properties/sas.client.props in true ändern.

Wenn Sie die Eigenschaft com.ibm.CORBA.loginSource in der Datei sas.client.props nicht definieren, verwendet das Tool "dumpNameSpace" weiterhin den Benutzernamen und das Kennwort aus dem Berechtigungsnachweis für abgehende Anforderungen.

Wenn Kerberos (KRB5) für die Verwaltungsauthentifizierung aktiviert ist, unterstützt authenticationTarget sowohl BasicAuth als auch KRB5. Zur Verwendung der Kerberos-Authentifizierung müssen Sie je nach Connector-Typ die Datei sas.client.props, soap.client.props bzw. ipc.client.props ändern. Bei der Verwendung der Kerberos-Authentifizierung wird das Benutzerkennwort nicht über die Verbindung übertragen. Der Client wird über einen unumkehrbaren Hash-Wert identifiziert.

Parameter

Die Schlüsselwörter und Werte für das Tool dumpNameSpace sind im Folgenden beschrieben:

-host myhost.company.com
Zeigt den Bootstrap-Host oder den WebSphere Application Server-Host an, für dessen Namespace Sie einen Speicherauszug erstellen möchten. Der Standardwert ist localhost. Geben Sie einen Wert für -host an, wenn das Tool nicht auf der lokalen Maschine ausgeführt wird. Der Parameter -host weist das Tool an, eine Verbindung zu einem Server auf einer fernen Maschine herzustellen. Führen Sie beispielsweise
dumpNameSpace -host meinhost.meinecompany.com
aus, um den Namespace des Servers anzuzeigen, der auf "meinhost.meinecompany.com" ausgeführt wird.
-port nnn
Zeigt den Bootstrap-Port an, der, falls nicht angegeben, den Standardwert 2809 annimmt.
-root {cell | server | node | host | legacy | tree | default}
Zeigt den Stammkontext an, der als Ausgangskontext für den Speicherauszug verwendet werden soll. Die verfügbaren Optionen von -root und der Standardstammkontext sind von dem Namensserver, von dem der Speicherauszug abgerufen wird, abhängig. Es folgen Beschreibungen der Optionen für -root.

Für Server von WebSphere Application Server:

Tabelle 1. Beschreibungen der Optionen für "-root" für Produktserver. Der Stammkontext wird als Ausgangskontext für den Speicherauszug verwendet.
Option für "-root" Beschreibung
Zelle DumpNameSpace-Standardwert für Server der Version 5.0 und höher. Gibt die Baumstruktur beginnend beim Zellenstammkontext aus.
Server Gibt die Baumstruktur, beginnend beim Serverstammkontext aus.
node Gibt die Baumstruktur, beginnend beim Knotenstammkontext aus.
tree Gibt die Baumstruktur, beginnend beim Stammkontext der Baumstruktur aus.
applications Gibt die Baumstruktur, beginnend beim Anwendungsstammverzeichnis aus.

Für alle Namensserver von WebSphere Application Server und andere Namensserver:

Tabelle 2. Beschreibungen der Optionen des Parameters "-root" für Produktserver und andere Server. Der Stammkontext wird als Ausgangskontext für den Speicherauszug verwendet.
Option für "-root" Beschreibung
Standardwert Gibt die Baumstruktur, beginnend beim Ausgangskontext aus, den JNDI standardmäßig für diesen Servertyp zurückgibt. Dies ist die einzige Option von -root, die mit Namensservern kompatibel ist, die keine Namensserver des Produkts sind.
-url Provider-URL
Zeigt den Wert für die Eigenschaft "java.naming.provider.url" an, die zum Abrufen des JNDI-Ausgangskontextes verwendet wird. Diese Option kann anstelle der Optionen -host, -port und -root verwendet werden. Wenn die Option -url angegeben ist, werden die Optionen -host, -port und -root ignoriert.
-factory com.ibm.websphere.naming.WsnInitialContextFactory
Zeigt die Ausgangskontextfactory an, die zum Abrufen des JNDI-Ausgangskontextes verwendet werden soll. Der Standardwert ist com.ibm.websphere.naming.WsnInitialContextFactory. Im Allgemeinen ist es nicht erforderlich, den Standardwert zu ändern.
-startAt ein/Subkontext/in/der/Struktur
Zeigt den Pfad vom Stammkontext des Bootstrap-Host zum Kontext der Ausgangsebene an, bei dem der Speicherauszug beginnen soll. Das Tool erstellt rekursiv Speicherauszüge für Subkontexte, die sich unterhalb dieses Punkts befinden. Standardmäßig wird eine leere Zeichenfolge angenommen. In diesem Fall handelt es sich um den Stammkontext des Bootstrap-Host.
-format { jndi | ins }
Tabelle 3. Beschreibungen der Optionen für "-format". Die Optionen sind "jndi" und "ins".
Option für "-format" Beschreibung
jndi Die Standardeinstellung. Zeigt Namenskomponenten in Form von nicht weiter zerlegbaren Zeichenfolgen an.
ins Zeigt Namenskomponenten an, die anhand von INS-Regeln (Interoperable Naming Service) (id.kind) syntaktisch analysiert wurden.
-report { short | long }
Tabelle 4. Beschreibungen der Optionen für "-report". Die Optionen sind "short" und "long".
Option für "-report" Beschreibung
short Die Standardeinstellung. Erstellt einen Speicherauszug für den Bindungsnamen und den gebundenen Objektnamen. Diese Ausgabe wird auch von JNDI Context.list() bereitgestellt.
long Erstellt einen Speicherauszug für den Bindungsnamen, den gebundenen Objekttyp, den lokalen Objekttyp und die Zeichenfolge des lokalen Objekts (d. h. die IORs, Zeichenfolgewerte und andere ausgegebene Werte).

Damit Objekte benutzerdefinierter Klassen mit der Berichtsoption "long" ordnungsgemäß angezeigt werden, ist es möglicherweise erforderlich, deren übergeordnete Verzeichnisse der Liste der gesuchten Verzeichnisse hinzuzufügen. Setzen Sie über die Befehlszeile die Umgebungsvariable WAS_USER_DIRS. Der Wert kann ein oder mehrere Verzeichnisse enthalten.

[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

Alle .zip-, .jar- und .class-Dateien, die sich in den angegebenen Verzeichnissen befinden, können beim Ausführen des Tools "dumpNameSpace" vom Klassenlader aufgelöst werden.

-traceString "some.package.name.to.trace.*=all=enabled"
Gibt die Tracezeichenfolge an, die dasselbe Format wie die von den Servern generierte Zeichenfolge hat. Die Ausgabe wird an die Datei DumpNameSpaceTrace.out gesendet.

Rückkehrcodes

Das Tool "dumpNameSpace" hat die folgenden Rückkehrcodes:

Tabelle 5. Rückkehrcodes des Tools "dumpNameSpace". Der Rückkehrcode "0" zeigt an, dass kein Fehler aufgetreten ist. Die Rückkehrcodes 1 bis 3 zeigen eine Fehlerbedingung an.
Rückkehrcode Beschreibung
0 Normaler Systemexit. Bei der Ausführung von dumpNameSpace ist kein Fehler aufgetreten.
1 Fehler beim Abrufen des Startkontextes
2 Anderer Fehler mit Ausnahme. Bei der Ausführung von dumpNameSpace ist ein Fehler aufgetreten, der nichts mit dem Abrufen des Startkontextes zu tun hat.
3 Nicht unterstützte Option angegeben

Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rnam_dump_utility
Dateiname:rnam_dump_utility.html