MEGA Data Upgrade Guide - MEGA 2009 SP5 R6/R7. Révisé le : January 2, 2013 Créé le : April 6, Auteur : Jérôme Horber

Transcription

1 Révisé le : January 2, 2013 Créé le : April 6, 2011 Auteur : Jérôme Horber

2 SOMMAIRE Résumé Ce document décrit la procédure nécessaire pour mettre à jour les données de MEGA 2009 SP5 vers la version MEGA 2009 SP5 R6 ou MEGA 2009 SP5 R7. Créer un nouvel environnement en version MEGA 2009 SP5 R6 ou MEGA 2009 SP5 R7. Notez que : Veuillez noter que l'installation de la version MEGA 2009 SP5 CP4.0 ou supérieur CP est un pré-requis pour la R6. Veuillez noter que l'installation de la version MEGA 2009 SP5 CP7.0 ou un CP supérieur est un pré-requis pour la R7. Pour les versions antérieures, il est nécessaire de réaliser une mise à jour intermédiaire vers l une des versions mentionnées ou un CP supérieur. Mettre à jour les programmes. mettre à jour les données. Pour mettre à jour vers la version MEGA 2009 SP5, veuillez vous référer au document "MEGA Data Upgrade Guide MEGA 2009 SP5 FR'. Ce document s applique au logiciel MEGA EA : MEGA Desktop MEGA Anywhere MEGA Advisor Ce document s applique également aux différents formats de stockage pour les données MEGA : GBMS Oracle SQL Server MySQL Il ne décrit pas : la configuration requise ni les architectures possibles (voir le documentation générale sur l'architecture). comment procéder à l installation (voir la documentation d installation). comment installer un Cumulative Patch (voir la documentation de mise à jour par CP). les fonctionnalités (voir les guides utilisateurs). comment gérer les mises à niveau des programmes (voir les documentations sur les upgrades). Comment mettre à jour les données vers la version MEGA 2009 SP5. page 2/14

3 Sommaire... 2 Mettre à jour un environnement vers MEGA 2009 SP5 R6 ou MEGA 2009 SP5 R7 4 Préambule... 4 Mettre à niveau l'environnement... 4 Convertir la base... 5 MEGA Suite for DoDAF/NAF... 5 Vérification de la mise à jour des données... 5 Mettre à jour un environnement vers MEGA 2009 SP5 R6 ou MEGA 2009 SP5 R7 7 Création d'un environnement... 7 Questions fréquentes... 8 Détails des fichiers... 8 Attention 'L'environment n'est pas mis à jour, l'installation du Release Pack n'est pas possible'!... 9 Avertissement concernant l'import de upgrade*.mol... 9 J'ai déjà installé le Release Pack R6. Est-ce que je peux install er aussi le Release Pack R7?... 9 Quelles sont les fonctions API qui permettent une mise à jour automatique d'un environnement?... 9 Après la mise à jour d'un CP, j'obtiens les avertissements suivants : "You cannot access repository "XX". Its internal structure is not up to date. Run the menu "Technical Conversion" to perform the upgrade?... 9 Détail des conversions Glossaire page 3/14

4 METTRE A JOUR UN ENVIRONNEMENT VERS MEGA 2009 SP5 R6 OU MEGA 2009 SP5 R7 La mise à jour est réalisée pour chaque environnement MEGA. Elle consiste en la mise à jour de la base systemdb et le lancement de plusieurs conversions de bases. Préambule Cette procédure de mise à jour d une version de MEGA a fait l'objet de nombreux tests, permettant ainsi de proposer aux utilisateurs MEGA de migrer en toute sécurité. Toutefois, cela ne vous dispense pas de faire au préalable une sauvegarde de l environnement de travail (données et fichiers de paramétrage) dans sa version initiale. Voici quelques recommandations supplémentaires avant de procéder à la mise à jour : Nettoyez l environnement initial : vérifiez qu aucune transaction et qu aucun verrou n existent. Assurez-vous de la stabilité de l environnement initial. vérifiez qu il est possible de le compiler. Ceci s applique quel que soit le type de stockage utilisé (GBMS, Oracle, SQL Server, MySQL). Mettre à niveau l'environnement Procédure : Lancez la console d administration MEGA. Sélectionnez et ouvrez l'environnement à mettre à jour. Sélectionnez la base "SystemDb". Dans le menu contextuel, sélectionnez «Conversions > Mise à jour automatique de l environnement». Lisez les informations, cochez la case «J ai pris connaissance du texte ci-dessus» puis cliquez sur «OK». Le processus 'Mise à jour automatique d'environnement' est exécuté. Veuillez patienter jusqu'à la fin de la mise à jour. Un message tel que : 'Votre environnement a été mis à jour avec succès' est édité. Cliquez sur «OK» Sélectionnez l'environnement. Dans son menu contextuel, sélectionnez Métamodèle > Importer un Release Pack. Sélectionnez le relase pack qui vous intéresse ('Release Pack R6' ou 'Release Pack R7') et cliquez sur 'OK' Le processus s'exécute : plusieurs fichiers sont importés et le métamodèle est compilé. Veuillez patienter jusqu'à la fin du processus. Fermez l environnement. Quittez la console d administration MEGA. page 4/14

