Anwendungen mit dem Migrationsutility migrieren

Als Essbase-Serviceadministrator können Sie über das Migrationsutility (migrationTools.jar) eine ganze Essbase-Instanz (alle Anwendungen, Benutzer, Gruppen und andere Artefakte) in einem einzigen Prozess von einer Cloud-Instanz zu einer anderen migrieren.

Mit dem Migrationsutility können Sie über Marketplace von Quellanwendungen und Elementen aus Essbase-Deployments auf OCI migrieren. Das Utility migriert mehrere Anwendungen gleichzeitig. Außerdem werden Artefakte, Regeln, Benutzer und Gruppen migriert.

Beachten Sie, dass die Essbase-Befehlszeilenschnittstelle (CLI), lcmimport und lcmexport keine Benutzer und Gruppen migrieren.

Bevor Sie das Migrationsutility verwenden, müssen Sie die folgenden Voraussetzungen erfüllen: SSL-Zertifikat einrichten.

Anwendungsfälle für das Migrationsutility

Im Folgenden finden Sie einige Anwendungsfälle für die Migration mit dem Migrationsutility.

  • Migrieren Sie Essbase-Benutzer aus WebLogic LDAP in der Quelle in OCI Identity and Access Management (IAM) oder Oracle Identity Cloud Service (IDCS) im Ziel.
  • Verwenden Sie das Migrationsutility für einfache, nicht benutzerdefinierte Deployments. Wenn Ihr Deployment Anpassungen enthält, wie benutzerdefinierte Single Sign-On-Lösungen, verwenden Sie die CLI anstelle des Migrationsutilitys.
  • Wenn das Essbase-Quell-Deployment von
    • Essbase Marketplace auf Oracle Cloud Infrastructure mit OCI Identity and Access Management (IAM) oder Oracle Identity Cloud Service (IDCS) oder
    • Essbase Marketplace auf Oracle Cloud Infrastructure, mit Embedded LDAP
    bevor Sie die folgenden Schritte des Migrationsutilitys zum Exportieren verwenden, erstellen Sie zunächst eine neue vertrauliche Anwendung, wie unter Vertrauliche Identitätsanwendung erstellen beschrieben. Bevor Sie das Migrationsutility zum Importieren verwenden, ändern Sie außerdem die Host- und IAM- oder IDCS-Details in import.properties, sodass sie auf die Essbase-Zielinstanz verweisen.

