스냅샷을 사용하여 Oracle Analytics Cloud 이전

다운로드 및 업로드 기능을 사용하면 스냅샷을 로컬 파일 시스템에 저장하여 클라우드로 다시 업로드할 수 있습니다. 해당 기능을 사용하여 다른 두 서비스 간에 콘텐츠를 이전하고 개발, 테스트 및 운용 환경 간 이전을 수행하며 Oracle Cloud Infrastructure Classic에 배치된 서비스를 Oracle Cloud Infrastructure로 이전할 수 있습니다.

항목:

Oracle Analytics Cloud 이전 정보

스냅샷을 사용하여 특정 Oracle Analytics Cloud 환경에서 다른 환경으로 콘텐츠 및 설정을 쉽게 이전할 수 있습니다. 전체 환경을 이전하거나 특정 유형의 콘텐츠를 이전할 수 있습니다.

이전을 위한 필요 조건

스냅샷을 사용하여 사용자 콘텐츠를 이전하기 전에 소스 및 대상 환경을 확인하십시오.

소스와 대상 환경이 Oracle Analytics Cloud 5.1.x 이상을 사용해야 합니다. 이전 버전에서 생성된 스냅샷은 전체 환경을 캡처하지 않습니다.

모를 경우 오라클 담당자에게 문의하십시오.
아직 수행하지 않은 경우 Oracle Cloud Infrastructure에서 대상 서비스를 생성합니다.

Administering Oracle Analytics Cloud on Oracle Cloud Infrastructure (Gen 2)의 Create a Service with Oracle Analytics Cloud을(를) 참조하십시오.
파일 기반 데이터를 이전하려면 소스 및 대상 환경이 작동되어 실행 중이며 적합한 스토리지 인증서로 구성되었는지 확인합니다.

스토리지 액세스 문제가 발생하면 스냅샷을 사용하여 데이터 파일을 이전하지 못할 수 있습니다. 이 경우 데이터 이전 유틸리티를 사용하여 별도로 데이터 파일을 다운로드한 다음 업로드할 수 있습니다.

이전되지 않는 항목

일부 Oracle Analytics Cloud 아티팩트는 스냅샷에 포함되지 않습니다. 비Oracle Analytics Cloud 아티팩트도 포함되지 않습니다.

이전되지 않는 항목	추가 정보
바이러스 검사 프로그램 구성	소스 환경에서 사용되는 바이러스 검사 프로그램 구성을 기록하고 동일한 정보를 사용하여 대상에서 바이러스 검사 프로그램을 구성합니다. 바이러스 검사 프로그램 구성을(를) 참조하십시오.
메일 서버 구성	소스 환경에서 사용되는 SMTP 메일 서버 구성을 기록하고 해당 정보를 사용하여 대상에서 메일 서버를 구성합니다. 보고서를 전달하도록 전자메일 서버 설정을(를) 참조하십시오.
소스 환경의 저장된 다른 스냅샷	필요한 경우 이전할 개별 스냅샷을 다운로드하여 대상에 업로드합니다. 스냅샷 임포트을(를) 참조하십시오.
사용자 및 그룹	Oracle Cloud Infrastructure IAM(Identity and Access Management) ID 도메인에서 이전 Oracle Cloud Infrastructure 콘솔의 익스포트 및 임포트 기능을 사용하여 특정 ID 도메인의 사용자와 롤을 다른 도메인으로 이전합니다. Oracle Cloud Infrastructure 설명서의 Transferring Data을(를) 참조하십시오. Oracle Identity Cloud Service에서 이전 Oracle Identity Cloud Service 콘솔의 익스포트 및 임포트 기능을 사용하여 특정 ID 도메인의 사용자와 롤을 다른 도메인으로 이전합니다. Manage Oracle Identity Cloud Service Users 및 Manage Oracle Identity Cloud Service Groups을(를) 참조하십시오. 내장된 WebLogic LDAP 서버에서 이전 `wls_ldap_csv_exporter` 스크립트를 사용하여 Oracle Identity Cloud Service 대상에서 임포트할 수 있는 CSV 파일로 사용자와 그룹을 익스포트합니다. Export Users and Groups from Embedded WebLogic LDAP Server을(를) 참조하십시오.
ID 관리 구성	대상 환경의 Oracle Cloud Infrastructure 콘솔을 사용하여 소스에 구성한 사용자(또는 그룹) 애플리케이션 롤 지정을 재구성하고 SSO(Single Sign-On) 등을 재구성합니다.
네트워크 구성	필요에 따라 대상 환경에서 네트워크 요구사항을 설정합니다.

Oracle Analytics Cloud 이전을 위한 일반적인 워크플로우

스냅샷을 사용하여 Oracle Analytics Cloud를 다른 환경으로 이전합니다. 수행할 작업은 다음과 같습니다.

