Oracle Analytics Cloud anhand von Snapshots migrieren

Mit Download- und Uploadfeatures können Sie Snapshots von im lokalen Dateisystem speichern und in die Cloud hochladen. Mit diesen Features können Sie Inhalt zwischen zwei verschiedenen Services migrieren, zwischen Entwicklungs-, Test- und Produktionsumgebungen migrieren sowie in Oracle Cloud Infrastructure Classic bereitgestellte Services zu Oracle Cloud Infrastructure migrieren.

Themen:

Oracle Analytics Cloud-Migration

Sie können Inhalte und Einstellungen ganz einfach mit Snapshots von einer Oracle Analytics Cloud-Umgebung in eine andere migrieren. Dabei können Sie alle oder nur bestimmte Inhaltstypen migrieren.

Voraussetzungen zur Migration

Bevor Sie Benutzerinhalt mithilfe von Snapshots migrieren, verifizieren Sie die Quell- und die Zielumgebung:

Die Quell- und die Zielumgebung müssen beide Oracle Analytics Cloud 5.1.x oder höher verwenden. Bei Snapshots aus früheren Versionen wird nicht die gesamte Umgebung erfasst.

Fragen Sie einen Oracle-Mitarbeiter, wenn Sie sich nicht sicher sind.
Falls noch nicht geschehen, erstellen Sie den Zielservice auf Oracle Cloud Infrastructure.

Siehe Service mit Oracle Analytics Cloud erstellen in Oracle Analytics Cloud auf Oracle Cloud Infrastructure (2. Generation) verwalten.
Wenn Sie dateibasierte Daten migrieren möchten, prüfen Sie, ob die Quell- und die Zielumgebung hochgefahren, gestartet und mit gültigen Speicherzugangsdaten konfiguriert sind.

Probleme mit dem Speicherzugriff können eine Datendateimigration mit Snapshots verhindern. In einem solchen Fall können Sie mit dem Datenmigrationsutility die Datendateien separat herunter- und anschließend hochladen.

Nicht migrierte Elemente

Einige Oracle Analytics Cloud-Artefakte werden nicht in Snapshots einbezogen. Nicht-Oracle Analytics Cloud-Artefakte sind ebenfalls nicht enthalten.

Nicht migrierte Elemente	Weitere Informationen
Virenscannerkonfiguration	Zeichnen Sie die Virenscannerkonfiguration in der Quellumgebung auf, und konfigurieren Sie den Virenscanner mit denselben Informationen auf dem Ziel. Siehe Virenscanner konfigurieren.
Mailserverkonfiguration	Zeichnen Sie die SMTP-Mailserverkonfiguration in der Quellumgebung auf, und konfigurieren Sie den Mailserver mit diesen Informationen auf dem Ziel. Siehe E-Mail-Server für die Zustellung von Berichten einrichten.
Andere gespeicherte Snapshots in der Quellumgebung	Laden Sie gegebenenfalls einzelne Snapshots herunter, die Sie migrieren möchten, und laden Sie diese dann in das Ziel hoch. Siehe Snapshots importieren.
Benutzer (und Gruppen)	Von Oracle Cloud Infrastructure Identity and Access Management-(IAM-)Identitätsdomain migrieren Mit Export- und Importfeatures in der Oracle Cloud Infrastructure-Konsole können Sie Benutzer und Rollen von einer Identitätsdomain zu einer anderen migrieren. Siehe Daten übertragen in der Oracle Cloud Infrastructure-Dokumentation. Von Oracle Identity Cloud Service migrieren Mit Export- und Importfeatures in der Oracle Identity Cloud Service-Konsole können Sie Benutzer und Rollen von einer Identitätsdomain zu einer anderen migrieren. Siehe Oracle Identity Cloud Service-Benutzer verwalten und Oracle Identity Cloud Service-Gruppen verwalten. Von Embedded WebLogic LDAP Server migrieren Mit dem Skript `wls_ldap_csv_exporter` können Sie Benutzer und Gruppen in eine CSV-Datei exportieren, die Sie in das Oracle Identity Cloud Service-Ziel importieren können. Siehe Benutzer und Gruppen aus Embedded WebLogic LDAP Server exportieren.
Identity-Management-Konfiguration	Verwenden Sie die Oracle Cloud Infrastructure-Konsole in der Zielumgebung, um Anwendungsrollenzuweisungen für Benutzer (oder Gruppen), die Sie in der Quelle konfiguriert haben, oder Single Sign-On (SSO) usw. neu zu konfigurieren.
Netzwerkkonfiguration	Richten Sie die Netzwerkanforderungen in der Zielumgebung nach Bedarf ein.

Typischer Workflow zum Migrieren von Oracle Analytics Cloud

Mit Snapshots können Sie Oracle Analytics Cloud in eine andere Umgebung migrieren. Führen Sie die folgenden Schritte aus.

