Configuration d'un référentiel de mappage d'entrée, d'un référentiel d'extension de propriété ou d'un référentiel de base de données de registre personnalisé à l'aide des commandes wsadmin
Vous pouvez configurer un référentiel de mappage d'entrée, un référentiel d'extension de propriété ou un référentiel de base de données de registre personnalisé à l'aide des commandes wsadmin.
Avant de commencer
Pour configurer un référentiel de mappage d'entrée, commencez par la procédure décrite dans Configuration d'un référentiel de mappage d'entrées dans une configuration de référentiel fédéré.
Pour configurer un référentiel d'extension de propriété, commencez par la procédure décrite dans Configuration d'un référentiel d'extension de propriété dans une configuration de référentiel fédéré.
Pourquoi et quand exécuter cette tâche
Lors de la création d'un référentiel, utilisez les commandes wsadmin appropriées pour définir le schéma de base de données et alimenter les définitions de propriétés de la base de données.
Procédure
Que faire ensuite
- Définir les arguments en ligne de commande
- Définir les arguments dans un fichier
L'option -file permet de définir un fichier dans lequel sont définis certains ou tous les paramètres. Pour utiliser l'argument -file en ligne de commande, entrez le chemin complet du fichier. Les paramètres du fichier doivent être définis sous forme de paires clé=valeur et chacun doit se trouver sur une ligne distincte. Si un paramètre est défini à la fois en ligne de commande et dans le fichier, la valeur de la ligne de commande est prioritaire.
Conseils pour le diagnostic des erreurs liées aux arguments :
- Si un argument n'est pas correctement défini en ligne de commande ou dans le fichier, un message l'indique. Ce message peut signifier que l'argument n'a pas été défini ou qu'il est nécessaire pour une configuration données.
- Si l'argument n'a pas été défini, vérifiez que le paramètre est défini sur la ligne de commande ou dans le fichier, qu'il a été correctement saisi (caractères et casse).
- Si l'argument n'a pas été défini alors qu'il est nécessaire
pour une configuration donnée, il est possible que la valeur soit requise non seulement
pour la commande, mais également pour le type de base de données et de configuration que
vous définissez.
Par exemple, si vous définissez les paramètres dn, wasAdminId ou wasAdminPassword, vous devez également définir le paramètre dbDriver.
De plus, si les paramètres dn, wasAdminId ou wasAdminPassword sont définis, et si databaseType n'est pas une base de données Apache Derby v10.2, les paramètres dbAdminId et dbAdminPassword doivent également être définis.
![[z/OS]](../images/ngzos.gif)
Commande setupIdMgrDBTables :
La commande setupIdMgrDBTables crée et remplit les tables dans la base de données précédemment créée. Les arguments sont dépendants maj/min, en ligne de commande et dans le fichier.
- schemaLocation (chaîne, obligatoire)
- Emplacement du répertoire <WAS>/etc/wim/setup.
- dbPropXML (chaîne)
- Emplacement du fichier XML de définition des propriétés du référentiel de la base de données.
- databaseType (chaîne, obligatoire)
- Type de base de données. Les bases de données prises en charge sont db2, oracle, informix, derby, sqlserver, db2zos et db2iseries.
- dbURL (chaîne, obligatoire)
- URL de la base de données pour le mode d'accès direct. Par exemple : jdbc:db2:wim.
- dbDriver (chaîne)
- Nom du pilote de la base de données. Par exemple : com.ibm.db2.jcc.DB2Driver.
- dbAdminId (chaîne)
- ID administrateur de la base de données pour le mode d'accès direct. Par exemple :
db2admin.Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminId n'est pas obligatoire.
- dbAdminPassword (chaîne)
- Mot de passe associé à dbAdminId. Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminPassword n'est pas obligatoire.
- dn (chaîne)
- NomUnique de l'organisation par défaut à remplacer. Par exemple : o=societe. S'il n'est pas défini, la valeur o=Default Organization est appliquée.
- wasAdminId (chaîne)
- ID de l'utilisateur administrateur de WebSphere Application Server. Cet ID doit être un nom abrégé, et non un NomUnique. Par exemple : wasadmin. Après la création, le NomUnique est uid=wasadmin, <defaultOrg>.
- wasAdminPassword (chaîne)
- Mot de passe de l'utilisateur administrateur de WebSphere Application Server. Si wasAdminId est défini, ce paramètre est obligatoire.
- saltLength (entier)
- Longueur du sel de cryptage généré de façon aléatoire pour le hachage du mot de passe.
- encryptionKey (chaîne)
- Clé de chiffrement du mot de passe. Définissez la clé de chiffrement du mot de passe de façon à la faire correspondre à la clé de chiffrement du fichier wimconfig.xml associé à ce référentiel. Si la clé de chiffrement n'est pas définie, la valeur par défaut est appliquée.
- derbySystemHome (chaîne)
- Emplacement de base du système Apache Derby v10.2 si vous configurez une base de données Apache Derby v10.2.
- reportSqlError (chaîne)
- Détermine si les erreurs SQL doivent être signalées lors de la configuration des bases de données.
- file (chaîne)
- Chemin d'accès absolu du fichier contenant les paramètres d'entrée. Chaque paramètre d'entrée doit correspondre à un paramètre associé entré en ligne de commande et il doit être placé dans une paire clé=valeur. Chaque paire doit se trouver sur une ligne distincte.
tablesBufferPool (chaîne)
Variable de pool de mémoire tampon des tables par défaut dans DB2 for z/OS. La valeur par défaut est BP0.
LOBtablesBufferPool (chaîne)
Variable de pool de mémoire tampon des tables LOB dans DB2 for z/OS. La valeur par défaut est BP0.
indextablesBufferPool (chaîne)
Variable de pool de mémoire tampon des tables d'index unique dans DB2 for z/OS. La valeur par défaut est BP0.
dbSchema (chaîne)
Schéma de base de données dans lequel vous voulez créer les tables de référentiel fédéré. Ce schéma doit exister dans la base de données. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
dbSchema (chaîne)
Schéma de base de données dans lequel vous voulez créer les tables de référentiel fédéré. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
tablespacePrefix (chaîne)
Préfixe de l'espace table. La longueur maximale autorisée pour cette chaîne est de 3 caractères. La valeur du paramètre tablespacePrefix est obligatoire lorsque vous utilisez le paramètre dbSchema. Ce paramètre est spécifique à DB2 for z/OS et sera ignoré pour tout autre type de base de données.
Commande deleteIdMgrDBTables :
La commande deleteIdMgrDBTables supprime les tables de la base de données.
- schemaLocation (chaîne, obligatoire)
- Emplacement du répertoire <WAS>/etc/wim/setup.
- databaseType (chaîne, obligatoire)
- Type de base de données. Les bases de données prises en charge sont db2, oracle, informix, derby, sqlserver, db2zos et db2iseries.
- dbURL (chaîne, obligatoire)
- URL de la base de données pour le mode d'accès direct. Par exemple : jdbc:db2:wim.
- dbDriver (chaîne)
- Nom du pilote de la base de données. Par exemple : com.ibm.db2.jcc.DB2Driver.
- dbAdminId (chaîne)
- ID administrateur de la base de données pour le mode d'accès direct. Par exemple :
db2admin.Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminId n'est pas obligatoire.
- dbAdminPassword (chaîne)
- Mot de passe associé à dbAdminId. Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminPassword n'est pas obligatoire.
- derbySystemHome (chaîne)
- Emplacement de base du système Apache Derby v10.2 si vous configurez une base de données Apache Derby v10.2.
- reportSqlError (chaîne)
- Détermine si les erreurs SQL doivent être signalées lors de la configuration des bases de données.
- file (chaîne)
- Chemin d'accès absolu du fichier contenant les paramètres d'entrée. Chaque paramètre d'entrée doit correspondre à un paramètre associé entré en ligne de commande et il doit être placé dans une paire clé=valeur. Chaque paire doit se trouver sur une ligne distincte.
dbSchema (chaîne)
Schéma de base de données à partir duquel vous voulez supprimer les tables de référentiel fédéré. Ce schéma doit exister dans la base de données. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
dbSchema (chaîne)
Schéma de base de données à partir duquel vous voulez supprimer les tables de référentiel fédéré. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
tablespacePrefix (chaîne)
Préfixe de l'espace table. La longueur maximale autorisée pour cette chaîne est de 3 caractères. La valeur du paramètre tablespacePrefix est obligatoire lorsque vous utilisez le paramètre dbSchema. Ce paramètre est spécifique à DB2 for z/OS et sera ignoré pour tout autre type de base de données.
Commande setupIdMgrPropertyExtensionRepositoryTables :
La commande setupIdMgrPropertyExtensionRepositoryTables définit le référentiel d'extension de propriété. Le comportement par défaut inclut la création et le remplissage des tables de la base de données.
Cette commande est disponible en mode connecté ou local.
- schemaLocation (chaîne, obligatoire)
- Emplacement du répertoire app_server_root/etc/wim/setup.
- laPropXML (chaîne)
- Emplacement du fichier XML de définition du référentiel d'extension de propriété.
- databaseType (chaîne, obligatoire)
- Type de base de données. Les bases de données prises en charge sont db2, oracle, informix, derby, sqlserver, db2zos et db2iseries.
- dbURL (chaîne, obligatoire)
- URL de la base de données pour le mode d'accès direct. Par exemple : jdbc:db2:wim.
- dbAdminId (chaîne)
- ID administrateur de la base de données pour le mode d'accès direct. Par exemple :
db2admin.Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminId n'est pas obligatoire.
- dbAdminPassword (chaîne)
- Mot de passe associé à dbAdminId. Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminPassword n'est pas obligatoire.
- derbySystemHome (chaîne)
- Emplacement de base du système Apache Derby v10.2 si vous configurez une base de données Apache Derby v10.2.
- reportSqlError (chaîne)
- Détermine si les erreurs SQL doivent être signalées lors de la configuration des bases de données.
- skipDBCreation (Booléen)
- Indique si les tables doivent être créées dans le référentiel d'extension de propriété.
Si vous définissez cette valeur de paramètre sur false ou si vous n'indiquez aucune valeur, la commande suit le comportement par défaut de création et de remplissage des tables dans la base de données.
Si vous définissez cette valeur de paramètre sur true, configurez manuellement le référentiel d'extension de propriété avant d'exécuter cette commande afin que les tables soient remplies. Pour plus d'informations sur ce processus manuel, consultez la rubrique appropriée sur la définition manuelle du référentiel d'extension de propriété pour votre base de données.
- file (chaîne)
- Chemin d'accès absolu du fichier contenant les paramètres d'entrée. Chaque paramètre d'entrée doit correspondre à un paramètre associé entré en ligne de commande et il doit être placé dans une paire clé=valeur. Chaque paire doit se trouver sur une ligne distincte.
tablesBufferPool (chaîne)
Variable de pool de mémoire tampon des tables par défaut dans DB2 for z/OS. La valeur par défaut est BP0.
LOBtablesBufferPool (chaîne)
Variable de pool de mémoire tampon des tables LOB dans DB2 for z/OS. La valeur par défaut est BP0.
indextablesBufferPool (chaîne)
Variable de pool de mémoire tampon des tables d'index unique dans DB2 for z/OS. La valeur par défaut est BP0.
dbSchema (chaîne)
Schéma de base de données dans lequel vous voulez créer les tables de référentiel fédéré. Ce schéma doit exister dans la base de données. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
dbSchema (chaîne)
Schéma de base de données dans lequel vous voulez créer les tables de référentiel fédéré. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
tablespacePrefix (chaîne)
Préfixe de l'espace table. La longueur maximale autorisée pour cette chaîne est de 3 caractères. La valeur du paramètre tablespacePrefix est obligatoire lorsque vous utilisez le paramètre dbSchema. Ce paramètre est spécifique à DB2 for z/OS et sera ignoré pour tout autre type de base de données.
Commande deleteIdMgrPropertyExtensionRepositoryTables :
La commande deleteIdMgrPropertyExtensionRepositoryTables supprime les tables de la base de données d'extension de propriété.
Cette commande est disponible en mode connecté ou local.
- schemaLocation (chaîne, obligatoire)
- Emplacement du répertoire <WAS>/etc/wim/setup.
- databaseType (chaîne, obligatoire)
- Type de base de données. Les bases de données prises en charge sont db2, oracle, informix, derby, sqlserver, db2zos et db2iseries.
- dbURL (chaîne, obligatoire)
- URL de la base de données pour le mode d'accès direct. Par exemple : jdbc:db2:wim.
- dbDriver (chaîne)
- Nom du pilote de la base de données. Par exemple : com.ibm.db2.jcc.DB2Driver.
- dbAdminId (chaîne)
- ID administrateur de la base de données pour le mode d'accès direct. Par exemple :
db2admin.Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminId n'est pas obligatoire.
- dbAdminPassword (chaîne)
- Mot de passe associé à dbAdminId. Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminPassword n'est pas obligatoire.
- derbySystemHome (chaîne)
- Emplacement de base du système Apache Derby v10.2 si vous configurez une base de données Apache Derby v10.2.
- reportSqlError (chaîne)
- Détermine si les erreurs SQL doivent être signalées lors de la configuration des bases de données.
- file (chaîne)
- Chemin d'accès absolu du fichier contenant les paramètres d'entrée. Chaque paramètre d'entrée doit correspondre à un paramètre associé entré en ligne de commande et il doit être placé dans une paire clé=valeur. Chaque paire doit se trouver sur une ligne distincte.
dbSchema (chaîne)
Schéma de base de données à partir duquel vous voulez supprimer les tables de référentiel fédéré. Ce schéma doit exister dans la base de données. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
dbSchema (chaîne)
Schéma de base de données à partir duquel vous voulez supprimer les tables de référentiel fédéré. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
tablespacePrefix (chaîne)
Préfixe de l'espace table. La longueur maximale autorisée pour cette chaîne est de 3 caractères. La valeur du paramètre tablespacePrefix est obligatoire lorsque vous utilisez le paramètre dbSchema. Ce paramètre est spécifique à DB2 for z/OS et sera ignoré pour tout autre type de base de données.
Commande The setupIdMgrEntryMappingRepositoryTables :
La commande setupIdMgrEntryMappingRepositoryTables configure le référentiel de mappage d'entrée, ce qui inclut la création et l'alimentation des tables du référentiel.
- schemaLocation (chaîne, obligatoire)
- Emplacement du répertoire <WAS>/etc/wim/setup.
- databaseType (chaîne, obligatoire)
- Type de base de données. Les bases de données prises en charge sont db2, oracle, informix, derby, sqlserver, db2zos et db2iseries.
- dbURL (chaîne, obligatoire)
- URL de la base de données pour le mode d'accès direct. Par exemple : jdbc:db2:wim.
- dbDriver (chaîne)
- Nom du pilote de la base de données. Par exemple : com.ibm.db2.jcc.DB2Driver.
- dbAdminId (chaîne)
- ID administrateur de la base de données pour le mode d'accès direct. Par exemple :
db2admin.Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminId n'est pas obligatoire.
- dbAdminPassword (chaîne)
- Mot de passe associé à dbAdminId. Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminPassword n'est pas obligatoire.
- derbySystemHome (chaîne)
- Emplacement de base du système Apache Derby v10.2 si vous configurez une base de données Apache Derby v10.2.
- reportSqlError (chaîne)
- Détermine si les erreurs SQL doivent être signalées lors de la configuration des bases de données.
- file (chaîne)
- Chemin d'accès absolu du fichier contenant les paramètres d'entrée. Chaque paramètre d'entrée doit correspondre à un paramètre associé entré en ligne de commande et il doit être placé dans une paire clé=valeur. Chaque paire doit se trouver sur une ligne distincte.
tablesBufferPool (chaîne)
Variable de pool de mémoire tampon des tables par défaut dans DB2 for z/OS. La valeur par défaut est BP0.
dbSchema (chaîne)
Schéma de base de données dans lequel vous voulez créer les tables de référentiel fédéré. Ce schéma doit exister dans la base de données. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
dbSchema (chaîne)
Schéma de base de données dans lequel vous voulez créer les tables de référentiel fédéré. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
tablespacePrefix (chaîne)
Préfixe de l'espace table. La longueur maximale autorisée pour cette chaîne est de 3 caractères. La valeur du paramètre tablespacePrefix est obligatoire lorsque vous utilisez le paramètre dbSchema. Ce paramètre est spécifique à DB2 for z/OS et sera ignoré pour tout autre type de base de données.
Commande deleteIdMgrEntryMappingRepositoryTables :
La commande deleteIdMgrEntryMappingRepositoryTables supprime les tables du référentiel de mappage d'entrée.
- schemaLocation (chaîne, obligatoire)
- Emplacement du répertoire <WAS>/etc/wim/setup.
- databaseType (chaîne, obligatoire)
- Type de base de données. Les bases de données prises en charge sont db2, oracle, informix, derby, sqlserver, db2zos et db2iseries.
- dbURL (chaîne, obligatoire)
- URL de la base de données pour le mode d'accès direct. Par exemple : jdbc:db2:wim.
- dbDriver (chaîne)
- Nom du pilote de la base de données. Par exemple : com.ibm.db2.jcc.DB2Driver.
- dbAdminId (chaîne)
- ID administrateur de la base de données pour le mode d'accès direct. Par exemple :
db2admin.Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminId n'est pas obligatoire.
- dbAdminPassword (chaîne)
- Mot de passe associé à dbAdminId. Remarque : Pour une base de données imbriquée Apache Derby v10.2, dbAdminPassword n'est pas obligatoire.
- derbySystemHome (chaîne)
- Emplacement de base du système Apache Derby v10.2 si vous configurez une base de données Apache Derby v10.2.
- reportSqlError (chaîne)
- Détermine si les erreurs SQL doivent être signalées lors de la configuration des bases de données.
- file (chaîne)
- Chemin d'accès absolu du fichier contenant les paramètres d'entrée. Chaque paramètre d'entrée doit correspondre à un paramètre associé entré en ligne de commande et il doit être placé dans une paire clé=valeur. Chaque paire doit se trouver sur une ligne distincte.
dbSchema (chaîne)
Schéma de base de données à partir duquel vous voulez supprimer les tables de référentiel fédéré. Ce schéma doit exister dans la base de données. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
dbSchema (chaîne)
Schéma de base de données à partir duquel vous voulez supprimer les tables de référentiel fédéré. La valeur par défaut est le schéma par défaut de la base de données en fonction du type de base de données. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
tablespacePrefix (chaîne)
Préfixe de l'espace table. La longueur maximale autorisée pour cette chaîne est de 3 caractères. La valeur du paramètre tablespacePrefix est obligatoire lorsque vous utilisez le paramètre dbSchema. Ce paramètre est spécifique à DB2 for z/OS et sera ignoré pour tout autre type de base de données.
Exemple de syntaxe en ligne de commande :
$AdminTask setupIdMgrDBTables {-schemaLocation "C:/WAS/etc/wim/setup" -dbPropXML
"C:/WAS/etc/wim/setup/wimdbproperties.xml" -databaseType db2
-dbURL jdbc:db2:wim -dbAdminId db2admin
-dbDriver com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd
-reportSqlError true}
$AdminTask deleteIdMgrDBTables {-schemaLocation "C:/WAS/etc/wim/setup"
-databaseType db2 -dbURL jdbc:db2:wim -dbAdminId db2admin
-dbDriver com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd
-reportSqlError true}
$AdminTask setupIdMgrPropertyExtensionRepositoryTables {-schemaLocation
"C:/WAS/etc/wim/setup"
-laPropXML "C:/WAS/etc/wim/setup/wimlaproperties.xml" -databaseType db2
-dbURL jdbc:db2:wim -dbAdminId db2admin -dbDriver com.ibm.db2.jcc.DB2Driver
-dbAdminPassword db2adminPwd -reportSqlError true}
$AdminTask deleteIdMgrPropertyExtensionRepositoryTables {-schemaLocation "C:/WAS/etc/wim/setup "
-databaseType db2 -dbURL jdbc:db2:wim -dbAdminId db2admin -dbDriver
com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd -reportSqlError true}
$AdminTask setupIdMgrEntryMappingRepositoryTables {-schemaLocation "C:/WAS/etc/wim/setup"
-databaseType db2 -dbURL jdbc:db2:wim -dbAdminId db2admin -dbDriver
com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd -reportSqlError true}
$AdminTask deleteIdMgrEntryMappingRepositoryTables {-schemaLocation "C:/WAS/etc/wim/setup"
-databaseType db2 -dbURL jdbc:db2:wim -dbAdminId db2admin -dbDriver
com.ibm.db2.jcc.DB2Driver -dbAdminPassword db2adminPwd -reportSqlError true}
Exemple de syntaxe CLI avec l'option -file :
$AdminTask setupIdMgrDBTables {–file C:/params.txt -dbPropXML
"C:/OverrideDBPropParam/wimdbproperties.xml"}
Params.txtschemaLocation=C:/WAS/etc/wim/setup
dbPropXML=C:/Program Files/IBM/WebSphere/AppServer/profiles/default
/config/cells/mycell/wim/config/wimdbproperties.xml
laPropXML=C:/Program Files/IBM/WebSphere/AppServer/profiles/default
/config/cells/mycell/wim/config/wimlaproperties.xml
databaseType=db2
dbURL=jdbc:db2:wim
dbDriver=com.ibm.db2.jcc.DB2Driver
reportSqlError=true
dn=o=db.com
dbAdminId=db2admin
dbAdminPassword=dbPassword
wasAdminId=wasadmin
wasAdminPassword=wasadmin1
$AdminTask setupIdMgrDBTables {-file C:/params.txt}