이전 유틸리티를 사용하여 애플리케이션 이전

Essbase 서비스 관리자는 이전 유틸리티(migrationTools.jar)를 사용하여 단일 프로세스를 위해 클라우드 인스턴스 간 전체 Essbase 인스턴스(모든 애플리케이션, 사용자/그룹 및 기타 아티팩트)를 이전할 수 있습니다.

마이그레이션 유틸리티를 사용하여 마켓플레이스를 통해 OCI의 Essbase 배포에서 소스 애플리케이션 및 요소를 마이그레이션할 수 있습니다. 이 유틸리티는 여러 응용 프로그램을 한 번에 마이그레이션합니다. 또한 아티팩트, 규칙, 사용자 및 그룹을 마이그레이션합니다.

Essbase CLI(명령행 인터페이스) 명령인 lcmimport 및 lcmexport는 사용자와 그룹을 마이그레이션하지 않습니다.

마이그레이션 유틸리티를 사용하기 전에 SSL 인증서 설정 필수 조건을 완료하십시오.

마이그레이션 유틸리티 사용 사례

마이그레이션 유틸리티를 사용하여 마이그레이션하는 몇 가지 사용 사례는 다음과 같습니다.

소스의 WebLogic LDAP에서 대상의 OCI ID 및 액세스 관리(IAM) 또는 Oracle Identity Cloud Service(IDCS)로 Essbase 사용자를 마이그레이션합니다.
사용자정의되지 않은 기본 배치에 마이그레이션 유틸리티를 사용합니다. 배포에 사용자정의(예: 사용자정의 Single Sign-On 솔루션)가 포함된 경우 마이그레이션 유틸리티 대신 CLI를 사용하십시오.
소스 Essbase 배포의 출처
- OCI Identity and Access Management(IAM) 또는 Oracle Identity Cloud Service(IDCS)를 사용하는 Oracle Cloud Infrastructure의 Essbase 마켓플레이스
- 내장된 LDAP을 사용하는 Oracle Cloud Infrastructure의 Essbase 마켓플레이스
다음 이전 유틸리티 단계를 사용하여 익스포트하기 전에 먼저 기밀 ID 애플리케이션 생성에 설명된 대로 새 기밀 애플리케이션을 생성하십시오. 또한 마이그레이션 유틸리티를 사용하여 임포트하기 전에 import.properties에서 호스트 및 IAM 또는 IDCS 세부정보를 대상 Essbase 인스턴스를 가리키도록 변경합니다.

마이그레이션 유틸리티를 사용하여 클라우드 애플리케이션 및 사용자를 마이그레이션하는 단계

마이그레이션 유틸리티를 사용하기 전에 아직 패치하지 않은 경우 소스 Essbase 인스턴스를 최신 버전으로 패치합니다.
설치되어있지 않은 경우 Oracle Technology Network에서 JDK(Java SE Development Kit) 8을 다운로드하고 설치합니다.
시스템의 JAVA_HOME 환경 변수 이름이 JDK 설치 폴더를 가리키도록 설정합니다. 설치 경로에 공백이 있는 경우 변수 값의 경로를 따옴표로 묶습니다(예: "C:\Program Files\Java\jdk1.8.0_171").
대상 Essbase 웹 인터페이스에 사인인하고 콘솔로 이동합니다.
콘솔에서 데스크톱 툴로 이동하여 명령행 툴을 확장합니다.
마이그레이션 유틸리티 옆에 있는 다운로드를 누릅니다.
마이그레이션 유틸리티 zip 파일을 로컬 드라이브로 다운로드합니다. 최적의 결과를 위해서는 공백이 없는 경로(예: C:\Oracle)을 선택합니다.
zip 파일의 압축을 풉니다. migrationTools 폴더에 추출된 파일(properties, jar, readme)이 나타납니다.

Migration Utility 익스포트를 실행하기 전에 유틸리티와 동일한 디렉토리에 있는 export.properties 파일을 편집합니다. 마이그레이션하려는 Essbase 소스 인스턴스의 세부정보를 제공합니다.

