마이그레이션 정의 작업

마이그레이션 정의 생성

마이그레이션할 아티팩트는 마이그레이션 정의에 정의해야 합니다. 마이그레이션 정의에 대한 다음 사항에 유의하십시오.

익스포트 또는 임포트 작업을 수행하는 경우 Oracle Hyperion Shared Services Console에서 마이그레이션 정의가 생성됩니다.
아티팩트를 익스포트하는 경우 Oracle Hyperion Enterprise Performance Management System Lifecycle Management는 익스포트와 임포트에 대해 각각 하나씩, 두 개의 XML 파일을 생성합니다. 이러한 XML 파일을 Lifecycle Management 유틸리티의 마이그레이션 정의 파일에 사용할 수 있습니다.
익스포트 작업을 수행하는 경우 익스포트와 해당 임포트에 대한 MDF 파일이 루트 폴더 아래의 File System 폴더에 자동으로 생성됩니다.

마이그레이션 정의 파일 XML 스키마

다음 그림에는 마이그레이션 정의의 XML 스키마 아웃라인이 설명되어 있습니다.

그림 7-2 마이그레이션 정의 파일의 XML 스키마 아웃라인

마이그레이션 정의 파일 요소

이 절에서는 마이그레이션 정의 파일의 XML 스키마에 사용되는 요소와 속성을 설명합니다.

로케일

마이그레이션 정의 파일이 생성될 때 서버 로케일을 정의합니다. 모든 오류 메시지와 콘솔 메시지가 이 로케일로 포함되어 있습니다.

사용자 및 비밀번호

마이그레이션 정의 파일을 실행할 사용자의 사용자 이름과 암호화된 비밀번호를 정의합니다.

태스크

마이그레이션 시 완료할 태스크를 정의합니다. 마이그레이션 정의 파일에 정의되는 태스크는 소스, 대상 및 마이그레이션할 아티팩트에 따라 달라집니다. 최소한 각 태스크에는 소스, 대상 및 아티팩트 태그가 포함됩니다.

소스와 대상이 여럿인 경우 소스/대상 조합별로 태스크(task)을 하나 이상 정의해야 합니다. 예를 들어, 파일 시스템에 아티팩트를 추출하는 태스크는 task 1로 정의되고, 파일 시스템에서 애플리케이션으로 아티팩트를 로드하는 태스크는 task 2로 정의됩니다.

주:

기본적으로 유틸리티는 실패한 태스크 후에 계속해서 다음 태스크를 수행합니다. 태스크 소스 및 대상 연결에 대한 검증은 태스크가 실행될 때만 수행되고 태스크 실행을 시작하기 전에는 수행되지 않습니다.

태스크에는 다음 요소가 포함됩니다.

소스

마이그레이션의 소스를 정의합니다. 태스크별로 소스와 대상을 하나씩 정의해야 합니다.

표 7-1 소스 속성

속성	설명
`application`	애플리케이션 등록 시 사용하는 이름입니다. 애플리케이션 이름은 Shared Services Console에 표시됩니다. 예: `HPAPP1`
`filePath`	파일 시스템에서 아티팩트가 저장되는 디렉토리입니다. 예: `filePath="/Essbase.Sample.Basic"` 참고: MDF 파일이 UI에서 생성될 경우 경로는 작업 폴더의 상대 경로입니다. MDF 파일이 작업 폴더에 없는 경우 `-b` 명령행 인수를 통해 파일 시스템 경로가 설정된 위치와 상대적인 기준 경로를 사용합니다.
`product`	Shared Services에 등록되는 애플리케이션의 제품 코드입니다. 예: `HUB`(Oracle Hyperion Shared Services) `CALC`(Oracle Hyperion Calculation Manager) `ESBAPP`(Oracle Essbase) `BPM`(Oracle Essbase Studio) `AIF`(Oracle Hyperion Financial Data Quality Management, Enterprise Edition) `HFM`(Oracle Hyperion Financial Management) `FCC`(Oracle Hyperion Financial Close Management) `HP`(Oracle Hyperion Planning) `HPM`(Oracle Hyperion Profitability and Cost Management)
`project`	애플리케이션이 속한 Shared Services 애플리케이션 그룹의 이름입니다. 프로젝트 이름은 Shared Services Console에 표시됩니다. 예: `DevPlan_Proj`
`type`	연결 유형: 파일 시스템 연결의 경우 `FileSystem` Shared Services로 등록된 애플리케이션 연결의 경우 `Application`

타겟

마이그레이션의 대상을 정의합니다. 태스크별로 대상을 하나씩 정의해야 합니다.

표 7-2 타겟 속성

