IBM InfoSphere Master Data Management Collaboration Server Version Guide de migration SC

Transkript

1 IBM InfoSphere Master Data Management Collaboration Serer Version 11.0 Guide de migration SC

2

3 IBM InfoSphere Master Data Management Collaboration Serer Version 11.0 Guide de migration SC

4 Important Aant d'utiliser le présent document et le produit associé, prenez connaissance des informations figurant à la section «Remarques», à la page 89. Première édition - Juin 2013 Réf. US : SC LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Ce document est mis à jour périodiquement. Chaque nouelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d'être modifiées aant que les produits décrits ne deiennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou serices non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés. Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-ous aux documents d'annonce disponibles dans otre pays, ou adressez-ous à otre partenaire commercial. Vous pouez également consulter les sereurs Internet suiants : (sereur IBM en France) (sereur IBM au Canada) (sereur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité 17, aenue de l'europe Bois-Colombes Cedex Copyright IBM France Tous droits réserés. Copyright IBM Corporation 2000, 2013.

5 Table des matières Tableaux Ais aux lecteurs canadiens..... ii Préface ix Noueautés de la ersion ix Serice de support logiciel IBM xii Chapitre 1. Migration Chapitre 2. Guide d'initiation Chapitre 3. Migration depuis des ersions antérieures Migration des données maître du format interne ers le format XML Migration de la ersion ers la ersion Migration de la ersion ers la ersion Migration de la ersion ers la ersion Migration de la ersion ers la ersion Migration de Global Data Synchronization ersion 1.3.x ers InfoSphere MDM Collaboration Serer ersion Préparation à la migration de GDS 1.3.x Exportation à partir de WebSphere Product Center ersion Importation dans InfoSphere MDM Collaboration Serer ersion Vérification de otre enironnement GDS migré 46 Compilation et débogage de scripts Chapitre 4. Migration de scripts InfoSphere MDM Collaboration Serer. 51 Différences entre les scripts dans les dierses ersions Méthodes aec des signatures différentes dans les ersions et Méthodes aux signatures différentes dans les ersions et Méthodes aec des signatures différentes dans les ersions et Méthodes aec des signatures différentes dans les ersions et Méthodes disponibles uniquement dans la ersion Méthodes disponibles uniquement dans la ersion Méthodes uniquement disponibles en ersion reprises dans la ersion Méthodes uniquement disponibles en ersion reprises dans la ersion actuelle de IBM InfoSphere Master Data Management Collaboration Serer Méthodes uniquement disponibles en ersion reprises dans la ersion Modifications du comportement des opérations de script entre la ersion et la ersion Modifications du comportement des opérations de script entre V et V Modifications du comportement des opérations de script entre les ersions et Différences des API Jaa entre les dierses ersions 71 Méthodes et énumérations API Jaa Nouelles interfaces de programme d'application (API) Jaa Optimisation de la base de données Transformation des métadonnées du modèle de données Corrections par le transformateur XSLT Migration manuelle des scripts Chapitre 5. Identification et résolution des incidents Identification et résolution des incidents liés aux scripts de migration Utilisation de scripts de migration compilés.. 81 Erreurs de compilation de script courantes Erreurs et incidents d'exécution courants Résolution des erreurs et incidents d'exécution courants Utilisation du script checkforcompileerror.sh.. 84 Identification et résolution des problèmes de migration Remarques Index Comment prendre contact aec IBM.. 95 Copyright IBM Corp. 2000, 2013 iii

6 i InfoSphere MDM Collaboration Serer : Guide de migration

7 Tableaux 1. Causes possibles des erreurs et actions recommandées Fichiers SQL à modifier lors de l'utilisation de DB2 ou d'oracle comme base de données dorsale Fichiers SQL à modifier lorsque ous utilisez des noms d'espace de table personnalisés Fichiers SQL à modifier lorsque ous utilisez des noms d'espace de table personnalisés Fichiers SQL à modifier lorsque ous utilisez des noms d'espace de table personnalisés Comparaison des méthodes aec des signatures différentes dans les ersions et Comparaison des méthodes aux signatures différentes dans les ersions et Comparaison des méthodes aec des signatures différentes dans les ersions et Comparaison des méthodes aec des signatures différentes dans les ersions et Ressources IBM Transmission de commentaires à IBM Copyright IBM Corp. 2000, 2013

8 i InfoSphere MDM Collaboration Serer : Guide de migration

9 Ais aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont ous deez tenir compte. Illustrations Les illustrations sont fournies à titre d'exemple. Certaines peuent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-ous au tableau ci-dessous, au besoin. IBM France ingénieur commercial agence commerciale ingénieur technico-commercial inspecteur IBM Canada représentant succursale informaticien technicien du matériel Claiers Les lettres sont disposées différemment : le claier français est de type AZERTY, et le claier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : les pages de codes 850 (multilingue) et 863 (français-canadien), le code pays 002, le code claier CF. Nomenclature Les touches présentées dans le tableau d'équialence suiant sont libellées différemment selon qu'il s'agit du claier de la France, du claier du Canada ou du claier des États-Unis. Reportez-ous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de otre claier. Copyright IBM Corp. 2000, 2013 ii

10 Breets Il est possible qu'ibm détienne des breets ou qu'elle ait déposé des demandes de breets portant sur certains sujets abordés dans ce document. Le fait qu'ibm ous fournisse le présent document ne signifie pas qu'elle ous accorde un permis d'utilisation de ces breets. Vous pouez enoyer, par écrit, os demandes de renseignements relaties aux permis d'utilisation au directeur général des relations commerciales d'ibm, 3600 Steeles Aenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si ous aez besoin d'assistance ou si ous oulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au iii InfoSphere MDM Collaboration Serer : Guide de migration

