Démarrage des utilitaires UDDI à partir d'une invite de commande

Vous pouvez démarrer les utilitaires UDDI à partir d'une invite de commande. Dans certaines situations, des prérequis doivent être remplis pour exécuter la commande de démarrage.

Vous devez utiliser le niveau de code Java™ correct : indiquez dans l'instruction PATH le code Java fourni avec WebSphere Application Server. Par exemple, tapez à l'invite :[Windows]
set PATH=racine_serveur_app\java\bin;%PATH%
[AIX][HP-UX][Linux][Solaris][z/OS]
export PATH=racine_serveur_app/java/bin:$PATH
[AIX][HP-UX][Linux][Solaris]Si vous utilisez DB2 sur les systèmes d'exploitation UNIX ou Linux, exécutez le script db2profile avant de démarrer les utilitaires UDDI. Ce script se trouve dans le répertoire principal de l'instance DB2, dans le répertoire sqllib. Pour appeler le script, entrez ce qui suit. Notez qu'un espace suit le point (.).
. /$DB2_HOME/db2profile
Remarque : L'utilisateur DB2 doit disposer d'un script db2profile dans $HOME/sqllib/db2profile.
Utilisez l'une des méthodes suivantes pour démarrer les utilitaires UDDI :
  • Entrez la commande suivante en utilisant un fichier de propriétés indiqué configurant le chemin de classes et d'autres paramètres :
    java - jar UDDIUtilityTools.jar {fonction} [options]
    Remarque : Avant d'exécuter UDDIUtilityTools.jar à partir d'une ligne de commande, vous devez avoir édité le fichier UDDIUtilityTools.properties. Si vous sauvegardez ce fichier de propriétés dans un répertoire autre que celui où se trouve le fichier UDDIUtilityTools.jar lui-même, indiquez ce répertoire dans les arguments de la ligne de commande.
  • Entrez la commande suivante, où CommandLineProcessor désigne la classe qui traite les arguments de ligne de commande des utilitaires UDDI, établit la configuration et appelle la fonction adéquate :
    java CommandLineProcessor
Syntaxe de UDDIUtilityTools.jar :
java -jar UDDIUtilityTools.jar {fonction} [options]
Fonctions :
  -promote <sourc entité>   Promotion d'entités entre registres
  -export <source entité>    Extraction d'entités depuis un registre vers XML
  -delete <source entité>    Suppression d'entités d'un registre
  -import                       Création des entités de XML vers le registre

où <entity source> est l'un des éléments suivants :
  -tmodel|-business|-service|-binding <key> Indique un type et un clé d'entité unique
  -keysFile | -f <filename>  Indique un fichier contenant types et clés d'entité
Options :
  -properties <nom_fichier>     Spécifie le chemin d'un fichier de configuration
  -overwrite | -o            Remplace une entité si elle existe déjà
  -log | -v                  Messages prolixes en sortie
  -definitionFile <filename> Indique le chemin d'un fichier de définition d'entité UDDI
  -importReferenced          Importe les entités référencées par des entités source
Les options de ligne de commande suivantes remplacent les paramètres des propriétés dans le fichier de configuration :
  • overwrite
  • log
  • definitionFile
  • importReferenced

Exemples

[AIX Solaris HP-UX Linux Windows]Ces exemples reposent sur le système de fichiers Windows :

