Définition manuelle du référentiel d'extension de propriété pour les référentiels fédérés
Vous pouvez utiliser le script createIdMgrPropExtDbTables pour créer des tables dans le référentiel d'extension de propriété pour les référentiels fédérés.
Avant de commencer
- IBM® DB2
- Apache Derby
- IBM Informix Dynamic Server
- Oracle 11g
- Microsoft SQL Server
Pour utiliser la base de données IBM DB2 sur z/OS ou IBM DB2 sur iSeries, consultez la rubrique relative à la configuration manuelle du référentiel d'extension de propriété dans DB2.
app_server_root\etc\wim\setup\bin\createIdMgrPropExtDbTables.sh
app_server_root\etc\wim\setup\bin\createIdMgrPropExtDbTables.bat
app_server_root\etc\wim\setup\lookaside\db_type\dbclean.sql
app_server_root\etc\wim\setup\lookaside\db_type\schema.sql
app_server_root\etc\wim\setup\lookaside\db_type\primarykeys.sql
app_server_root\etc\wim\setup\lookaside\db_type\indexes.sql
app_server_root\etc\wim\setup\lookaside\db_type\references.sql
app_server_root\etc\wim\setup\lookaside\keys.sql
app_server_root\etc\wim\setup\lookaside\bootstrap.sql
Indication du schéma de base de données :
Vous pouvez indiquer le schéma de base de données à l'emplacement où vous voulez créer les tables de référentiel fédéré lorsque vous installez manuellement le référentiel d'extension de propriété.
Si vous voulez utiliser le schéma par défaut de la base de données vous devez exécuter les commandes suivantes sans indiquer le paramètre DBSCHEMA. En principe, le schéma par défaut est l'espace de nom de l'utilisateur de la base de données en cours.
Pour remplacer la variable de schéma dans les fichiers sql par le nom de schéma de base de données actuel, suivez la procédure ci-dessous. Si WebSphere Application Server et la base de données ne se trouvent pas sur le même système, paramétrez la valeur SCHEMA_LOCATION sur l'emplacement dans lequel vous avez copié les fichiers SQL.
- Ouvrez une fenêtre de commande.
- Accédez au répertoire racine_serveur_applications\etc\wim\setup.
- Entrez les commandes suivantes :
set SCHEMA_LOCATION=racine_serveur_applications\etc\wim\setup\lookaside set DBTYPE=<type_bd> set DBSCHEMA=dbschemaname set SCHEMA_DEST_LOCATION=<emplacement auquel les fichiers SQL mis à jour avec les variables remplacées seront copiés> ws_ant.bat -f racine_serveur_applications\etc\wim\setup\filterbuild.xml
où la valeur de <type_bd> est db2, derby, informix, oracle ou sqlserver.
- Ouvrez une fenêtre de commande
- Accédez au répertoire racine_serveur_applications/etc/wim/setup.
- Entrez les commandes suivantes :
export SCHEMA_LOCATION=racine_serveur_applications/etc/wim/setup/lookaside export DBTYPE=<type_bd> export DBSCHEMA=dbschemaname export SCHEMA_DEST_LOCATION=<emplacement auquel les fichiers SQL mis à jour avec les variables remplacées doivent être remplacées> ws_ant.sh -f racine_serveur_applications/etc/wim/setup/filterbuild.xml
où la valeur de <type_bd> est db2, derby, informix, oracle ou sqlserver.
Pourquoi et quand exécuter cette tâche
- Oracle 11g
- Si vous n'avez pas créé la base de données par défaut lors de l'installation du produit Oracle, vous devez créer manuellement la base de données avant d'exécuter le script createIdMgrPropExtDbTables. La valeur de la variable ORACLE_SID est identique au nom de la base de données.
- Si vous voulez créer les tables dans le schéma que vous avez indiqué à l'aide de DBSCHEMA (décrit dans la section précédente, Spécification du schéma de base de données), veillez à créer le schéma indiqué dans cette base de données avant d'exécuter le script createIdMgrPropExtDbTables.
- Sur les systèmes d'exploitation AIX, HP-UX, Linux et Solaris, exécutez le script createIdMgrPropExtDbTables en tant qu'utilisateur Oracle ou en tant que superutilisateur doté des droits d'administrateur de base de données (dba) et des permissions appropriés pour exécuter des requêtes SQL en tant qu'administrateur de base de données système (sysdba).
- IBM DB2
- Sur les systèmes d'exploitation Windows, vous devez initialiser l'environnement DB2 avant d'exécuter le script createIdMgrPropExtDbTables. A l'invite de commande Windows, entrez db2cmd pour ouvrir une fenêtre de commande DB2 et exécutez le fichier de traitement par lots createIdMgrPropExtDbTables.
- Microsoft SQL Server
- Ouvrez une fenêtre de commande, accédez au répertoire app_server_root\bin, puis entrez les commandes suivantes pour remplacer les variables dans les fichiers SQL : Si WebSphere
Application Server et la base de données ne sont pas installés sur le même système, paramétrez la valeur
SCHEMA_LOCATION sur l'emplacement dans lequel vous avez copié les fichiers SQL.
set SCHEMA_LOCATION=racine_serveur_applications\etc\wim\setup\lookaside set DBTYPE=sqlserver set SCHEMA_DEST_LOCATION=<emplacement auquel les fichiers SQL mis à jour avec les variables remplacées seront copiés> set DBOWNER=dbo ws_ant.bat -f racine_serveur_applications\etc\wim\setup\filterbuild.xml
Remarque : Si la variable SCHEMA_DEST_LOCATION n'est pas définie, les fichiers SQL mis à jour sont copiés dans un répertoire avec pour nom la valeur non remplacée sous le répertoire courant. La sortie montre l'emplacement où les fichiers sont copiés. - Ouvrez une fenêtre de commande, accédez au répertoire app_server_root\bin, puis entrez les commandes suivantes pour remplacer les variables dans les fichiers SQL : Si WebSphere
Application Server et la base de données ne sont pas installés sur le même système, paramétrez la valeur
SCHEMA_LOCATION sur l'emplacement dans lequel vous avez copié les fichiers SQL.
- DB2 : DB2
- Informix : demo_on
- SQL Serve r: %computername%
CLIENT_LOCALE=EN_US.CP1252
DB_LOCALE=EN_US.8859-1
SERVER_LOCALE=EN_US.CP1252
DBLANG=EN_US.CP125
Procédure
- Systèmes d'exploitation AIX, HP-UX, Linux et Solaris
- app_server_root/etc/wim/setup/bin/createIdMgrPropExtDbTables.sh
- Windows
- app_server_root\etc\wim\setup\bin\createIdMgrPropExtDbTables.bat
- -b
- Ce paramètre permet de spécifier le répertoire de base de la base de données.
Cette valeur est une valeur de chaîne qui est obligatoire pour tous les types de base de données.
- -d
- Ce paramètre permet d'indiquer le schéma de la base de données.
La valeur de ce paramètre doit être identique à celle indiquée pour DBSCHEMA (comme décrit dans la section précédente, Indication du schéma de base de données).
Il s'agit d'une valeur de chaîne facultative pour les bases de données DB2, Derby et SQL Server si vous voulez indiquer le schéma de base de données pour la création des tables de référentiel fédéré. Cette valeur n'est pas requise pour les bases de données Oracle et Informix.
- -h
- Ce paramètre permet d'afficher les informations d'aide. (Facultatif)
- -i
- Ce paramètre permet de spécifier le répertoire de base de l'instance de base de données.
instance.
Cette valeur est une valeur de chaîne qui est obligatoire pour une base de données DB2 uniquement ; n'indiquez pas de valeur pour d'autres types de base de données.
Ce paramètre s'applique aux systèmes d'exploitation AIX, HP-UX, Linux et Solaris.
- -n
- Ce paramètre permet de spécifier le nom de la base de données à laquelle vous vous connectez.
Pour une base de données Oracle, la valeur de la variable ORACLE_SID est identique au nom de la base de données.
Cette valeur est une valeur de chaîne qui est obligatoire pour tous les types de base de données.
- -p
- Ce paramètre permet de spécifier le mot de passe de l'administrateur de base de données.
Cette valeur est une valeur de chaîne qui est obligatoire pour les bases de données DB2, Oracle, Informix et SQL Server uniquement ; n'indiquez pas de valeur pour une base de données Derby.
- -s
- Sur les systèmes d'exploitation
AIX, HP-UX,
Linux et Solaris, ce
paramètre indique l'emplacement du répertoire
racine_serveur_applications/etc/wim/setup
ou l'emplacement dans lequel les fichiers mis à jour sont copiés
selon la procédure fournie dans la section précédente, Indication du
schéma de base de données.
Dans les systèmes d'exploitation Windows, ce paramètre indique l'emplacement du répertoire racine_serveur_applications\etc\wim\setup ou l'emplacement dans lequel les fichiers mis à jour sont copiés selon la procédure fournie dans la section précédente, Indication du schéma de base de données.
Cette valeur est une valeur de chaîne qui est obligatoire pour tous les types de base de données.
- -t
- Ce paramètre permet de spécifier un type de base de données.
- Sur les systèmes d'exploitation AIX, HP-UX, Linux et Solaris, indiquez l'une des valeurs valides suivantes : db2, oracle, informix- derby.
- Sur les systèmes d'exploitation Windows, indiquez l'une des valeurs valides suivantes : db2, oracle, informix, derby ou sqlserver.
Cette valeur est une valeur de chaîne qui est obligatoire pour tous les types de base de données.
- -u
- Ce paramètre permet de spécifier l'ID utilisateur de l'administrateur de base de données.
Cette valeur est une valeur de chaîne qui est obligatoire pour les bases de données DB2, Oracle, Informix et SQL Server uniquement ; n'indiquez pas de valeur pour une base de données Derby.
Exemple
Exécutez le script approprié pour votre base de données et système d'exploitation pour créer des tableaux dans le référentiel d'extension de propriété. Utilisez les valeurs fournies en exemple pour spécifier les paramètres de base de données. Si la base de données existe sur un système où WebSphere Application Server n'est pas installé, les exemples suivants partent du principe que votre variable PATH inclut une entrée pour l'emplacement où vous avez copié les fichiers de scripts. Sur les systèmes d'exploitation AIX, HP-UX, Linux et Solaris, l'entrée peut être le répertoire app_server_root/etc/wim/setup/bin/ ou /setup/bin/. Sur les systèmes d'exploitation Windows, l'entrée peut être le répertoire app_server_root\etc\wim\setup\bin\ ou \setup\bin\.
Les exemples de la section ci-après figurent sur plusieurs lignes à des fins d'illustration uniquement.
- Bases de données Oracle
createIdMgrPropExtDbTables.sh -b /space/oracle/product/10.2.0/Db_1/ -n orcl -u system -p manager -s /opt/IBM/WebSphere/AppServer1/etc/wim/setup -t oracle
- Bases de données Informix
createIdMgrPropExtDbTables.sh -b /opt/IBM/informix/ -n demo_on -u informix -p informix -s /opt/IBM/WebSphere/AppServer/etc/wim/setup -t informix
- Bases de données DB2
createIdMgrPropExtDbTables.sh -b /opt/ibm/db2/V9.1/ -n db2inst1 -p db2inst1 -s /opt/IBM/WebSphere/AppServer/etc/wim/setup -t DB2 -u db2inst1 -i /home/db2inst1/
- Bases de données Derby
createIdMgrPropExtDbTables.sh -b /opt/ibm/derby/ -n test11 -s /opt/IBM/WebSphere/AppServer/etc/wim/setup -t derby
- Bases de données Oracle
createIdMgrPropExtDbTables.bat -b "c:\oracle\product\10.2.0\Db_1" -n orcl -u system -p manager -s "c:\Program Files\IBM\WebSphere\AppServer1\etc\wim\setup" -t oracle
- Bases de données Informix
createIdMgrPropExtDbTables.bat -b "c:\Program Files\IBM\informix" -n demo_on -u informix -p informix -s "c:\Program Files\IBM\WebSphere\AppServer\etc\wim\setup" -t informix
- Bases de données DB2
createIdMgrPropExtDbTables.bat -t db2 -u db2admin -p sec001ret# -n test23 -b "c:\Program Files\IBM\SQLLIB" -s "c:\Program Files\IBM\WebSphere\AppServer1\etc\wim\setup"
- Bases de données Derby
createIdMgrPropExtDbTables.bat -t derby -b "c:\Derby" -n test11 -s "c:\Program Files\IBM\WebSphere\AppServer1\etc\wim\setup"
- Bases de données Microsoft SQL Server
createIdMgrPropExtDbTables.bat -t sqlserver -u sa -p sec001ret# -n sqlsrv -b "c:\Progra~1\Micros~1\90\Tools" -s "C:\Progra~1\IBM\WebSphere\AppServer1\etc\wim\setup"