11 Préface Ces informations expliquent comment migrer d'ibm InfoSphere Master Data Management Serer for Product Information Management, ersions et 9.1.0, et d'ibm InfoSphere Master Data Management Collaboration Serer ersion ers IBM InfoSphere Master Data Management Collaboration Serer ersion en exécutant des sous-étapes et des migrations. A propos de cette publication Les informations du présent guide courent les rubriques suiantes : instructions pas à pas, pratiques recommandées, réglage des performances et résolution des incidents courants. Public cible Ce guide de migration est destiné aux installateurs, aux administrateurs système et au personnel des serices de maintenance IBM afin de les aider à déployer correctement le produit dans otre enironnement. Informations sur les prérequis et informations associées Aant d'utiliser ce guide de migration, familiarisez-ous aec les sources d'information suiantes : Le centre de documentation d'infosphere MDM Collaboration Serer La documentation de otre sereur d'applications La documentation de otre logiciel de base de données Enoi de commentaires Vos commentaires sont essentiels pour nous aider à fournir des informations de première qualité et les plus précises possibles. Si ous aez des commentaires relatifs à ce guide ou à toute autre documentation InfoSphere MDM Collaboration Serer, utilisez le formulaire suiant pour nous les faire parenir : Noueautés de la ersion 11.0 IBM InfoSphere Master Data Management Collaboration Serer ersion 11.0 propose un grand nombre de nouelles fonctions. InfoSphere MDM Collaboration Serer est inclus dans InfoSphere MDM Enterprise Edition et dans InfoSphere MDM Collaboratie Edition. InfoSphere MDM Collaboration Serer permet de créer un seul référentiel d'informations produit à jour, à utiliser à l'échelle d'une entreprise dans le cadre d'initiaties commerciales stratégiques. Vous trouerez ci-après les principales modifications apportées au produit. Copyright IBM Corp. 2000, 2013 ix

12 Prise en charge de la migration pour les utilisateurs InfoSphere MDM Collaboration Serer Les rubriques suiantes présentent les noueaux chemin de migration depuis les ersions précédentes de InfoSphere MDM Collaboration Serer ers la ersion 11.0 : Migration de la ersion ers la ersion Migration de la ersion ers la ersion Migration de la ersion ers la ersion Migration de la ersion ers la ersion Option Nouelle page d'accueil (tableau de bord Flux de traaux) Le noueau tableau de bord de flux de traaux est conçu pour simplifier le traail d'un utilisateur métier classique et il inclut les nouelles fonctions suiantes : Vue graphique complète des entrées aec affectation et des tâches aec priorités Portail intuitif permettant d'accéder rapidement aux flux de traaux, étapes de flux de traaux ou entrées Possibilité de lancer facilement des entrées dans un seule ou dans plusieurs ues d'édition Boîte de dialogue permettant d'effectuer des recherches dans des flux de traaux et de lancer des entrées d'un simple clic Possibilité de gérer des tâches de base telles que des réserations et des délégations Pour plus d'informations, oir Enabling the business user workflow dashboard for business processes Etiquettes personnalisables La nouelle option d'étiquettes personnalisables inclut les nouelles fonctions suiantes : Personnalisation des étiquettes "article" et "catégorie" en fonction des préférences utilisateur Personnalisation des icônes affichées dans le olet de naigation de gauche, dans les écrans en modification unique, en modification multiple et dans les écrans de recherche aancée Pour plus d'informations, oir Personnalisation des étiquettes et des icônes pour les éléments et les catégories et Gestion des erreurs pour les entités de domaine. Améliorations apportées aux écrans en modification unique Le nouel écran en modification unique comporte les nouelles fonctions suiantes : Personnalisation de l'espacement des attributs à la fois horizontalement et erticalement en fonction des préférences utilisateur Personnalisation de la largeur des étiquettes d'attribut en fonction des préférences utilisateur Nouelles longueurs d'attribut par défaut en fonction du type d'attribut Les longueurs de zone d'attribut augmentent de gauche à droite en fonction des préférences utilisateur et du pourcentage d'écran utilisable Nouel onglet pour l'affichage des relations et le lancement des entrées associées Pour plus d'informations, oir Paramètres de l'interface utilisateur. x InfoSphere MDM Collaboration Serer : Guide de migration

13 Améliorations apportées aux écrans en modification multiple Le nouel écran en modification multiple comporte les nouelles fonctions suiantes : Cases à cocher pour la sélection Option permettant de "désélectionner tout" Sélection de ligne d'un seul clic Edition de cellule d'un double clic Enregistrement simplifié Améliorations apportées à ACM (Adanced Catalog Management) Les nouelles améliorations apportées à ACM comportent les nouelles fonctions suiantes : Exportation intégrale des attributs de dictionnaire d'attributs Exportation intégrale groupes de catalogue Exportation sélectie pour une entrée de catalogue aec attributs de définition Exportation sélectie pour une entrée de catalogue aec attributs descriptifs Ajout d'une prise en charge pour l'analyseur syntaxique XML SAX dans le chargement de données Prise en charge du chargement de données simultané Pour plus d'informations, oir Integrating with IBM WebSphere Commerce Serer. Nouelles API Les nouelles API sont les suiantes : API publiques pour la génération XML Nouelle API pour l'ouerture d'un ensemble d'entrées de collaboration ou de catégories sur la base de critères de langage de requête, dans les écrans en modification unique ou multiple Pour plus d'informations, oir IBM Jaadoc Documentation. Améliorations des recherches Les nouelles améliorations apportées à la recherche comportent les nouelles fonctions suiantes : Les administrateurs peuent créer des modèles de recherche qui sont partagés entre utilisateurs et rôles Les utilisateurs peuent optimiser les modèles partagés afin de créer des recherches personnalisées indiiduelles Utilitaire permettant de conertir des signets de recherche préexistants en noueaux modèles de recherche (pour les clients migrant depuis une ersion précédente) Recherche basée sur des données de localisation pour des attributs indexés et non indexés Recherche basée sur la date à laquelle une entrée a intégré une étape de flux de traaux Pour plus d'informations, oir Transformation du modèle de recherche. Prise en charge z/linux Plus précisément, InfoSphere MDM Collaboration Serer prend en charge : Prise en charge pour SuSE Linux ersion 11 sur System z Préface xi

