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

Les bases de données ci-après sont prise en charge par le script lorsqu'elles se trouvent sur un système d'exploitation réparti :
  • IBM® DB2
  • Apache Derby
  • IBM Informix Dynamic Server
  • Oracle 11g
  • Microsoft SQL Server
Vous trouverez une liste des versions de base de données prises en charge dans la section traitant de la configuration système requise pour IBM WebSphere Application 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.

Si WebSphere Application Server n'est pas installé sur même système que la base de données, vous devez copier les fichiers suivants du système sur lequel WebSphere Application Server est installé vers celui où se trouve la base de données. Assurez-vous de répliquer la même structure de répertoire dans le répertoire de configuration. La variable db_type représente l'un des noms de répertoire suivants : db2, oracle, informix, derby ou sqlserver.
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.

Systèmes d'exploitation Windows :
  1. Ouvrez une fenêtre de commande.
  2. Accédez au répertoire racine_serveur_applications\etc\wim\setup.
  3. 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.

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.
Systèmes d'exploitation AIX, HP-UX, Linux et Solaris :
  1. Ouvrez une fenêtre de commande
  2. Accédez au répertoire racine_serveur_applications/etc/wim/setup.
  3. 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.

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.

Pourquoi et quand exécuter cette tâche

Les notes suivantes concernant des bases de données spécifiques :
  • 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.
L'instance par défaut suivante est créée dans le cadre de l'installation de la base de données :
  • DB2 : DB2
  • Informix : demo_on
  • SQL Serve r: %computername%
La base de données Informix est créée avec l'environnement suivant :
CLIENT_LOCALE=EN_US.CP1252  
DB_LOCALE=EN_US.8859-1
SERVER_LOCALE=EN_US.CP1252
DBLANG=EN_US.CP125

Procédure

Exécutez le script createIdMgrPropExtDbTables.sh ou createIdMgrPropExtDbTables.bat pour créer les tableaux dans le référentiel d'extension de propriété.
Exécutez le script à partir de l'emplacement suivant ou à partir du répertoire dans lequel vous avez préalablement copié le fichier script :
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
Utilisez les paramètres suivants pour spécifier les valeurs dont vous avez besoin lors de l'exécution du script :
-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.

Sur les systèmes d'exploitation AIX, HP-UX, Linux et Solaris :
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 
Sur les systèmes d'exploitation Windows :
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"

Que faire ensuite

Exécutez la commande setupIdMgrPropertyExtensionRepositoryTables avec le paramètre skipDBCreation défini sur true pour remplir les tableaux créés. Pour plus d'informations, consultez la rubrique 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.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twim_manpropextrepos
Nom du fichier : twim_manpropextrepos.html