Installation et configuration du référentiel SDO

SDO (Service Data Objects) est une norme ouverte permettant aux applications de traiter de manière uniforme les données des différentes sources de données, sous forme de graphes de données. Les services Web utilisant un bus d'intégration de services emploient un référentiel SDO pour stocker et gérer les définitions WSDL. Exécutez cette tâche pour créer et configurer la base de données de votre choix pour le stockage des données SDO et pour installer et configurer un référentiel SDO sur chaque serveur que vous envisagez d'utiliser pour les services Web activés par un bus.

Avant de commencer

Sélectionnez les serveurs ou les clusters sur lesquels installer et configurer un référentiel SDO comme décrit dans Planification de votre installation de services Web activés par un bus puis ajoutez chaque serveur ou cluster comme membre de bus conformément aux instructions de la rubrique Configuration des membres d'un bus.

Un référentiel SDO fonctionne avec la plupart des produits de base de données. Pour obtenir des informations spécifiques sur le choix et la configuration de votre base de données favorite, consultez votre administrateur de base de données ou la documentation relative à votre base de données, et lisez les remarques de cette rubrique concernant l'utilisation de la base de données.

Pourquoi et quand exécuter cette tâche

Pour installer et configurer un référentiel SDO, procédez comme suit :
  • Installez le produit de base de données de votre choix.
  • Créez un fournisseur JDBC et une source de données pour votre base de données.
  • Exécutez le script installSdoRepository.jacl une ou plusieurs fois afin d'installer l'application SDO sur chaque serveur et pour définir le type de base de données que le référentiel SDO doit utiliser.
Pour plus d'informations sur cette opération, lisez les remarques ci-dessous relatives à l'utilisation de la base de données et au script installSdoRepository.jacl, puis appliquez la procédure pour l'une des configurations suivantes :
Remarques sur l'utilisation d'une base de données :
  • [AIX Solaris HP-UX Linux Windows][IBM i]Pour une configuration de serveur unique, vous pouvez utiliser votre base de données favorite ou la base de données Apache Derby imbriquée qui est fournie avec WebSphere Application Server. [z/OS]Dans un environnement z/OS, vous ne pouvez pas utiliser la base de données Derby imbriquée car elle ne peut être utilisée que par un seul processus à la fois et même un serveur z/OS unique peut s'exécuter dans plusieurs processus.
  • Dans le cas d'une configuration de déploiement réseau, vous pouvez utiliser la base de données de votre choix ou la base de données Derby mise à disposition et l'application Network Server associée. Cependant, vous devrez tenir compte des limitations de Derby Network Server, qui, Les transactions, par exemple, ne sont pas prises en charge.
  • Le référentiel SDO indique les noms de table et de schéma employés ; par conséquent, chaque référentiel doit utiliser une base de données distincte pour garantir que différents référentiels n'accèdent pas aux mêmes données. Utilisez un référentiel SDO pour chaque cellule ; ainsi, si vous disposez de plusieurs cellules, vous devez employer plusieurs bases de données (une pour chaque cellule).
  • [z/OS]Le concept de plusieurs bases de données n'est pas intégré à DB2 sur z/OS . Sur les systèmes z/OS , chaque référentiel SDO doit utiliser une instance DB2 différente afin de garantir que plusieurs référentiels n'accèdent pas aux mêmes données.
  • Créez la base de données du fournisseur de base de données favori à l'aide du fichier Table.ddl à partir du répertoire approprié racine_serveur_app/util/SdoRepository/type_base_données. Le fichier Table.ddl décrit la table de base de données requise par le référentiel SDO.
  • L'indicateur -editBackendId du script installSdoRepository.jacl détermine le type de base de données à utiliser par le référentiel. L'ID du système dorsal détermine les règles propres à la base de données suivies par l'application lorsqu'elle communique avec la base de données. Lisez les remarques sur le script installSdoRepository.jacl.
  • Certaines bases de données requièrent un ID utilisateur autorisé à accéder à la base de données du référentiel SDO. Créez un ID utilisateur pour le nom d'utilisateur SDOREP avant de créer les tables pour les bases de données Oracle, Sybase et SQL Server. Etant donné le mode de gestion des noms d'utilisateur et des noms de table par ces bases de données, le nom d'utilisateur doit être SDOREP afin que le référentiel SDO puisse accéder à sa table avec le nom complet SDOREP.BYTESTORE. Veillez à attribuer à l'utilisateur SDOREP des droits de lecture et d'écriture pour la base de données.
  • Si vous utilisez une base de données Informix, ne désactivez pas la journalisation.
  • Le référentiel SDO n'a pas besoin de la prise en charge XA. Dans la plupart des cas, vous pouvez utiliser une source de données XA ou non XA. Toutefois, si votre base de données est Oracle 8 ou 9, vous devez employer le pilote JDBC Oracle (non XA) pour la source de données du référentiel SDO.
  • Vous pouvez également choisir d'effectuer d'autres opérations pour notamment créer un index de la clé principale afin d'améliorer les performances de la base de données. Ne changez pas le nom du schéma, de la table et des colonnes.
  • Si vous configurez ce référentiel SDO pour l'utiliser avec une cellule contenant des serveurs d'applications WebSphere Application Server Version 6.0, Version 6.1 et versions ultérieures, vous devez employer une base de données compatible avec toutes ces versions.
