사용량 측정기 업그레이드 및 라이선스 키 교환

서비스 종료: 2025년 10월 31일부터 신규 고객은 ‘ VMware Solutions ’ 서비스를 더 이상 신규로 도입할 수 없습니다. 기존 고객은 IBM Cloud® 에서 현재 사용 중인 VMware® 워크로드를 계속 사용하고 확장할 수 있습니다. 자세한 내용은 IBM Cloud 에서 마케팅 종료(VMware)를 참조하세요.

기존의 VMware vCloud 사용량 측정기를 9.x 버전 이상으로 업그레이드하십시오. VMware vCloud 의 최신 사용량 측정기 버전은 v9.1.0 입니다. 사용량 측정기( v4.8 )의 경우, 업그레이드 절차는 IBM Cloud 사용량 측정기 포털을 통해 현재 등록된 사용량 측정기에 대한 액세스 토큰을 수신한 후, 먼저 v9.0.1 로 인플레이스 업그레이드를 수행하는 순서로 진행됩니다. v9.0.1 으로 처음 업그레이드한 후에는, v9.x 또는 그 이후 버전으로 추가 업그레이드할 때 액세스 토큰을 제공할 필요가 없습니다.

Usage Meter v4.8 의 경우, Usage Meter v4.8 에서 v9.1 로의 직접 업그레이드 경로는 지원되지 않습니다. 먼저 4.8 버전에서 9.0.1 버전으로 업그레이드한 다음, 9.1 버전으로 업그레이드해야 합니다. 자세한 내용은 ‘업그레이드 경로 - 제품 상호운용성 매트릭스’를 참조하십시오.

버전 9 이상으로 업그레이드하기 전에 VMware Cloud Foundation™ ( VCF ) 라이선스 키를 교체해야 합니다.

라이선스 키를 교체하는 절차

  1. 새 Broadcom 라이선스 키를 얻은 다음 VMware Solutions 콘솔에서 VMware Cloud Foundation ( VCF ) 라이선스 키를 검색합니다. 자세한 내용은 라이선스 키 검색하기(VCF)를 참조하세요.
  2. VMware 애드온 키를 받습니다. 자세한 내용은 VMware 애드온 키 가져오기를 참조하세요.
  3. 모든 VMware 제품에 새 라이선스 키를 추가한 다음 필요에 따라 라이선스를 할당합니다. 자세한 내용은 VMware 제품 라이선스 관리하기를 참조하세요.

사용량 측정기를 업그레이드하는 절차

Usage Meter를 업그레이드하려면 다음 단계를 따르십시오:

SSH 로그인 사용

  1. https://<Usage Meter IP>:5480 을 통해 usagemeter 사용자로 VMware vCloud 사용량 측정기 어플라이언스 관리 콘솔에 로그인합니다.
  2. 왼쪽 탐색 패널에서 ‘Access’를 클릭하세요.
  3. 액세스 설정에서 오른쪽 상단의 편집을 클릭합니다.
  4. 액세스 설정 수정 창에서 SSH 로그인 사용 스위치를 켭니다. SSH 로그인이 사용됨으로 변경됩니다.

업그레이드 ISO 파일 마운트하기

  1. 다음 링크에서 Usage Meter ISO 파일을 다운로드하십시오:

    • Usage Meter v4.8 (또는 그 이전 버전)에서 v9.0.1 로 업그레이드하려면 다음 링크를 사용하십시오: https://ibm.biz/~V0YiDk0EP.
    • Usage Meter( v9.0.1 )에서 v9.1.0 로 업그레이드하려면 다음 링크를 사용하십시오: https://ibm.biz/~aBF0Bw0fU.

  2. 다음 SHA-256 값을 기준으로 SHA-2 의 체크섬을 검증하십시오:

    • Usage Meter v4.8 (또는 그 이전 버전)에서 v9.0.1 로 업그레이드하려면 다음을 참조하십시오: ec5c46b4bdae915cb4a289dfbb03077cb802f404692bb3f2501b59b448102797.
    • Usage Meter v9.0.1 에서 v9.1.0 로 업그레이드하는 방법은 다음을 참조하십시오: d1f79f1bcc711c7753c871bd95bc434e8a31bb8fc584fc7ac88b75398be445c1.

    Windows®에서 명령 프롬프트를 열거나, Linux® 및 MacOS 에서 터미널 창을 열고 다음 명령을 실행하십시오:

    • Windows의 경우: certutil -hashfile <path-to-iso-file> SHA256
    • Linux: sha256sum <path-to-iso-file>
    • macOS의 경우: shasum -a 256 <path-to-iso-file>

  3. VMware vSphere® 웹 클라이언트에서 vCenter 서버 인스턴스에 로그인합니다.

  4. 저장소 메뉴에서 사용량 측정기 가상 머신( VM )이 있는 데이터스토어를 선택합니다.

  5. VM 탭에서 가상 머신을 클릭하고 대상 데이터 저장소에 사용량 측정기가 있는지 확인합니다.

  6. 파일 탭에서 파일 업로드를 클릭합니다. ISO 파일 업로드가 시작됩니다.

    호스트 인증서에 대한 오류가 표시될 수 있습니다. 이 문제를 해결하려면 다른 웹 브라우저 탭에서 오류에 표시된 지정된 URL 을 열고 인증서를 수락합니다. 로드되지 않으면 호스트가 현재 데스크톱 DNS에 있는지 확인한 다음 URL 에 다시 액세스하세요.

  7. 업로드가 완료되면 ISO 파일이 파일 목록에 나타납니다.

  8. 호스트 및 클러스터 메뉴에서 사용량 측정기 VM 를 찾아 마우스 오른쪽 버튼으로 클릭하고 설정 편집을 선택합니다.

  9. 가상 하드웨어 탭의 CD/DVD 드라이브에서 Datastore ISO 파일을 선택하고 확인을 클릭합니다.

    CD/DVD 드라이브 옵션이 표시되지 않으면 새 장치 추가를 클릭합니다.

  10. 파일 선택 창에서 ISO 파일을 업로드한 데이터스토어를 찾습니다.

  11. ISO 파일을 선택한 다음 ‘확인’을 클릭하십시오.

  12. 설정 편집 창의 가상 하드웨어 탭에서 연결됨 확인란을 선택한 다음 확인을 클릭합니다.

