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 du groupe de commandes IdMgrDBSetup.

Avant de commencer

Si vous configurez un référentiel de mappage d'entrées, commencez par les étapes décrites dans Configuration d'un référentiel de mappage d'entrées dans une configuration de référentiel fédéré.

Si vous configurez un référentiel d'extensions de propriété, commencez par les étapes décrites dans Configuration d'un référentiel d'extensions de propriété dans une configuration de référentiel fédéré.

A propos de 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

  1. Créez la base de données.
    Vous pouvez utiliser le produit de base de données relationnelle de votre choix. Les exemples ci-après illustrent quelques conseils concernant des fournisseurs particuliers.
    1. Pour DB2®, ouvrir un Db2 fenêtre de commande ou centre de commande et entrez ce qui suit :
      Db2 create database <name> using codeset UTF-8 territory US
      Entrez les commandes suivantes d'optimisation de base de données :
      
db2 update database configuration for <name> using applheapsz 1024
db2 update database configuration for <name> using stmtheap 4096
db2 update database configuration for <name> using app_ctl_heap_sz 2048
db2 update database configuration for <name> using locklist 1024
db2 update database configuration for <name> using indexrec RESTART
db2 update database configuration for <name> using logfilsiz 1000
db2 update database configuration for <name> using logprimary 12
db2 update database configuration for <name> using logsecond 10
db2 update db cfg for <name> using sheapthres_shr MANUAL
db2 update database configuration for <name> using sortheap 2048
    2. Facultatif: Pour Informix® bases de données utilisantdbaccess, saisissez la commande suivante :
      CREATE DATABASE <name> WITH BUFFERED LOG
    3. Facultatif: Pour Oracle bases de données, la base de données existe déjà lors Oracle installation (par exemple,orcl).
  2. Exécutez lesetupIdMgrEntryMappingRepositoryTables commande, lesetupIdMgrPropertyExtensionRepositoryTables commande, ou lesetupIdMgrDBTables commande (pour les référentiels de registre personnalisés) en procédant comme suit :
    1. Commencer WebSphere® Application Server.
    2. Ouvrez une fenêtre de commande et accédez au<WAS>/Profiles/<PROFILE_NAME>bin:NONE.
    3. Lancez wsadmin.
    4. Entrez les commandes nécessaires décrites dans la section suivante.

Etape suivante

Ces commandes permettent d'effectuer les opérations suivantes :
  • Définir les arguments en ligne de commande
  • Définir les arguments dans un fichier

:NONE.-fileL'option vous permet de spécifier un fichier dans lequel tout ou partie des paramètres sont spécifiés. Pour utiliser le-fileargument sur la ligne de commande, entrez le chemin complet du fichier. Les paramètres du fichier doivent être spécifiés danskey=valuepaires et chacune doit être sur sa propre ligne. 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, 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 ledn,wasAdminIdouwasAdminPasswordparamètres, vous devez également spécifier lesdbDriverparamètre.

    De plus, si ledn,wasAdminIdouwasAdminPasswordles paramètres sont spécifiés et lesdatabaseTypen'est pas un Apache Derby v10.2 base de données, puis ledbAdminIdetdbAdminPasswordles paramètres doivent également être spécifiés.

[z/OS]Important: Utiliser Apache Derby v10.2 pour votre référentiel, vous devez exécuter le Apache Derby Cadre de serveur réseau. Ce canevas prend en charge plusieurs connexions JVM simultanées à la base de données, tandis que le canevas imbriqué fonctionne avec une seule machine JVM, ce qui ne permet pas de répondre aux exigences d'équilibrage de charge. L'exécution du canevas Network Server pour Apache Derby v10.2 nécessite les fichiers et les classes du pilote Client Derby.

Exemples de ligne de commande :

  • deleteIdMgrDBTables
Pour configurer une base de données en ligne de commande, entrez :
$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}
Pour supprimer des tables de base de données en ligne de commande, entrez :
$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}
Pour configurer un référentiel d'extension de propriété en ligne de commande, entrez :
$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}
Pour supprimer un référentiel d'extension de propriété en ligne de commande, entrez :
$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}
Pour configurer un référentiel de mappage d'entrée à l'aide de la ligne de commande, entrez :
$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}
Pour supprimer un référentiel de mappage d'entrée à l'aide de la ligne de commande, entrez :
$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 :

Pour configurer une base de données avec le-fileoption en utilisant l'exemple suivantparams.txtfichier, saisissez les lignes suivantes :
$AdminTask setupIdMgrDBTables {-file C:/params.txt -dbPropXML 
"C:/OverrideDBPropParam/wimdbproperties.xml"}
Params.txt
schemaLocation=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
Pour configurer une base de données avec le-fileen utilisant un fichier uniquement, saisissez ce qui suit :
$AdminTask setupIdMgrDBTables {-file C:/params.txt}
Note: L'utilisation d'un fichier ne fonctionne que si-fileest le seul paramètre spécifié sur la ligne de commande. Si d'autres paramètres sont définis, le fichier n'est pas pris en compte et seuls les paramètres en ligne de commande sont appliqués pour exécuter la commande.