14 Prise en charge pour RHEL ersion 6 sur System z Pour plus d'informations, oir Configuration système requise. Programme d'installation unifié Le programme d'installation dans InfoSphere MDM Collaboration Serer ersion inclut les modifications suiantes : Installation Manager est utilisé à la place de Install Shield. Standardisation entre les différentes éditions dans MDM sur un programme d'installation commun Pour plus d'informations, oir la rubrique Installation d'infosphere MDM Collaboration Serer. Ajout de nouelles fonctions de seriçabilité à l'utilitaire pimsupport.sh Vous pouez utiliser le script pimsupport.sh pour collecter des données de diagnostic si ous rencontrez des problèmes aec InfoSphere MDM Collaboration Serer et si ous deez partager des données aec l'équipe de support technique. Pour plus d'informations, oir, pimsupport.sh script. Mises à nieau de pile Les nouelles mises à nieau de pile suiantes sont prises en charge aec InfoSphere MDM Collaboration Serer: Plus de prise en charge pour RHEL ersion 5.x Prise en charge pour SuSE Linux ersion 11 sur System z Prise en charge pour RHEL ersion 6 sur System z Mise à nieau de WebSphere Application Serer ers la ersion Prise en charge pour Installation Manager ersion 1.6 Plus de prise en charge pour Rational Software Architect ersion Plus de prise en charge pour Rational Application Deeloper ersion Mise à nieau de WebSphee MQ ers la ersion 7.5 Pour plus d'informations, oir Configuration système requise. Serice de support logiciel IBM Le serice de support logiciel IBM ous fournit une assistance en cas de défaillance d'un produit, ous aide à répondre aux FAQ et à réaliser une nouelle reconnaissance. Aant de commencer Si ous ne trouez pas une réponse ou une solution en utilisant d'autres options d'auto-assistance tels que les notes techniques, ous pouez contacter le support IBM. Aant de contacter le serice de support IBM, érifiez que otre entreprise possède un contrat de maintenance aec IBM et que ous êtes autorisé à soumettre des incidents à IBM. Pour plus d'informations sur les différents types de support disponibles, oir la rubrique Support portfolio dans le Software Support Handbook. Lorsque ous contactez le serice de support logiciel IBM, eillez à distinguer les différents nieaux de support offerts ia IBM : Questions spécifiques au produit : si ous aez suii une formation au produit, ous pouez soumettre os questions et préoccupations spécifiques. Support d'incident : analyse et traail nécessaires requis pour la résolution d'un défaut de produit ou soumission d'une solution palliatie. xii InfoSphere MDM Collaboration Serer : Guide de migration

