cloneEnvironment

Clona l'ambiente corrente e, facoltativamente, gli artifact del dominio di Identity (utenti e assegnazioni di ruoli predefiniti), i record di Data Management, i record di audit, i record della console job, il contenuto delle cartelle inbox e outbox e gli snapshot memorizzati. Questo comando rappresenta un'alternativa all'utilizzo della funzione Clona ambiente in Migrazione.

Note:

  • Account Reconciliation: dopo la clonazione, le impostazioni dell'applicazione Account Reconciliation target verranno ripristinate ai valori predefiniti. Se desideri conservare le impostazioni dell'applicazione target, esportale dall'ambiente di origine utilizzando il comando exportARApplicationProperties . Quindi, al termine della clonazione, importare le proprietà dell'applicazione nell'ambiente target utilizzando il comando importARApplicationProperties .
  • Data Management: se le tabelle intermedie includono un numero elevato di record, la clonazione dei record di Data Management può richiedere tempo. Analogamente, anche la clonazione del contenuto delle cartelle inbox e outbox e degli snapshot memorizzati può richiedere molto tempo, soprattutto se contengono una quantità elevata di dati.
  • Ambienti precedenti: la clonazione mantiene la versione Oracle Essbase corrente come illustrato negli scenari descritti di seguito.
    • Scenario 1: si sta clonando un ambiente precedente di origine in cui viene utilizzata una versione di Essbase che non supporta i cubi ibridi verso un ambiente precedente target in cui viene utilizzata una versione di Essbase che li supporta. In questo scenario, viene eseguito il downgrade della versione di Essbase nell'ambiente target in modo che corrisponda alla versione nell'ambiente di origine.
    • Scenario 2: si sta clonando un ambiente precedente di origine in cui viene utilizzata una versione di Essbase che supporta i cubi ibridi verso un ambiente precedente target in cui viene utilizzata una versione di Essbase che non li supporta. In questo scenario, viene eseguito l'upgrade della versione di Essbase nell'ambiente target in modo che corrisponda alla versione nell'ambiente di origine.
    • Scenario 3: si sta clonando un ambiente precedente di origine in cui viene utilizzata una versione di Essbase che non supporta i cubi ibridi verso un ambiente EPM Standard Cloud Service o EPM Enterprise Cloud Service target in cui, per impostazione predefinita, viene utilizzata una versione di Essbase che li supporta. In questo scenario, non viene eseguito il downgrade della versione di Essbase nell'ambiente target in modo che corrisponda alla versione nell'ambiente di origine.
  • Planning: la clonazione potrebbe non riuscire se il processo aziendale di Planning contiene un membro periodo generato ridenominato che è stato sostituito da un membro periodo customizzato. Ad esempio, si è rinominato il membro periodo YearTotal generato in unused_YearTotal e quindi è stato aggiunto un membro periodo di tipo alternativo con il nome del membro originale (YearTotal in questo esempio). In questo scenario, la clonazione dell'ambiente potrebbe non riuscire.
  • Quando eseguire questo comando: dopo la manutenzione giornaliera pianificata degli ambienti di origine e target.

    L'avvio della manutenzione giornaliera degli ambienti di origine e target non può avvenire durante il processo di clonazione. Viene eseguita all'ora programmata successiva dopo che il processo di clonazione termina o viene interrotto dopo 36 ore.

Se questo comando viene eseguito mentre viene generato lo snapshot dell'ambiente di origine, durante la manutenzione giornaliera ad esempio verrà visualizzato l'errore File not found.

Per informazioni dettagliate su questi argomenti, fare riferimento alla sezione Clonazione degli ambienti di EPM Cloud nella Guida Administering Migration for Oracle Enterprise Performance Management Cloud (in lingua inglese).

Si applica a

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Oracle Enterprise Data Management Cloud, Narrative Reporting, Sales Planning e Strategic Workforce Planning.

Ruoli necessari

Amministratore servizi

Il ruolo amministratore del dominio di Identity è necessario per clonare gli utenti e i ruoli predefiniti.

Utilizzo