5 Convertir la base Procédure : Lancez la console d administration MEGA. Sélectionnez et ouvrez l'environnement à mettre à jour. Pour chaque base (sauf "Systemdb") : o Dans son menu contextuel, sélectionnez Conversions > Convertir les données dans la version courante, puis sélectionnez "A partir des données MEGA 2009". o Cliquez sur "Déselectionnez tout". o Sélectionnez uniquement les conversions suivantes : MEGA Repository - Conversion of link instances to Generic MetaAssociation (2009 and earlier versions). MEGA IT Planning - Master Plans : Conversion of Type Attribute to Link Plannable MetaClasses (2009 only). MEGA Requirement Tracker - Conversion of Requirements (2009 uniquement). o Cliquez sur «OK» Le processus de conversion s'exécute. Attendez jusqu à ce que la mise à jour soit terminée. Fermez l environnement. Quittez la console d administration MEGA. Référez-vous à la rubrique "Questions fréquentes" de ce document pour les détails des conversions. MEGA Suite for DoDAF/NAF Cette procédure s'applique si : Vous utilisez un des produits suivants : o MEGA Suite for NAF o MEGA Suite for NAF Vous avez importé un des frameworks suivants en mettant à jour la base système : o DoDAF - Diagram Customizations. o DoDAF - Metamodel Renaming. o NAF - Metamodel Renaming. Une fois que le framework a été importé, il doit être mis à jour à chaque service pack (par exemple, lorsque vous passez de MEGA 2009 SP5 à MEGA 2009 SP5 R6). Procédure : Lancez la console d administration MEGA. Sélectionnez et ouvrez l'environnement à mettre à jour. Dans le répertoire 'Bases', sélectionnez une autre base que 'SystemDb'. o Dans son menu contextuel, sélectionnez 'Gestion des objets > Importer un framework' o Sélectionnez les frameworks de la liste ci-dessus qui ont déjà été importés une fois. Fermez l environnement. Quittez la console d administration MEGA. Vérification de la mise à jour des données Il n est pas possible d effectuer des vérifications sur l ensemble des données. La réussite de la conversion des données est garantie par : une mise à niveau de l environnement correcte page 5/14

6 Si des erreurs interviennent au cours de cette étape, le processus de migration doit être stoppé, de manière à réaliser un diagnostic. l exécution correcte de toutes les conversions obligatoires sur la base système. Si des erreurs interviennent au cours de cette étape, le processus de migration doit être stoppé, de manière à réaliser un diagnostic. l exécution correcte de toutes les conversions obligatoires sur chaque base utilisateur. Si des erreurs interviennent au cours de cette étape, le processus de migration doit être stoppé, de manière à réaliser un diagnostic. A la fin du processus de migration, il est recommandé d'effectuer un contrôle manuel sur les données migrées. Exemple de scénario : Ouvrez une transaction. Parcourez les objets en utilisant l outil de recherche, les arbres de navigation et les diagrammes. Effectuez des mises à jour sans grande importance (par exemple, modifier un caractère dans un commentaire, déplacer légèrement un objet dans un diagramme, etc.) Publiez la transaction. Si des personnalisations ont été effectuées (couche métamodèle, pages de propriétés, paramétrage des diagrammes, documents types, programmes basés sur les APIs scripts...). Il est nécessaire de réaliser une vérification spécifique par rapport aux spécifications initiales des personnalisations. Comme les personnalisations sont souvent basées sur des couches standards, il se peut qu elles ne soient pas prêtes à être utilisées et qu'elles aient un aspect différent. Cette vérification nécessite des compétences fonctionnelles et en développement de la plate-forme. Veuillez noter que dans la nouvelle version la licence utilisée et les options de l'utilisateur actives ont un impact sur la vision méthodologique de l'utilisateur. Il est possible que la nouvelle version modifie les valeurs par défaut ou ajoute de nouvelles options de compatibilité/méthodologiques. page 6/14

