cloneEnvironment

현재 환경을 복제하고 선택적으로 ID 도메인 아티팩트(사용자 및 사전 정의된 역할 지정), Data Management 레코드, 감사 레코드, 작업 콘솔 레코드, 인박스 및 아웃박스 콘텐츠, 저장된 스냅샷을 복제합니다. 이 명령은 마이그레이션의 환경 복제 기능 대신 사용할 수 있습니다.

Note:

  • Account Reconciliation: 복제하면 타겟 Account Reconciliation 애플리케이션 설정이 기본값으로 재설정됩니다. 타겟 애플리케이션 설정을 유지하려면 exportARApplicationProperties 명령을 사용하여 소스 환경에서 익스포트합니다. 그런 다음 복제가 완료된 후 importARApplicationProperties 명령을 사용하여 애플리케이션 등록정보를 타겟 환경으로 임포트합니다.
  • Data Management: 스테이지 테이블에 매우 많은 수의 레코드가 있는 경우 Data Management 레코드를 복제하는 데 시간이 오래 걸릴 수 있습니다. 마찬가지로, 인박스 및 아웃박스 콘텐츠와 저장된 스냅샷 복제도 많은 양의 데이터가 포함되어 있는 경우 특히 상당한 시간이 걸릴 수 있습니다.
  • 레거시 환경: 복제는 이 시나리오에서의 설명과 같이 현재 Oracle Essbase 버전을 유지합니다.
    • 시나리오 1: 하이브리드 큐브를 지원하지 않는 Essbase 버전을 사용하는 소스 레거시 환경을 하이브리드 큐브를 지원하는 Essbase 버전을 사용하는 타겟 레거시 환경에 복제하고 있습니다. 이 시나리오에서 타겟 환경의 Essbase는 소스 환경의 버전과 일치하도록 다운그레이드됩니다.
    • 시나리오 2: 하이브리드 큐브를 지원하는 Essbase 버전을 사용하는 소스 레거시 환경을 하이브리드 큐브를 지원하지 않는 Essbase 버전을 사용하는 타겟 레거시 환경에 복제하고 있습니다. 이 시나리오에서 타겟 환경의 Essbase는 소스 환경의 버전과 일치하도록 업그레이드됩니다.
    • 시나리오 3: 하이브리드 큐브를 지원하지 않는 Essbase 버전을 사용하는 소스 레거시 환경을 기본적으로 하이브리드 큐브를 지원하는 Essbase 버전을 사용하는 타겟 EPM Standard Cloud Service 또는 EPM Enterprise Cloud Service 환경에 복제하고 있습니다. 이 시나리오에서 타겟 환경의 Essbase는 소스 환경의 버전과 일치하도록 다운그레이드되지 않습니다.
  • Planning: Planning 비즈니스 프로세스에 사용자정의 기간 멤버로 대체된 이름이 변경된 시드된 기간 멤버가 포함된 경우 복제가 실패할 수 있습니다. 예를 들어, 시드된 YearTotal 기간 멤버를 unused_YearTotal로 이름을 변경한 다음 대체 유형 기간 멤버를 원래 시드된 멤버 이름(이 예에서 YearTotal)로 추가했습니다. 이 시나리오에서는 환경 복제가 실패할 수 있습니다.
  • 이 명령을 실행할 때: 소스 및 타겟 환경의 스케줄링된 일별 유지관리 이후에 이 명령을 실행합니다.

    복제 프로세스가 실행 중인 동안에는 소스 및 타겟 환경의 일별 유지관리를 모두 시작할 수 없습니다. 일별 유지관리는 복제 프로세스가 종료되거나 36시간이 지나서 종료된 후 다음 스케줄링된 시간에 실행됩니다.

소스 환경의 스냅샷이 생성되는 동안(예: 일별 유지관리 중) 이 명령을 실행하는 경우 파일을 찾을 수 없습니다 오류가 표시됩니다.

이러한 항목에 대한 자세한 내용은 Oracle Enterprise Performance Management Cloud용 마이그레이션 관리 에서 EPM Cloud 환경 복제를 참조하십시오.

적용 대상

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 및 Strategic Workforce Planning.

필수 역할

서비스 관리자

사용자 및 사전 정의된 역할을 복제하려면 ID 도메인 관리자 역할이 있어야 합니다.

