자체 호스팅형 Classic Edition 업그레이드 ( Docker )

클래식 에디션을 업그레이드하려면 다음 단계를 따르세요:

참고: 업그레이드 정책에 따르면 최대 한 번의 릴리스만 건너뛸 수 있습니다. 즉, 245-x 릴리스에서 247-x 또는 249-x 릴리스로 업그레이드하는 것은 가능하지만, 그 이상 건너뛸 수는 없습니다. 정책이 한 번에 필요한 업그레이드를 수행하도록 허용하지 않는 경우 둘 이상의 업그레이드 단계를 수행해야 합니다.
참고: 백엔드 279, stanctl 1.6.0 또는 Operator 1.0.0 이전 버전의 경우, 백엔드를 한 번에 최대 두 버전씩만 업그레이드해야 합니다. 예를 들어, 버전 275 이상에서만 버전 279로 업그레이드할 수 있습니다. 자세한 내용은 이전 버전의 Instana 관련 문서를 참조하십시오.
중요: Classic Edition의 경우, 업그레이드 후 Instana 백엔드의 롤백은 지원되지 않습니다.

Docker 듀얼 호스트 환경 업그레이드

듀얼 호스트 Docker 환경을 업그레이드하려면 다음 단계를 따르십시오:

  1. Instana 콘솔을 ClickHouse 호스트의 대상 버전으로 업그레이드하십시오. 자세한 내용은 ‘ Instana 콘솔 업그레이드’를 참조하십시오.

  2. Instana 가 배포된 호스트 머신에서 다음 작업을 수행하십시오:

    1. Instana 콘솔을 Instana 호스트의 대상 버전으로 업그레이드하십시오. 자세한 내용은 ‘ Instana 콘솔 업그레이드’를 참조하십시오.

    2. Instana 호스팅 서비스에서 Instana 백엔드를 업그레이드하세요. 자세한 내용은 ‘ Instana 백엔드 업그레이드’를 참조하십시오.

에어갭(air-gapped) 환경의 Docker 구성 업그레이드

에어 갭(air-gapped) 방식의 Docker 환경을 업그레이드하려면 외부 가상 머신( VM )이나 대상 VM 에서 수행할 수 있습니다.

외부 사이트 VM (인터넷 연결 필요)

  1. Instana 콘솔 애플리케이션을 다운로드하여 설치하십시오.

    yum --showduplicates 명령어는 Instana 콘솔 애플리케이션의 사용 가능한 버전 목록을 표시합니다.

    yum --showduplicates list instana-console
    (...)
    instana-console.x86_64   259_3-1   instana-product
    instana-console.x86_64   259_4-1   instana-product
    instana-console.x86_64   261_0-1   instana-product
    instana-console.x86_64   261_1-1   instana-product
    instana-console.x86_64   261_2-1   instana-product
    instana-console.x86_64   263_0-1   instana-product
    instana-console.x86_64   263_1-1   instana-product
    instana-console.x86_64   263_2-1   instana-product
    instana-console.x86_64   263_3-1   instana-product
    instana-console.x86_64   265_0-1   instana-product
     
  2. Instana 콘솔을 사용하여 필요한 모든 Instana 이미지를 다운로드하십시오.

  3. Instana 콘솔 애플리케이션과 Instana 이미지를 에어갭(air-gapped) 상태의 VM 로 내보냅니다.

    다음 instana images export -k DOWNLOAD_KEY 명령어는 Instana 의 이미지를 파일로 다운로드하며, 이 .tar 파일은 이후 에어갭(air-gapped) 상태의 VM 로 내보낼 수 있습니다:

    instana images export -k DOWNLOAD_KEY
    Images export ⣯ pull artifact-public.instana.io/backend/butler:3.265.276-0
    (...)
    -rw------- 1 root    root    8295586304 Feb  8 01:38 export-265-1.tar
     
    참고: ` .tarInstana ` 파일의 크기는 약 8GB입니다.

대상 사이트 VM (인터넷 연결 불필요)

  1. 필요한 버전을 설치하거나 instana-console 업데이트하십시오. 자세한 내용은 ‘ Instana 콘솔 업그레이드’를 참조하십시오.

    다음 yum install --downloadonly 명령어를 실행하면 instana-console 파일을 특정 위치로 다운로드할 수 있으며, 이후 인터넷에 연결되지 않은 상태에서도 해당 파일을 VM 로 내보낼 수 있습니다:

    yum install -y --downloadonly --downloaddir=/opt/instana instana-console-265_1-1
    (...)
    -rw-r--r-- 1 root    root      30581559 Feb 12 02:41 instana-console-265_1-1.x86_64.rpm
     

    다음 yum localinstall 명령은 로컬 파일 (예: Red Hat Package Manager (RPM)) 에서 패키지를 설치합니다.

    yum localinstall instana-console-259_2-1.x86_64.rpm
    (...)
    Total size: 29 M
    Is this ok [y/N]: Y
    Downloading Packages:
    Running transaction check
    Transaction check succeeded.
    Running transaction test
    Transaction test succeeded.
    Running transaction
     Preparing        :                                                                                                                                                     1/1
     Upgrading        : instana-console-265_1-1.x86_64                                                                                                                      1/2
     Cleanup          : instana-console-259_2-1.x86_64                                                                                                                      2/2
     Running scriptlet: instana-console-259_2-1.x86_64                                                                                                                      2/2
     Verifying        : instana-console-265_1-1.x86_64                                                                                                                      1/2
     Verifying        : instana-console-259_2-1.x86_64                                                                                                                      2/2
     Installed products updated.
    
     Upgraded:
     instana-console-265_1-1.x86_64
     
  2. 다음 명령어를 사용하여 Instana 이미지를 가져옵니다:

    instana images import -f /opt/instana/export-265-0.tar
     

    instana-console 버전이 지원되지 않는 경우 업데이트 프로시저가 실패합니다.

  3. 다음 명령을 사용하여 Instana 업데이트 프로세스를 실행하십시오:

    instana update -f settings.hcl