7 METTRE A JOUR UN ENVIRONNEMENT VERS MEGA 2009 SP5 R6 OU MEGA 2009 SP5 R7 Après avoir créé un environnement en MEGA 2009 SP5, une étape supplémentaire est nécessaire. Il s'agit de mettre à niveau la base système. Création d'un environnement Procédure : Lancez la console d administration MEGA. Sélectionnez le dossier "Environnements". Dans le menu contextuel, sélectionnez «Conversions > Nouveau». Définissez les paramètres usuels et cliquez sur "OK'. Sélectionnez l'environnement. Dans son menu contextuel, sélectionnez Métamodèle > Importer un Release Pack. Sélectionnez le relase pack qui vous intéresse ('Release Pack R6' ou 'Release Pack R7') et cliquez sur 'OK' Le processus s'exécute : plusieurs fichiers sont importés et le métamodèle est compilé. Veuillez patienter jusqu'à la fin du processus. Fermez l environnement. Quittez la console d administration MEGA. page 7/14

8 QUESTIONS FREQUENTES Détails des fichiers Tous les fichiers nécessaires à la mise à jour des données sont présents dans les dossiers cidessous : <Dossier d installation de MEGA>\Install\Upgrade et <Dossier d installation de MEGA>\Mega_Std. Dans le dossier <Dossier d installation de MEGA>\Install\Upgrade : 2009sp5r6.mol : Mise à jour d'un environnement 2009 sp5 ( xxx) vers un environnement 2009 R6 ( xxx). 2009sp5r7.mol: Mise à jour d'un environnement 2009 sp5 ( xxx) vers un environnement 2009 R7 ( xxx). Dans le dossier <Dossier d installation de MEGA>\Mega_Std : Upgrade1.mol: mises à jour pour la compatibilité avec un environnement MEGA 2009 SP5 R6 s'appliquent à des bases installées dans une version entre MEGA 2009 SP5 et MEGA 2009 SP5 CP4.0 (exclue). Upgrade2.mol: mises à jour pour la compatibilité avec un environnement MEGA 2009 SP5 R6 s'appliquent à des bases installées dans une version entre MEGA 2009 SP5 CP4.0 et MEGA 2009 SP5 CP7.0 (exclue) Upgrade2R6.mol: compatibilité avec un environnement MEGA 2009 SP5 R6 seulement depuis un CP7.0. Upgrade.mol: Dernières mises à jour à appliquer à un environnement MEGA 2009 SP5 à partir d'un CP7.0.. UpgradeR6.mol: Dernières mises à jour à appliquer à un environnement MEGA 2009 R6. UpgradeR7.mol: Dernières mises à jour à appliquer à un environnement MEGA 2009 R7. L'enchaînement des fichiers est devenue complexe et elle change avec les versions. Par conséquent : N'importez pas un fichier.mol file manuellement. Exécutez la fonctionnalité 'Environment Automatic Update'. N'importez pas automatiquement le fichier.mol. Utilisez les fonctions API adaptées (disponibles avec MEGA 2009 SP5 CP7.0 et CP suivants) Quand vous faîtes une mise à jour de CP avec MEGA 2009 SP5, les fichiers suivants seront importés automatiquement en fonction de la release : Version de base CP01.0 CP02.0 CP03.0 CP04.0 CP05.0 CP06.0 CP07.0 CP08.0 MEGA 2009 SP5 MEGA 2009 R6 MEGA 2009 R7 Upgrade.mol - - Upgrade.mol Upgrade.mol UpgradeR6.mol Upgrade.mol UpgradeR6.mol Upgrade.mol - UpgradeR7.mol Upgrade.mol page 8/14

