Migrer des applications à l'aide de l'utilitaire de migration

En tant qu'administrateur de service Essbase, vous pouvez vous servir de l'utilitaire de migration (migrationTools.jar) pour migrer l'ensemble d'une instance Essbase (toutes les applications, utilisateurs et groupes, et autres artefacts) d'une instance cloud vers un autre au cours d'une seule et même procédure.

Vous pouvez utiliser l'utilitaire de migration pour effectuer une migration à partir d'applications et d'éléments source à partir de déploiements Essbase sur OCI via Marketplace. L'utilitaire migre plusieurs applications à la fois. Il migre également les artefacts, les règles, les utilisateurs et les groupes.

Notez que les commandes de l'interface de ligne de commande Essbase, lcmimport et lcmexport ne migrent pas les utilisateurs et les groupes.

Avant d'utiliser l'utilitaire de migration, effectuez le prérequis suivant : Configuration du certificat SSL.

Cas d'utilisation de l'utilitaire de migration

Voici quelques cas d'utilisation pour la migration avec l'utilitaire de migration.

  • Migrez les utilisateurs Essbase à partir du LDAP WebLogic dans la source vers OCI Identity and Access Management (IAM) ou Oracle Identity Cloud Service (IDCS) dans la cible.
  • Utilisez l'utilitaire de migration pour les déploiements de base qui ne sont pas personnalisés. Si votre déploiement inclut des personnalisations, telles que des solutions d'accès avec connexion unique personnalisées, utilisez l'interface de ligne de commande au lieu de l'utilitaire de migration.
  • Lorsque le déploiement Essbase source provient de
    • Marketplace Essbase sur Oracle Cloud Infrastructure, à l'aide d'OCI Identity and Access Management (IAM) ou d'Oracle Identity Cloud Service (IDCS), ou
    • Marketplace Essbase sur Oracle Cloud Infrastructure, à l'aide du protocole LDAP imbriqué
    puis, avant d'utiliser les étapes de l'utilitaire de migration ci-dessous pour l'export, créez d'abord une application confidentielle comme indiqué dans Création d'une application d'identité confidentielle. De plus, avant d'utiliser l'utilitaire de migration pour l'import, modifiez l'hôte et les détails IAM ou IDCS dans import.properties pour qu'ils pointent vers l'instance Essbase cible.

