업데이트 패키지를 사용하여 VMware Cloud Director 장치 업그레이드

업데이트 패키지를 사용하여 VMware Cloud Director 장치를 최신 버전으로 업그레이드하거나 VMware Cloud Director 장치에 패치를 적용할 수 있습니다.

VMware Cloud Director 장치 배포를 업그레이드하는 동안 VMware Cloud Director 서비스가 작동을 중지하고 다운타임이 발생할 수 있습니다. 다운타임은 각 VMware Cloud Director 장치를 업그레이드하고 VMware Cloud Director 데이터베이스 업그레이드 스크립트를 실행하는 데 필요한 시간에 따라 달라집니다. VMware Cloud Director 서버 그룹의 작업 셀 수는 마지막 VMware Cloud Director 장치에서 VMware Cloud Director 서비스를 중지할 때까지 줄어듭니다. VMware Cloud Director HTTP 끝점 앞에 올바르게 구성된 로드 밸런서는 중지된 셀에 대한 트래픽 라우팅을 중지해야 합니다.

모든 VMware Cloud Director 장치에 업그레이드를 적용하고 데이터베이스 업그레이드가 완료된 후에는 각각의 VMware Cloud Director 장치를 재부팅해야 합니다.

사전 요구 사항

기본 VMware Cloud Director 장치의 스냅샷을 생성합니다.

버전 10.1 이상에서 업그레이드하거나 패치를 적용할 때 기본 데이터베이스 서비스 장애가 발생하는 경우 자동 페일오버를 사용하도록 설정하는 경우, 업그레이드 중에 페일오버 모드를 Manual로 변경합니다. 업그레이드 후에는 페일오버 모드를 Automatic으로 설정할 수 있습니다. VMware Cloud Director 장치의 자동 페일오버의 내용을 참조하십시오.
데이터베이스 고가용성 클러스터의 기본 VMware Cloud Director 장치가 있는 vCenter Server 인스턴스에 로그인합니다.
기본 VMware Cloud Director 장치로 이동하여 해당 장치를 마우스 오른쪽 버튼으로 클릭한 다음 전원 > 게스트 OS 종료를 클릭합니다.
장치를 마우스 오른쪽 버튼으로 클릭하고 스냅샷 > 스냅샷 생성을 클릭합니다. 스냅샷의 이름과 설명(선택 사항)을 입력하고 확인을 클릭합니다.
VMware Cloud Director 장치를 마우스 오른쪽 버튼으로 클릭하고 전원 > 전원 켜기를 클릭합니다.
데이터베이스 고가용성 구성의 모든 노드가 정상 상태인지 확인합니다. VMware Cloud Director 장치 클러스터 상태 및 페일오버 모드 보기의 내용을 참조하십시오.
VMware Cloud Director 장치의 백업 절차를 숙지합니다. VMware Cloud Director 장치의 내장된 데이터베이스 백업의 내용을 참조하십시오.

프로시저