9 Attention 'L'environment n'est pas mis à jour, l'installation du Release Pack n'est pas possible'! Vous devez mettre à jour l'environnement avant d'installer un release pack. Utilisez la fonctionnalité 'Environment Automatic Update' citée dans la procédure ci-dessus. Avertissement concernant l'import de upgrade*.mol Au moment de l'import d'un fichier upgrade*.mol dans la base système, un avertissement apparaît : You are trying to import the 'Upgrade*.mol' file to the systemdb repository. Cancel this action as the procedure for updating the environment has changed. To update the current version of the environment with the correct version of the programs: Sélectionnez la base système (systemdb). Select the menu Conversions > Environment Automatic Update Do you want to cancel this import? Ceci est un avertissement standard. Pour éviter les erreurs et importer le bon fichier, il est nécessaire d'utiliser le menu "Environment Automatic Update". Cliquez sur "Oui" pour annuler l'import et appliquez la procédure prévue. J'ai déjà installé le Release Pack R6. Est-ce que je peux install er aussi le Release Pack R7? Oui. Pour l'environment souhaité, utilisez la fonctionnalité 'Importer un Release Pack' citée dans la procédure ci-dessus. Quelles sont les fonctions API qui permettent une mise à jour automatique d'un environnement? Utilisez la fonction EnvironmentUpgrade avec un objet MegaRoot pour la base systemdb. Notez que cette fonction est disponile avec une mise à jour de systemdb en CP7.0 ou supérieur. Après la mise à jour d'un CP, j'obtiens les avertissements suivants : "You cannot access repository "XX". Its internal structure is not up to date. Run the menu "Technical Conversion" to perform the upgrade? Oui. Avec un CP particilier, la version technique de la base peut changer. Exécuter la conversion depuis la console MEGA Administration. Pour chaque environnement : Sélectionnez le dossier de l'environnement. page 9/14

10 Cliquez droit et sélectionnez Conversion Technique Cliquez sur 'OK quand la conversion de la base Systemdb est terminée. Pour toutes les bases de l'environnement. Sélectionnez la base. Cliquez droit et sélectionnez Conversion Technique Cliquez sur 'OK quand la conversion de la base Systemdb est terminée. Après la mise à jour d'un CP, j'obtiens l'avertissement suivant : "You cannot access repository "XX". Its internal structure is not up to date. Is it a solution to perform the upgrade by running the menu "Technical Conversion"? Oui. Avec un CP particilier, la version technique de la base peut changer. Exécuter la conversion depuis la console MEGA Administration. page 10/14

11 DETAIL DES CONVERSIONS Ces conversions mettent à jour les bases MEGA à partir des versions MEGA 2009 SP5 pour les rendre compatibles avec MEGA 2009 R6 ou MEGA 2009 SP5 R7. Si les conversions obligatoires ne sont pas effectuées sur les bases, des dysfonctionnements ou des pertes de données peuvent survenir. Il est nécessaire de convertir les bases une seule fois seulement. Conversions MEGA Repository - Conversion of link instances to Generic MetaAssociation (2009 and earlier versions) Cet utilitaire met à jour le métamodèle pour permettre une gestion générique de certaines MetaAssociations. La conversion des liens alias peut prendre plusieurs minutes en fonction du volume de données et nécessite de compiler le métamodèle. Cette conversion est obligatoire pour les bases de données et la base système si vos données proviennent de MEGA 2009 ou de versions antérieures Nom précédent : Conversion de la MetaAssociationEnd Alias MEGA IT Planning - Master Plans : Conversion of Type Attribute to Link Plannable MetaClasses (2009 uniquement) Convertit les spécifications d'un type de plan d'évolution vers un nouveau format. Cette conversion est obligatoire pour les bases de données si vos données proviennent de MEGA 2009 SP5 et si MEGA 2009 R6 ou R7 est installé. Cette conversion ne s'affiche pas si ni MEGA 2009 R6, ni MEGA 2009 R7 n'est installé. Cette conversion est mise en oeuvre par une macro "Conversion of Type Attribute to Link". MEGA Requirement Tracker - Conversion of Requirements (2009 uniquement) Convertit les spécifications des exigences vers un nouveau format pour permettre un nouveau type de synchronisation. Cette conversion est obligatoire pour les bases de données si vos données proviennent de MEGA 2009 SP5 et si MEGA 2009 R6 ou R7 est installé. Cette conversion ne s'affiche pas si ni MEGA 2009 R6, ni MEGA 2009 R7 n'est installé. Référentiel MEGA Base SystemDb Obligatoire si mise à jour à partir de 2009 SP5 Oui Non Oui Oui Non Oui Oui Non Oui page 11/14

12 Conversions Cette conversion est mise en oeuvre par une macro "Conversion of requirements'" Référentiel MEGA Base SystemDb Obligatoire si mise à jour à partir de 2009 SP5 page 12/14