Remarques sur le script installSdoRepository.jacl :
  • Utilisez le client de scriptage wsadmin pour exécuter le script.
  • [IBM i]Exécutez le script à partir de QShell.
  • Ce script se trouve dans le répertoire racine_serveur_app/binracine_serveur_app est le répertoire racine d'installation de WebSphere Application Server. Si vous choisissez d'exécuter le client de scriptage wsadmin à partir d'un autre répertoire, indiquez le chemin complet du script au niveau de l'option de la commande. Par exemple, pour utiliser un profil différent du profil par défaut, accédez au répertoire racine_serveur_applications/profiles/nom_profil/bin, puis indiquez le chemin suivant pour le script :[IBM i]
    wsadmin -f rép_princ_serveur_app/bin/installSdoRepository.jacl
    [AIX Solaris HP-UX Linux Windows][z/OS]
    wsadmin.ext
    -f
    rép_princ_serveur_app/bin/installSdoRepository.jacl
    [AIX Solaris HP-UX Linux Windows][z/OS].ext est l'extension de fichier .bat pour un système Windows ou .sh pour un système UNIX, Linux ou z/OS.
  • L'indicateur -editBackendId du script installSdoRepository.jacl détermine le type de base de données à utiliser par le référentiel. L'ID du système dorsal détermine les règles propres à la base de données suivies par l'application lorsqu'elle communique avec la base de données. Pour afficher la liste complète des valeurs d'ID du système dorsal disponibles, utilisez l'indicateur -listBackendIds :
    wsadmin -f installSdoRepository.jacl -listBackendIds
    Toutes les valeurs d'ID du système dorsal de la liste peuvent être utilisées lorsque le référentiel SDO est installé sur un ou plusieurs serveurs d'applications WebSphere Application Server Version 7.0 ou ultérieures. Les valeurs portant le symbole (*) ne peuvent pas être utilisées lorsque le référentiel SDO est installé sur des serveursVersion 6.0. Les valeurs portant le symbole (**) ne peuvent pas être utilisées lorsque le référentiel SDO est installé sur des serveurs Version 6.0 ou Version 6.1.
  • Si la source de données existe déjà ou que l'application de référentiel SDO a déjà été installée partiellement ou de manière incorrecte, le script installSdoRepository.jacl échoue et les modifications apportées à la configuration ne sont pas sauvegardées. Dans ce cas, exécutez le script de désinstallation du référentiel SDO, corrigez l'incident et exécutez à nouveau le script installSdoRepository.jacl.
[IBM i][AIX Solaris HP-UX Linux Windows]

Configurez le référentiel SDO pour un serveur unique avec la base de données Derby imbriquée.

[z/OS]

Avant de commencer

[z/OS]Dans un environnement z/OS, vous ne pouvez pas utiliser la base de données Derby imbriquée car elle ne peut être utilisée que par un seul processus à la fois et même un serveur z/OS unique peut s'exécuter dans plusieurs processus.

Pourquoi et quand exécuter cette tâche

Si vous créez une configuration de serveur unique et voulez utiliser la base de données Derby imbriquée, exécutez le script installSdoRepository.jacl avec l'option -createDb. Cette action crée la base de données Derby et installe le référentiel SDO.

Pour configurer le référentiel SDO pour un serveur unique avec la base de données Derby imbriquée, effectuez les étapes ci-après.

