Esegui migrazione applicazioni mediante utility di migrazione

L'utente amministratore del servizio Essbase può usare la utility di migrazione (migrationTools.jar) per eseguire la migrazione dell'intera istanza di Essbase (talità di applicazioni, utenti e gruppi e altri artifact) da un'istanza cloud a un'altra in un unico processo.

È possibile utilizzare la utility di migrazione per eseguire la migrazione da applicazioni ed elementi di origine da distribuzioni di Essbase in OCI tramite Marketplace. La utility esegue la migrazione di più applicazioni contemporaneamente. Esegue inoltre la migrazione di artifact, regole, utenti e gruppi.

Si noti che i comandi CLI (Command-line Interface) di Essbase, lcmimport e lcmexport, non eseguono la migrazione di utenti e gruppi.

Prima di utilizzare la utility di migrazione, completare il prerequisito seguente: Impostare il certificato SSL.

Casi d'uso per utility di migrazione

Di seguito sono riportati alcuni casi d'uso per la migrazione con la utility di migrazione.

Eseguire la migrazione degli utenti di Essbase da LDAP WebLogic nell'origine a OCI Identity and Access Management (IAM) o Oracle Identity Cloud Service (IDCS) nella destinazione.
Utilizzare la utility di migrazione per le distribuzioni di base non personalizzate. Se la distribuzione include personalizzazioni, ad esempio soluzioni Single Sign-On personalizzate, utilizzare l'interfaccia CLI anziché la utility di migrazione.
Quando la distribuzione di Essbase di origine proviene da
- Marketplace Essbase su Oracle Cloud Infrastructure, utilizzando OCI Identity and Access Management (IAM) o Oracle Identity Cloud Service (IDCS), oppure
- Marketplace Essbase su Oracle Cloud Infrastructure, utilizzando il protocollo LDAP incorporato
quindi, prima di utilizzare i passi della utility Migrazione riportati di seguito per l'esportazione, creare una nuova applicazione riservata come descritto in Crea un'applicazione di identità riservata. Inoltre, prima di utilizzare la utility di migrazione per importare, modificare i dettagli dell'host e di IAM o IDCS in import.properties per puntare all'istanza di Essbase di destinazione.

Passi per eseguire la migrazione delle applicazioni e degli utenti cloud mediante la utility di migrazione

Prima di utilizzare la utility di migrazione, se non lo si è già fatto, applicare la patch all'istanza di Essbase di origine alla versione più recente.
If it isn't already installed, download and install Java SE Development Kit (JDK) 8 from Oracle Technology Network.
Impostare la variabile di ambiente JAVA_HOME del sistema in modo che punti alla cartella di installazione del kit JDK. Se contiene spazi, racchiuderlo tra virgolette, ad esempio "C:\Program Files\Java\jdk1.8.0_171", nel valore di variabile.
Accedere all'interfaccia Web Essbase di destinazione e passare alla console.
Nella console andare a Strumenti desktop ed espandere Strumenti della riga di comando.
Fare clic su Scarica accanto a Utility di migrazione.
Scaricare il file zip della utility di migrazione in un'unità locale. Per risultati ottimali, scegliere un percorso che non contenga spazi, ad esempio C:\Oracle.
Estrarre il file zip e osservare i file estratti (properties, jar e readme) nella cartella migrationTools.

Prima di eseguire l'esportazione della utility di migrazione, modificare il file export.properties, che si trova nella stessa directory della utility. Fornire i dettagli dell'istanza di origine Essbase di cui si sta eseguendo la migrazione.

