02 • 34 • 09 • 31 • 70
Différents déploiements architecturaux sont désormais possibles pour Planning Analytics :
- En local (on Premice)
- En IBM Cloud
- En container / Hybrid
- En Cloud AWS, Azure
Le local et IBM Cloud utilisent les mêmes concepts technologiques et sont donc compatibles. On parle de V11. Cependant, la containerisation et le Cloud (AWS, Amazone) utilisent, eux, une version intitulée Planning Analytics Engine. On parle ici de V12.
Compte tenu des contraintes sécuritaires, matérielles et financières, vous pouvez faire le choix de migrer l’intégralité de votre base de données TM1 et de vos applications d’un environnement à un autre :
- Local ↔ IBM Cloud (dans les deux sens)
- Local → Container/Hybrid
- Local → Cloud AWS, Azure
Nous allons voir dans cet article comment migrer vers le cloud AWS, tant en termes de concepts que de prérequis, de préparation et d’exécution.
Préparation de l’environnement technique
Le Migrateur
Vous pouvez vous le procurer de diverses manières : soit à partir du site IBM Passport Advantage, soit à partir de votre plateforme AWS :
Vous êtes alors en possession d’un fichier .zip que vous pouvez extraire dans un répertoire particulier de votre machine hébergeant la base TM1 :
Quelques indications préalables
- Vos noms d’objets doivent être propres (pas d’accents ni de caractères spéciaux)
- Vos processus perdront le « chemin » de vos fichiers sources (ce qui n’est pas grave)
- Vos bacs à sable ne seront pas migrés
- Vos objets « privés » et vos utilisateurs devront prévoir quelques préparations
- Vérifiez que vous avez sur votre disque au moins 2 fois la taille de la base en espace libre
Avant de commencer la migration
- Assurez-vous que le fichier tm1s.cfg existe
- Assurez-vous que le paramètre DatabaseDirectory existe et soit renseigné avec le chemin relatif vers ce même fichier tm1s.cfg
- Assurez-vous que les chemins de fichier utilisés dans vos processus sont accessibles de l’endroit où vous allez lancer le migrateur
- Effectuez un SaveDataAll de manière à vous assurer que :
- Tous vos objets sont sur disques
- Les feeders sont à jour
- Effectuez un éventuel Mapping entre vos utilisateurs « on premise » et vos utilisateurs « cloud ».
- Pour effectuer le mapping :
- Ajouter un nouvel Attribut « CloudID » à la dimension de contrôle :
}ClientProperties
- Renseignez votre mappage des utilisateurs
- Ajouter un nouvel Attribut « CloudID » à la dimension de contrôle :
- Si aucun mapping n’est fait ET que l’attribut CloudID n’est pas créé, tous les utilisateurs seront migrés à l’identique (en perdant les objets privés).
- Si au moins un mapping est fait, seuls les utilisateurs mappés seront migrés.
- Pour effectuer le mapping :
-
Effectuez à nouveau un SaveDataAll puis arrêtez votre instance TM1
Lancement du migrateur
Placez-vous dans une fenêtre d’exécution MSDOS.
Allez dans le répertoire bin64 de votre implémentation puis, afin de connaitre les paramètres idoines, exécutez la commande suivante :
migrate_tm1.exe --help
Le résultat nous donne de précieuses indications sur la syntaxe d’appel du migrateur :
TM1 v12 Migration utility allows users to migrate a v11 model to v12 by creating a backup file that can be later restored onto a v12 Database.
Usage:
migrate_tm1 [flags]
migrate_tm1 [command]
Available Commands:
help Help about any command
version Prints the version number of TM1 database
Flags:
-h, --help help for migrate_tm1
-i, --input string [REQUIRED] Absolute/Relative path to TM1 v11 data directory(tm1s.cfg location)
-l, --log-to-file string Absolute/Relative path to a log file to write migration logs to
-o, --output string [REQUIRED] Absolute/Relative path to v12 backup file to be created
-t, --temp-dir string Absolute/Relative path to a temporary directory to be used to store intermittent v12 database contents
Use "migrate_tm1 [command] --help" for more information about a command.
Pour notre cas, nous allons utiliser les paramètres suivants :
- -i : le chemin vers notre fichier tm1s.cfg : C:\ibm\cognos\tm1_64\samples\tm1\SData
- -l : le chemin vers un fichier log c:\Migration_Tool\sData\sData.log
- -o : le chemin vers notre résultat de migration : c:\Migration_Tool\sData\sData.gz
- -t : le chemin vers un répertoire temporaire : c:\ Migration_Tool\sData\Temporaire
Au sein d’un script.cmd analogue à :
Durant l’exécution, nous aurons des messages de progression, peut-être quelques erreurs dues à des objets privés, mais nous obtenons avec bonheur notre base de données migrée.
Importation de la base de données dans le nouvel environnement
Dans notre cas, nous allons, sous AWS, créer une enveloppe « sData » puis importer et restaurer le résultat de notre migration.
Création de la nouvelle enveloppe
Import de la « base migrée »
Restauration de la base migrée
Nous recevons alors une notification nous indiquant que la restauration est achevée.
Nous pouvons désormais utiliser notre nouvelle base TM1 !
Vous avez maintenant les connaissances nécessaires pour migrer vos applications TM1 de la V11 vers la V12.
Vous souhaitez bénéficier d'experts, de développeurs, ou d'une formation sur TM1 / Planning Analytics ? Rendez-vous sur la page Contact !