Etapes de migration des applications et des utilisateurs cloud à l'aide de l'utilitaire de migration

  1. Avant d'utiliser l'utilitaire de migration, si vous ne l'avez pas encore fait, appliquez un patch à votre instance Essbase source vers la dernière version.

  2. S'il n'est pas déjà installé, téléchargez et installez Java SE Development Kit (JDK) 8 à partir d'Oracle Technology Network.

  3. Définissez le nom de la variable d'environnement JAVA_HOME sur votre système afin qu'elle pointe vers le dossier d'installation de JDK. Si le chemin d'installation contient des espaces, placez-le dans la valeur de la variable, entre guillemets, par exemple "C:\Program Files\Java\jdk1.8.0_171".

  4. Connectez-vous à l'interface Web Essbase cible et accédez à la console.

  5. Dans la console, accédez aux Outils de bureau et développez Outils de ligne de commande.

  6. Cliquez sur Télécharger en regard de l'utilitaire de migration.

  7. Téléchargez le fichier zip de l'utilitaire de migration sur un lecteur local. Pour des meilleurs résultats, choisissez un chemin sans espace. Par exemple, C:\Oracle.

  8. Extrayez le fichier zip et afficheZ les fichiers extraits (fichiers .properties, .jar et Lisez-moi) dans le dossier migrationTools.

  9. Avant d'exécuter l'export de l'utilitaire de migration, modifiez le fichier export.properties, situé dans le même répertoire que l'utilitaire. Fournissez les détails de l'instance source Essbase à partir de laquelle vous effectuez la migration.

    Exporter la propriété Description
    userName Requis. Nom utilisateur de l'administrateur Essbase.
    mot de passe Requis. Mot de passe d'administrateur Essbase.
    hôte Requis. Adresse IP de l'équilibreur de charge, si un équilibreur de charge a été configuré lors du déploiement Essbase. Sinon, le nom d'hôte ou l'adresse IP correspondant à l'adresse IP publique Essbase.
    port Facultatif. Port d'écoute HTTP de l'instance Essbase source. Si l'instance source est configurée en mode sécurisé (TLS) et que le port 443 isTLS=true est pris en compte. Si l'instance source est configurée avec le fournisseur d'identités LDAP, définissez le port sur 80.
    isTLS Facultatif : true ou false. Si la valeur est True, l'instance source est configurée en mode sécurisé (TLS) à l'aide de la valeur port indiquée.
    proxy Facultatif. Adresse de l'hôte proxy HTTP, si la connexion à l'instance Essbase source nécessite un proxy. L'hôte proxy et le port proxy sont séparés par le signe deux-points. Si le port proxy est omis, sa valeur est supposée être 80. Exemple avec port omis : www-proxy-example.com. Exemple avec port inclus : www-proxy-example.com:80
    skipdata Facultatif. La valeur par défaut est false. Définissez la valeur sur true si seuls les schémas de l'application Essbase doivent être exportés.
    ignorer l'utilisateur Facultatif : true ou false. Définissez la valeur sur Vrai uniquement si vous n'avez pas besoin d'exporter des utilisateurs et/ou des groupes. La valeur par défaut est False.
    IDCSHost Requis uniquement lors de la migration d'utilisateurs et/ou de groupes à partir d'une instance déployée sur OCI via Marketplace. Hôte de domaine d'identité de la source dans IAM ou IDCS. A partir de l'URL du domaine d'identité (par exemple, https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)), extrayez uniquement la partie du domaine après la chaîne. Exemple : identity.oraclecloud.com
    idcsLocataire Requis uniquement pour la migration des utilisateurs et/ou des groupes à partir d'une instance déployée sur OCI via Marketplace. Identificateur de location de domaine d'identité de l'hôte source dans IAM ou IDCS. A partir de l'URL du domaine d'identité (par exemple : https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com), extrayez uniquement idcs-<string_of_numbers_and_letters>).
    ID client Requis uniquement pour la migration des utilisateurs et/ou des groupes à partir d'une instance déployée sur OCI via Marketplace. Identificateur client de l'hôte source pour l'autorisation OAuth, trouvé dans l'application d'identité confidentielle intégrée.
    Clé secrète du client Requis uniquement pour la migration des utilisateurs et/ou des groupes à partir d'une instance déployée sur OCI via Marketplace. Clé secrète client de l'hôte source pour l'autorisation OAuth, trouvée dans l'application d'identité confidentielle intégrée.
    appid Requis uniquement pour la migration des utilisateurs et/ou des groupes à partir d'une instance déployée sur OCI via Marketplace. Identificateur de l'application d'identité confidentielle intégrée sur le domaine d'identité OCI (IAM ou IDCS). Cette application d'identité doit être configurée avec des rôles d'application pouvant être accordés aux utilisateurs et aux groupes. Cette propriété permet d'accorder des rôles aux utilisateurs et aux groupes migrés.

  10. Modifiez le fichier import.properties, situé dans le même répertoire que l'utilitaire. Fournissez les détails de l'instance cible Essbase vers laquelle vous effectuez la migration.

    Importer une propriété Description
    userName Requis. Nom utilisateur de l'administrateur Essbase de l'instance cible.
    mot de passe Requis. Mot de passe de l'administrateur Essbase de l'instance cible.
    hôte Requis. Adresse IP de l'instance cible de l'équilibreur de charge, si un équilibreur de charge a été configuré lors du déploiement Essbase. Sinon, le nom d'hôte ou l'adresse IP correspondant à l'adresse IP publique Essbase.
    port Facultatif. Port d'écoute HTTP de l'instance Essbase cible. Si l'instance cible est configurée en mode sécurisé (TLS) et que le port 443 isTLS=true est pris en compte. Si l'instance source est configurée avec le fournisseur d'identités LDAP, définissez le port sur 80.
    isTLS Facultatif : true ou false. Si la valeur est True, l'instance cible est configurée en mode sécurisé (TLS) à l'aide de la valeur port indiquée.
    mot de passe utilisateur Facultatif. Mot de passe initial à affecter aux nouveaux utilisateurs que l'utilitaire migre vers l'application d'identité intégrée dans IAM ou IDCS. Pour modifier les mots de passe après la migration, utilisez la console OCI.
    proxy Facultatif. Adresse de l'hôte proxy HTTP, si la connexion à l'instance Essbase cible nécessite un proxy. L'hôte proxy et le port proxy sont séparés par le signe deux-points. Si le port proxy est omis, sa valeur est supposée être 80. Exemple avec port omis : www-proxy-example.com. Exemple avec port inclus : www-proxy-example.com:80
    ignorer l'utilisateur Facultatif : true ou false. Définissez la valeur sur Vrai uniquement si vous n'avez pas besoin d'importer des utilisateurs et/ou des groupes. La valeur par défaut est False.
    IDCSHost Requis uniquement pour la migration des utilisateurs et/ou des groupes vers une instance déployée sur OCI via Marketplace. Hôte de domaine d'identité cible. A partir de l'URL du domaine d'identité (par exemple, https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)), extrayez uniquement la partie du domaine après la chaîne. Exemple : identity.oraclecloud.com
    idcsLocataire Requis uniquement pour la migration des utilisateurs et/ou des groupes vers une instance déployée sur OCI via Marketplace. Identificateur de location de domaine d'identité de l'hôte cible. A partir de l'URL du domaine d'identité (par exemple : https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com), extrayez uniquement idcs-<string_of_numbers_and_letters>).
    ID client Requis uniquement pour la migration des utilisateurs et/ou des groupes vers une instance déployée sur OCI via Marketplace. Identificateur client de l'hôte cible pour l'autorisation OAuth, trouvé dans l'application d'identité confidentielle intégrée.
    Clé secrète du client Requis uniquement pour la migration des utilisateurs et/ou des groupes vers une instance déployée sur OCI via Marketplace. Clé secrète client de l'hôte cible pour l'autorisation OAuth, trouvée dans l'application d'identité confidentielle intégrée.
    appid Requis uniquement pour la migration des utilisateurs et/ou des groupes vers une instance déployée sur OCI via Marketplace. Identificateur de l'application d'identité confidentielle intégrée sur le domaine d'identité OCI (IAM ou IDCS). Cette application d'identité doit être configurée avec des rôles d'application pouvant être accordés aux utilisateurs et aux groupes. Cette propriété permet d'accorder des rôles aux utilisateurs et aux groupes migrés.
    overwrite Facultatif. Définissez la valeur sur true si des applications à importer existent déjà sur la cible et que vous souhaitez les remplacer. La valeur par défaut est False.
    certificats Facultatif. Chemin d'accès complet à tous les fichiers de certificat sécurisé pour tous les serveurs TLS/SSL. Pour Windows, utilisez une barre oblique inverse avec une autre barre oblique inverse. Exemple : C:\\migrationTools\\all_certs.pem

  11. Exécutez l'utilitaire de migration dans Java avec la commande d'export pour exporter toutes les applications, tous les utilisateurs et tous les groupes du catalogue d'instances source Essbase vers un fichier compressé. 

    java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar export export.properties <new_tar_file>

    Par exemple :

    java –jar -Dhttps.proxyHost=www-proxy-abcdef.example.com -Dhttps.proxyPort=80 migrationTools.jar export export.properties export.tar.gz

  12. Exécutez l'utilitaire de migration dans Java avec la commande d'import pour importer le fichier compressé vers l'instance cible.

    java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar import import.properties <existing_tar_file>

  13. Une fois l'import effectué, les données sont migrées dans le catalogue Essbase de l'instance cible.