15 Opérations de script : pour les questions relaties à une opération de script ou le signalement d'un probable défaut aec une opération de script, ous deez limiter otre question ou incident à eniron 5 lignes de code ou moins. IBM ne prend pas en charge le débogage et l'analyse des scripts personnalisés. Demandes d'améliorations : demandes relaties à une nouelle fonctionnalité ajoutée au produit. Les demandes qui ne concernent pas le serice de support logiciel IBM et qui requièrent que ous contactiez otre représentant de serice ou commercial : Traail diers : traail ou aide qui requiert une implication supplémentaire d'ibm au cours de l'installation ou du processus de mise en oeure qui englobe les installations complexes ou les installations à traers plusieurs plateformes. Support pour les clients non formés : demandes d'aide IBM étape par étape mais les clients n'ont pas suii de formation au produit IBM. IBM Education propose des formations aux clients si du personnel supplémentaire doit être formé. Consultez le site Web IBM pour obtenir des informations spécifiques sur les cours disponibles. Scripts personnalisés ou rédaction de scripts : aucune prise en charge n'est fournie pour les scripts que ous aez rédigés ou qui requièrent un débogage. Tous les scripts personnalisés rédigés par les serices professionnels sont détenus et gérés par ous, le client, une fois le traail des serices acheé. Le support technique n'est pas disponible pour la rédaction ou le débogage des scripts personnalisés. Récupération des données : nous ous recommandons fortement d'effectuer régulièrement une sauegarde de os données. Aide pour les performances et le réglage ou recommandations requérant des données client. Procédure 1. Déterminez si une note technique relatie à otre incident existe déjà. Pour des informations supplémentaires sur l'affichage des notes techniques, oir Recherche dans les bases de connaissances. 2. Déterminez si un collègue ou otre équipe de support interne peut ous fournir de l'aide. 3. Définissez le problème, collectez des informations générales, puis déterminez la graité du problème. Pour obtenir de l'aide, oir «Before contacting IBM Software Support» du document Software Support Handbook. Informations d'arrière-plan requises Tous les paramètres et informations relatifs à la configuration. Le comportement attendu par rapport au comportement obtenu. Tous les changements et modifications récemment mis en oeure. Déterminer si l'incident peut être recréé. Définir les étapes qui mènent à l'apparition de l'incident. 4. Rassemblez les données de diagnostic : Utilisez également la fonction de collecte de données de base de l'ibm Support Assistant pour rassembler les fichiers journaux et de configuration critiques (pour plus d'informations, oir isa/). Créez otre propre outil de collecte IBM Support Assistant Lite dans l'atelier. Préface xiii

16 a. Téléchargez le module complémentaire du produit dans le plan de traail d'ibm Support Assistant. b. Cliquez sur Collect and Send Data. Trois options apparaissent à gauche. c. Choisissez...Using IBM Support Assistant Lite. d. Créez le collecteur généré en effectuant chacune des opérations suiantes : Choisissez un collecteur (si l'add-on du produit installé ne s'affiche pas, c'est qu'il ne possède pas de document Must Gather et qu'il ne peut pas créer de collecteur IBM Support Assistant Lite) Spécifiez le répertoire cible Indiquez le nom du fichier Cliquez sur le bouton Export e. Transférez le collecteur IBM Support Assistant Lite exporté sur un système distant ia ftp ou par le biais d'un autre protocole de transfert de fichiers disponible. f. Décompressez le collecteur IBM Support Assistant Lite exporté dans l'emplacement cible. g. Configurez la ariable JAVA_HOME ou érifiez que Jaa se troue dans l'instruction PATH. h. Exécutez la commande runisalite.bat sous Windows ou le script runisalite.sh sous UNIX et LINUX à partir du répertoire d'outils d'ibm Support Assistant Lite sur le système distant. i. Apportez les réponses appropriées aux messages de collecte éentuels. j. Vérifiez les fichiers collectés ou enoyez-les au serice de support IBM. 5. Soumettez otre problème au serice de support logiciel IBM de l'une des façons suiantes : En ligne : (recommandé) a. Cliquez sur le lien Demandes de serice, qui figure dans la section Choisissez otre page de la barre de naigation gauche du site de support d'ibm InfoSphere Master Data Management Collaboration Serer. b. Cliquez sur ESR/SRet suiez les instructions fournies sur le site ESR. Utilisez les instructions et conseils suiants pour utiliser l'esr et soumettre des RGP : Joignez les documents directement au RGP afin de les rendre disponibles pour les serices de support IBM. ESR gère la liste de tous les RGP que ous aez affichés afin que ous puissiez y accéder directement afin de érifier leur statut. Utilisez l'esr pour configurer des notifications RGP automatiques. Enoyez des mises à jour pour les RGP que ous aez ouerts directement aux serices de support IBM depuis l'esr. Lorsque ous soumettez un RGP, ous deez indiquer un degré de graité afin de nous aider à définir la priorité pour nos ressources par rapport aux autres RGP en cours : Graité 1 Impact métier majeur : ce degré indique que ous êtes dans l'impossibilité d'utiliser le programme ce qui affecte sérieusement os opérations. Cette situation nécessite une solution immédiate. xi InfoSphere MDM Collaboration Serer : Guide de migration

17 Remarque : L'impact métier majeur signifie généralement que otre système de production est à l'arrêt, et, pour que le serice de support logiciel IBM puisse traailler en dehors des heures de bureau, ous deez ous assurer qu'un contact soit disponible par téléphone 24 heures sur 24 afin de faciliter les recherches de l'ingénieur chargé du problème, d'exécuter les tests dans otre instance de production, etc. Graité 2 Impact métier important : indique que le programme est utilisable mais de façon très restreinte. Graité 3 Impact métier quelconque : indique que le programme est utilisable et que certaines fonctions majeures (non essentielles pour les opérations) sont indisponibles. Graité 4 Impact métier minime : indique un problème aec un faible impact sur les opérations ou qu'un contournement au problème a été mis en oeure. Pour ourir une demande d'amélioration (une demande pour une nouelle fonctionnalité produit générale non associée à une personnalisation spécifique) : - Ourez un RGP aec le degré de graité 2, 3 ou 4 (en fonction du gain potentiel de la demande) et la requête est enoyée à la gestion produit IBM pour réision. Vous recerez un numéro de demande d'amélioration pour le suii qui remplace le numéro de RGP. Généralement, otre approbation est requise pour clôturer le RGP. Par téléphone : pour connaître le numéro de téléphone à appeler dans otre pays, accédez à la page des contacts du Software Support Handbook. Que faire ensuite Si le problème que ous soumettez concerne un défaut de produit ou une documentation manquante ou inexacte, le serice de support logiciel IBM crée un rapport officiel d'analyse de programme (APAR). L'APAR décrit l'incident en détails. Lorsque cela est possible, le serice de support logiciel IBM propose une solution palliatie jusqu'à la résolution de l'apar et à la découerte d'un correctif. IBM publie les APAR résolus tous les jours sur le site Web du support IBM afin que d'autres utilisateurs qui connaissent le même problème puissent bénéficier de la même résolution. Préface x

18 xi InfoSphere MDM Collaboration Serer : Guide de migration

19 Chapitre 1. Migration Si ous utilisez une ersion antérieure d'ibm InfoSphere Master Data Management Collaboration Serer, ous pouez migrer otre ersion ers la ersion la plus récente. Ces informations d'installation sont également disponibles dans le document InfoSphere MDM Collaboration Serer - Guide de migration, accessible au format PDF. Cliquez aec le bouton droit de la souris sur le lien, puis sélectionnez Enregistrer la cible sous pour télécharger le fichier PDF sur otre ordinateur. Copyright IBM Corp. 2000,

20 2 InfoSphere MDM Collaboration Serer : Guide de migration

