Eseguire la migrazione dei dati basati su file

Gli utenti caricano file di dati, ad esempio fogli di calcolo, in Oracle Analytics Cloud per creare data set. Quando si esegue la migrazione verso un nuovo ambiente Oracle Analytics Cloud, è possibile acquisire questi dati basati su file. A volte, problemi di connettività della rete o di accesso alla memoria possono impedire la migrazione dei file di dati nello snapshot. Per questi casi, in Oracle Analytics Cloud è disponibile una utility CLI (interfaccia della riga di comando) che consente di spostare i file di dati nella nuova posizione. La utility CLI snapshot consente inoltre di spostare i plugin relativi alle mappe e i file di estensione che gli utenti possono caricare per le visualizzazioni dei dati.

Eseguire la utility CLI di migrazione dei dati se viene visualizzato il messaggio Ripristino completato con errori - Ripristino dei dati non riuscito o un messaggio simile quando si tenta di ripristinare uno snapshot che contiene file di dati. Questo messaggio viene visualizzato quando:

si esegue la migrazione da un'altra area;
si esegue la migrazione da Oracle Analytics Cloud in Gen 1 o dall'infrastruttura Oracle Cloud Classic a Oracle Analytics Cloud in Gen 2;
il processo di ripristino non è riuscito a causa di altri problemi relativi alla connettività di rete o di accesso alla memoria.

La utility CLI consente di spostare direttamente i file di dati da un ambiente a un altro con una sola operazione. In alternativa, è tuttavia possibile scaricare i dati basati su file in un file ZIP e successivamente caricare i file di dati nell'ambiente scelto con due operazioni distinte.

Controllare i dettagli dell'ambiente.
- Verificare che il sistema di origine e il sistema destinazione utilizzino entrambi la versione più recente di Oracle Analytics Cloud 5.3.x o successiva. La utility CLI non è disponibile nelle versioni precedenti.
  
  Se non si è sicuri, contattare il rappresentante Oracle.
- Verificare che il sistema di origine e il sistema destinazione siano attivi e in esecuzione e che Oracle Analytics Cloud sia configurato con credenziali di memorizzazione valide.
- Controllare l'ambiente locale. Per eseguire la utility CLI è necessario Java 1.8 o versione successiva.
- Assicurarsi di poter accedere all'ambiente di origine e all'istanza di Oracle Analytics Cloud di destinazione dall'ambiente locale in cui si prevede di eseguire la utility CLI.
- Verificare il nome e la posizione dello snapshot, scaricato in precedenza, che contiene i dati basati su file. Ad esempio, /tmp/20190307095216.bar.
Scaricare la utility CLI.
1. Nell'istanza di Oracle Analytics Cloud di destinazione fare clic su Console quindi su Snapshot.
2. Fare clic sul menu Pagina e selezionare Scarica utility di migrazione dei dati.
  Attenersi alle istruzioni visualizzate per salvare localmente il file migrate-oac-data.zip.
Estrarre migrate-oac-data.zip.
Il file ZIP contiene tre file:
- migrate-oac-data.jar
- config.properties
- readme

Se si desidera eseguire la migrazione diretta dei file di dati memorizzati nell'ambiente di origine verso la destinazione con una sola operazione, configurare opportunamente la sezione [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>

Se si desidera scaricare prima i file di dati dall'istanza di Oracle Analytics Cloud di origine nell'ambiente locale e successivamente caricare i file di dati nell'ambiente Oracle Analytics Cloud di destinazione, configurare le sezioni [DownloadDataFiles] e [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>

Eseguire il file migrate-oac-data.jar nell'ambiente locale.
Sintassi:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Dove:
- -config configfile: nome del file config.properties
- -d: consente di scaricare i dati localmente in base alle informazioni contenute in config.properties
- -help: visualizza la Guida
- -m: esegue la migrazione dei dati utilizzando le informazioni sull'origine e la destinazione disponibili nel file config.properties
- -u: carica i dati utilizzando le informazioni contenute nel file config.properties
Esempio di istruzione per la migrazione dei file di dati con una sola operazione:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Esempio di istruzione per scaricare i file di dati localmente:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Esempio di istruzione per caricare i file di dati:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Collegarsi all'istanza Oracle Analytics Cloud di destinazione.
Per esporre i file di dati in Oracle Analytics Cloud, è necessario ripristinare per la seconda volta lo snapshot utilizzato per la migrazione del resto del contenuto. Questa volta è necessario selezionare l'opzione di ripristino Personalizzato.
1. Aprire la console e fare clic su Snapshot.
2. Selezionare lo snapshot che contiene i file di dati.
3. Selezionare l'opzione di ripristino Personalizzato, quindi selezionare l'opzione Dati basati su file.
  Deselezionare tutte le altre opzioni.
4. Fare clic su Ripristina.
Verificare che i file di dati siano disponibili.