Esporta struttura	Descrizione
userName	Obbligatoria. Nome utente dell'amministratore Essbase.
password	Obbligatoria. Password amministratore Essbase.
host	Obbligatoria. Indirizzo IP del load balancer, se durante la distribuzione di Essbase è stato configurato un load balancer. In caso contrario, il nome host o l'indirizzo IP corrispondente all'indirizzo IP pubblico di Essbase.
port	Facoltativo. Porta di ascolto HTTP dell'istanza di Essbase di origine. Se l'istanza di origine è configurata in modalità sicura (TLS) e si presume che la porta `isTLS`=true 443 sia impostata. Se l'istanza di origine è configurata con il provider di identità LDAP, impostare la porta su 80.
isTLS	Facoltativo: true o false. Se true, l'istanza di origine viene configurata in modalità sicura (TLS) utilizzando il valore `port` specificato.
proxy	Facoltativo. Indirizzo host proxy HTTP, se la connessione all'istanza di Essbase di origine richiede un proxy. L'host proxy e la porta proxy sono separati da due punti. Se la porta proxy viene omessa, il suo valore viene assunto come 80. Esempio con porta omessa: `www-proxy-example.com`. Esempio con porta inclusa: `www-proxy-example.com:80`
ignora dati	Facoltativo. Il valore predefinito è false. Impostare su true se devono essere esportati solo gli schemi dell'applicazione Essbase.
Ignora utente	Facoltativo: vero o falso. Impostare su true solo se non è necessario esportare utenti e/o gruppi. Il valore predefinito è false.
IdcsHost	Obbligatorio solo quando si esegue la migrazione di utenti e/o gruppi da un'istanza distribuita su OCI tramite Marketplace. L'host del dominio di Identity dell'origine in IAM o IDCS. Dall'URL del dominio di Identity (ad esempio: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, estrarre solo la parte del dominio dopo la stringa. Esempio: `identity.oraclecloud.com`
idcsTenant	Obbligatorio solo per la migrazione di utenti e/o gruppi da un'istanza distribuita su OCI tramite Marketplace. Identificativo della tenancy del dominio di Identity dell'host di origine in IAM o IDCS. Dall'URL del dominio di Identity (ad esempio: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, estrarre solo `idcs-<string_of_numbers_and_letters>`).
ID cliente	Obbligatorio solo per la migrazione di utenti e/o gruppi da un'istanza distribuita su OCI tramite Marketplace. Identificativo client dell'host di origine per l'autorizzazione OAuth, trovato nell'applicazione di identità riservata integrata.
clientSecret	Obbligatorio solo per la migrazione di utenti e/o gruppi da un'istanza distribuita su OCI tramite Marketplace. Il segreto client dell'host di origine per l'autorizzazione OAuth, trovato nell'applicazione di identità riservata integrata.
ID applicazione	Obbligatorio solo per la migrazione di utenti e/o gruppi da un'istanza distribuita su OCI tramite Marketplace. Identificativo dell'applicazione di identità riservata integrata nel dominio di Identity OCI (IAM o IDCS). Questa applicazione identità deve essere configurata con ruoli applicazione concedibili a utenti e gruppi. Questa proprietà consente di concedere ruoli agli utenti e ai gruppi migrati.

Modificare il file import.properties, che si trova nella stessa directory della utility. Fornire i dettagli dell'istanza di destinazione Essbase di cui si sta eseguendo la migrazione.

Importa struttura	Descrizione
userName	Obbligatoria. Nome utente amministratore Essbase dell'istanza di destinazione.
password	Obbligatoria. Password amministratore Essbase dell'istanza di destinazione.
host	Obbligatoria. Indirizzo IP dell'istanza di destinazione del load balancer, se un load balancer è stato configurato durante la distribuzione di Essbase. In caso contrario, il nome host o l'indirizzo IP corrispondente all'indirizzo IP pubblico di Essbase.
port	Facoltativo. Porta di ascolto HTTP dell'istanza Essbase di destinazione. Se l'istanza di destinazione è configurata in modalità sicura (TLS) e si presume che la porta `isTLS`=true 443 sia impostata. Se l'istanza di origine è configurata con il provider di identità LDAP, impostare la porta su 80.
isTLS	Facoltativo: vero o falso. Se true, l'istanza di destinazione viene configurata in modalità sicura (TLS) utilizzando il valore `port` specificato.
userPassword	Facoltativo. Password iniziale da assegnare a qualsiasi nuovo utente di cui la utility esegue la migrazione all'applicazione di identità integrata in IAM o IDCS. Per modificare le password dopo la migrazione, utilizzare OCI Console.
proxy	Facoltativo. Indirizzo host proxy HTTP, se la connessione all'istanza di destinazione di Essbase richiede un proxy. L'host proxy e la porta proxy sono separati da due punti. Se la porta proxy viene omessa, il suo valore viene assunto come 80. Esempio con porta omessa: `www-proxy-example.com`. Esempio con porta inclusa: `www-proxy-example.com:80`
Ignora utente	Facoltativo: vero o falso. Impostare su true solo se non è necessario importare utenti e/o gruppi. Il valore predefinito è false.
IdcsHost	Obbligatorio solo per la migrazione di utenti e/o gruppi a un'istanza distribuita su OCI tramite Marketplace. Host del dominio di Identity di destinazione. Dall'URL del dominio di Identity (ad esempio: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, estrarre solo la parte del dominio dopo la stringa. Esempio: `identity.oraclecloud.com`
idcsTenant	Obbligatorio solo per la migrazione di utenti e/o gruppi a un'istanza distribuita su OCI tramite Marketplace. Identificativo della tenancy del dominio di Identity dell'host di destinazione. Dall'URL del dominio di Identity (ad esempio: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`, estrarre solo `idcs-<string_of_numbers_and_letters>`).
ID cliente	Obbligatorio solo per la migrazione di utenti e/o gruppi a un'istanza distribuita su OCI tramite Marketplace. Identificativo client dell'host di destinazione per l'autorizzazione OAuth, trovato nell'applicazione di identità riservata integrata.
clientSecret	Obbligatorio solo per la migrazione di utenti e/o gruppi a un'istanza distribuita su OCI tramite Marketplace. Segreto client dell'host di destinazione per l'autorizzazione OAuth, trovato nell'applicazione di identità riservata integrata.
ID applicazione	Obbligatorio solo per la migrazione di utenti e/o gruppi a un'istanza distribuita su OCI tramite Marketplace. Identificativo dell'applicazione di identità riservata integrata nel dominio di Identity OCI (IAM o IDCS). Questa applicazione identità deve essere configurata con ruoli applicazione concedibili a utenti e gruppi. Questa proprietà consente di concedere ruoli agli utenti e ai gruppi migrati.
overwrite	Facoltativo. Impostare su true se le applicazioni da importare esistono già nella destinazione e si desidera sovrascriverle. Il valore predefinito è false.
certificati	Facoltativo. Percorso completo di tutti i file del certificato sicuro per tutti i server TLS/SSL. Per Windows, l'escape si rovescia con un'altra barra rovesciata. Esempio: `C:\\migrationTools\\all_certs.pem`

Eseguire la utility di migrazione in Java con il comando di esportazione per esportare tutte le applicazioni, gli utenti e i gruppi dal catalogo delle istanze di origine Essbase in un file compresso.

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

Esempio:

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

Eseguire la utility di migrazione in Java con il comando di importazione per importare il file compresso nell'istanza di destinazione.
```
java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar import import.properties <existing_tar_file>
```
Al termine dell'importazione, i dati vengono migrati nel catalogo Essbase dell'istanza di destinazione.