커스텀 에디션에서 커스텀 에디션으로 마이그레이션

온라인 편집

커스텀 에디션을 커스텀 에디션으로 마이그레이션할 수 있습니다. 마이그레이션할 수 있는 데이터에는 테넌트 유닛 구성 데이터가 포함됩니다. 임차인 단위 구성 데이터에는 사용자 설정, 대시보드, 이벤트, 알림, 애플리케이션 관점, EUM 웹사이트 및 모바일 앱, 기타 데이터가 포함됩니다. 마이그레이션은 수동으로 수행되며 백엔드 설치 전 단계입니다. Postgres 의 새 설치가 필요합니다.

참고: Instana 에이전트의 분석 및 메트릭스 데이터는 마이그레이션할 수 없습니다.

참고: 중요 커스텀 에디션으로 마이그레이션할 때 기존 커스텀 에디션 라이선스를 그대로 사용할 수 있습니다.

전제조건

온라인 편집

다음 전제조건이 충족되는지 확인하십시오.

Kubernetes 클러스터가 설치 및 구성되었습니다.
Instanakubectl 플러그인이 설치되었습니다.
데이터 저장소가 가동 중입니다.

프로시저

온라인 편집

데이터를 마이그레이션하려면 다음 단계를 완료하십시오:

사용자 지정 에디션 호스트에서 Postgres 데이터 저장소에서 테넌트 유닛 구성 데이터를 추출하십시오.

kubectl-instana dump config-data --unit <unitname> --unit-namespace <namespace>

현재 디렉터리에 파일이 dump-<timestamp>.tar.gz 생성됩니다. 이 파일에는 실행 가능한 SQL 쿼리 형태로 테넌트 유닛 구성 데이터가 포함되어 있습니다.

표 1. 추출 매개변수
매개변수	설명
--unit-namespace	유닛 네임스페이스 (기본값: instana-units)
--postgres-namespace	네임스페이스 (기본값: instana-postgres)
--unit	단위명 (기본값: unit0-tenant0 )

생성된 dump-<timestamp>.tar.gz 파일 패키지를 기존 호스트에서 새 커스텀 에디션 호스트로 전송하십시오.
데이터 스토어를 설치하려면 ‘데이터 스토어 설정’을 참조하십시오.

커스텀 에디션에서 데이터를 가져옵니다.

kubectl-instana migrate -f <path-to-dump-file>

표 2. 이주 매개변수
매개변수	설명
-f, --file	마이그레이션 메모리 덤프 아카이브 경로
--postgres-namespace	네임스페이스 (기본값: `instana-postgres`)
--postgres-name	Postgres 클러스터 이름 (기본값: `postgres`)
--postgres-user	Postgres 사용자 이름
--postgres-password	Postgres 비밀번호

메모리 덤프 아카이브를 추출하고 백엔드 설치를 위해 다음 구성을 사용하십시오:
```
tar -xzf dump-<timestamp>.tar.gz -o dump/migrate.yaml | cat
```
파일 migrate.yaml 내의 매개변수를 확인하십시오. Instana 백엔드를 설치하려면 이 값들을 사용해야 합니다.
- Core Secret의 파일에서 migrate.yaml 다음 매개변수를 사용하십시오.
  - salesKey
  - tokenSecret
  - downloadKey
- Unit Secret의 파일에서 migrate.yaml 다음 매개변수를 사용하십시오.
  - downloadKey
  - 에이전트 키
- 다음 예시와 같이 코어를 생성하기 위해 파일에서 migrate.yaml 다음 매개변수를 사용하십시오.
```
apiVersion: instana.io/v1beta2 
kind: Core 
metadata: 
  namespace: instana-core 
  name: instana-core 
spec:
   imageConfig: 
     tag: 3.xxx.xxx-0 
...
```
- 유닛 및 테넌트 생성을 위해 다음 매개변수를 migrate.yaml 파일에서 사용하십시오.
  - tenantName
  - unitName
Instana 백엔드를 설치하십시오. 자세한 내용은 ‘ Instana 백엔드 설치’를 참조하십시오.

이동 후 구성

온라인 편집

필요한 경우, 기존 호스트에 있던 다음 구성을 다시 수행하십시오.

새 사용자 지정 에디션 인스턴스는 기본적으로 어떤 에이전트에도 연결되어 있지 않습니다. 다음 단계 중 하나를 완료하십시오.
- 에이전트를 기존 및 새로운 백엔드에 연결하려면, 다중 백엔드 구성을 참조하십시오.
- 에이전트를 새 백엔드에 연결하고, 기존 DNS 레코드를 새 커스텀 에디션 인스턴스로 가리키도록 업데이트하십시오. 에이전트들은 자동으로 새로운 백엔드에 보고하기 시작합니다.
마이그레이션 후, 기존 환경과 새 환경이 에이전트에 연결되면 두 환경( Instana ) 모두에서 경고가 발생합니다. 중복 알림을 방지하려면 Instana 인스턴스 중 하나에 유지보수 시간대를 설정할 수 있습니다. 자세한 내용은 ‘유지보수 시간대 예약’을 참조하십시오.
이전 Custom Edition 인스턴스에서 활성화된 기능 플래그는 마이그레이션되지 않습니다. 새로운 환경에서 해당 기능 플래그를 다시 수동으로 활성화해야 합니다.