epmAutomate cloneEnvironment TARGET_USERNAME TARGET_PASSWORD TARGET_URL [SnapshotName=NAME] [UsersAndPreDefinedRoles=true|false] [DataManagement=true|false] [appAudit=true|false] [jobConsole=true|false] [storedSnapshotsAndFiles=true|false] [DailyMaintenanceStartTime=true|false]. I parametri sono descritti di seguito.

Note:

  • Il parametro dataManagement non si applica agli ambienti Oracle Enterprise Data Management Cloud e Narrative Reporting.

    Clonare record di Data Management solo se gli ambienti di origine e target sono entrambi inclusi nello stesso aggiornamento mensile o se l'ambiente target ha un solo livello di aggiornamento in più rispetto all'ambiente di origine. I record di Data Management di un ambiente 22.01 ad esempio possono essere clonati solo in un altro ambiente 22.01 o in un ambiente 22.02.

  • Il parametro jobConsole si applica solo a Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Enterprise Profitability and Cost Management, Sales Planning e Strategic Workforce Planning.
  • Il parametro appAudit si applica solo a Planning, Planning Modules, FreeForm, Enterprise Profitability and Cost Management, Sales Planning e Strategic Workforce Planning.

    Le informazioni di audit per Financial Consolidation and Close e Tax Reporting sono incluse nello snapshot per impostazione predefinita.

  • Se il parametro dataManagement, jobConsole o appAudit non è applicabile a un ambiente, EPM Automate ignora il valore specificato.
  • TARGET_USERNAME indica l'ID di un amministratore servizi nell'ambiente target. È necessario utilizzare il nome utente del dominio di Identity target, non il nome utente SSO. Se si prevede di clonare le assegnazioni di utenti e ruoli nell'ambiente target, è necessario che questo utente disponga anche del ruolo Amministratore del dominio di Identity.
  • TARGET_PASSWORD indica la posizione del password file cifrato dell'utente identificato da TARGET_USERNAME.
  • TARGET_URL indica l'URL dell'ambiente che diventerà l'ambiente clonato.
  • SnapshotName (facoltativo) indica il nome di uno snapshot da utilizzare per la clonazione. Lo snapshot deve essere presente nell'ambiente di origine. Il valore predefinito è Artifact Snapshot, che utilizza lo snapshot della manutenzione più recente per clonare l'ambiente.
  • UsersAndPreDefinedRoles (facoltativo) indica se clonare gli utenti e le relative assegnazioni di ruoli predefiniti (i gruppi Controllo accesso vengono sempre clonati). Il valore predefinito è false.

    Per il funzionamento di questa opzione, è necessario che l'utente identificato da TARGET_USER_NAME disponga del ruolo di amministratore del dominio di Identity nell'ambiente target.

    Se un utente che non è amministratore del dominio di Identity clona un ambiente dopo aver selezionato questa casella di controllo, l'importazione degli utenti e dei loro ruoli predefiniti non riuscirà. Nel report sullo stato della migrazione viene registrato il seguente errore: Impossibile importare l'artifact di directory esterna <artifact_name>. L'utente <user_name> non è autorizzato a eseguire questa operazione. L'utente deve disporre del ruolo Amministratore del dominio di Identity per poter eseguire questa operazione.
    • Se non si stanno importando utenti e un utente nello snapshot di origine non è assegnato a un ruolo predefinito nell'ambiente target, viene visualizzato un errore (EPMIE-00070: Impossibile trovare il membro utente durante l'importazione dei ruoli assegnati).
    • L'assegnazione del ruolo amministratore del dominio di Identity non viene clonata. Gli utenti che dispongono solo dell'assegnazione del ruolo amministratore del dominio di Identity non vengono clonati nell'ambiente target.

      Gli utenti assegnati al ruolo amministratore del dominio di Identity combinato con ruoli predefiniti nell'ambiente di origine vengono clonati, ma vengono assegnati solo ai rispettivi ruoli predefiniti nell'ambiente target. Questi utenti non disporranno del ruolo amministratore del dominio di Identity nell'ambiente target.

    • Le modifiche apportate ai ruoli predefiniti dell'utente verranno aggiornate in base ai ruoli assegnati nello snapshot di origine. Le assegnazioni dei ruoli nel target tuttavia non verranno rimosse per garantire la corrispondenza con quelle nello snapshot di origine. Si supponga ad esempio che l'utente jdoe sia assegnato al ruolo predefinito Utente avanzato nell'ambiente target, ma che disponga solo del ruolo Utente nello snapshot di origine. In questo caso, questo comando assegna jdoe al ruolo Utente e non rimuove l'assegnazione del ruolo Utente avanzato nell'ambiente target.
    • Questo comando non elimina gli utenti esistenti dall'ambiente target se non sono presenti nello snapshot di origine. Si supponga ad esempio che jdoe disponga di un account nell'ambiente target, ma che questo account non sia presente nello snapshot di origine. In questo caso, l'account di jdoe nell'ambiente target non viene eliminato.
    • Questo comando aggiunge utenti non presenti nell'ambiente target. Non aggiorna le proprietà degli utenti correnti nell'ambiente target anche se sono diverse nello snapshot di origine. Se ad esempio il cognome di jdoe nello snapshot di origine è scritto in modo diverso rispetto all'ambiente target, non verranno apportate modifiche nell'ambiente target. Ai nuovi utenti nell'ambiente target viene assegnata una password casuale. I nuovi utenti riceveranno e-mail di attivazione degli account in cui verrà richiesto di cambiare le password.
    • Questo comando non cambia le password degli utenti esistenti nell'ambiente target anche se sono diverse nello snapshot di origine.
  • dataManagement=true|false (facoltativo) clona i record di Data Management dall'ambiente di origine all'ambiente target. Il valore predefinito è true, che clona i record di Data Management. Impostare questo valore su false se non si desidera clonare i record di Data Management.
  • appAudit=true|false(facoltativo) clona i record di audit dall'ambiente di origine all'ambiente target. Il valore predefinito è true, che clona i valori di audit dell'applicazione. Impostare questo valore su false se non si desidera clonare i dati di audit dell'applicazione nell'ambiente target.
  • jobConsole=true|false(facoltativo) clona i record della console job dall'ambiente di origine all'ambiente target. Il valore predefinito è true. Impostare questo valore su false se non si desidera clonare i record della console job.
  • storedSnapshotsAndFiles, (facoltativo) indica se il comando deve clonare il contenuto delle cartelle inbox e outbox e gli snapshot memorizzati. Il valore predefinito è false.

    Note:

    Vengono clonate solo le cartelle di livello superiore della posta in entrata e in uscita, non le sottocartelle. Se è necessario conservare il contenuto delle sottocartelle, eseguirne il backup su un computer locale e quindi caricarle nell'ambiente target.
  • DailyMaintenanceStartTime(facoltativo) reimposta l'ora di inizio della manutenzione dell'ambiente target clonato su quella dell'ambiente di origine. Il valore predefinito è true. Per mantenere l'ora di inizio corrente della manutenzione dell'ambiente target, impostare questo valore su false.