웹 브라우저에서 VMware Cloud Director 장치 인스턴스의 장치 관리 사용자 인터페이스에 로그인하여 기본 장치를 식별합니다(https://appliance_ip_address:5480).
기본 장치 이름을 기록해 둡니다. 대기 및 애플리케이션 셀 보다 먼저 기본 장치를 업그레이드해야 합니다. 데이터베이스를 백업할 때는 기본 장치를 사용해야 합니다.
클러스터의 모든 장치에서 다음 명령을 실행하여 VMware Cloud Director를 종료합니다.
```
/opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown
```
업그레이드 중인 장치에 업데이트 패키지를 다운로드합니다.

참고: 먼저 기본 장치를 업그레이드해야 합니다.
VMware Cloud Director는 이름이 VMware_Cloud_Director_v.v.v.v- nnnnnnnn_update. tar.gz 형식인 실행 파일로 배포되며, 여기서 v. v. v. v는 제품 버전을 나타내고 nnnnnnnn은 빌드 번호를 나타냅니다. 예: VMware_Cloud_Director_10.1.0.4424-14420378_update.tar.gz.
업데이트 패키지를 추출할 local-update-package 디렉토리를 생성합니다.
```
mkdir /tmp/local-update-package
```

새로 생성한 디렉토리에 업데이트 패키지를 추출합니다.

 tar -zxf VMware_Cloud_Director_v.v.v.v-nnnnnnnn_update.tar.gz \
				-C /tmp/local-update-package

local-update-package 디렉토리를 업데이트 저장소로 설정합니다.
```
vamicli	update --repo file:///tmp/local-update-package
```
업데이트를 확인하여 저장소를 올바르게 설정했는지 확인합니다.
```
vamicli update --check
```
업그레이드 릴리스가 사용 가능한 업데이트로 표시됩니다.
기본 또는 대기 장치 관리 UI를 사용하여 백업을 만듭니다.
애플리케이션 셀을 사용하여 백업을 수행할 수 없습니다.
사용 가능한 업그레이드를 적용합니다.
```
vamicli update --install latest
```
나머지 대기 및 애플리케이션 셀에서 3~7 단계와 9 단계를 반복합니다.
임의 장치에서 VMware Cloud Director 데이터베이스 upgrade 유틸리티를 실행합니다.
```
/opt/vmware/vcloud-director/bin/upgrade
```
각 VMware Cloud Director 장치를 재부팅합니다.
```
shutdown -r now
```

다음에 수행할 작업

업그레이드가 성공했는지 확인합니다.
- VMware Cloud Director Service Provider Admin Portal에 로그인합니다.
- VMware Cloud Director 장치 관리 UI에 로그인하고 모든 장치가 Healthy 상태로 나타나는지 확인합니다.
업그레이드 중에 로그에 인증서 변환 오류가 표시되지 않는지 확인합니다. 로그에 인증서 변환 오류가 있는 경우 VMware Cloud Director 장치를 백업할 수 없습니다. 오류가 표시되면 업그레이드를 다시 시도하지 말고 오류에 따라 변환 명령을 다시 실행하기 전에 수동으로 문제를 해결합니다.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates --convert
```
오류에 따라 다른 해결 방법이 있습니다. 예를 들면 다음과 같습니다.
- 인증서 변환 프로세스 중에 /opt/vmware/var/log/vami/updatecli.log에 다음 예외가 나타나면 KB 문서 88372를 참조하십시오.
```
 <JAVA_HOME>/lib/ext exists, extensions mechanism no longer supported; Use -classpath instead.
             .Error: Could not create the Java Virtual Machine.
              Error: A fatal exception has occurred. Program will exit. 
```
- /opt/vmware/var/log/vami/updatecli.log에 잘못된 키와 관련된 인증서 변환 프로세스의 오류가 있거나 실패 이유를 명시하지 않는 경우 가능한 해결 방법은 다음과 같습니다.
  - 준비된 .pem 및 .key 파일이 없으면 키 저장소 파일이 있는지 확인합니다. 키 저장소 파일의 위치는 global.properties 파일에서 찾을 수 있습니다.
  - VMware Cloud Director가 키 저장소 파일을 찾으면 keytool 유틸리티 또는 OpenSSL 도구를 사용하여 키 저장소에서 .pem 및 .key 파일을 추출합니다.
  - VMware Cloud Director가 키 저장소 파일을 찾지 못하면 인증서를 완전히 재구성합니다. 인증서 생성에 대해 자세히 알아보려면 VMware Cloud Director 장치의 SSL 인증서 생성 및 관리 항목을 참조하십시오.
  - 와일드카드 인증서와 관련된 기존 .pem 및 .key 파일이 있는 경우 노드의 기존 인증서를 와일드카드 인증서로 교체하려면 셀 관리 도구 인증서 명령을 사용합니다.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -j --cert /opt/vmware/vcloud-director/data/transfer/user.http.pem --key /opt/vmware/vcloud-director/data/transfer/user.http.key --key-password key_password
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -p --cert /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.pem --key /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.key --key-password key_password
```
업그레이드에 성공하면 VMware Cloud Director 장치의 스냅샷을 삭제할 수 있습니다.
업그레이드에 성공하지 못하면 VMware Cloud Director 장치를 업그레이드 전에 생성한 스냅샷으로 롤백할 수 있습니다. 업그레이드 실패 시 VMware Cloud Director 장치 롤백의 내용을 참조하십시오.