Procédure

  1. Ouvrez un invite de commande et placez-vous dans le répertoire rép_princ_serveur_app/bin.
  2. Entrez la commande suivante : [IBM i]
    wsadmin -f installSdoRepository.jacl -createDb
    [AIX Solaris HP-UX Linux Windows][z/OS]
    wsadmin.ext -f installSdoRepository.jacl -createDb
    Remarque : L'option -createDb permet de créer une base de données Derby par défaut. Si vous ne l'indiquez pas, la commande installe un référentiel SDO configuré pour l'utilisation de Derby mais ne crée pas la base de données.

Configurez le référentiel SDO pour un serveur unique avec une base de données autre que la base de données Derby imbriquée

Pourquoi et quand exécuter cette tâche

Si vous créez une configuration de serveur unique utilisant une base de données autre que la base de données Derby imbriquée, installez le produit de base de données de votre choix puis créez un fournisseur JDBC et une source de données et exécutez le script installSdoRepository.jacl deux fois :
  1. une fois pour installer l'application SDO sur le serveur d'applications,
  2. une fois pour définir le type de base de données que le référentiel SDO utilise.

Pour configurer le référentiel SDO pour un serveur unique avec une base de données autre que la base de données Derby imbriquée, effectuez les étapes suivantes :

Procédure

  1. Créez la base de données du fournisseur de base de données favori à l'aide du fichier Table.ddl à partir du répertoire approprié racine_serveur_app/util/SdoRepository/type_base_données.

    Pour consulter une illustration du processus de création des tables dans DB2, voir Recréation des tables d'une base de données à partir du fichier DDL de table exporté. Pour plus d'informations, voir la rubrique Déploiement d'applications d'accès aux données.

  2. Créez un alias d'authentification J2C.

    Ces éléments seront utilisés avec la source de données créée à l'étape suivante. Vérifiez que l'alias d'authentification correspond aux informations de connexion de l'instance de base de données. Dans le cas contraire, aucune connexion n'est établie.

  3. Create and configure a JDBC provider and data source.
    Définissez les propriétés de la source de données suivantes :
    • Configurez la propriété d'authentification pour utiliser l'alias d'authentification créé à l'étape précédente.
    • Cochez la case Utiliser cette source de données dans la persistance CMP.
    • Associez la propriété Nom au nom de votre choix. Par exemple, Source de données du référentiel SDO.
    • Associez la propriété Nom JNDI à la valeur suivante : jdbc/com.ibm.ws.sdo.config/SdoRepository.
    • Définissez les autres propriétés nécessaires à la base de données que vous avez choisie.
  4. Facultatif : Testez la connexion à la source de données :
    Remarque : Cette option ne fonctionne pas dans toutes les configurations. Sa disponibilité dépend de la portée pour laquelle la source de données a été définie et de celle des variables de WebSphere Application Server utilisées dans la configuration de la source de données et dans la configuration du fournisseur JDBC. Pour plus d'informations sur le test des connexions aux sources de données, voir Service de connexion test.
    1. Dans la console d'administration, naviguez à Ressources -> JDBC -> Sources de données.
    2. Sélectionnez la source de données du référentiel SDO.
    3. Cliquez sur Tester la connexion.
  5. Configurez le répertoire SDO :
    1. Ouvrez une invite de commande et accédez au répertoire racine_serveur_app/bin.
    2. Installez l'application du référentiel SDO sur le serveur : [IBM i]
      wsadmin -f installSdoRepository.jacl
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl
    3. Définissez le type de base de données que le référentiel SDO doit utiliser :
      [IBM i]
      wsadmin -f
      installSdoRepository.jacl -editBackendId
      type_base_données
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext
      -f installSdoRepository.jacl -editBackendId
      type_base_données
      Par exemple :[IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId DB2UDB_V82
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId DB2UDB_V82

Configuration du référentiel SDO pour une cellule de déploiement réseau

Pourquoi et quand exécuter cette tâche

Si vous utilisez un environnement de déploiement réseau, installez le produit de base de données de votre choix, puis créez un fournisseur JDBC et une source de données et enfin exécutez le script installSdoRepository.jacl plusieurs fois pour chaque cellule :
  1. une fois pour installer l'application SDO sur le gestionnaire de déploiement,
  2. une fois pour définir le type de base de données que le référentiel SDO utilise.
  3. plusieurs fois pour installer une instance de l'application SDO sur chaque serveur ou cluster que vous envisagez d'utiliser pour un ou plusieurs rôles de service Web activés par un bus.

Pour configurer le référentiel SDO pour une cellule de déploiement réseau, procédez comme suit :

Procédure

  1. Créez la base de données du fournisseur de base de données favori à l'aide du fichier Table.ddl à partir du répertoire approprié racine_serveur_app/util/SdoRepository/type_base_données.

    Pour consulter une illustration du processus de création des tables dans DB2, voir Recréation des tables d'une base de données à partir du fichier DDL de table exporté. Pour plus d'informations, voir la rubrique Déploiement d'applications d'accès aux données.

  2. Créez les variables WebSphere Application Server suivantes au niveau des noeuds sur tous les noeuds affectés, y compris le noeud du gestionnaire de déploiement.
    Remarque : Vous pouvez définir ces variables dans la portée du noeud ou de la cellule, en fonction de votre configuration. Pour les noeuds multiplateformes cependant, vous ne pouvez pas définir WAS_INSTALL_ROOT au niveau de la cellule car les noeuds possèdent des répertoires d'installation distincts.
    1. Dans la console d'administration, naviguez à Environnement -> Variables WebSphere et définissez la portée au niveau du noeud.
    2. Vérifiez que la variable WAS_INSTALL_ROOT existe avec la valeur du répertoire principal d'installation de WebSphere Application Server.
    3. Créez une variable votre_base_de_données_JDBC_DRIVER_PATH associée à la valeur de l'emplacement auquel vos fichiers JAR de base de données doivent être stockés (ultérieurement) sur chaque machine hôte de la cellule.
  3. Créez un alias d'authentification J2C.

    Ces éléments seront utilisés avec la source de données créée à l'étape suivante. Vérifiez que l'alias d'authentification correspond aux informations de connexion de l'instance de base de données. Dans le cas contraire, aucune connexion n'est établie.

  4. Create and configure a JDBC provider and data source.
    Définissez les propriétés de la source de données suivantes :
    • Configurez la propriété d'authentification pour utiliser l'alias d'authentification créé à l'étape précédente.
    • Cochez la case Utiliser cette source de données dans la persistance CMP.
    • Associez la propriété Nom au nom de votre choix. Par exemple, Source de données du référentiel SDO.
    • Associez la propriété Nom JNDI à la valeur suivante : jdbc/com.ibm.ws.sdo.config/SdoRepository.
    • Définissez les autres propriétés nécessaires à la base de données que vous avez choisie.
  5. Déployez les fichiers JAR du client de la base de données sur chacune des machines hôte de la cellule.

    Les fichiers JAR doivent être déployés à l'emplacement indiqué par la variable votre_base_de_données_JDBC_DRIVER_PATH que vous avez déclarée précédemment ; si tel n'est pas le cas, les noeuds distants ne pourront pas se connecter au référentiel SDO.

  6. Configurez le répertoire SDO :
    1. Ouvrez une invite de commande et accédez au répertoire racine_serveur_app/bin.
    2. Installez l'application du référentiel SDO sur le gestionnaire de déploiement de cette cellule : [IBM i]
      wsadmin -f installSdoRepository.jacl nom_noeud_gestionnaire_déploiement nom_serveur_gestionnaire_déploiement
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl nom_serveur_gestionnaire_déploiement nom_serveur_gestionnaire_déploiement
      Par exemple :[IBM i]
      wsadmin -f installSdoRepository.jacl dmgrNode dmgr
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.sh -f installSdoRepository.jacl dmgrNode dmgr
    3. Définissez le type de base de données que le référentiel SDO doit utiliser :
      [IBM i]
      wsadmin -f
      installSdoRepository.jacl -editBackendId
      type_base_données
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext
      -f installSdoRepository.jacl -editBackendId
      type_base_données
      Par exemple :[IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId DB2UDB_V82
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId DB2UDB_V82
    4. Installez une instance du référentiel SDO sur chaque serveur ou cluster que vous avez l'intention d'utiliser pour un ou plusieurs rôles de services Web activés par un bus :
      • Pour chaque serveur n'appartenant pas à un cluster, répétez la commande suivante :[IBM i]
        wsadmin -f installSdoRepository.jacl nom_noeud nom_serveur
        [AIX Solaris HP-UX Linux Windows][z/OS]
        wsadmin.ext -f installSdoRepository.jacl nom_noeud nom_serveur
      • Pour chaque cluster, répétez la commande suivante :[IBM i]
        wsadmin -f installSdoRepository.jacl -cluster nom_cluster
        [AIX Solaris HP-UX Linux Windows][z/OS]
        wsadmin.ext
        -f installSdoRepository.jacl -cluster
        nom_cluster

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=tjw_install_sdo
Nom du fichier : tjw_install_sdo.html