Utilisation du traitement de ligne de commande

Vous pouvez exécuter un ou plusieurs services en soumettant les demandes de service au serveur de gestion à partir de la ligne de commande.

Avant d'exécuter un service, vous devez affecter le service à un proxy et à un serveur de gestion à l'aide du gestionnaire. Le proxy et le serveur de gestion doivent être activés pour que le traitement de la demande de service puisse s'effectuer. Vous devez également installer InfoSphere Data Architect et IBM Optim Designer pour connaître les fichiers dont vous avez besoin pour exécuter le traitement de la ligne de commande.

Deux options existent pour utiliser cette ligne de commande :
  • Le script runservice vous permet d'entrer des services d'exécution en entrant moins d'arguments ; vous pouvez personnaliser ce script en fonction de vos besoins.
  • La commande java -jar com-ibm-nex-client-tool.jar peut être utilisée dans un script que vous préparez vous-même.

runservice, script

Le script runservice se trouve dans le dossier dossier_ida\optim\designer\runservice, où dossier_ida est le dossier dans lequel InfoSphere Data Architect est installé. Vous devez ouvrir la ligne de commande dans le dossier dossier_ida\optim\designer\runservice. Le dossier contient deux fichiers script, un pour Microsoft Windows (runservice.bat) et un pour Linux et UNIX (runservice.sh).

Le script runservice implique que vous ajoutiez le dossier principal d'une installation Java 6.0 JRE ou JDK à la variable d'environnement PATH.

Le script runservice utilise la syntaxe suivante lorsque vous exécutez les services affectés à un serveur de gestion et un proxy :

runservice {--service | -s} nom_service:version
{--url | -u} URL_serveur {--continueOnError | -c} 
--service | -s nomservice:version

Nom de service et numéro de version (au format n.n.n) Obligatoire.

Les noms de service sont sensibles à la casse. Si un nom de service contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

Par exemple : -s demosvc:1.0.0.

--url | -u URLserveur
Emplacement du serveur de gestion qui héberge le registre et référentiel contenant le service. L'emplacement http://localhost:8080 est utilisé par défaut.

Par exemple : -u http://mgmtserver1:8080.

--continueOnError | -c

Ce paramètre définit le script permettant de continuer à envoyer des services au proxy pour une exécution, même si un service ne parvient pas à être lancé par le proxy.

Le script runservice utilise la syntaxe suivante lorsque vous exécutez une demande de service exportée :

runservice {-r|--serviceRequest} cheminfichierdemande
{-u|-url} URLproxy {-j|--jarMap} mapfilepath
{-v|--overrideValues} cheminfichiersubs {-l|--logLevel} niveaujournal
{-t|--timeout} secondes|never {-p|--serviceResponse} cheminfichieréponses
--serviceRequest | -r cheminfichierdemande

Chemin d'accès au fichier complet pour la demande de service exportée. Obligatoire.

Les noms de fichiers de demande de service sont sensibles à la casse. Si le nom de fichier contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

Par exemple : -r demosvc.jar.

--url | -u URLproxy
Emplacement du proxy à utiliser pour exécuter le service. L'emplacement http://localhost:12000 est utilisé par défaut.

Par exemple : -u http://proxy1:12000.

--jarMap | -j cheminfichiermappe

Chemin d'accès au fichier complet pour le fichier de mappage.

Les noms de fichiers de mappage sont sensibles à la casse. Si le nom de fichier contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

--overrideValues | -v cheminfichiersubstitution

Chemin d'accès au fichier complet pour le fichier de substitution.

Les noms de fichiers de mappage sont sensibles à la casse. Si le nom de fichier contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

