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.
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}
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.
Par exemple : -u http://mgmtserver1:8080.
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
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.
Par exemple : -u http://proxy1:12000.
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.
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.
Par exemple : -l INFO.
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.
Chemin d'accès au fichier complet du fichier dans lequel la réponse du service est écrite.
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}
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.
Par exemple : -u http://mgmtserver1:8080.
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.
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
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
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
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}
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.
Par exemple : -v C:\override\requestfileoverride.xml.
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.
<?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.
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.)
<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.
db2jcc4.*\.jar=/opt/IBM/sqllib/java/db2jcc4.jar db2jcc4_license_cu.*\.jar=/opt/IBM/sqllib/java/db2jcc4_license_cu.jarSi 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.
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
Mot de passe de texte en clair que vous souhaitez coder. Obligatoire.
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}
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.
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.
Vous pouvez utiliser le script runservice pour afficher les informations dans une demande de service.
runservice {-d|--displayService} cheminfichierdemande {-x|--xsltStylesheet} cheminfeuillestyle
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.
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.