java -jar UDDIUtilityTools.jar -promote -keysFile [AIX Solaris HP-UX Linux Windows]C:/uddikeys.txt
Exportez une entreprise unique dans le fichier de définition d'entité indiqué dans un fichier de propriétés contenu dans le répertoire en cours.
java -jar UDDIUtilityTools.jar -export 
-business 28B8B928-2B2E-4EC9-A647-1E40651E4752
Exportez une entreprise unique dans le fichier de définition d'entité indiqué dans un fichier de propriétés contenu dans le répertoire en cours et utilisez un fichier de clés pour indiquer les entités à exporter.
java -jar UDDIUtilityTools.jar -export -keysFile [AIX Solaris HP-UX Linux Windows]C:/myKeyFiles/keyFile01.txt
Exportez une entreprise unique dans le fichier de définition d'entité indiqué dans un fichier de propriétés contenu dans le répertoire en cours et utilisez un fichier de clés pour indiquer les entités à exporter. Affichez également une sortie prolixe sur la ligne de commande.
java -jar UDDIUtilityTools.jar -export -keysFile [AIX Solaris HP-UX Linux Windows]C:/myKeyFiles/keyFile02.txt -v
Importez le contenu du fichier de définition d'entité par défaut indiqué dans le fichier UDDIUtilityTools.properties contenu dans le répertoire en cours.
java -jar UDDIUtilityTools.jar -import
Importez le contenu du fichier de définition d'entité par défaut indiqué dans le fichier UDDIUtilityTools.properties contenu dans le répertoire en cours et importez dans le registre cible les entités tModel référencées.
java -jar UDDIUtilityTools.jar -import -importReferenced
Importez les entités depuis un fichier de définition d'entité situé à un emplacement spécifié. [AIX Solaris HP-UX Linux Windows]Notez l'emploi des barres obliques, en retenant que cet exemple repose sur un système de fichiers Windows.
java -jar UDDIUtilityTools.jar -import -definitionFile [AIX Solaris HP-UX Linux Windows]C:/myEDFs/entities01.xml
Importez les entités à partir du fichier de définition d'entité par défaut, y compris les entités tModel référencées. L'option overwrite indique que les entités excluant les entités tModel référencées figurant dans le registre cible sont remplacées.
java -jar UDDIUtilityTools.jar -import -overwrite -importReferenced
Exécutez une promotion d'un service unique à partir d'un registre source vers un registre cible à l'aide d'un fichier de propriétés situé à un emplacement indiqué.
java -jar UDDIUtilityTools.jar -promote 
-service 67961D67-330F-4F14-8210-E74A58E710F3 
-properties [AIX Solaris HP-UX Linux Windows]C:/UUT/myUUTProps.properties
Exécutez une promotion d'un ensemble d'entités indiqué dans un fichier de clés.
java -jar UDDIUtilityTools.jar -promote -keysFile [AIX Solaris HP-UX Linux Windows]C:/myKeyFiles/keyFile03.txt
Exécutez une promotion d'un ensemble d'entités indiqué dans un fichier de clés et remplacez les entités existantes dans le registre cible.
java -jar UDDIUtilityTools.jar -promote -keysFile [AIX Solaris HP-UX Linux Windows]C:/myKeyFiles/keyFile04.txt 
-overwrite
Exécutez une promotion d'un ensemble d'entités indiqué dans un fichier de clés en incluant les entités tModel référencées.
java -jar UDDIUtilityTools.jar -promote -keysFile [AIX Solaris HP-UX Linux Windows]C:/myKeyFiles/keyFile05.txt 
-importReferenced
Exécutez une promotion d'un ensemble d'entités indiqué dans un fichier de clés et créez un fichier de définition d'entité contenant les entités promues.
java -jar UDDIUtilityTools.jar -promote -keysFile [AIX Solaris HP-UX Linux Windows]C:/myKeyFiles/keyFile06.txt 
-definitionFile [AIX Solaris HP-UX Linux Windows]C:/myEDFs/entities02.xml
Supprimez logiquement une entité tModel unique. Vous ne pouvez pas supprimer les entités tModel physiquement.
java -jar UDDIUtilityTools.jar -delete 
-tModel UUID:1E2B9D1E-E53D-4D36-9D46-6CCC176C466A
Supprimez toutes les entités indiquées dans le fichier de clés. Sachez qu'à l'exception des entités tModel, toutes les autres entités seront supprimées physiquement dans le registre cible.
java -jar UDDIUtilityTools.jar -delete -keysFile [AIX Solaris HP-UX Linux Windows]C:/myKeyFiles/keyFile04.txt

Exemple de fichier de clés

L'exemple suivant indique les clés devant être exportées, promues ou supprimées dans le registre cible :
#
# Clés des entités à exporter, promouvoir à partir du registre source ou supprimées 
# dans le registre cible
#
# Remarque : les clés doivent être séparées par une virgule et définies sur la MEME ligne
# Remarque : les majuscules et les minuscules sont différenciées dans les noms de propriété. (les "tmodels=" sont ignorés)

businesses=97C77097-AC6C-4CA0-A6C4-452F7045C470, 
4975E949-581F-4FCA-AD5F-E08280E05F9F
services=BB3864BB-1578-4833-8179-14391F14791F
bindings=
tModels=273F1727-7BFF-4FB5-A1FD-BA5C45BAFD9C

Si la propriété importReferenced a la valeur true, la liste des entités tModel dans la section referencedTModels est importée dans le registre cible. Des entités minimales sont créées si la section referencedTModels est nouvelle. Si elle existe déjà, elle n'est pas remplacée, quelle que soit la valeur de la propriété overwrite. Cette méthode évite la mise à jour inutile des entités tModel fréquemment référencées, par exemple les entités tModel "categorization".

Pour mettre à jour une section referencedTModels, déplacez manuellement la définition correspondante dans la section des entités tModel du fichier de définition des entités et attribuez la valeur true à l'option overwrite.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwsu_utility_tool_command
Nom du fichier : rwsu_utility_tool_command.html