Outil dumpNameSpace
Vous pouvez faire appel à l'outil dumpNameSpace pour vider le contenu d'un espace de nom accessible via un serveur de noms. L'outil dumpNameSpace repose sur l'interface JNDI (Java™ Naming and Directory Interface).
Lorsque vous lancez l'outil dumpNameSpace, le service de nommage doit être actif. Cet outil ne peut pas effectuer de cliché des espaces de nom locaux pour le processus serveur, comme les espaces de nom comportant des modèles d'URL java: et local:. L'espace de nom local: contient des références aux beans enterprise associés à des interfaces locales. Exécutez l'utilitaire de clichage d'espace de nom pour les noms d'espaces java:, local: et serveur pour vider les espaces de nom java: et local:.
L'outil vide le contexte racine du serveur situé sur l'hôte et le port spécifiés (sauf spécification d'un contexte de démarrage non défini par défaut qui l'en empêcherait). Il ne prend pas de cliché des contextes racines de serveur des autres serveurs.

Lancement de dumpNameSpace
Vous pouvez lancer cet outil à partir d'une ligne de commande ou à l'aide de son interface de programme. Cette section décrit les appels de ligne de commande. Pour accéder à l'outil dumpNameSpace via son interface de programme, reportez-vous à la classe com.ibm.websphere.naming.DumpNameSpace dans la documentation de l'API de WebSphere Application Server.
Pour lancer l'outil à partir d'une ligne de commande, entrez la commande dumpNameSpace à partir du répertoire racine_serveur_app/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 vous exécutez l'outil dumpNameSpace alors que la sécurité est activée et que la propriété com.ibm.CORBA.loginSource est définie dans le fichier racine_profil/properties/sas.client.props, une invite de connexion s'affiche.
Si vous annulez cette invite, l'outil dumpNameSpace poursuit la communication sortante avec l'accréditation "UNAUTHENTICATED". Ainsi, par défaut, une accréditation "UNAUTHENTICATED" équivalente à la règle d'autorisation d'accès "Tous les utilisateurs" est utilisée. Vous pouvez modifier cette valeur par défaut en affectant à la propriété com.ibm.CSI.performClientAuthenticationRequired la valeur true dans le fichier racine_serveur_app/properties/sas.client.props.
Si vous ne configurez pas la propriété com.ibm.CORBA.loginSource dans le fichier sas.client.props, l'outil dumpNameSpace poursuit la communication sortante avec le nom d'utilisateur et le mot de passe configurés dans l'accréditation.
Si Kerberos (KRB5) est activé pour une authentification administrative, authenticationTarget prend en charge BasicAuth et KRB5. Pour utiliser l'authentification Kerberos, vous devez mettre à jour les fichiers sas.client.props, soap.client.props, et ipc.client.props selon le type de connecteur. Lors de l'utilisation de l'authentification Kerberos, le mot de passe de l'utilisateur ne passe pas par la connexion. Un hachage à sens unique du mot de passe identifie le client.
Paramètres
Les mots-clés et valeurs associées de l'outil dumpNameSpace sont les suivants :
- -host monhôte.monentreprise.com
- Représente l'hôte amorce ou l'hôte WebSphere
Application Server
dont vous souhaitez clicher l'espace de nom. La valeur par défaut est hôte_local.
Spécifiez la valeur de -host si l'outil n'est pas lancé à partir du poste local. Le paramètre -host demande à l'outil de se connecter à un serveur situé sur un poste distant. Par exemple,
permet d'afficher l'espace de nom du serveur exécuté sur monhôte.monentreprise.com.dumpNameSpace -host myhost.mycompany.com
- -port nnn
- Représente le port amorce. Si aucun numéro n'est spécifié explicitement, le numéro de port par défaut est 2809.
- -root {cellule | serveur | noeud | hôte | existant | arborescence | défaut}
- Représente le contexte de racine à utiliser
comme contexte initial pour le cliché. Les options de racine applicables et le
contexte de racine par défaut dépendent du type de serveur de noms à partir
duquel le cliché est obtenu.
Descriptions des options de -root à suivre.
Pour les serveurs WebSphere Application Server :
Tableau 1. Description de l'option -root pour les serveurs de produits. Le contexte de racine fournit le contexte initial du cliché. Option -root Description cellule Valeur par défaut DumpNameSpace pour des produits de la Version 5.0 ou des serveurs de Version ultérieure. Vide l'arborescence en commençant au contexte de racine de la cellule. serveur Vide l'arborescence en commençant au contexte de racine du serveur. noeud Vide l'arborescence en commençant au contexte de racine du noeud. tree Vide l'arborescence en commençant au contexte de racine de l'arborescence. applications Vide l'arborescence en commençant au contexte de racine des applications. Pour tous les WebSphere Application Server et autres serveurs de noms :
Tableau 2. Description de l'option -root pour les serveurs de produits et les autres serveurs. Le contexte de racine fournit le contexte initial du cliché. Option -root Description default Vide l'arborescence en commençant au contexte initial retourné par défaut par JNDI pour ce type de serveur. Il s'agit de la seule option -root compatible avec les serveurs de noms autres que ceux du produit. - -url URL_d'un_fournisseur
- Indique la valeur de la propriété java.naming.provider.url utilisée pour obtenir le contexte JNDI initial. Cette option peut être utilisée à la place des options -host, -port et -root. Si l'option -url est spécifiée, les options -host, -port et -root sont ignorées.
- -factory com.ibm.websphere.naming.WsnInitialContextFactory
- Désigne la fabrique de contextes initiaux à utiliser pour obtenir le contexte initial JNDI. La valeur par défaut est com.ibm.websphere.naming.WsnInitialContextFactory. Il n'est généralement pas nécessaire de la remplacer.
- -startAt un/sous-contexte/de/l'/arborescence
- Indique le chemin entre le contexte racine de l'hôte amorce et le contexte de niveau supérieur où doit commencer le clichage. Les sous-contextes situés en dessous de ce point seront vidés les uns après les autres. Par défaut, la chaîne est vide. Le clichage commence donc au contexte racine de l'hôte amorce.
- -format { jndi | ins }
Tableau 3. Description de l'option -format. Les options comprennent jndi et ins. Option -format Description jndi La valeur par défaut. Affiche les composants de nom sous forme de chaînes atomiques. ins Affiche des composants de nom analysés selon la syntaxe INS (Interoperable Naming Service)(id.kind). - -report { short | long }
Tableau 4. Description de l'option -report. Les options comprennent short et long. Option -report Description short La valeur par défaut. Extrait le nom de liaison et le type de l'objet lié. Cette sortie est également fournie par JNDI Context.list(). long Extrait le nom de liaison, le type de l'objet lié et le type de l'objet local, ainsi que la représentation sous forme de chaîne de l'objet local (les IOR, les valeurs de chaîne, etc. sont donc extraites). Pour que les objets des classes définies par l'utilisateur s'affichent correctement dans la version longue du rapport, il peut être nécessaire d'ajouter les répertoires qui les contiennent à la liste des répertoires à analyser. Définissez la variable d'environnement WAS_USER_DIRS à partir d'une ligne de commande. La valeur de cette variable peut comprendre un ou plusieurs répertoires.
WAS_USER_DIRS=/usr/classdir1:/usr/classdir2 export WAS_USER_DIRS
set WAS_USER_DIRS=c:\classdir1;d:\classdir2
Tous les fichiers .zip, .jar et .class figurant dans les répertoires spécifiés pourront ainsi être résolus par le chargeur de classe lors de l'exécution de l'outil dumpNameSpace.
- -traceString "un.nom.de.package.à.tracer.*=all=enabled"
- Représente la chaîne de spécification de trace au même format que celle générée par les serveurs. La sortie est écrite dans le fichier DumpNameSpaceTrace.out.
Codes retour
L'outil dumpNameSpace obtient les codes retour suivants :
Code retour | Description |
---|---|
0 | Sortie normale du système. L'exécution de dumpNameSpace n'a donné lieu à aucune erreur. |
1 | Erreur d'obtention du contexte de départ. |
2 | Une autre erreur s'est produite avec une exception. L'exécution de dumpNameSpace a donné lieu à une autre erreur qu'une erreur d'obtention du contexte de démarrage. |
3 | Une option non prise en charge a été spécifiée. |