Esempi

  • Clonazione dell'ambiente, degli utenti con relative assegnazioni di ruoli predefiniti, dei dati di audit, dei record della console job e dei record di Data Management. Impostazione inoltre dell'ora di inizio della manutenzione dell'ambiente target su quella dell'ambiente di origine:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com UsersAndPreDefinedRoles=true

  • Clonazione dell'ambiente, inclusi il contenuto delle cartelle inbox e outbox e gli snapshot memorizzati, ma non gli utenti e le assegnazioni di ruoli predefiniti, i record di Data Management, i dati di audit e i record della console job, senza modificare l'ora di inizio della manutenzione dell'ambiente target:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com DataManagement=false appAudit=false jobConsole=false storedSnapshotsAndFiles=true DailyMaintenanceStartTime=false

  • Clonazione dell'intero ambiente (utenti e assegnazioni di ruoli predefiniti, dati di audit, record della console job, contenuto delle cartelle inbox e outbox, snapshot memorizzati e record di Data Management) utilizzando uno snapshot customizzato. Impostazione inoltre dell'ora di inizio della manutenzione dell'ambiente target su quella dell'ambiente di origine:

    epmAutomate cloneEnvironment serviceAdmin Password.epw https://test-cloudpln.pbcs.us1.oraclecloud.com UsersAndPreDefinedRoles=true storedSnapshotsAndFiles=true SnapshotName=SampleSnapshot