속성	설명
`application`	애플리케이션 등록 시 사용하는 이름입니다. 애플리케이션 이름은 Shared Services Console에 표시됩니다. 예: `HPAPP1`
`filePath`	파일 시스템에서 아티팩트가 저장되는 디렉토리입니다. 예: `filePath="/Essbase.Sample.Basic"` 참고: MDF 파일이 UI에서 생성될 경우 경로는 작업 폴더의 상대 경로입니다. .MDF 파일이 작업 폴더에 없는 경우 `-b` 명령행 인수를 통해 파일 시스템 경로가 설정된 위치와 상대적인 기준 경로를 사용합니다.
`product`	Shared Services에 등록되는 애플리케이션의 제품 코드입니다. 예: `HUB`(Shared Services) `ESBAPP`(Essbase) `HFM`(Financial Management) `HP`(Planning) `CALC`(Calculation Manager) `HPM`(Profitability and Cost Management)
`project`	애플리케이션이 속한 Shared Services 애플리케이션 그룹의 이름입니다. 프로젝트 이름은 Shared Services Console에 표시됩니다. 예: `DevHP_Proj`

아티팩트

현재 마이그레이션에 사용되는 필터입니다.

표 7-3 아티팩트 속성

속성 설명

속성	설명
`parentPath`	마이그레이션의 아티팩트 또는 데이터가 저장되는 최상위 디렉토리입니다. 제품 디렉토리 구조에 대한 자세한 내용은 이 가이드의 마지막에 있는 부록을 참조하십시오. 예: `/Data Analysis & Report Creation` 주의: 상위 경로 디렉토리에 앰퍼샌드(&) 문자가 포함된 경우 마이그레이션 정의 파일에서 `"&"`로 바꿉니다(아래 예 참조). 참고: `recursive="true"`인 경우 이 디렉토리의 하위 디렉토리에 들어 있는 모든 아티팩트를 가져옵니다. `pattern` 속성은 모든 제품에 필수입니다.
`pattern`	아티팩트 선택 기준입니다. 가져올 아티팩트의 이름을 지정하거나 (별표)를 사용하여 필터 조건에 맞는 모든 아티팩트를 가져옵니다. 예: 참고: `pattern` 속성은 모든 제품에 필수입니다.
`recursive`	하위 디렉토리에 저장된 아티팩트에 마이그레이션을 수행해야 하는지 여부입니다. 예: `true` 참고: `recursive` 속성은 선택사항입니다.

parentPath

마이그레이션의 아티팩트 또는 데이터가 저장되는 최상위 디렉토리입니다. 제품 디렉토리 구조에 대한 자세한 내용은 이 가이드의 마지막에 있는 부록을 참조하십시오.

예: /Data Analysis & Report Creation

주의: 상위 경로 디렉토리에 앰퍼샌드(&) 문자가 포함된 경우 마이그레이션 정의 파일에서 "&"로 바꿉니다(아래 예 참조).

참고:

recursive="true"인 경우 이 디렉토리의 하위 디렉토리에 들어 있는 모든 아티팩트를 가져옵니다.

pattern 속성은 모든 제품에 필수입니다.

pattern

아티팩트 선택 기준입니다.

가져올 아티팩트의 이름을 지정하거나 *(별표)를 사용하여 필터 조건에 맞는 모든 아티팩트를 가져옵니다.

예: *

참고: pattern 속성은 모든 제품에 필수입니다.

recursive

하위 디렉토리에 저장된 아티팩트에 마이그레이션을 수행해야 하는지 여부입니다.

예: true

참고: recursive 속성은 선택사항입니다.

옵션

옵션은 제품마다 다릅니다. 설정할 수 있는 임포트/익스포트 옵션에 대해서는 이 가이드의 마지막에 있는 부록을 참조하십시오. 소스 또는 대상은 이러한 옵션을 해석하여 마이그레이션할 아티팩트를 이해합니다.

옵션을 설정하지 않으면 Oracle Hyperion Shared Services Registry에 설정된 기본 옵션이 사용됩니다.

표 7-4 옵션 속성

속성	설명
`option`	Shared Services Registry에 정의된 옵션 이름을 재정의하는 데 사용되는 이름입니다. 예: `ExportJobOutput`
`value`	Shared Services Registry에 정의된 옵션 값을 재정의하는 데 사용되는 값입니다. 예: `true`

샘플 마이그레이션 정의 파일

다음은 샘플 마이그레이션 정의 파일입니다. 구조나 구문을 변경하면 마이그레이션 중에 오류가 발생합니다.

<?xml version="1.0" encoding="UTF-8"?>
<Package>
<LOCALE>en_US</LOCALE>
<User name="admin" password=""/>
   <Task>
      <Source type="Application" product="HUB" project="Foundation" application="Shared Services"/>
      <Target type="FileSystem" filePath="/folder/HUB.Shared Services" />
      <Options option="GroupFilter" Value= "*" />
      <Artifact recursive="true" parentPath="/Native Directory" pattern="*"/>
      <Artifact recursive="true" parentPath="/Taskflows" pattern="*"/>
   </Task>
   <Task>
      <Source type="FileSystem" filePath="/folder/HUB.Shared Services" />
      <Target type="Application" product="HUB" project="Foundation" application="Shared Services" />
      <Artifact recursive="true" parentPath="/Native Directory" pattern="*"/>
      <Artifact recursive="true" parentPath="/Taskflows" pattern="*"/>
           </Task>
</Package>