View a markdown version of this page

Wickr 임베디드 클러스터 설치 문제 해결 - Wickr Enterprise
일반 문제업그레이드 문제

이 가이드에서는 Wickr Enterprise에 대한 설명서를 제공합니다. AWS Wickr를 사용하는 경우 AWS Wickr 관리 안내서 또는 AWS Wickr 사용 설명서를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Wickr 임베디드 클러스터 설치 문제 해결

이러한 문제 해결 단계의 모든 인스턴스는 Wickr Embedded Cluster 설치를 실행하는 인스턴스에 대한 셸 액세스 권한이 있고 ./wickr-enterprise-ha shell 명령을 실행하여 Kubernetes 설치와 직접 상호 작용할 수 있다고 가정합니다.

일반 문제

클러스터 관리 화면에서 노드 추가 버튼 누락

에어갭 설치

에어갭을 설치하는 경우 Wickr Support에 문의하여이 동작을 수정하는 데 도움을 받으세요.

표준 설치

라이선스에 임베디드 클러스터 다중 노드 권한이 포함된 경우 라이선스 동기화를 수행하여 최신 버전을 가져옵니다. 확실하지 않거나이 권한이 없는 경우 Wickr Support에 문의하십시오.

라이선스 동기화를 수행하려면 다음 단계를 완료합니다.

  1. KOTS 제어판으로 이동합니다.

  2. 대시보드 페이지의 오른쪽 상단 영역에서 라이선스 섹션을 찾습니다.

  3. 이 섹션의 오른쪽 상단에는 동기화 라이선스 하이퍼링크가 표시됩니다. 하이퍼링크를 선택합니다.

  4. 라이선스가 동기화되면 UI가 업데이트되고 몇 초 전에 마지막으로 동기화된가 나타납니다.

  5. KOTS 대시보드 페이지의 버전 섹션에서 재배포를 선택합니다.

  6. 재배포가 완료되면 클러스터 관리로 돌아가 노드를 추가할 수 있습니다.

업그레이드 문제

클러스터 업그레이드 시 업그레이드 중단

업그레이드가 클러스터 업그레이드에 멈춘 경우 일부 포드가 적절하게 종료되지 않을 수 있습니다. 인스턴스에 로그온하고 ./wickr-enteprise-ha shell 명령을 사용하여 kubernetes 설치를 관리하기 위한 쉘 환경에 들어갑니다.

  1. 아직 실행 중인 포드를 식별합니다.

    kubectl -n kotsadm get pods | grep Running

  2. kubectl -n kotsadm delete pod name-of-running-pod

    참고

    실행 중인 포드 중 하나가 embedded-cluster-upgrade-XXXXXXXXXXXXXX-xxxxx kotsadm-xxxxxxx 또는 유사한 경우 업그레이드를 수행하는 데 필요하므로 삭제하지 마십시오.

  3. 실행 중인 포드가 남아 있지 않은지 확인합니다.

    kubectl -n kotsadm get pods | grep Running

이 절차에서는 클러스터 업그레이드가 Wickr 업그레이드로 진행되도록 허용해야 합니다.

클러스터 업그레이드 중에 애플리케이션이 업데이트되지 않아 새 버전을 배포할 수 없음

업그레이드 후에도 애플리케이션이 이전 버전을 유지하는 경우 새 버전이 일관되지 않은 상태일 수 있습니다.

Kubernetes 설치 레코드를 확인합니다.

  1. 설치 프로그램에서 Kubernetes 쉘을 엽니다.

    ./wickr-enterprise-ha shell

  2. 다음 kubectl 명령을 실행합니다.

    kubectl get installations

  3. 출력은 다음과 같습니다.

    
      [root@ip-172-31-6-72 ~]# kubectl get installations
NAME             STATE      INSTALLERVERSION   CREATEDAT              AGE
20251113170603   Obsolete   2.1.3+k8s-1.30     2025-11-13T17:06:05Z   22h
20251113180133   Failed     2.6.0+k8s-1.31     2025-11-13T18:01:37Z   21h

  4. 실패한 설치를 삭제합니다.

    kubectl delete installation 20251113180133

  5. KOTS 관리자 패널을 통해 업그레이드를 다시 실행해 봅니다.

로그 줄을 사용한 RabbitMQ 포드 실패 Error while waiting for Mnesia tables: {timeout_waiting_for_tables}

RabbitMQ 보안 암호와 스토리지가 동기화되지 않았습니다. 이는 일반적으로 여러 RabbitMQ 인스턴스가 실행되어 리더 선택 또는 쿼럼 오류가 발생할 때 발생합니다. 이 문제를 해결하려면 RabbitMQ 서비스와 해당 스토리지 볼륨을 삭제한 다음 재배포합니다.

장애가 발생한 RabbitMQ를 삭제하려면 다음 단계를 완료합니다.

  1. RabbitMQ 상태 저장 세트를 삭제합니다.

    kubectl -n kotsadm delete statefulset rabbitmq —cascade=orphan

  2. 나머지 RabbitMQ 포드를 삭제합니다. 실행 중인 RabbitMQ-X 포드가 여러 개 있는 경우이 명령을 여러 번 실행하여 추가 포드 이름에 맞게 RabbitMQ-X 값을 업데이트합니다.

    kubectl -n kotsadm delete pod rabbitmq-0

  3. 해당 PVCs. 실행 중인 포드가 여러 개 있는 경우이 명령을 여러 번 실행하여 data-RabbitMQ-X를 적절한 포드에 맞게 업데이트합니다.

    kubectl -n kotsadm delete pvc data-rabbitmq-0

  4. 남은 포드가 있는지 확인합니다. 성공하면 아무것도 출력하지 않습니다.

    kubectl -n kotsadm get pods|grep -i rabbitmq

  5. 나머지 PVCs가 있는지 확인합니다. 성공하면 아무것도 출력하지 않습니다.

    kubectl -n kotsadm get pvc|grep -i rabbitmq

  6. KOTS 관리 패널을 통해 재배포합니다.

자세한 문제 해결 정보는 문제 해결을 참조하세요.