21 Chapitre 2. Guide d'initiation Vous deez modifier le schéma de base de données de otre installation actuelle à l'aide de scripts de migration pour migrer les ersions antérieures ers IBM InfoSphere Master Data Management Collaboration Serer ersion Vous deez posséder les droits appropriés pour créer et modifier des tables et des index dans la base de données, de même que pour créer et supprimer des fichiers dans les sous-répertoires du répertoire $TOP. Le processus de migration comprend les étapes de base suiantes : Vérifier que la table de base de données contient un espace suffisant. Arrêter l'instance qui utilise le schéma de base de données. Sauegarder le schéma de base de données existant. Installer InfoSphere MDM Collaboration Serer ersion et pointer sur le même schéma de base de données que celui qui était utilisé par l'instance précédente. Exécuter le script de migration approprié afin de modifier le schéma de base de données et l'amener au nieau InfoSphere MDM Collaboration Serer ersion Copyright IBM Corp. 2000,

22 4 InfoSphere MDM Collaboration Serer : Guide de migration

23 Chapitre 3. Migration depuis des ersions antérieures Vous pouez migrer ers IBM InfoSphere Master Data Management Collaboration Serer ersion depuis des ersions antérieures spécifiques. Les chemins de migration suiants sont pris en charge pour la ersion : Migration depuis la ersion 6.0.0, groupe de correctifs 13, ers la ersion Migration de la ersion 9.1.0, groupe de correctifs 2, ers la ersion Migration de la ersion , groupe de correctifs 1 ou suiant, ers la ersion Migration de la ersion , à la date de disponibilité générale ou plus tard, ers la ersion Si ous migrez ers une ersion suiante, et non pas un groupe de correctifs de la même édition, ous deez utiliser un noueau répertoire d'installation pour éiter les discordances de ersion de fichier JAR. Si ous effectuez la migration à partir d'une ersion, assurez-ous que ous n'utilisez pas d'api supprimées dans os scripts Excel. Les API suiantes ne sont pas disponibles dans le dernier fichier JAR POI : public String getexcelcellencoding(); public oid setencoding(string encoding); public String getexcelcellencoding(object cellobj) throws AustinException; Remarque : 1. L'analyseur syntaxique InfoSphere MDM Collaboration Serer Excel est pris en charge ia un fichier.jar tiers nommé poi jar. Cette bibliothèque prend en charge le format Microsoft Excel 2007, lequel autorise plus 255 colonnes par feuille de données. Vous deez exécuter le noueau script de rapport de résultat de la recherche aancée à l'aide de l'option Default Rich Search Results Report Script (Excel xlsx format) pour exporter les éléments comportant plus de 255 attributs. 2. Vous pouez encire exporter les résultats de la recherche aancée dans le format Excel 2003 à l'aide de l'option Default Rich Search Results Report Script, mais aec ce format le rapport échouera si des éléments comportent plus de 255 attributs. 3. Excel 2010.xlsx n'est pas pris en charge par ce fichier JAR. Important : Aant d'exécuter les scripts de migration, ous deez érifier que ous utilisez la ersion correcte de la base de données. Voir la configuration système pour plus d'informations : mdm_serer_pim/requirements.html et dociew.wss?uid=swg en fonction de otre ersion du produit. Vous deez également érifier que l'utilisateur de la base de données InfoSphere MDM Collaboration Serer bénéficie des droits appropriés, comme indiqué dans le guide d'installation. Consultez l'équipe DBA pour les modifications des priilèges utilisateur de base de données pour les règles de sécurité. Vous deez utiliser la ersion de base de données DB2 ou Oracle, comme indiqué dans la configuration système. Voir la configuration système pour plus Copyright IBM Corp. 2000,

24 d'informations : mdm_serer_pim/requirements.html et dociew.wss?uid=swg en fonction de otre ersion du produit. Vous pouez ous reporter à la documentation DB2 ou Oracle pour saoir comment mettre à nieau otre base de données DB2 et Oracle ers la ersion prise en charge. Etapes de migration de InfoSphere MDM Collaboration Serer lorsque des espaces table personnalisés sont utilisés dans DB2 et Oracle Si ous utilisez des noms d'espace table personnalisés à la place de USERS ou INDX, ous deez modifier manuellement les noms d'espace table dans les fichiers SQL suiants aant de migrer ers InfoSphere MDM Collaboration Serer. Vous deez érifier que la base de données contient un espace suffisant aant d'effectuer la migration. Les journaux d'audit ne sont pas migrés ers la ersion Suite au noueau format des descriptions de journal d'audit introduit dans la ersion 9.1.0, les descriptions de journal d'audit dans les éditions antérieures à la ersion ne peuent pas être affichées dans la ersion Par conséquent, elles sont supprimées de la base de données pendant la migration. Les anciens journaux d'audit peuent être affichés en utilisant l'édition depuis laquelle ous effectuez la migration. Vous deez effectuer manuellement les étapes suiantes pour réussir la migration : 1. Procédez à la migration manuelle des fichiers de propriétés mentionnés ci-après. Dans la mesure où les fichiers de propriétés font partie des systèmes de fichiers locaux, la méthode de migration ne prend pas en charge l'exportation de ces fichiers. Modifiez chaque propriété personnalisée des éditions précédentes pour utiliser le fichier correspondant dans la nouelle ersion. Ne remplacez pas les fichiers de propriétés d'une ancienne ersion par une nouelle ersion, car de noueaux paramètres ont été introduits dans la ersion Pour plus d'informations sur chacun des fichiers de propriétés, consultez la documentation InfoSphere MDM Collaboration Serer. $TOP/etc/default/common.properties $TOP/etc/default/logs.xml $TOP/etc/default/docstore_mount.xml $TOP/etc/default/user_jars.list 2. Copiez manuellement le contenu du répertoire $TOP/public_html/suppliers/ <cmp code>/ctg_files ers la nouelle instance pour chaque société. Dans la mesure où ces fichiers font partie du système de fichiers local, la méthode de migration ne prend pas en charge l'exportation du répertoire ctg_files. 3. Ajoutez manuellement les fichiers JAR utilisateur nécessaires à la nouelle instance. Comme ces fichiers font partie du système de fichiers local, la méthode de migration ne permet pas d'exporter les fichiers. Pour plus d'informations sur l'ajout des fichiers JAR au déploiement, oir Déploiement d'un fichier.jar utilisateur personnalisé. 4. Rétablissez toutes les modifications que ous aiez apportées au script Default Rich Search Results Report pour le personnaliser. La migration ers InfoSphere MDM Collaboration Serer ersion remplace le script existant dans le répertoire de magasin de documents InfoSphere MDM Collaboration Serer, /scripts/report. Ce script permet d'exporter les résultats de recherche d'objet 6 InfoSphere MDM Collaboration Serer : Guide de migration