--logLevel | -l niveaujournal
Niveau de journalisation pour le service (c'est-à-dire niveau de gravité le plus faible des messages à inclure au journal). Les valeurs possibles vont de niveau faible à niveau élevé : .
  • OFF
  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
  • ALL

Par exemple : -l INFO.

--timeout | -t délaisecondes

Indiquez le nombre de secondes pendant lequel il faut attendre une réponse avant de terminer (ou ne jamais attendre). Le script runservice attend pendant 600 secondes par défaut.

--serviceResponse | -p fichierréponsesservice

Chemin d'accès au fichier complet du fichier dans lequel la réponse du service est écrite.

Commande java -jar com-ibm-nex-client-tool.jar

Le fichier com-ibm-nex-client-tool.jar se trouve dans le dossier dossier_ida\optim\designer\runservice, où dossier_ida est le dossier dans lequel InfoSphere Data Architect est installé. Vous devez ouvrir la ligne de commande dans le dossier dossier_ida\optim\designer\runservice.

La commande java -jar com-ibm-nex-client-tool.jar utilise la syntaxe suivante dans laquelle dossier_java est le dossier principal d'une installation Java 6.0 JRE ou JDK. Pour éviter d'avoir à saisir le dossier principal chaque fois que vous saisissez la commande, ajoutez le dossier principal à la variable d'environnement PATH.

dossier_java/java -jar com-ibm-nex-client-tool.jar 
{--service | -s} nom_service:version
{--url | -u} URL_serveur {--continueOnError | -c}
--service | -s nomservice:version

Nom et numéro de version (au format n.n.n) du service de gestion de données Obligatoire.

Les noms de service sont sensibles à la casse. Si un nom de service contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

Par exemple : -s demosvc:1.0.0.

--url | -u URLserveur
Emplacement du serveur de gestion qui héberge le registre et référentiel contenant le service. Obligatoire.

Par exemple : -u http://mgmtserver1:8080.

--continueOnError | -c

Ce paramètre définit le script permettant de continuer à envoyer des services au proxy pour une exécution, même si un service ne parvient pas à être lancé par le proxy.

Exécution de plusieurs services

Vous pouvez utiliser la ligne de commande pour exécuter plusieurs services déployés sur le même serveur de gestion. Les services sont lancés un par un dans l'ordre indiqué. Exécuter en parallèle

Indiquez chaque paire service/version en les séparant par une virgule. Ne mettez pas d'espace avant ou après la virgule.

Exemple :

runservice -s service1:1.0.0,service2:1.0.0 -u http://mymgmtserver:8080 -c

Espaces dans les noms de service

Si un nom de service contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, le nom doit être saisi entre guillemets (" "). Exemple :

runservice -s "service name":1.0.0 -u http://mymgmtserver:8080

Exécution de la demande de service exportée

Vous pouvez utiliser la ligne de commande pour exécuter une demande de service ayant été exportée dans un fichier.

Exemple :

runservice -r C:\services\service1.jar -u http://myproxy:12000

Fichier de substitution

Un fichier de substitution est un fichier XML contenant les paramètres de demande de service. Si vous spécifiez un fichier de substitution lorsque vous exécutez une demande de service exportée, le script runservice utilise les paramètres dans le fichier de substitution lorsqu'il exécute la demande.

Vous pouvez utiliser le script runservice pour générer un fichier de substitution contenant les paramètres contenus dans une demande de service.

runservice {-g|--generateOverrideTemplate} cheminfichierdemande
{-v|--overrideValues} cheminfichiersubs {-i|--includeComments} {true|false}
--generateOverrideTemplate | -g cheminfichierdemande

Chemin d'accès au fichier complet pour la demande de service exportée. Obligatoire.

Les noms de fichiers de demande de service sont sensibles à la casse. Si un nom de demande de service contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

--overrideValues | -v cheminfichiersubs
Chemin d'accès au fichier complet pour le nouveau fichier de substitution.

Par exemple : -v C:\override\requestfileoverride.xml.

--includeComments | -i

Indiquez si vous souhaitez intégrer des commentaires au fichier de substitution. Les valeurs valides sont true et false. Par défaut, aucun commentaire n'est intégré au fichier de substitution.

Une fois que vous générez le fichier de substitution, vous pouvez changer les paramètres du fichier de substitution. Si vous exécutez une demande de service, vous pouvez spécifier le fichier de substitution modifié et le script runservice utilise les paramètres modifiés pour exécuter la demande de service.

Les fichiers de substitution utilisent le même espace de nom XML que les demandes de service (http://www.ibm.com/nex/ecore/2.2.0/svc). L'élément principal du fichier de substitution est toujours Overrides. Le format général est une hiérarchie imbriquée de groupes et d'attributs de substitution dérivés du groupe de substitution et des descripteurs d'attribut se trouvant dans la demande de service. Lorsque le script runservice génère un modèle de substitution, les éléments de groupe et d'attribut sont nommés grâce aux noms de descripteurs de groupes et d'attributs de substitution.
<?xml version=”1.0” encoding=”UTF-8”?>
<svc:Overrides xmlns:svc=”http://www.ibm.com/nex/ecore/2.2.0/svc”>
    <svc:ParentGroup uuid=”...”>
        <svc:ChildGroup uuid=”...”>
            <svc:Attribute1 value=”...” uuid=”...” />
            <svc:Attribute2 value=”...” uuid=”...” />
            <svc:Attribute3 value=”...” uuid=”...” />
            ...
        </svc:ChildGroup>
        ...
    </svc:ParentGroup>
    ...
</svc:Overrides>
Le fichier de substitution doit être chiffré à l'aide d'UTF-8.

Fichier de mappage

Un fichier de mappage est un fichier que le proxy utilise pour comparer le pilote JDBC d'une demande de service à un pilote JDBC du proxy. Si le pilote JDBC de la demande de service correspond à une ligne du fichier de mappage, le proxy utilise le pilote JDBC indiqué sur cette ligne. Si le pilote JDBC d'une demande de service ne correspond pas aux lignes du fichier de mappage, le proxy utilise le pilote JDBC correct indiqué dans la demande de service. (Le proxy peut être configuré pour utiliser une version plus récente du pilote JDBC s'il en existe sur le proxy.)

Le fichier de mappage utilisé par le script runservice est similaire à un fichier .properties Java standard. Les lignes vierges sont ignorées. Les lignes commençant par le caractère dièse (#) sont traitées comme des commentaires. Toutes les autres lignes doivent présenter le format suivant :
<regex>=<path>
<regex> est un modèle d'expression régulière valide utilisé pour correspondre au nom d'un fichier .jar fourni par Designer. <path> est un chemin complet vers un fichier .jar réel d'un proxy.
Par exemple, un fichier de mappage contient les lignes suivantes :
db2jcc4.*\.jar=/opt/IBM/sqllib/java/db2jcc4.jar
db2jcc4_license_cu.*\.jar=/opt/IBM/sqllib/java/db2jcc4_license_cu.jar
Si une demande de service est paramétrée pour utiliser le pilote JDBC db2jcc4-9.1.jar, le proxy exécute la demande de service à l'aide du pilote JDBC /opt/IBM/sqllib/java/db2jcc4.jar. Si une demande de service est paramétrée pour utiliser le pilote JDBC db2jcc4_license_cu-9.1.jar, le proxy exécute la demande de service à l'aide du pilote JDBC /opt/IBM/sqllib/java/db2jcc4_license_cu.jar.

Chiffrement d'un mot de passe

Vous pouvez utiliser le script runservice pour chiffrer un mot de passe de texte en clair dans une demande de service.

runservice {-e|--encryptPassword} motdepasse 
--encryptPassword | -e motdepasse

Mot de passe de texte en clair que vous souhaitez coder. Obligatoire.

Consultation de la table initiale

Vous pouvez utiliser le script runservice pour afficher la table initiale (et d'autres tables) dans une demande de service.

runservice {-a|--startTable} cheminfichierdemande
{-o|--otherTables } {true|false}
--startTable | -a cheminfichierdemande

Chemin d'accès au fichier complet pour la demande de service exportée dont la table initiale doit s'afficher. Obligatoire.

Les noms de fichiers de demande de service sont sensibles à la casse. Si le nom de fichier contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

--otherTables | -o

Indiquez si les autres tables de la demande de service doivent être incluses dans la sortie. Les valeurs valides sont true et false. Par défaut, toutes les tables sont incluses.

Affichage d'une demande de service

Vous pouvez utiliser le script runservice pour afficher les informations dans une demande de service.

runservice {-d|--displayService} cheminfichierdemande
{-x|--xsltStylesheet} cheminfeuillestyle
--displayService | -d cheminfichierdemande

Chemin d'accès au fichier complet pour la demande de service exportée dont les informations doivent s'afficher. Obligatoire.

Les noms de fichiers de demande de service sont sensibles à la casse. Si le nom de fichier contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

--xsltStylesheet | -x cheminfichierxslt

Chemin d'accès au fichier complet pour la feuille de style XSLT qui doit être utilisée pour formater la demande de service.

Les noms de fichiers de la feuille de style XSLT sont sensibles à la casse. Si le nom de fichier contient un espace ou des caractères provenant d'un jeu de caractères multi-octets, vous devez entrer le nom entre guillemets.

  • Exemples de ligne de commande
    Cette section contient des exemples de demandes de service soumis à l'aide des commandes de serveur de gestion.