FileNet P8 Content Engine, Version 5.0.+              

Commande execute

La commande execute applique les paramètres d'un fichier XML de configuration pour une tâche de configuration spécifiée. Le nom de commande n'est pas sensible à la casse.

Syntaxe de la commande execute

La syntaxe ci-dessous contient des retours à la ligne pour en faciliter la lecture. Mais elle doit être saisie sur une seule ligne, sans retours à la ligne.

configmgr_cl execute [-task type_de-tâche | -taskfile nom_de_fichier_de_tâche]
 -profile monprofil [-silent] [-force] [-help]

Paramètres de la commande execute

-task type_de_tâche
Le paramètre -task type_de_tâche indique la tâche à exécuter. En présence du paramètre -taskfile nom_de_fichier_de_tâche, ou si vous désirez exécuter toutes les tâches, le paramètre -task type_de_tâche peut être omis. La valeur type_de_tâche n'est pas sensible à la casse. Le tableau ci-dessous présente la liste des noms de tâche valides, des fichiers XML de configuration associés, et la description des paramètres de Content Engine affectés par la tâche.
Tableau 1. Valeurs du nom de tâche
Option Fichier de configuration à exécuter Description
Omise

configurebootstrap.xml

configurebootstrap.n.xml

configurejdbcgcd.xml

configurejdbcos.xml

configurejdbcos.n.xml

configureldap.xml

configureldap.n.xml

configureloginmodules.xml

deployapplication.xml

n est un nombre entier égal ou supérieur à 2.

Lorsque les paramètres -task type_de_tâche et -taskfile nom_de_fichier_de_tâche sont omis, tous les fichiers de configuration du répertoire sont exécutés. Tous les fichiers XML de configuration dont l'attribut enabled dans la balise <configuration> est défini à false ne sont pas pris en compte.
configurebootstrap

configurebootstrap.xml

configurebootstrap.n.xml, où n est un nombre entier égal ou supérieur à 2.

Applique les paramètres d'amorçage de Content Engine sur le serveur d'applications. Les informations relatives à l'amorçage sont nécessaires pour la création de la base de données FNGCD (Global Configuration Data) et le démarrage de Content Engine.

Si vous créez un deuxième fichier de configuration d'amorçage, il est nommé configurebootstrap.2.xml. Le nom de fichier s'incrémente à chaque nouveau fichier. Le nom du fichier n'est pas modifiable, mais le nom de la tâche à l'intérieur du fichier l'est. Par exemple, vous pourriez exécuter la tâche initiale d'amorçage d'un nouveau profil, puis exécuter une tâche de modification du fichier EAR pour l'application d'un correctif.

Si le profil contient plus d'une tâche configurebootstrap, le paramètre -taskfile nom_de_fichier_de_tâche doit être présent pour identifier la tâche à exécuter.

configurejdbcgcd

configurejdbcgcd.xml

Applique les paramètres de configuration des connections JDBC à la base de données GCD (Global Configuration Data) utilisée par Content Engine.

configurejdbcos

configurejdbcos.xml

configurejdbcos.n.xml , où n est un nombre entier égal ou supérieur à 2.

Applique les paramètres de configuration des connections JDBC à une base de données de librairies utilisée par Content Engine. La tâche configurejdbcos doit être créée, éditée et appliquée pour chaque librairie de la base de données.

Si vous créez un deuxième fichier de configuration de librairie JDBC, il est nommé configurejdbcos.2.xml. Le nom de fichier s'incrémente à chaque nouveau fichier. Il est éditable.

Si le profil contient plus d'une tâche configurejdbcos, le paramètre -taskfile nom_de_fichier_de_tâche doit être présent pour identifier la tâche à exécuter.

configureldap

configureldap.xml

configureldap.n.xml , où n est un nombre entier égal ou supérieur à 2.

Configure la connexion au serveur d'annuaire pour l'authentification des utilisateurs de Content Engine.

WebSphere Application Server ou Oracle WebLogic Server seulement) Si vous créez un deuxième fichier de configuration LDAP, il sera nommé configureldap.2.xml. Le nom de fichier s'incrémente à chaque nouveau fichier. Il est éditable.

JBoss ne prend pas en charge plusieurs tâches LDAP.

Si le profil contient plus d'une tâche configureldap, le paramètre -taskfile nom_de_fichier_de_tâche doit être présent pour identifier la tâche à exécuter.