25 InfoSphere MDM Collaboration Serer ers une feuille de calcul Excel. Pour plus d'informations sur ce script, consultez la rubrique sur l'exportation des résultats de la recherche ers Excel. 5. Assurez-ous qu'aucune option de compilation prolixe n'est définie pour les scripts de compilation. Vérifiez que dans le fichier common.properties ous n'utilisez pas erbose comme aleur pour le paramètre script_compiler_options. Pour plus d'informations sur ce paramètre, oir script_compiler_options parameters. 6. Exécutez le script setup.sh pour érifier si la ersion de PERL installée sur otre ordinateur est compatible aec la ersion de InfoSphere MDM Collaboration Serer que ous aez installé. Ce script se troue dans le répertoire $TOP. Si la ersion actuelle de PERL n'est pas compatible, ous deez installer une nouelle ersion. 7. Si ous installez la nouelle ersion de InfoSphere MDM Collaboration Serer dans un noueau répertoire, ous deez mettre à jour la aleur de TOP et les ariables PERL5LIB dans le fichier.bash_profile. Vous deez définir la ariable PERL5LIB sur le répertoire $TOP/bin/perllib. Migration des données maître du format interne ers le format XML Vous deez conertir les données maître dans le format XML lors de la migration depuis IBM InfoSphere Master Data Management Serer for Product Information Management ersions ou ers IBM InfoSphere Master Data Management Collaboration Serer ersion Aant de commencer 1. Créez des espaces table XML et des pools de mémoire tampon, comme indiqué dans le guide d'installation. 2. Vous deez également érifier que l'utilisateur de la base de données de InfoSphere MDM Collaboration Serer dispose des droits appropriés, comme indiqué dans le guide d'installation. 3. Arrêtez l'application InfoSphere MDM Collaboration Serer sur le sereur local. 4. Exécutez le script delete_old_ersions.sh pour supprimer les anciennes ersions. Utilisez le code de la société et la date en cours comme aleurs pour les paramètres code et end_date. 5. Facultatif : étendez la mémoire disponible pour le processus Jaa. L'exécution du script de conersion des données utilise beaucoup de mémoire. Il est recommandé dé fournir 2 Go de mémoire au processus Jaa en mettant à jour le paramètre custom_jaa_options dans le fichier $TOP/bin/conf/ en_settings.ini. Exécutez configureen.sh après aoir modifié le paramètre custom_jaa_options pour appliquer les noueaux paramètres de mémoire. custom_jaa_options=-xmx2048m -Xms256m Pourquoi et quand exécuter cette tâche Le script de migration des données nécessite en terme de connexions le double du nombre d'unités d'exécution. Par exemple, si ous utilisez 10 unités d'exécution dans l'option de ligne de commande, 20 connexions BD sont nécessaires. Vous deez configurer le nombre de connexions BD en utilisant les deux paramètres de configuration suiants : db_maxconnection db_maxconnection_default Chapitre 3. Migration depuis des ersions antérieures 7

26 Les deux paramètres sont disponibles dans le fichier common.properties. Si les aleurs des paramètres sont déjà égales ou supérieures au nombre de connexions BD nécessaires, ous n'aez pas à les modifier. Si elles sont inférieures au nombre de connexion BD, augmentez les aleurs pour améliorer la itesse. Si les catalogues contiennent plus de entrées de données, augmentez le nombre d'unité d'exécution. Par exemple, ous pouez utiliser 50 ou 100 unités d'exécution pour accélérer la migration des données. Le nombre d'unités d'exécution maximal que ous pouez utiliser dépend des ariables suiantes dans InfoSphere MDM Collaboration Serer. Vous pouez connaître ce nombre en exécutant le script de migration dans un enironnement de test. Nombre de coeurs de processeurs disponibles Nombre de spécs définies Mémoire disponible Toutes les spécs définies dans l'enironnement InfoSphere MDM Collaboration Serer sont extraites et utilisées dans le processus de conersion des données. Si ous disposez de plus de 100 spécs, modifiez les paramètres de mise en cache des spécs en leur affectant les aleurs appropriées pour éiter les lectures fréquentes de base de données et améliorer les performances générales du script. Procédure 1. Obtenez le nombre de spécs dans InfoSphere MDM Collaboration Serer en utilisant la commande suiante. $PERL5LIB/runSQL.pl --sql_command="select count(*) from spc;" 2. Modifiez les paramètres aec les aleurs extraites de la requête de l'étape 1. Ces paramètres se trouent dans le fichier mdm-cache-config.properties dans le répertoire $TOP/etc/default. speccache_key_start_version_to_value.maxelementsinmemory=<spec count> speccache_key_to_current_start_version.maxelementsinmemory=<spec count> speccache_key_version_to_start_version.maxelementsinmemory=<spec count> Remarque : L'exécution du script configureen.sh après la mise à jour du fichier mdm-cache-config.properties remplace les paramètres par les aleurs par défaut. 3. Exécutez le script de shell de migration des données migratedatatoxml.sh. Ce fichier se troue dans le répertoire $TOP/bin/migration. migratedatatoxml.sh --company=<company name> --threads=<number of threads>,où --company Définit le code de société utilisé pour se connecter à InfoSphere MDM Collaboration Serer. --threads Définit le nombre d'unités d'exécution. Utilisez un grand nombre d'unités d'exécution pour améliorer la itesse, mais érifiez qu'un nombre suffisant de connexions DB existent. La aleur par défaut est 1. Au moins 10 unités d'exécution sont recommandées. Par exemple, migratedatatoxml.sh --company=ibm --threads=50 8 InfoSphere MDM Collaboration Serer : Guide de migration