업그레이드 명령 실행

사용량 측정기에 대한 업그레이드 명령을 실행하기 전에 다음 단계를 완료하세요:

  1. VMware vSphere® 웹 클라이언트에서 vCenter 서버 인스턴스에 로그인합니다.
  2. 호스트 및 클러스터 메뉴에서 사용량 측정기 VM 를 찾아 마우스 오른쪽 버튼으로 클릭하고 설정 편집을 선택합니다.
  3. 가상 하드웨어 탭의 CD/DVD 드라이브에서 연결됨 확인란의 선택을 취소하고 확인을 클릭합니다.
  4. 호스트 및 클러스터 메뉴에서 사용량 측정기 VM 를 찾아 마우스 오른쪽 버튼으로 클릭하고 스냅샷 > 스냅샷 만들기를 선택합니다.
  5. 스냅샷 이름을 입력하고 ‘생성’을 클릭하세요.

SSH를 사용하여 사용량 측정기 어플라이언스( VM )에 로그인하고 다음 단계를 완료합니다:

  1. Windows에서 명령 프롬프트를 열거나 Linux 및 MacOS 에서 터미널 창을 열고 root 사용자로 다음 명령을 실행합니다:

    1. mkdir /root/upgrade
    2. mount -o loop /dev/cdrom /root/upgrade
    3. bash /root/upgrade/upgrade-um.sh

    사용량 측정기 VM 를 업그레이드하기 위해 mount -o loop /dev/cdrom /root/upgrade 을 실행하기 전에 umount /root/upgrade 을 실행하여 이전 업그레이드를 마운트 해제해야 할 수 있습니다.

  2. IBM Cloud® for VMware Solutions 콘솔에서 사용량 측정기에 대해 생성된 액세스 토큰을 입력합니다. 자세한 내용은 IBM 에 사용량 측정기 등록을 참조하세요.

  3. Y를 입력하여 VCF 사용량 측정기 어플라이언스가 IBM 의 제공자 조직에 속하는 것에 동의합니다.

  4. Y를 입력하여 사용량 측정기 VM 에 스냅샷이 생성되었는지 확인합니다.

    사용량 측정기 호스트 이름에 대한 오류 메시지가 표시될 수 있습니다. 업그레이드 경로를 계속하려면 y를 입력합니다.

  5. 업그레이드 프로세스가 시작되고 완료되면 y를 입력하여 사용량 측정기를 다시 시작합니다 VM.

  6. 재시작이 완료되면 웹 브라우저에서 사용량 측정기 URL 를 열고 로그인하여 업그레이드된 버전을 확인합니다. 그런 다음 사용량 측정기 어플라이언스의 상태를 확인합니다.