Aufgabe	Beschreibung	Weitere Informationen
Informationen zum Migrieren mit Snapshots sammeln	Ermitteln Sie, welche Inhalte in Snapshots migriert werden können und welche nicht sowie welche Voraussetzungen dabei gelten.	Oracle Analytics Cloud-Migration
Zielservice erstellen	Verwenden Sie die Oracle Cloud Infrastructure-Konsole, um einen neuen Service auf Oracle Cloud Infrastructure bereitzustellen.	Service mit Oracle Analytics Cloud erstellen
Benutzer und Gruppen migrieren	Mit Export- und Importfeatures in der Oracle Cloud Infrastructure-Konsole können Sie Benutzer und Rollen von einer Identitätsdomain zu einer anderen migrieren. Die Art der Benutzermigration für Oracle Analytics Cloud hängt davon ab, ob Identitätsdomains in Ihrem Cloud-Account verfügbar sind. Informationen dazu finden Sie unter Benutzer und Gruppen einrichten. Wenn das Quellsystem einen Embedded WebLogic-LDAP-Server für das Identity Management verwendet, exportieren Sie die Benutzer und Gruppen mit dem Skript `wls_ldap_csv_exporter` in eine CSV-Datei.	Daten übertragen (IAM-Benutzer) Oracle Identity Cloud Service-Benutzer verwalten Benutzer und Gruppen aus Embedded WebLogic LDAP Server exportieren
Snapshot der Quelle erstellen	Erfassen Sie den Inhalt im Quellsystem, den Sie migrieren möchten.	Snapshot erstellen
Snapshot exportieren	Laden Sie den Snapshot, den Sie migrieren möchten, in das lokale Dateisystem oder in einen Speicher-Bucket auf Oracle Cloud Infrastructure herunter.	Snapshots exportieren
Snapshot in das Ziel hochladen	Melden Sie sich beim Zielsystem an, und laden Sie den Snapshot hoch.	Snapshots importieren
Snapshot-Inhalt wiederherstellen	Wählen Sie den neu hochgeladenen Snapshot in der Liste der gespeicherten Snapshots aus, und stellen Sie den Snapshot-Inhalt wieder her.	Aus Snapshot wiederherstellen
Datendateien migrieren	Migrieren Sie Datendateien mit dem Datenmigrationsutility von einer Umgebung in eine andere. Nur in folgenden Fällen erforderlich: Sie migrieren zu einer anderen Region. Sie migrieren von Oracle Analytics Cloud der 1. Generation oder Oracle Cloud Infrastructure Classic zu Oracle Analytics Cloud der 2. Generation. Die Wiederherstellung verläuft aufgrund von Problemen mit der Netzwerkverbindung oder dem Speicherzugriff nicht erfolgreich.	Dateibasierte Daten migrieren
Virenscanner neu konfigurieren	Zeichnen Sie die Virenscannerkonfiguration in der Quellumgebung auf, und konfigurieren Sie den Virenscanner damit auf dem Ziel.	Virenscanner konfigurieren
Mailserver neu konfigurieren	Zeichnen Sie die SMTP-Mailserverkonfiguration in der Quellumgebung auf, und konfigurieren Sie den Mailserver damit auf dem Ziel.	E-Mail-Server für die Zustellung von Berichten einrichten
(Optional) Weitere Snapshots migrieren	Laden Sie einzelne Snapshots herunter, die Sie migrieren möchten, und laden Sie diese dann in die erforderliche Zielumgebung hoch.	Snapshots exportieren Snapshots importieren
Identity-Management-Konfiguration migrieren	Verwenden Sie die Oracle Cloud Infrastructure-Konsole in der Zielumgebung, um Anwendungsrollenzuweisungen für Benutzer (oder Gruppen), die Sie in der Quelle konfiguriert haben, oder Single Sign-On (SSO) usw. neu zu konfigurieren.

Dateibasierte Daten migrieren

Benutzer können Datendateien wie Kalkulationstabellen in Oracle Analytics Cloud hochladen, um Datasets zu erstellen. Bei der Migration zu einer neuen Oracle Analytics Cloud-Umgebung können Sie diese dateibasierten Daten ebenfalls migrieren. Manchmal können Sie die Datendateien im Snapshot aufgrund von Problemen mit der Netzwerkverbindung oder dem Speicherzugriff nicht migrieren. Für solche Fälle bietet Oracle Analytics Cloud ein CLI-Utility (Befehlszeilenschnittstelle), mit dem Sie Datendateien an den neuen Speicherort verschieben können. Das Snapshot-CLI-Utility verschiebt auch alle kartenbezogenen Plug-ins und Erweiterungsdateien, die Benutzer für Datenvisualisierungen hochladen können.

Führen Sie das CLI-Datenmigrationsutility aus, wenn die Meldung Restore succeeded with errors - data restore failed (oder eine ähnliche Meldung) beim Versuch angezeigt wird, einen Snapshot mit Datendateien wiederherzustellen. Diese Meldung wird in folgenden Fällen angezeigt:

Sie migrieren Inhalt aus einer anderen Region.
Sie migrieren Inhalt von Oracle Analytics Cloud der 1. Generation oder Oracle Cloud Infrastructure Classic zu Oracle Analytics Cloud der 2. Generation.
Die Wiederherstellung verläuft aufgrund eines anderen Problems mit der Netzwerkverbindung oder dem Speicherzugriff nicht erfolgreich.