13 GLOSSAIRE Terme Définition Numéro de build Identification d'un ensemble de programmes MEGA formant un tout (build). Exemple : Corrective Patch (CP) Mises à jour logicielles mineures constituant un ensemble de corrections cohérent. Exemple : CP3.0 de MEGA 2009 SP5. Par le passé, CP correspondait à Cumulative Patch. Serveur de fichiers Serveur utilisé pour le partage de fichiers. Les composants du matériel doivent être de qualité supérieure (disque dur et carte contrôleur de disque dur). La configuration doit favoriser les performances d accès aux fichiers en mode lecture-écriture. Fix list Document décrivant la liste des améliorations, des corrections et des problèmes connus. Ce document est fourni avec chaque CP. Hotfix Ensemble de fichiers installés et désinstallés manuellement. Les fichiers sont généralement groupés sous forme de fichier.zip. Le Hotfix est créé en cas d urgence lorsqu'il n est pas possible d attendre le CP suivant. Console d administration MEGA La console d administration MEGA permet d effectuer les tâches d administration suivantes : Gérer les environnements MEGA Gérer les bases MEGA. Gérer les utilisateurs MEGA Gérer les profils MEGA. Disque MEGA CD/DVD contenant le programme d installation des logiciels MEGA. Le contenu de ce disque peut être copié sur un dossier du réseau et être installé à partir du réseau. Client MEGA Un client MEGA est une société cliente des produits MEGA ayant signé un contrat de licence avec MEGA. Un identifiant est affecté au client (customer-id). Synonyme : client, compte Environnement MEGA Espace de données pour un groupe d'utilisateurs MEGA. Un environnement MEGA référence une base systemdb ainsi qu une ou plusieurs bases utilisateur. Licence MEGA Licence utilisée pour lancer un programme MEGA (Produit MEGA, Options MEGA ou Bundles MEGA). Il existe différentes technologies. La plus courante est la licence MEGA Must. Fonctions du programme Composant de l installation sélectionnée au cours de l'installation du logiciel MEGA. Exemples pour MEGA EA : Environnement exemple Logiciel MEGA o Programme d administration o Utilitaires o Fichiers exemples Documentation MEGA Programmes MEGA Binaires, ressources et fichiers de configuration des logiciels MEGA EA. Egalement appelés «MEGA Application Services" page 13/14

14 Terme Référentiel MEGA Fichier MSI Fichier MSP Fichier MST Version mineure Sales Administration Contact (SAD) Ferme de serveurs Service Pack (SP) Mise à jour Version majeure Définition pour les applications MEGA Advisor et MEGA Anywhere. Sur une machine le dossier des programmes MEGA peut être identifié par deux sous-dossiers : 'Cfg' et 'System'. Un référentiel MEGA est une base qui constitue l espace de travail au sein duquel les données de modélisation principales sont stockées. Plusieurs utilisateurs peuvent s y connecter et y travailler en même temps. Un référentiel permet ainsi à plusieurs utilisateurs de travailler en équipe sur un même projet. Coeur du package Windows Installer Avec MEGA EA, un fichier.msi est fourni avec chaque version de produit (par exemple : MEGA 2009) et pour chaque Service Pack (par exemple : MEGA 2009 SP4). L'exécution du fichier.msi peut appeler des fichiers de resssources externes (par exemple : fichiers CAB). Mise à jour pour un package Windows Installer. Avec MEGA EA, un fichier.msp est fourni avec chaque CP (par exemple : CP3.0 de MEGA 2009 SP5). Fichiers de paramètres d installation pour un package Windows Installer. Avec MEGA EA, un fichier.mst est fourni pour chaque langue lorsqu'une interface utilisateur est disponible. Il permet de contrôler la langue de l installation pour l'installation d'un.msi utilisant setup.exe. Version logicielle qui fournit des évolutions fonctionnelles, de nouveaux produits ou de nouvelles fonctionnalités, sans nécessiter de migration de données. Elle peut être installée ou non selon le choix du client. Exemple : MEGA 2009 SP5 R6, MEGA 2009 SP5 R7. "Sales Administration Contact" est une personne faisant partie de "Client MEGA". Cette personne décide notamment : qui est autorisé à télécharger les programmes MEGA au sein de l'entreprise. qui est autorisé à contacter MEGA Support au sein de l'entreprise. Une ferme de serveurs est un ensemble de machines serveurs généralement maintenues par une entreprise pour satisfaire des besoins allant bien au-delà des capacités d'une machine. Synonyme : cluster de serveurs Mise à jour significative, qui fournit des corrections ainsi que des améliorations. Exemple : SP5 pour MEGA Mise à jour d un logiciel. Pour MEGA EA, les mises à jour se présentent sous la forme de fichiers.msi ou.msp. Version logicielle qui fournit des évolutions techniques ayant un impact sur la plateforme logicielle et nécessitant une migration des données. Exemple : MEGA 2007, MEGA page 14/14