Schritte zur Migration von Cloud-Anwendungen und -Benutzern mit dem Migrationsutility

  1. Bevor Sie das Migrationsutility verwenden, patchen Sie die Essbase-Quellinstanz auf die neueste Version, falls noch nicht geschehen.

  2. Wenn das Java SE Development Kit (JDK) 8 von Oracle Technology Network noch nicht installiert wurde, laden Sie es herunter und installieren Sie es.

  3. Legen Sie den Namen der Umgebungsvariablen JAVA_HOME auf Ihrem System so fest, dass sie auf den JDK-Installationsordner verweist. Wenn der Installationspfad Leerzeichen enthält, schließen Sie den Pfad im Variablenwert mit Anführungszeichen ein, z.B. "C:\Program Files\Java\jdk1.8.0_171".

  4. Melden Sie sich bei der Essbase-Zielweboberfläche an, und navigieren Sie zur Konsole.

  5. Wechseln Sie in der Konsole zu Desktoptools, und blenden Sie Befehlszeilentools aus.

  6. Klicken Sie neben Migrationsutility auf Herunterladen.

  7. Laden Sie die ZIP-Datei des Migrationsutilitys auf ein lokales Laufwerk herunter. Für beste Ergebnisse wählen Sie am besten einen Pfad ohne Leerzeichen, z.B. C:\Oracle.

  8. Extrahieren Sie die ZIP-Datei, und zeigen Sie die extrahierten Dateien (Properties, jar und readme) im Ordner migrationTools an.

  9. Bevor Sie den Export des Migrationsutilitys ausführen, bearbeiten Sie die Datei export.properties, die sich im selben Verzeichnis wie das Utility befindet. Geben Sie die Details der Essbase-Quellinstanz an, von der Sie migrieren.

    Eigenschaft exportieren Beschreibung
    userName Eingabe erforderlich. Essbase-Administratorbenutzername.
    Kennwort Eingabe erforderlich. Essbase-Administratorkennwort.
    Moderator Eingabe erforderlich. IP-Adresse des Load Balancers, wenn während des Essbase-Deployments ein Load Balancer konfiguriert wurde. Andernfalls der Hostname oder die IP-Adresse, der/die der öffentlichen IP-Adresse von Essbase entspricht.
    port Optional. HTTP-Listening-Port der Essbase-Quellinstanz. Wenn die Quellinstanz im sicheren (TLS-)Modus konfiguriert ist und isTLS=true-Port 443 angenommen wird. Wenn die Quellinstanz mit dem LDAP-Identitätsprovider konfiguriert ist, setzen Sie den Port auf 80.
    istTLS Optional: true oder false. Wenn true, wird die Quellinstanz im sicheren (TLS-)Modus mit dem angegebenen port-Wert konfiguriert.
    Proxy Optional. HTTP-Proxyhostadresse, wenn die Verbindung zur Essbase-Quellinstanz einen Proxy erfordert. Proxyhost und Proxyport werden durch einen Doppelpunkt getrennt. Wenn der Proxyport ausgelassen wird, wird davon ausgegangen, dass er 80 ist. Beispiel mit ausgelassenem Port: www-proxy-example.com. Beispiel mit Port: www-proxy-example.com:80
    Daten überspringen Optional. Der Standardwert lautet false. Setzen Sie diesen Wert auf true, wenn nur Schemas der Essbase-Anwendung exportiert werden sollen.
    skipUser Optional: true oder false. Wählen Sie 'Wahr', wenn keine Benutzer und/oder Gruppen exportiert werden müssen. Der Standardwert ist "false".
    idcsHost Nur erforderlich, wenn Benutzer und/oder Gruppen von einer über Marketplace auf OCI bereitgestellten Instanz migriert werden. Der Identitätsdomainhost der Quelle in IAM oder IDCS. Extrahieren Sie aus der Identitätsdomain-URL (Beispiel: https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)) nur den Domainteil nach der Zeichenfolge. Beispiel: identity.oraclecloud.com
    IDCS-Mandant Nur für die Migration von Benutzern und/oder Gruppen aus einer Instanz erforderlich, die über Marketplace auf OCI bereitgestellt ist. Die Identitätsdomainmandanten-ID des Quellhosts in IAM oder IDCS. Aus der Identitätsdomain-URL (Beispiel: https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com), extrahieren Sie nur idcs-<string_of_numbers_and_letters>.
    Client-ID Nur für die Migration von Benutzern und/oder Gruppen aus einer Instanz erforderlich, die über Marketplace auf OCI bereitgestellt ist. Die Client-ID des Quellhosts für die OAuth-Autorisierung in der integrierten vertraulichen Identitätsanwendung.
    Client Secret Nur für die Migration von Benutzern und/oder Gruppen aus einer Instanz erforderlich, die über Marketplace auf OCI bereitgestellt ist. Das Client Secret des Quellhosts für die OAuth-Autorisierung in der integrierten vertraulichen Identitätsanwendung.
    Anwendungs-ID Nur für die Migration von Benutzern und/oder Gruppen aus einer Instanz erforderlich, die über Marketplace auf OCI bereitgestellt ist. ID der integrierten vertraulichen Identitätsanwendung in der OCI-Identitätsdomain (IAM oder IDCS). Diese Identitätsanwendung muss mit Anwendungsrollen konfiguriert werden, die Benutzern und Gruppen erteilt werden können. Diese Eigenschaft ermöglicht das Erteilen von Rollen für migrierte Benutzer und Gruppen.

  10. Bearbeiten Sie die Datei import.properties, die sich im selben Verzeichnis wie das Utility befindet. Geben Sie die Details der Essbase-Zielinstanz an, zu der Sie migrieren.

    Eigenschaft importieren Beschreibung
    userName Eingabe erforderlich. Benutzername des Essbase-Administrators der Zielinstanz.
    Kennwort Eingabe erforderlich. Das Essbase-Administratorkennwort der Zielinstanz.
    Moderator Eingabe erforderlich. IP-Adresse der Zielinstanz des Load Balancers, wenn während des Essbase-Deployments ein Load Balancer konfiguriert wurde. Andernfalls der Hostname oder die IP-Adresse, der/die der öffentlichen IP-Adresse von Essbase entspricht.
    port Optional. HTTP-Listening-Port der Essbase-Zielinstanz. Wenn die Zielinstanz im sicheren (TLS-)Modus konfiguriert ist und isTLS=true-Port 443 angenommen wird. Wenn die Quellinstanz mit dem LDAP-Identitätsprovider konfiguriert ist, setzen Sie den Port auf 80.
    istTLS Optional: true oder false. Wenn true, wird die Zielinstanz im sicheren (TLS-)Modus mit dem angegebenen port-Wert konfiguriert.
    userPassword Optional. Anfängliches Kennwort, das neuen Benutzern zugewiesen werden soll, die das Utility in die integrierte Identitätsanwendung in IAM oder IDCS migriert. Um die Kennwörter nach der Migration zu ändern, verwenden Sie die OCI-Konsole.
    Proxy Optional. HTTP-Proxyhostadresse, wenn für die Verbindung zur Essbase-Zielinstanz ein Proxy erforderlich ist. Proxyhost und Proxyport werden durch einen Doppelpunkt getrennt. Wenn der Proxyport ausgelassen wird, wird davon ausgegangen, dass er 80 ist. Beispiel mit ausgelassenem Port: www-proxy-example.com. Beispiel mit Port: www-proxy-example.com:80
    skipUser Optional: true oder false. Wählen Sie 'Wahr' nur, wenn keine Benutzer und/oder Gruppen importiert werden müssen. Der Standardwert ist "false".
    idcsHost Nur für die Migration von Benutzern und/oder Gruppen zu einer über Marketplace auf OCI bereitgestellten Instanz erforderlich. Zielidentitätsdomainhost. Extrahieren Sie aus der Identitätsdomain-URL (Beispiel: https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)) nur den Domainteil nach der Zeichenfolge. Beispiel: identity.oraclecloud.com
    IDCS-Mandant Nur für die Migration von Benutzern und/oder Gruppen zu einer über Marketplace auf OCI bereitgestellten Instanz erforderlich. Die Identitätsdomainmandanten-ID des Zielhosts. Aus der Identitätsdomain-URL (Beispiel: https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com), extrahieren Sie nur idcs-<string_of_numbers_and_letters>.
    Client-ID Nur für die Migration von Benutzern und/oder Gruppen zu einer über Marketplace auf OCI bereitgestellten Instanz erforderlich. Die Client-ID des Zielhosts für die OAuth-Autorisierung in der integrierten vertraulichen Identitätsanwendung.
    Client Secret Nur für die Migration von Benutzern und/oder Gruppen zu einer über Marketplace auf OCI bereitgestellten Instanz erforderlich. Das Client Secret des Zielhosts für die OAuth-Autorisierung in der integrierten vertraulichen Identitätsanwendung.
    Anwendungs-ID Nur für die Migration von Benutzern und/oder Gruppen zu einer über Marketplace auf OCI bereitgestellten Instanz erforderlich. ID der integrierten vertraulichen Identitätsanwendung in der OCI-Identitätsdomain (IAM oder IDCS). Diese Identitätsanwendung muss mit Anwendungsrollen konfiguriert werden, die Benutzern und Gruppen erteilt werden können. Diese Eigenschaft ermöglicht das Erteilen von Rollen für migrierte Benutzer und Gruppen.
    overwrite Optional. Setzen Sie diesen Wert auf true, wenn Anwendungen, die importiert werden sollen, bereits auf dem Ziel vorhanden sind und Sie sie überschreiben möchten. Der Standardwert ist "false".
    Zertifikate Optional. Vollständiger Pfad zu allen vertrauenswürdigen Zertifikatsdateien für alle TLS/SSL-Server. Bei Windows entweichen Sie umgekehrte Schrägstriche mit einem anderen umgekehrten Schrägstrich. Beispiel: C:\\migrationTools\\all_certs.pem

  11. Führen Sie das Migrationsutility mit dem Exportbefehl in Java aus, um alle Anwendungen, Benutzer und Gruppen aus dem Katalog der Essbase-Quellinstanz in eine komprimierte Datei zu exportieren. 

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

    Beispiel:

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

  12. Führen Sie das Migrationsutility in Java mit dem Importbefehl aus, um die komprimierte Datei in die Zielinstanz zu importieren.

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

  13. Nach der Ausführung des Imports werden die Daten in den Essbase-Katalog der Zielinstanz migriert.