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 mon_profil [-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 Platform 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
configurepricingmodel.xml
configurejdbcgcd.xml
configurejdbcos.xml
configurejdbcos.n.xml
configureldap.xml
configureldap.n.xml
configureloginmodules.xml
deployapplication.xml
Où n est un entier supérieur ou égale à 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
Applique les paramètres d'amorçage et d'extraction de texte de Content Platform Engine sur le serveur d'applications. Les informations relatives à l'amorçage sont nécessaires pour la création de la Global Configuration Database et le démarrage de Content Platform Engine.
configurepricingmodel configurepricingmodel.xml
Applique les choix de licence à IBM® FileNet Content Manager ou IBM Content Foundation, IBM Case Foundation, et IBM Case Manager.
configurejdbcgcd configurejdbcgcd.xml
Applique les paramètres de configuration des connections JDBC à la base de données GCD (Global Configuration Database) utilisée par Content Platform Engine.
configurejdbcos configurejdbcos.xml
configurejdbcos.n.xml , où n est un nombre entier supérieur ou égal à 2.
Applique les paramètres de configuration des connections JDBC à une base de données de librairie utilisée par Content Platform 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 supérieur ou égal à 2.
Configure la connexion au serveur d'annuaire pour l'authentification des utilisateurs de Content Platform Engine.
WebSphere Application Server ou Oracle WebLogic Server seulement) Si vous créez un deuxième fichier de configuration LDAP, il est nommé configureldap.2.xml. Le nom de fichier s'incrémente à chaque nouveau fichier. Il est éditable.
JBoss Application Server 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
est définie à SUFFICIENT pour l'authentification des utilisateurs.weblogic.security. providers.authentication. DefaultAuthenticator. ControlFlag
configureloginmodules configureloginmodules.xml (WebSphere Application Server ou JBoss Application Server seulement) Créez les modules de connexion pour l'application Content Platform Engine. deployapplication deployapplication.xml Déployez l'application Content Platform Engine sur le serveur d'applications. - -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 mon_profil
- Le paramètre -profile mon_profil indique le profil à utiliser. La valeur de mon_profil peut être l'un des éléments suivants :
- Le nom du profil, par exemple ce_was_tiv_db2. Le profil doit se trouver dans le répertoire chemin_inst_ce/tools/configure/profiles, où chemin_inst_ce est le répertoire dans lequel Content Platform 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 de profil 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. Si vous exécutez la commande execute pour effectuer toutes les tâches d'un profil et que vous indiquez le paramètre -silent, vous devez également indiquer 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_installation_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 configurepricingmodel (Choose Licenses).
- La commande suivante exécute la tâche configurepricingmodel dans le répertoire chemin_installation_ce/tools/configure/profiles/wstdb2jdbc :
configmgr_cl execute -task configurepricingmodel.xml -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_installation_ce/tools/configure/profiles/wstdb2jdbc :
configmgr_cl execute -task configurejdbcos.xml -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_installation_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