사용법

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], 설명:

Note:

  • dataManagement 매개변수는 Oracle Enterprise Data Management Cloud 및 Narrative Reporting 환경에 적용되지 않습니다.

    데이터 관리 레코드는 소스 환경과 타겟 환경 둘 다 월별 업데이트 버전이 동일하거나 타겟 환경이 소스 환경보다 업데이트 버전이 하나 더 최신인 경우에만 복제합니다. 예를 들어 22.01 Data Management 레코드는 다른 22.01 환경 또는 22.02 환경에만 복제할 수 있습니다.

  • jobConsole 매개변수는 Planning, Planning 모듈, 무형식, Financial Consolidation and Close, Tax Reporting, Enterprise Profitability and Cost Management, Sales Planning, 전략적 Workforce Planning에만 적용됩니다.
  • appAudit 매개변수는 Planning, Planning 모듈, 무형식, Enterprise Profitability and Cost Management, Sales Planning, 전략적 Workforce Planning에만 적용됩니다.

    Financial Consolidation and Close 및 Tax Reporting에 대한 감사 정보는 기본적으로 스냅샷에 포함되어 있습니다.

  • dataManagement, jobConsole 또는 appAudit 매개변수를 환경에 적용할 수 없는 경우 EPM Automate는 지정된 값을 무시합니다.
  • TARGET_USERNAME은 타겟 환경의 서비스 관리자 ID입니다. 타겟 ID 도메인 사용자 이름(SSO 사용자 이름이 아님)을 사용해야 합니다. 타겟 환경에서 사용자 및 역할 지정을 복제하려면 이 사용자에게 ID 도메인 관리자 역할도 있어야 합니다.
  • TARGET_PASSWORD는 TARGET_USERNAME 에서 확인된 사용자의 암호화된 비밀번호 파일 위치입니다.
  • TARGET_URL은 복제된 환경이 될 환경의 URL입니다.
  • SnapshotName은 선택사항으로, 복제에 사용해야 하는 스냅샷의 이름입니다. 이 스냅샷은 소스 환경에 있어야 합니다. 기본값은 Artifact Snapshot이며, 최종 유지관리 스냅샷을 사용하여 환경을 복제합니다.
  • UsersAndPreDefinedRoles는 선택사항으로, 사용자 및 사전 정의된 역할 지정을 복제할지 여부를 나타냅니다(액세스 제어 그룹은 항상 복제됨). 기본값은 false입니다.

    이 옵션을 사용하려면 TARGET_USER_NAME으로 확인된 사용자에게 타겟 환경에서 ID 도메인 관리자 역할이 있어야 합니다.

    이 확인란을 선택한 다음 ID 도메인 관리자가 아닌 사용자가 환경을 복제하는 경우 사용자 및 사전 정의된 역할 임포트가 실패합니다. 마이그레이션 상태 보고서에 다음 오류가 기록됨: 외부 디렉토리 아티팩트 <artifact_name> 임포트 실패. <user_name> 사용자는 이 작업을 수행할 수 있는 권한이 없습니다. 이 작업을 수행하려면 사용자에게 ID 도메인 관리자 역할이 있어야 합니다.
    • 사용자를 임포트하지 않고 소스 스냅샷의 사용자가 타겟 환경의 사전 정의된 역할에 지정되지 않은 경우 오류(EPMIE-00070: 지정된 역할 임포트 중 사용자를 찾지 못했습니다.)가 표시됩니다.
    • ID 도메인 관리자 역할 지정은 복제되지 않습니다. ID 도메인 관리자 역할만 지정된 사용자는 타겟 환경으로 복제되지 않습니다.

      소스 환경에서 ID 도메인 관리자 역할 및 사전 정의된 역할 조합에 지정된 사용자는 복제되지만 타겟 환경의 해당 사전 정의된 역할에만 지정됩니다. 이러한 사용자는 타겟 환경에서 ID 도메인 관리자 역할에 지정되지 않습니다.

    • 사용자의 사전 정의된 역할 변경사항은 소스 스냅샷에서 지정된 역할에 따라 업데이트됩니다. 그러나 타겟의 역할 지정이 소스 스냅샷의 역할 지정과 일치하도록 제거되지는 않습니다. 예를 들어 jdoe가 타겟 환경에서는 고급 사용자 사전 정의된 역할에 지정되었지만 소스 스냅샷에서는 사용자 역할만 있다고 가정합니다. 이런 상황에서 이 명령은 사용자 역할에 jdoe를 지정하고 타겟 환경의 고급 사용자 역할 지정을 제거하지 않습니다.
    • 이 명령은 소스 스냅샷에 없는 경우에도 타겟 환경의 기존 사용자를 삭제하지 않습니다. 예를 들어 jdoe는 타겟 환경에 계정이 있지만 소스 스냅샷에는 이 계정이 없습니다. 이런 상황에서 타겟 환경의 jdoe 계정은 삭제되지 않습니다.
    • 이 명령은 타겟 환경에 없는 사용자를 추가합니다. 소스 스냅샷과 다른 경우에도 타겟 환경의 현재 사용자 등록정보를 업데이트하지 않습니다. 예를 들어 소스 스냅샷에 있는 jdoe의 성 철자가 타겟 환경과 다른 경우에도 타겟 환경에서 변경되지 않습니다. 타겟 환경의 새 사용자에게 무작위 비밀번호가 지정됩니다. 새 사용자는 비밀번호를 변경하도록 요청하는 계정 활성화 전자메일을 받게 됩니다.
    • 이 명령은 소스 스냅샷과 다른 경우에도 타겟 환경의 기존 사용자 비밀번호를 변경하지 않습니다.
  • dataManagement=true|false는 선택사항으로, 소스 환경의 Data Management 레코드를 타겟 환경으로 복제합니다. 기본값은 true이며, Data Management 레코드를 복제합니다. Data Management 레코드를 복제하지 않으려면 이 값을 false로 설정하십시오.
  • appAudit=true|false는 선택사항으로, 소스 환경의 감사 레코드를 타겟 환경으로 복제합니다. 기본값은 true이며, 애플리케이션 감사 데이터를 복제합니다. 애플리케이션 감사 데이터를 타겟 환경에 복제하지 않으려면 이 값을 false로 설정하십시오.
  • jobConsole=true|false는 선택사항으로, 소스 환경의 작업 콘솔 레코드를 타겟 환경으로 복제합니다. 기본값은 true입니다. 작업 콘솔 레코드를 복제하지 않으려면 이 값을 false로 설정하십시오.
  • storedSnapshotsAndFiles는 선택사항으로, 이 명령에서 인박스 및 아웃박스 콘텐츠와 저장된 스냅샷을 복제하는지 여부를 나타냅니다. 기본값은 false입니다.

    Note:

    인박스 및 아웃박스의 최상위 폴더만 복제되며 하위 폴더는 복제되지 않습니다. 하위 폴더의 콘텐츠를 유지해야 하는 경우 로컬 컴퓨터에 백업한 다음 타겟 환경에 업로드합니다.
  • DailyMaintenanceStartTime은 선택사항으로, 복제된 타겟 환경의 유지관리 시작 시간을 소스 환경의 해당 시간으로 재설정합니다. 기본값은 true입니다. 타겟 환경의 현재 유지관리 시작 시간을 유지하려면 이 값을 false로 설정하십시오.

예

  • 환경, 사용자 및 사전 정의된 역할 지정, 감사 데이터, 작업 콘솔 레코드, Data Management 레코드를 복제합니다. 또한, 타겟 환경의 유지관리 시작 시간을 소스 환경의 해당 시간으로 변경합니다.

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

  • 타겟 환경의 유지관리 시작 시간을 변경하지 않고 인박스 및 아웃박스 콘텐츠, 저장된 스냅샷은 포함되지만 사용자 및 사전 정의된 역할 지정, Data Management 레코드, 감사 데이터, 작업 콘솔 레코드는 포함되지 않은 환경을 복제합니다.

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

  • 사용자정의 스냅샷을 사용하여 전체 환경(사용자 및 사전 정의된 역할 지정, 감사 데이터, 작업 콘솔 레코드, 인박스 및 아웃박스 콘텐츠, 저장된 스냅샷, Data Management 레코드)을 복제합니다. 또한, 타겟 환경의 유지관리 시작 시간을 소스 환경의 해당 시간으로 변경합니다.

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