Oracle WebLogic Server seulement. Lorsque l'option configureldap est exécutée, la valeur de
weblogic.security.
providers.authentication.
DefaultAuthenticator.
ControlFlag
est définie à SUFFICIENT pour l'authentification des utilisateurs.
configureloginmodules configureloginmodules.xml (WebSphere Application Server ou JBoss Application Server seulement) Crée les modules de connexion pour Content Engine
deployapplication deployapplication.xml Déploie Content Engine sur le serveur d'applications.
registerem registerem.xml Windows seulement. Enregistre ou supprime l'enregistrement d'Enterprise Manager du registre Windows.
-taskfile nom_de_fichier_de_tâche
Le paramètre -taskfile nom_de_fichier_de_tâche spécifie le fichier XML de configuration à utiliser.

S'il n'existe qu'un seul fichier de tâche par type de tâche, le paramètre -taskfile nom_de_fichier_de_tâche est facultatif.

En revanche, s'il existe plusieurs fichiers de tâche par type de tâche, le paramètres -taskfile nom_de_fichier_de_tâche doit être spécifié. En présence du paramètre -taskfile nom_de_fichier_de_tâche, le paramètre -task type_de_tâche peut être omis.

-profile monprofil
Le paramètre -profile monprofil indique le profil à utiliser. La valeur de monprofil peut être l'un des éléments suivants :
  • Le nom du profil, par exemple ce_was_tiv_db2. Le profil doit être dans le répertoire chemin_d_installation_de_ce/tools/configure/profiles, où chemin_d_installation_de_ce est le répertoire dans lequel Content Engine est installé.
  • Le chemin absolu du répertoire contenant le profil, par exemple "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2" ou opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2.
  • Le chemin absolu du fichier en entrée, par exemple "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg" ou opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2/ce_was_tiv_db2.cfg.
A faire : Si le chemin comporte un nom de répertoire incluant un espace, il doit être mis entre guillemets. Saisissez, par exemple, "C:\Program Files\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg".
-silent
Le paramètre -silent est facultatif. Lorsque -silent est spécifié, la console n'affiche ni invites ni messages d'information, mais les erreurs sont consignées dans le journal. Les messages d'incident et d'erreur de validation s'affichent si nécessaire, par exemple lorsqu'il manque un mot de passe ou qu'un numéro de port est non valide. La commande d'exécution de toutes les tâches d'un profil contenant le paramètre -silent doit aussi contenir le paramètre -force.
-force
Le paramètre -force est facultatif et n'est valide qu'avec le paramètre -silent. Le paramètre -force implique que la tâche est exécutée sans qu'il soit attendu de réponse aux messages d'erreur de validation, par exemple lorsqu'il manque un mot de passe ou qu'un numéro de port est non valide.
-help
Le paramètre -help est facultatif. Un bref message sur la syntaxe de la commande s'affiche et celle-ci n'est pas exécutée.

Exemples de commande execute

La syntaxe ci-dessous contient des retours à la ligne pour en faciliter la lecture. Mais elle doit être saisie sur une seule ligne, sans retours à la ligne.

Exécution de toutes les tâches d'un profil.
La commande ci-dessous exécute toutes les tâches du profil wstdb2jdbc, situé dans le répertoire chemin_d_installation_de_ce/tools/configure/profiles/wstdb2jdbc. Si la commande contient le paramètre -silent, elle doit contenir également le paramètre -force.
 configmgr_cl execute -profile wstdb2jdbc
Exécution de la tâche configurejdbcos dans un profil n'en contenant qu'une.
La commande suivante exécute la tâche configurejdbc dans le répertoire chemin_d_installation_de_ce/tools/configure/profiles/wstdb2jdbc :
 configmgr_cl execute -task configurejdbcos -profile wstdb2jdbc
Exécution d'une seule tâche configurejdbcos dans un profil en contenant plusieurs.
La commande suivante exécute la tâche configurejdbcos.2.xml dans le répertoire chemin_d_installation_de_ce/tools/configure/profiles/wstdb2jdbc :
 configmgr_cl execute -taskfile configurejdbc.2.xml -profile wstdb2jdbc
Affichage de l'aide de la commande execute.
La commande suivante affiche l'aide de la commande execute :
configmgr_cl execute -help


Commentaires

Dernière mise à jour : Novembre 2010


© Copyright IBM Corp. 2010.
Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)