속성 내보내기	설명
사용자 이름	필수입니다. Essbase 관리자 사용자 이름입니다.
비밀번호	필수입니다. Essbase 관리자 비밀번호입니다.
호스트	필수입니다. 로드 밸런서가 Essbase 배포 중에 구성된 경우 로드 밸런서의 IP 주소입니다. 그렇지 않은 경우 Essbase 공용 IP 주소에 해당하는 호스트 이름 또는 IP 주소입니다.
port	선택사항. 소스 Essbase 인스턴스의 HTTP 수신 포트입니다. 소스 인스턴스가 보안(TLS) 모드로 구성되고 `isTLS`=true 포트 443으로 간주되는 경우 소스 인스턴스가 LDAP ID 제공자로 구성된 경우 포트를 80으로 설정합니다.
사이트맵	선택 사항: true 또는 false. true인 경우 소스 인스턴스는 지정된 `port` 값을 사용하여 보안(TLS) 모드로 구성됩니다.
proxy	선택사항. 소스 Essbase 인스턴스에 대한 접속에 프록시가 필요한 경우 HTTP 프록시 호스트 주소입니다. 프록시 호스트 및 프록시 포트는 콜론으로 구분됩니다. 프록시 포트가 생략된 경우 해당 값은 80으로 간주됩니다. 포트가 생략된 예: `www-proxy-example.com`. 포함된 포트의 예: `www-proxy-example.com:80`
건너뛰기데이터	선택사항. 기본값은 false입니다. Essbase 애플리케이션의 스키마만 익스포트해야 하는 경우 true로 설정합니다.
사용자 건너뛰기	선택 사항: true 또는 false. 사용자 및/또는 그룹을 익스포트할 필요가 없는 경우에만 true로 설정합니다. 기본값은 false입니다.
idcsHost	Marketplace를 통해 OCI에 배포된 인스턴스에서 사용자 및/또는 그룹을 마이그레이션할 때만 필요합니다. IAM 또는 IDCS의 소스의 ID 도메인 호스트입니다. ID 도메인 URL(예: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`)에서 문자열 뒤의 도메인 부분만 추출합니다. 예: `identity.oraclecloud.com`
idcs테넌트	Marketplace를 통해 OCI에 배포된 인스턴스에서 사용자 및/또는 그룹을 마이그레이션하는 경우에만 필요합니다. IAM 또는 IDCS에서 소스 호스트의 ID 도메인 테넌시 식별자입니다. ID 도메인 URL(예: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`)에서 `idcs-<string_of_numbers_and_letters>`만 추출합니다.
클라이언트 ID	Marketplace를 통해 OCI에 배포된 인스턴스에서 사용자 및/또는 그룹을 마이그레이션하는 경우에만 필요합니다. 통합 기밀 ID 애플리케이션에서 발견된 OAuth 권한 부여에 대한 소스 호스트의 클라이언트 식별자입니다.
clientSecret	Marketplace를 통해 OCI에 배포된 인스턴스에서 사용자 및/또는 그룹을 마이그레이션하는 경우에만 필요합니다. 통합 기밀 ID 애플리케이션에서 발견된 OAuth 권한 부여를 위한 소스 호스트의 클라이언트 암호입니다.
appId	Marketplace를 통해 OCI에 배포된 인스턴스에서 사용자 및/또는 그룹을 마이그레이션하는 경우에만 필요합니다. OCI ID 도메인(IAM 또는 IDCS)에서 통합된 기밀 ID 애플리케이션의 식별자입니다. 이 ID 애플리케이션은 사용자 및 그룹에 부여할 수 있는 애플리케이션 롤로 구성되어야 합니다. 이 등록 정보를 사용하면 이전된 사용자 및 그룹에 롤을 부여할 수 있습니다.

유틸리티와 동일한 디렉토리에 있는 import.properties 파일을 편집합니다. 마이그레이션할 대상 Essbase 대상 인스턴스의 세부정보를 제공합니다.