작업	설명	추가 정보
스냅샷을 사용하여 이전하는 방법 이해	스냅샷으로 이전할 수 있는 것과 없는 것은 무엇이고 어떤 필요 조건이 있는지 이해합니다.	Oracle Analytics Cloud 이전 정보
대상 서비스 생성	Oracle Cloud Infrastructure 콘솔을 사용하여 Oracle Cloud Infrastructure에서 새 서비스를 배치합니다.	Create a Service with Oracle Analytics Cloud
사용자 및 그룹 이전	Oracle Cloud Infrastructure 콘솔의 익스포트 및 임포트 기능을 사용하여 특정 ID 도메인의 사용자와 롤을 다른 도메인으로 이전합니다. Oracle Analytics Cloud에 대한 사용자를 이전하는 방법은 클라우드 계정에서 ID 도메인을 사용할 수 있는지 여부에 따라 달라집니다. 확실하지 않을 경우 About Setting Up Users and Groups을(를) 참조하십시오. 소스 시스템이 ID 관리를 위해 내장된 WebLogic LDAP 서버를 사용하는 경우 `wls_ldap_csv_exporter` 스크립트를 사용하여 사용자와 그룹을 CSV 파일로 익스포트합니다.	Transferring Data (IAM Users) Manage Oracle Identity Cloud Service Users Export Users and Groups from Embedded WebLogic LDAP Server
소스에 스냅샷 생성	소스 시스템에서 이전할 콘텐츠를 캡처합니다.	스냅샷 생성
스냅샷 익스포트	로컬 파일 시스템 또는 Oracle Cloud Infrastructure의 스토리지 버킷으로 이전할 스냅샷을 다운로드합니다.	스냅샷 익스포트
대상에 스냅샷 업로드	대상 시스템에 사인인하고 스냅샷을 업로드합니다.	스냅샷 임포트
스냅샷 콘텐츠 복원	저장된 스냅샷 목록에서 새로 업로드한 스냅샷을 선택하고 스냅샷의 콘텐츠를 복원합니다.	스냅샷에서 복원
데이터 파일 이전	데이터 이전 유틸리티를 사용하여 환경 간에 데이터 파일을 이전합니다. 다음과 같은 경우에만 필요합니다. 다른 지역으로 이전합니다. 1세대 Oracle Analytics Cloud 또는 Oracle Cloud Infrastructure Classic에서 2세대 Oracle Analytics Cloud로 이전합니다. 네트워크 접속 또는 스토리지 액세스 문제로 인해 복원 프로세스가 실패합니다.	파일 기반 데이터 이전
바이러스 검사 프로그램 재구성	소스 환경의 바이러스 검사 프로그램 구성을 기록하고 이를 사용하여 대상에 바이러스 검사 프로그램을 구성합니다.	바이러스 검사 프로그램 구성
메일 서버 재구성	소스 환경의 SMTP 메일 서버 구성을 기록하고 이를 사용하여 대상에 메일 서버를 구성합니다.	보고서를 전달하도록 전자메일 서버 설정
(선택사항) 다른 스냅샷 이전	이전할 개별 스냅샷을 다운로드하고 필요에 따라 대상 환경에 업로드합니다.	스냅샷 익스포트 스냅샷 임포트
ID 관리 구성 이전	대상 환경의 Oracle Cloud Infrastructure 콘솔을 사용하여 소스에 구성한 사용자(또는 그룹) 애플리케이션 롤 지정을 재구성하고 SSO(Single Sign-On) 등을 재구성합니다.

파일 기반 데이터 이전

사용자는 스프레드시트와 같은 데이터 파일을 Oracle Analytics Cloud에 업로드하여 데이터 집합을 생성합니다. 새 Oracle Analytics Cloud 환경으로 이전할 때는 이 파일 기반 데이터를 포함할 수 있습니다. 네트워크 접속 또는 스토리지 액세스 문제로 인해 스냅샷의 데이터 파일을 이전하지 못하는 경우도 있습니다. 이러한 경우 Oracle Analytics Cloud는 데이터 파일을 새 위치로 이동할 수 있는 CLI(명령행 인터페이스) 유틸리티를 제공합니다. 스냅샷 CLI 유틸리티는 사용자가 데이터 시각화를 위해 업로드한 맵 관련 플러그인과 확장 파일도 이동합니다.

데이터 파일이 포함된 스냅샷을 복원하려고 시도할 때 Restore succeeded with errors - data restore failed와 유사한 메시지가 표시되는 경우에만 데이터 이전 CLI 유틸리티를 실행하십시오. 이 메시지는 다음과 같은 경우 발생합니다.

다른 지역에서 콘텐츠를 이전합니다.
1세대 Oracle Analytics Cloud 또는 Oracle Cloud Infrastructure Classic의 콘텐츠를 2세대 Oracle Analytics Cloud로 이전합니다.
기타 몇 가지 네트워크 접속 또는 스토리지 액세스 문제로 인해 복원 프로세스가 실패합니다.