사용량 측정기 VM 를 마이그레이션한 후 업그레이드 과정에서 Connection control operation failed for disk 오류가 발생할 수 있습니다. 이 문제는 마운트된 CD/DVD 장치에 잠금이 유지되는 활성 스냅샷으로 인해 발생할 수 있습니다. 이 문제를 해결하려면 다음 절차 중 하나를 수행하십시오. 그러나 VM 의 성공적인 마이그레이션을 위해서는 이 모든 항목을 완료해야 할 수 있습니다.

  1. 기존 스냅샷을 모두 삭제하십시오:

    1. VMware vSphere 웹 클라이언트에서 vCenter 서버 인스턴스에 관리자로 로그인합니다.
    2. 호스트 및 클러스터 메뉴에서 사용량 측정기 VM 를 선택합니다.
    3. 스냅샷 탭에서 모두 삭제를 선택하거나 CD/DVD 드라이브가 마운트된 스냅샷을 지정하고 삭제를 선택합니다.
    4. 확인을 클릭하십시오.

  2. 마운트된 드라이브를 분리합니다:

    1. vSphere 웹 클라이언트에서 vCenter 서버 인스턴스에 관리자로 로그인합니다.
    2. 호스트 및 클러스터 메뉴에서 사용량 측정기 VM 를 찾아 마우스 오른쪽 버튼으로 클릭하고 설정 편집을 선택합니다.
    3. ISO 업그레이드 파일을 마운트한 CD/DVD 드라이브의 상자를 지웁니다.
    4. 확인을 클릭하십시오.

  3. 마운트된 드라이브를 호스팅된 ESXi에서 분리합니다:

    1. vSphere 웹 클라이언트에서 vCenter 서버 인스턴스에 관리자로 로그인합니다.
    2. 호스트 및 클러스터 메뉴에서 사용량 측정기 VM 를 선택합니다.
    3. 요약 탭에서 관련 개체를 찾아 VM 이 위치한 호스트를 확인합니다.
    4. ESXi 호스트에 루트 또는 관리자로 로그인합니다.
    5. 가상 머신을 선택하고 목록에서 사용량 측정기 VM 를 마우스 오른쪽 버튼으로 클릭합니다.
    6. 설정 편집을 클릭하십시오.
    7. CD/DVD 드라이브에서 연결된 확인란의 선택을 취소합니다.
    8. 저장 을 클릭하십시오.

사용량 측정기 인증서 교체하기

업그레이드 후 사용량 측정기 URL 에 액세스하거나 대시보드에 로그인할 수 없는 경우, 호스트 이름이 호환되지 않아 사용량 측정기 인증서를 교체하려면 다음 단계를 완료하세요:

  1. SSH를 사용하여 usagemeter 사용자 아이디로 사용량 측정기( VM )에 로그인합니다.

  2. stop.sh All 명령을 실행하여 모든 서비스를 중지합니다.

  3. 루트 사용자로 hostnamectl hostname <new hostname> 명령을 실행하여 호스트 이름을 올바른 값으로 업데이트합니다.

  4. export $(grep -v '^#' "/opt/vmware/cloudusagemetering/platform/conf/env.properties" | xargs) 및 mv /opt/vmware/cloudusagemetering/platform/security/keystore /opt/vmware/cloudusagemetering/platform/security/keystore.backup 명령을 실행하여 환경 변수를 내보내고 기존 키 저장소를 백업합니다.

  5. FIPS가 활성화된 경우 keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storetype BCFKS -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providerpath /opt/vmware/cloudusagemetering/platform/lib/bc-fips-*.jar -storepass "${TRUST_STORE_PASSWORD}" 명령을 실행합니다. 비활성화되어 있으면 keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}" 명령을 실행하세요.

    FIPS가 활성화된 상태에서 FIPS 비활성화 버전을 실행하면 keytool error: java.security.KeyStoreException: Unrecognized keystore format. 오류가 표시됩니다. 이 문제를 해결하려면 지정된 유형으로 로드하세요.

  6. NGINX 변수에 대한 임시 디렉터리를 만들고 export NGINX_FOLDER=$(mktemp -d) 명령을 실행하여 cloudusagemetering 디렉터리로 이동한 다음 cd /opt/vmware/cloudusagemetering 명령을 실행하여 새 디렉터리에 액세스합니다.

  7. ./platform/bin/create-keystore.sh 명령을 실행하여 새 키 저장소를 만듭니다.

  8. rm -rf $NGINX_FOLDER 및 rm /opt/vmware/cloudusagemetering/platform/security/keystore.backup 명령을 실행하여 임시 백업 파일을 제거합니다.

  9. FIPS가 활성화된 경우 keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storetype BCFKS -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providerpath /opt/vmware/cloudusagemetering/platform/lib/bc-fips-*.jar -storepass "${TRUST_STORE_PASSWORD}" 명령을 실행하여 백업 키 저장소를 삭제합니다. 비활성화되어 있으면 keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}" 명령을 실행하세요.

  10. chmod 0640 /opt/vmware/cloudusagemetering/platform/security/keystore 명령을 실행하여 새 키스토어 권한을 업데이트하고 사용량 측정기 VM 를 다시 시작합니다.

    호스트 네임 변경으로 인해 DNS 항목을 새 호스트 네임으로 업데이트하거나 없는 경우 추가해야 할 수 있습니다. OAuth 오류와 함께 로그인 페이지로 리디렉션되는 경우 사용량 측정기에 대한 기존 DNS 항목을 모두 지우고 다시 시도하세요.

  11. 재시작이 완료되면 웹 브라우저에서 사용량 측정기 URL 를 열어 업그레이드된 버전을 확인합니다.