속성 가져오기	설명
사용자 이름	필수입니다. 대상 인스턴스의 Essbase 관리자 사용자 이름입니다.
비밀번호	필수입니다. 대상 인스턴스의 Essbase 관리자 비밀번호입니다.
호스트	필수입니다. 로드 밸런서가 Essbase 배포 중에 구성된 경우 로드 밸런서의 대상 인스턴스의 IP 주소입니다. 그렇지 않은 경우 Essbase 공용 IP 주소에 해당하는 호스트 이름 또는 IP 주소입니다.
port	선택사항. 대상 Essbase 인스턴스의 HTTP 수신 포트입니다. 대상 인스턴스가 보안(TLS) 모드로 구성되고 `isTLS`=true 포트 443으로 간주되는 경우 소스 인스턴스가 LDAP ID 제공자로 구성된 경우 포트를 80으로 설정합니다.
사이트맵	선택 사항: true 또는 false. true인 경우 대상 인스턴스는 지정된 `port` 값을 사용하여 보안(TLS) 모드로 구성됩니다.
사용자 비밀번호	선택사항. 유틸리티가 IAM 또는 IDCS의 통합 ID 애플리케이션으로 마이그레이션하는 새 사용자에게 지정할 초기 비밀번호입니다. 이전 후 비밀번호를 변경하려면 OCI 콘솔을 사용합니다.
proxy	선택사항. HTTP 프록시 호스트 주소(대상 Essbase 인스턴스에 대한 접속에 프록시가 필요한 경우). 프록시 호스트 및 프록시 포트는 콜론으로 구분됩니다. 프록시 포트가 생략된 경우 해당 값은 80으로 간주됩니다. 포트가 생략된 예: `www-proxy-example.com`. 포함된 포트의 예: `www-proxy-example.com:80`
사용자 건너뛰기	선택 사항: true 또는 false. 사용자 및/또는 그룹을 임포트할 필요가 없는 경우에만 true로 설정합니다. 기본값은 false입니다.
idcsHost	사용자 및/또는 그룹을 마켓플레이스를 통해 OCI에 배포된 인스턴스로 마이그레이션하는 경우에만 필요합니다. 대상 ID 도메인 호스트입니다. ID 도메인 URL(예: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`)에서 문자열 뒤의 도메인 부분만 추출합니다. 예: `identity.oraclecloud.com`
idcs테넌트	사용자 및/또는 그룹을 마켓플레이스를 통해 OCI에 배포된 인스턴스로 마이그레이션하는 경우에만 필요합니다. 대상 호스트의 ID 도메인 테넌시 식별자입니다. ID 도메인 URL(예: `https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)`)에서 `idcs-<string_of_numbers_and_letters>`만 추출합니다.
클라이언트 ID	사용자 및/또는 그룹을 마켓플레이스를 통해 OCI에 배포된 인스턴스로 마이그레이션하는 경우에만 필요합니다. 통합 기밀 ID 애플리케이션에서 발견된 OAuth 권한 부여에 대한 대상 호스트의 클라이언트 식별자입니다.
clientSecret	사용자 및/또는 그룹을 마켓플레이스를 통해 OCI에 배포된 인스턴스로 마이그레이션하는 경우에만 필요합니다. 통합 기밀 ID 애플리케이션에서 발견된 OAuth 권한 부여를 위한 대상 호스트의 클라이언트 암호입니다.
appId	사용자 및/또는 그룹을 마켓플레이스를 통해 OCI에 배포된 인스턴스로 마이그레이션하는 경우에만 필요합니다. OCI ID 도메인(IAM 또는 IDCS)에서 통합된 기밀 ID 애플리케이션의 식별자입니다. 이 ID 애플리케이션은 사용자 및 그룹에 부여할 수 있는 애플리케이션 롤로 구성되어야 합니다. 이 등록 정보를 사용하면 이전된 사용자 및 그룹에 롤을 부여할 수 있습니다.
overwrite	선택사항. 임포트할 애플리케이션이 대상에 이미 있고 덮어쓰려는 경우 true로 설정합니다. 기본값은 false입니다.
인증서	선택사항. 모든 TLS/SSL 서버에 대한 모든 보안 인증서 파일의 전체 경로입니다. Windows의 경우 백슬래시를 다른 백슬래시로 이스케이프합니다. 예: `C:\\migrationTools\\all_certs.pem`

익스포트 명령을 사용하여 Java에서 마이그레이션 유틸리티를 실행하여 모든 애플리케이션, 사용자 및 그룹을 Essbase 소스 인스턴스 카탈로그에서 압축 파일로 익스포트합니다.

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

예:

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

import 명령을 사용하여 Java에서 Migration Utility를 실행하여 압축된 파일을 대상 인스턴스로 임포트합니다.
```
java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar import import.properties <existing_tar_file>
```
임포트를 실행한 후 대상 인스턴스의 Essbase 카탈로그에 데이터가 마이그레이션됩니다.