CLI 유틸리티는 특정 환경에서 다른 환경으로 직접 데이터 파일을 이동할 수 있습니다(한 단계). 또는 원하는 경우 파일 기반 데이터를 ZIP 파일로 다운로드하고, 선택한 환경에 데이터 파일을 업로드할 수 있습니다(별도의 두 단계).

환경 세부정보를 확인합니다.
- 소스 및 대상 시스템이 모두 Oracle Analytics Cloud 5.3 이상을 사용하는지 확인합니다. 그 이전 버전에서는 CLI 유틸리티를 사용할 수 없습니다.
  
  모를 경우 오라클 담당자에게 문의하십시오.
- 소스 및 대상 시스템이 모두 작동되어 실행 중이며 적합한 스토리지 인증서로 Oracle Analytics Cloud가 구성되었는지 확인합니다.
- 로컬 환경을 확인합니다. CLI 유틸리티를 실행하려면 Java 1.8 이상이 필요합니다.
- CLI 유틸리티를 실행하려는 로컬 환경에서 소스 환경 및 대상 Oracle Analytics Cloud에 액세스할 수 있는지 확인합니다.
- 파일 기반 데이터가 포함된 이전에 다운로드한 스냅샷의 이름과 위치를 확인합니다. 예를 들어 /tmp/20190307095216.bar입니다.
CLI 유틸리티를 다운로드합니다.
1. 대상 Oracle Analytics Cloud에서 콘솔을 누르고 스냅샷을 누릅니다.
2. 페이지 메뉴 를 누르고 이전, 데이터 이전 유틸리티 다운로드를 차례로 선택합니다.
  지침에 따라 migrate-oac-data.zip 파일을 로컬에 저장합니다.
migrate-oac-data.zip의 압축을 풉니다.
ZIP 파일에는 세 개의 파일이 들어 있습니다.
- migrate-oac-data.jar
- config.properties
- readme

소스 환경에 저장된 데이터 파일을 한 단계로 대상에 직접 이전하려면 config.properties에서 [MigrateData] 섹션을 구성합니다.

[MigrateData]
# Migrate data files from a source Oracle Analytics Cloud environment (OAC) to a target Oracle Analytics Cloud environment.
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>

먼저 소스 Oracle Analytics Cloud의 데이터 파일을 로컬 환경으로 다운로드하여 대상 Oracle Analytics Cloud 환경에 데이터 파일을 업로드하려면 config.properties에서 [DownloadDataFiles] 및 [UploadDataFiles] 섹션을 구성합니다.

[DownloadDataFiles]
#Download Data Files: Download data files from Oracle Analytics Cloud storage to a local repository
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Local data file directory. Make sure you have enough space to download the data files to this directory. For example: /tmp/mydatafiledir 
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
     # Data fragment size. Data files are downloaded in fragments. Default fragment size is 500MB.
      MAX_DATA_FRAGMENT_SIZE_IN_MB=500

[UploadDataFiles]
#Upload data files: Upload data files to the target Oracle Analytics Cloud. 
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>
    # Local directory containing the data files you want to upload. For example: /tmp/mydatafiledir
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>

로컬 환경에서 migrate-oac-data.jar 파일을 실행합니다.
구문:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
설명:
- -config configfile : config.properties 파일의 이름입니다.
- -d : config.properties의 정보를 사용하여 로컬에 데이터를 다운로드합니다.
- -help : 도움말을 표시합니다.
- -m : config.properties 파일의 소스 및 대상 정보를 사용하여 데이터를 이전합니다.
- -u : config.properties 파일의 정보를 사용하여 데이터를 업로드합니다.
예를 들어, 한 단계로 데이터 파일을 이전하려면 다음을 입력합니다.
```
java -jar migrate-oac-data.jar -m -config config.properties
```
예를 들어, 로컬에 데이터 파일을 다운로드하려면 다음을 입력합니다.
```
java -jar migrate-oac-data.jar -d -config config.properties
```
예를 들어, 데이터 파일을 업로드하려면 다음을 입력합니다.
```
java -jar migrate-oac-data.jar -u -config config.properties
```
대상 Oracle Analytics Cloud에 사인인합니다.
다음 번부터는 Oracle Analytics Cloud에서 데이터 파일을 노출하려는 경우 나머지 콘텐츠의 이전에 사용한 스냅샷을 복원해야 합니다. 지금은 사용자정의 복원 옵션을 선택해야 합니다.
1. 콘솔을 열고 스냅샷 관리를 누릅니다.
2. 데이터 파일이 포함된 스냅샷을 선택합니다.
3. 사용자정의 복원 옵션을 선택하고 파일 기반 데이터 옵션을 선택합니다.
  기타 모든 옵션의 선택을 해제합니다.
4. 복원을 누릅니다.
데이터 파일이 사용 가능한지 확인합니다.