27 Que faire ensuite Vous pouez érifier que le script fonctionne correctement en obserant les erreurs qui s'affichent sur la console et qui sont consignées dans le fichier default.log dans le répertoire $TOP/logs/default. La liste des entrées qui n'ont pas pu être migrées s'affichent à la fin de l'exécution. Le script de migration de données met à jour la base de données par lot. En cas d'erreur, l'ensemble du lot est annulé. Par conséquent, le nombre d'entrées dont la migration échoue est supérieur au nombre réel d'échecs. Affectez la aleur 1 au paramètre index_regeneration_batch_size dans le fichier common.properties, puis réexécutez le script de migration de données pour réduire le nombre d'entrées par rapport aux échecs réels. Le tableau des causes possibles des erreurs de migration et les actions recommandées sont fournis : Tableau 1. Causes possibles des erreurs et actions recommandées Causes des erreurs de migration Action recommandée La migration des données affiche l'erreur suiante : jaa.sql.sqlexception: ORA-00600: internal error code, arguments: [KGHALP1], [0x ], [], [], [], [], [], [], [], [], [], [] La migration des données affiche l'erreur suiante : jaa.sql.sqlexception: ORA-31061: XDB error: XML eent error ORA-19202: Error occurred in XML processing In line 46 of orastream: LPX-00241: entity reference is not well formed Vérifiez que ous utilisez le nieau de correctif de base de données correct. Si nécessaire, mettez à jour la base de données, puis réexécutez le script de migration des données. L'une des aleurs d'attribut dans l'entrée contient le caractère "&" ou la aleur n'est pas alide. Modifiez l'entrée pour supprimer la aleur non alide depuis l'interface d'édition d'élément de InfoSphere MDM Collaboration Serer et réexécutez le script de migration des données. Migration de la ersion ers la ersion Pour migrer ers IBM InfoSphere Master Data Management Collaboration Serer ersion depuis IBM InfoSphere Master Data Management Serer for Product Information Management ersion 6.0.0, ous deez exécuter le script de migration approprié. Aant de commencer Pour migrer depuis la ersion d'infosphere MDM Serer for PIM ers InfoSphere MDM Collaboration Serer ersion , ous deez érifier que ous utilisez spécifiquement le groupe de correctifs 13 pour la ersion Si ous utilisez la ersion aec un nieau de groupe de correctifs compris entre 1 et 12, ous deez passer à la ersion 6.0.0, groupe de correctifs 13 en suiant les instructions de la documentation d'ibm InfoSphere Master Data Management Serer for Product Information Management ersion 6.0.0, groupe de correctifs 13. La configuration doit aoir les caractéristiques ci-après. Chapitre 3. Migration depuis des ersions antérieures 9

28 1. Tous les espaces table XML doient être créés comme indiqué dans le guide d'installation et l'utilisateur de la base de données MDM Collaboration Serer doit être autorisé à utiliser les noueaux espaces table. 2. Les espaces table doient contenir un espace libre suffisant. Si ous utilisez des noms d'espace table personnalisés à la place des noms par défaut USERS ou INDX, ous deez modifier manuellement les noms d'espace table dans les fichiers SQL suiant aant de migrer ers InfoSphere MDM Collaboration Serer. Tableau 2. Fichiers SQL à modifier lors de l'utilisation de DB2 ou d'oracle comme base de données dorsale Fichiers SQL à modifier quand DB2 est la base de données d'arrière plan Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/ db2 : create_new_tables_of_650.sql create_new_tables_of_1000.sql create_tables_of_gds.sql recreate_coa_for_edit_flag.sql migrateitd.sql migratedbl.sql migrateobh.sql migratesst.sql migratecad.sql addsstshared.sql addcaestepentrydate.sql addobhcompanyid.sql. Remarques concernant les bases de données DB2 Fichiers SQL à modifier quand Oracle est la base de données d'arrière plan Remplacez les noms d'espace table USERS, INDX et BLOB_TBL_DATA par les noms d'espace table personnalisés appropriés dans les fichiers SQL suiants dans le répertoire $TOP/src/db/schema/dbscripts/oracle : create_new_tables_of_650.sql create_new_tables_of_1000.sql create_tables_of_gds.sql recreate_coa_for_edit_flag.sql migrateitd.sql migratedbl.sql migrateobh.sql migratesst.sql migratecad.sql addsstshared.sql add_icm_index.sql add_lot_index.sql redefine_ctg_indexes.sql modifyicm1index.sql Si ous effectuez une mise à nieau depuis une ancienne ersion de DB2 ers la ersion prise en charge, ous deez ous assurer que le paramètre de configuration de la base de données CUR_COMMIT est actié. Vous deez définir manuellement ce paramètre ; en effet, il est par défaut désactié pour les bases de données mises à nieau depuis des ersions plus anciennes. L'administrateur de base de données doit également exécuter les commandes SQL suiantes aant de migrer InfoSphere MDM Collaboration Serer. alter tablespace blob_tbl_data conert to large; alter tablespace blob_tbl_data file system caching Vous pouez configurer l'emplacement du fichier journal des erreurs en modifiant la ariable _ERROR_LOGS dans le script de migration migratefrom600fp.sh. Cette ariable est définie sur $TOP/logs/errfile.log par défaut. Pourquoi et quand exécuter cette tâche Il s'agit de la seule et unique méthode possible pour migrer depuis la ersion d'infosphere MDM Serer for PIM. Aucun autre moyen, comme utiliser l'outil 10 InfoSphere MDM Collaboration Serer : Guide de migration