Mit dem CLI-Utility können Sie Datendateien in nur einem Schritt direkt von einer Umgebung in eine andere verschieben. Sie können die dateibasierten Daten auch in zwei separaten Schritten in eine ZIP-Datei herunterladen und die Datendateien dann in die ausgewählte Umgebung hochladen.

Prüfen Sie die Umgebungsdetails.
- Stellen Sie sicher, dass sowohl das Quell- als auch das Zielsystem Oracle Analytics Cloud 5.3 oder höher verwenden. Das CLI-Utility ist in früheren Versionen nicht verfügbar.
  
  Fragen Sie einen Oracle-Mitarbeiter, wenn Sie sich nicht sicher sind.
- Prüfen Sie, ob das Quell- und das Zielsystem hochgefahren sind und ausgeführt werden und ob Oracle Analytics Cloud mit gültigen Speicherzugangsdaten konfiguriert ist.
- Prüfen Sie die lokale Umgebung. Zur Ausführung des CLI-Utilitys ist Java 1.8 oder höher erforderlich.
- Stellen Sie sicher, dass Sie von der lokalen Umgebung, in der Sie das CLI-Utility ausführen möchten, auf die Quellumgebung und das Oracle Analytics Cloud-Ziel zugreifen können.
- Prüfen Sie den Namen und den Speicherort des zuvor heruntergeladenen Snapshots, der die dateibasierten Daten enthält. Beispiel: /tmp/20190307095216.bar.
Laden Sie das CLI-Utility herunter.
1. Klicken Sie im Oracle Analytics Cloud-Ziel auf Konsole und dann auf Snapshots.
2. Klicken Sie auf das Seitenmenü , wählen Sie Migrieren aus, und klicken Sie auf Datenmigrationsutility herunterladen.
  Befolgen Sie die Anweisungen, um die Datei migrate-oac-data.zip lokal zu speichern.
Dekomprimieren Sie migrate-oac-data.zip.
Die ZIP-Datei enthält drei Dateien:
- migrate-oac-data.jar
- config.properties
- readme

Wenn Sie Datendateien, die in der Quellumgebung gespeichert sind, mit einem Schritt direkt in das Ziel migrieren möchten, konfigurieren Sie den Abschnitt [MigrateData] in config.properties.

[MigrateData]
# Migrate data files from a source Oracle Analytics Cloud environment (OAC) to a target Oracle Analytics Cloud environment.
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>

Wenn Sie zuerst Datendateien von der Oracle Analytics Cloud-Quellumgebung in die lokale Umgebung herunterladen und anschließend in die Oracle Analytics Cloud-Zielumgebung hochladen möchten, konfigurieren Sie die Abschnitte [DownloadDataFiles] und [UploadDataFiles] in config.properties.

[DownloadDataFiles]
#Download Data Files: Download data files from Oracle Analytics Cloud storage to a local repository
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Local data file directory. Make sure you have enough space to download the data files to this directory. For example: /tmp/mydatafiledir 
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
     # Data fragment size. Data files are downloaded in fragments. Default fragment size is 500MB.
      MAX_DATA_FRAGMENT_SIZE_IN_MB=500

[UploadDataFiles]
#Upload data files: Upload data files to the target Oracle Analytics Cloud. 
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>
    # Local directory containing the data files you want to upload. For example: /tmp/mydatafiledir
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>

Führen Sie die Datei migrate-oac-data.jar in der lokalen Umgebung aus.
Syntax:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Hierbei gilt:
- -config configfile: Name der Datei config.properties
- -d: Lädt Daten lokal anhand von Informationen in config.properties herunter
- -help: Zeigt Hilfe an
- -m: Migriert Daten anhand von Quell- und Zielinformationen in der Datei config.properties
- -u: Lädt Daten anhand von Informationen in der Datei config.properties hoch
Beispiel: So migrieren Sie Datendateien mit nur einem Schritt:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Beispiel: So laden Sie Datendateien lokal herunter:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Beispiel: So laden Sie Datendateien hoch:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Melden Sie sich bei der Oracle Analytics Cloud-Zielinstanz an.
Um die Datendateien in Oracle Analytics Cloud zugänglich zu machen, müssen Sie den Snapshot, mit dem Sie den restlichen Inhalt migriert haben, ein zweites Mal wiederherstellen. Wählen Sie dieses Mal die Wiederherstellungsoption Benutzerdefiniert aus.
1. Öffnen Sie die Konsole, und klicken Sie auf Snapshots verwalten.
2. Wählen Sie den Snapshot aus, der die Datendateien enthält.
3. Wählen Sie die Wiederherstellungsoption Benutzerdefiniert und dann die Option Dateibasierte Daten aus.
  Deaktivieren Sie alle anderen Optionen.
4. Klicken Sie auf Wiederherstellen.
Prüfen Sie, ob die Datendateien verfügbar sind.