29 d'exportation et d'importation d'enironnement, ne peut être utilisé pour cette migration. Procédure 1. Effectuez une copie de sauegarde du schéma de base de données existant. 2. Installez InfoSphere MDM Collaboration Serer ersion dans un répertoire différent. 3. Configurez la base de données. a. Pour les bases de données DB2, créez des pools de mémoire tampon et des espaces table, comme indiqué dans Configuration de la base de données DB2 dans le guide d'installation. Remarque : La taille de l'espace table XML_DATA doit être égale à l'espace occupé par l'espace table TCTG_ITD_ITEM_DETAIL. Pour connaître la taille approximatie de la table, utilisez la requête suiante : select (fpages * 16) / 1024 megabytes from syscat.tables where tabschema = current schema and tabname like TCTG_ITD_ITEM_DETAIL ; b. Pour les bases de données Oracle, créez des espaces table et installez le composant Oracle XML DB, comme indiqué dans Configuration de la base de données Oracle dans la guide d'installation. 4. Pointez l'instance InfoSphere MDM Collaboration Serer ersion ers le schéma de base de données ersion 6.0.0, groupe de correctifs 13. Pour pointer l'instance ers la base de données, ajoutez les paramètres de base de données dans le fichier en_settings.ini. Pour plus d'informations, oir Configuration des paramètres communs de la base de données. 5. Exécutez le script de migration migratefrom600fp.sh. Ce script est disponible dans le répertoire $TOP/bin/migration. Consultez la section Results dans le récapitulatif de la migration. Si la migration n'a pas abouti, ous pouez exécuter de noueau le script de migration. 6. Migrez les données, comme indiqué dans Conersion des données maître du format interne dans le format XML. 7. Exécutez le script test_db.sh afin de érifier le schéma de base de données, la connectiité entre InfoSphere MDM Collaboration Serer et les bases de données, et pour érifier les connexions client naties et JDBC. Pour plus d'informations, oir test_db.sh script. 8. Démarrez l'instance InfoSphere MDM Collaboration Serer ersion Résultats Tous les messages, comme l'état des composants de migration indiiduels et le récapitulatif de migration global, sont affichés dans la console. Après aoir exécuté le script de migration, des messages indiquant que la migration a réussi ou échoué s'affichent. Le message suiant s'affiche si la migration a réussi : Summary of the migration Migration to IBM InfoSphere Master Data Management Collaboration Serer Version is complete. Check the messages for any errors. Generating database erification report... Chapitre 3. Migration depuis des ersions antérieures 11

30 Changed tables =========================================================== There are no changed tables Missing Tables =========================================================== There are no missing tables Changed Indexes =========================================================== There are no changed indexes Missing Indexes =========================================================== There are no missing indexes LOG FILE: $TOP/logs/default/default.log Le message suiant s'affiche si la migration a échoué :!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Migration Failed : xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Please see the log file for further details : /home/pimuser/mdmcs11/logs/errfile.log Le message suiant s'affiche si la migration de modules spécifiques a échoué : Summary of the migration Migration of the following modules failed : <module names> Ce message s'affiche s'il existe une différence dans les tables et les index de base de données. Generating database erification report... Changed tables =========================================================== <table names> 12 InfoSphere MDM Collaboration Serer : Guide de migration

31 Missing Tables =========================================================== <table names> Changed Indexes =========================================================== <index names> Missing Indexes =========================================================== <index names> LOG FILE: $TOP/logs/default/default.log Recherchez d'éentuels messages supplémentaires dans le fichier errfile.log. Pour les erreurs SQL, trouez le message d'erreur détaillé à partir du code d'erreur SQL, corrigez l'erreur, puis exécutez de noueau le script de migration. Pour l'action recommandée en cas d'échec de la migration, oir Identification et résolution des problèmes de migration. Contactez IBM Software Support si le problème persiste après aoir corrigé les erreurs. Migration de la ersion ers la ersion Pour migrer ers IBM InfoSphere Master Data Management Collaboration Serer ersion depuis IBM InfoSphere Master Data Management Serer for Product Information Management ersion 9.1.0, ous deez exécuter le script de migration approprié. Aant de commencer Aant de migrer d'infosphere MDM Serer for PIM V9.1.0 ers InfoSphere MDM Collaboration Serer V11.0.0, ous deez érifier que ous utilisez le groupe de correctifs 2 de la ersion Si ous utilisez la ersion aec un autre nieau de groupe de correctifs, ous deez migrer ers la ersion groupe de correctifs 2 ou ultérieur en suiant les instructions des notes d'édition appropriées. Vous deez également érifier que tous les espaces table XML sont créés comme indiqué dans le guide d'installation et que l'utilisateur de la base de données InfoSphere MDM Collaboration Serer est autorisé à utiliser les noueaux espaces table. Vous pouez configurer l'emplacement du fichier journal des erreurs en modifiant la ariable _ERROR_LOGS dans le script de migration migratefrom910.sh. Cette ariable est définie sur $TOP/logs/errfile.log par défaut. Chapitre 3. Migration depuis des ersions antérieures 13