위치 오류 메시지

기본적으로, IBM Cloud Satellite는 위치의 상태를 모니터하고 자동으로 문제를 해결하려 시도합니다. 자동으로 해결할 수 없는 문제에 대해서는 제공된 상태 정보를 검토하여 위치를 디버그할 수 있습니다.

오류 메시지 및 로그 검토

콘솔에서 위치를 보거나 CLI에서 위치를 나열하고 상태를 검토하십시오. 상태가 비정상인 경우에는 다음 단계로 진행하십시오. 자세한 정보는 위치 상태 보기를 참조하십시오.

ibmcloud sat location ls

출력 예

Name         ID                     Status            Ready   Created      Hosts (used/total)   Managed From   
Port-North   aaaaa1a11aaaaaa111aa   action required   no      6 days ago   3 / 5                Washington DC

사용자 위치에 대한 세부사항을 찾고 상태, 배치 준비 및 메시지 섹션을 검토하십시오. 콘솔에서는 위치를 클릭하고 위치 이름 및 상태가 있는 제목의 도구 팁 위로 마우스 커서를 이동할 수 있습니다.

ibmcloud sat location get --location <location_name_or_ID>

출력 예:

Name:                           Port-NewYork   
ID:                             aaaaa1a11aaaaaa111aa   
Created:                        2020-06-05 13:50:58 -0400 (6 days ago)   
Creator:                        name@email.com   
Managed From:                   Washington DC   
State:                          action required   
Ready for deployments:          no   
Message:                        R0015: Could not assign hosts because no hosts are available. Attach more hosts to the location and try again. For more information, see the docs: 'http://ibm.biz/sat-loc'

IBM Cloud Logs 를 설정하여 Satellite 위치 로그를 검토하면 오류 메시지와 영향을 받는 구성 요소에 대한 자세한 정보를 확인할 수 있습니다.
위치 상태 및 메시지에서 문제를 해결하기 위한 단계를 검토하십시오. 위치 상태에 대한 설명은 Red Hat OpenShift on IBM Cloud 문서에서 클러스터 상태 를 참조하십시오. 위치 메시지에 대한 설명은 다음 섹션을 검토하십시오. 위치 상태가 warning 또는 critical 이고 위치가 배치 준비가 된 경우 지원 티켓을 여십시오.

R0001: 위치 준비됨

위치 메시지: The Satellite location is ready for operations.
해결 단계: Satellite 위치에 대한 위험 경보가 없으며 위치 제어 플레인의 IBM 모니터링 컴포넌트가 위치의 상태를 모니터하고 있습니다. 위치에 있는 리소스(예: 호스트)의 상태를 개선하기 위해 취할 수 있는 조치에 대한 몇 가지 경고 메시지는 여전히 표시될 수 있습니다.

R0002, R0018, R0020, R0029, R0037, R0039, R0042: 위치 정보가 준비될 때까지 기다려 주세요

위치 메시지: R0002: Satellite 위치에 문제가 있습니다. IBM Cloud 지원 센터에서 이 문제를 해결하기 위해 작업 중입니다. 나중에 다시 확인하십시오.; R0018: Satellite가 복구하려고 시도하는 중입니다.; R0020: Satellite가 복구 조치를 완료하는 동안 기다리십시오.; R0029: 복구 조치가 시작되었습니다.; R0037: Satellite 위치에 실패 상태의 클러스터가 있습니다. IBM Cloud 지원 센터에서 이 문제를 해결하기 위해 작업 중입니다. 나중에 다시 확인하십시오.; R0039: Satellite 위치 제어 플레인이 현재 비정상 상태입니다. IBM Cloud 지원 센터에서 이 문제를 해결하기 위해 작업 중입니다. 나중에 다시 확인하십시오.; R0042: IBM Cloud 지원 센터에서 링크 API 실패를 해결하는 중입니다. 나중에 다시 확인하십시오. If this issue persists, raise a support case.
해결 단계: 나중에 문제가 해결되었는지 확인하십시오. 문제가 한동안 지속되는 경우에는 지원 케이스를 열 수 있습니다.

문제에 대한 자세한 내용을 확인하려면, Satellite 위치에 대해 IBM Cloud Logs 를 설정하십시오.

IBM Cloud Logs 위치 플랫폼 로그의 Satellite를 설정하십시오.
권한 오류로 인해 실패한 API 메소드와 같은 자세한 정보는 플랫폼 로그에서 오류 코드를 검색하십시오.
세부사항이 권한 오류를 표시하는 경우 다음을 수행하십시오.
1. 계정 관리자로서 IBM Cloud CLI에 로그인하여 위치가 있는 리소스 그룹 및 지역을 대상으로 지정하십시오.
```
    ibmcloud login -g <resource_group> -r <region>
    ```
2. 권한에 사용되는 API 키를 재설정하십시오.
```sh {: pre}
    ibmcloud ks api-key reset
    ```
```

R0009: 복구할 수 없음

위치 메시지: R0009: Satellite가 문제를 복구할 수 없습니다.
해결 단계: Satellite가 자동으로 문제를 해결하려 시도했으나 실패했습니다. 위치에 호스트를 추가하는 등과 같은 추가적인 문제 해결을 위해 후속 메시지를 검토하십시오. 문제가 한동안 지속되는 경우에는 지원 케이스를 열 수 있습니다.

R0010, R0030, R0031, R0032: 제어 플레인에 호스트가 필요함

위치 메시지: R0010: 위치 제어 플레인에 더 많은 호스트를 지정하거나 비정상 호스트를 교체하십시오.; R0030: Satellite 위치 제어 플레인의 구역이 곧 위험 용량에 도달합니다. If critical capacity is reached, you cannot add more clusters to location. Add more hosts to the control plane zone, or replace unhealthy hosts.; R0031: Satellite 위치 제어 플레인의 구역이 곧 경고 용량에 도달합니다. Add more hosts to the control plane zone, or replace unhealthy hosts.; R0032: 3개의 구역 모두에 걸쳐 제어 플레인에 호스트를 수동으로 지정하십시오.
해결 단계: 위치에 Satellite가 위치 제어 플레인에 자동으로 지정할 수 있는 사용 가능한 호스트가 없으며, 용량 한계가 가까워지고 있을 수 있습니다. 다음 옵션 중에서 선택할 수 있습니다.

위치 제어 플레인에 추가 호스트를 연결하고 지정합니다. 위치 제어 플레인을 스케일링 업할 때는 항상 3의 배수로 스케일링해야 하며 구역 전체에 호스트를 고르게 지정해야 한다는 점을 명심하십시오.
호스트를 제거하고 다시 연결하십시오.

R0011, R0040, R0041: 제어 플레인 호스트 문제

위치 메시지

R0011: Satellite 위치에 대한 모든 호스트가 정상 상태인지 확인하십시오. If you still have issues, contact IBM Cloud Support and include your Satellite location ID.

R0040: Satellite 위치 데이터 플레인이 현재 비정상 상태입니다. To debug the host, see 'http://ibm.biz/sat-host-debug'. 여전히 문제가 있는 경우 IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.

R0041: Satellite 위치 제어 플레인 호스트에서 알 수 없는 문제가 발견되었습니다. Ensure that hosts meet the minimum requirements, http://ibm.biz/sat-host-reqs. 여전히 문제가 있는 경우 IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.

해결 단계

호스트의 상태를 확인하십시오. ibmcloud sat host ls --location <location_name_or_ID>
호스트가 없는 경우에는 위치에 호스트를 연결하십시오.
위치 제어 플레인 오퍼레이션을 실행하기 위해 위치의 인프라 클러스터에 6개 이상의 호스트(총 3개 구역에서 구역당 2개 호스트)가 지정되도록 하십시오.
호스트에 상태가 없으며 현재 지정되어 있지 않은 경우에는 호스트 시스템에 로그인하여 디버그하십시오.
호스트 상태를 검토하여 호스트 문제를 해결하십시오.

R0012: 호스트가 3개 구역 모두에 있어야 함

위치 메시지

R0012: 위치 제어 플레인의 3개 구역 모두에 호스트가 없습니다. Add available hosts to your location for the control plane.

해결 단계

제어 플레인에 방금 호스트를 지정한 경우에는 부트스트랩 프로세스가 완료될 때까지 기다리십시오. 그렇지 않은 경우에는 제어 플레인 오퍼레이션을 실행하기 위해 위치 자체의 세 구역 각각에 하나 이상의 호스트를 지정하십시오.

3개 구역 각각에 2개 이상의 호스트를 지정한 경우에는 호스트의 CPU 및 메모리 크기를 확인하십시오. 호스트에는 최소한 4개의 vCPU와 16GB의 메모리가 있어야 합니다.
구역당 2개 이상의 호스트를 지정한 경우에는 호스트가 운영 체제 및 네트워킹 구성과 같이 Satellite에서 사용하기 위한 최소 요구사항을 충족하는지 확인하십시오.
3개 구역 각각에 2개 이상의 호스트를 지정했으나 부트스트랩 프로세스가 실패한 경우에는 호스트 시스템에 로그인하여 디버그하십시오.

R0013: 구역 사용 불가능

위치 메시지

R0013: 위치 제어 플레인의 구역을 사용할 수 없습니다. Attach more hosts to the location and assign the hosts to the zone, or replace unhealthy hosts.

해결 단계

제어 플레인 오퍼레이션을 실행하기 위해 위치 자체의 3개 구역 각각에 2개 이상의 호스트를 지정하십시오. 3개 구역 각각에 2개 이상의 호스트를 지정한 경우에는 다음 단계를 수행하십시오.

호스트의 CPU 및 메모리 크기를 확인하십시오. 호스트에는 최소한 4개의 vCPU와 16GB의 메모리가 있어야 합니다.
호스트가 운영 체제 및 네트워킹 구성과 같이 Satellite에서 사용하기 위한 최소 요구사항을 충족하는지 확인하십시오.
호스트 시스템에 로그인하여 디버그하십시오.
호스트를 제거하고 다시 연결하십시오. 호스트를 제거하면 해당 호스트가 위치 제어 플레인에서 지정 해제되며 다른 호스트를 구역에 지정해야 합니다.

R0014: 제어 플레인에 대한 DNS 레코드

위치 메시지

R0014: Satellite 위치에 위치 제어 플레인에 대한 로드 밸런싱 요청의 DNS 레코드가 있는지 확인하십시오.

해결 단계

ibmcloud sat host ls --location <location_ID_or_name>을 실행하여 Satellite 제어 플레인에 있는 모든 호스트가 assigned 상태(State) 및 Ready **상태(Status)**를 표시하는지 확인하십시오.
모든 호스트의 상태(State)와 상태(Status)가 올바른 경우에는 위치에 대한 DNS 레코드가 아직 작성되지 않은 것입니다. 이 프로세스를 완료하는 데는 모든 호스트가 위치에 지정된 후 최대 30분이 소요될 수 있습니다.
하나 이상의 호스트가 올바른지 않은 상태(State) 또는 상태(Status)를 표시하는 경우에는 호스트 상태 디버깅을 참조하십시오.

R0015, R0016: 호스트 문제

위치 메시지: R0015: 사용 가능한 호스트가 없으므로 호스트를 지정할 수 없습니다. Attach more hosts to the location and try again. For more information, see the docs: 'http://ibm.biz/sat-loc'; R0016: 호스트를 지정한 후 예기치 않은 오류가 발생했습니다. To debug the host, see 'http://ibm.biz/sat-host-debug'. If you still have issues, contact IBM Cloud Support and include your Satellite location ID.
해결 단계: 위치에 추가 호스트를 연결하십시오. 연결한 호스트가 사용 가능으로 표시되지 않는 경우에는 호스트 상태 디버깅을 참조하십시오.

R0023, R0101: 위치가 준비될 때까지 대기

위치 메시지: R0023: Satellite 가 위치 제어 플레인을 설정하는 동안 잠시 기다려 주십시오.; R0101: Satellite 의 해당 위치에서는 작업 도중 클러스터가 발생하고 있습니다. Wait for them to finish and check back later.
해결 단계: 위치 제어 플레인이 설정을 완료할 때까지 대기한 후 나중에 다시 확인하십시오.

R0024, R0025: 클러스터 문제

위치 메시지

R0024: Satellite 위치에 경고 상태의 Red Hat OpenShift 클러스터가 있습니다.

R0025: Satellite 위치에 위험 상태의 Red Hat OpenShift 클러스터가 있습니다.

해결 단계

호스트 용량에 대한 메시지와 같은, 또 다른 메시지가 리턴되지 않는지 기다리십시오.
호스트 메시지가 리턴되는 경우에는 호스트 디버깅을 수행해 보십시오.
추가 메시지가 리턴되지 않으면 Red Hat OpenShift on IBM Cloud 클러스터 디버깅을 시도하십시오.

R0026: 호스트 디스크 공간

위치 메시지

R0026: 위치 제어 플레인의 호스트에 디스크 공간이 부족합니다. 위치 제어 플레인에 더 많은 호스트를 지정하거나 디스크 공간 문제가 있는 호스트를 다시 로드하십시오.

해결 단계

ibmcloud sat host ls --location <location_name_or_ID> | grep infrastructure를 실행하여 제어 플레인에 지정된 호스트를 나열하십시오.
ibmcloud sat host get --host <host_ID> --location <location_name_or_ID>를 실행하여 호스트의 세부사항을 확인하십시오.
호스트의 인프라 제공자에서 호스트 시스템의 디스크 공간을 확인하십시오. 각 호스트가 최소 요구사항을 충족하는지 확인하십시오. 호스트를 제거하고 다시 연결하십시오.
호스트 디버깅 및 다시 연결로 문제가 해결되지 않는 경우에는 위치 제어 플레인을 계속해서 실행하기 위해 추가 컴퓨팅 리소스가 필요한 것입니다. 위치 제어 플레인에 추가 호스트를 지정하십시오.

R0033, R0034, R0035: 제어 플레인 용량 문제

위치 메시지

R0033: 위치 제어 플레인의 호스트에 심각한 메모리 사용량 문제가 있습니다. Add more hosts to the location control plane and wait for the location to return to normal.

R0034: 위치 제어 플레인의 호스트에 심각한 CPU 사용량 문제가 있습니다. Add more hosts to the location control plane and wait for the location to return to normal.

R0035: 위치 제어 플레인이 최대 용량으로 실행 중이며 더 이상의 워크로드를 지원할 수 없습니다. Add hosts to each zone and wait for the location to return to normal.

해결 단계

각 구역에서 호스트의 CPU 및 메모리 크기를 확인하십시오.
- 한 구역에 있는 모든 호스트에서 최소 3개 이상의 CPU 총계를 사용할 수 있어야 합니다.
- 한 구역에 있는 모든 호스트에서 최소 4GB 이상의 메모리 총계를 사용할 수 있어야 합니다.
위치에 3개의 추가 호스트를 연결하십시오.
세 구역 각각에 하나 이상의 호스트를 지정하여 제어 플레인 오퍼레이션을 위한 용량을 추가하십시오. 위치 제어 플레인을 스케일링 업할 때는 항상 3의 배수로 스케일링해야 하며 구역 전체에 호스트를 고르게 지정해야 한다는 점을 명심하십시오.
ibmcloud ks cluster master refresh --cluster <cluster-id> 명령을 실행하여 클러스터를 새로 고칩니다.

R0036: 위치 하위 도메인 트래픽 라우팅

위치 메시지: R0036: 위치 하위 도메인이 제어 플레인 호스트로 트래픽을 올바르게 라우팅하지 않습니다. ibmcloud sat location dns 명령을 사용하여 위치 하위 도메인이 제어 플레인 호스트에 대한 올바른 IP 주소로 등록되었는지 확인하십시오.
해결 단계: 위치 하위 도메인이 제어 플레인 호스트로 트래픽을 라우팅하지 않는 이유는 무엇입니까?의 내용을 참조하십시오.

R0038, R0101: 위치에 진행 중인 클러스터 조작이 있습니다.

위치 메시지: R0038: Satellite 위치에 작업 중인 클러스터가 있습니다. Wait for them to finish and check back later.; R0101: Satellite 의 해당 위치에서는 작업 도중 클러스터가 발생하고 있습니다. Wait for them to finish and check back later.
해결 단계: 클러스터가 해당 조작을 완료할 때까지 대기한 후 나중에 다시 확인하십시오.

R0043: 계층 3 연결

위치 메시지: R0043: 위치가 다음 요구사항을 충족하지 않습니다. 호스트에는 호스트 전체에서 모든 포트에 대한 TCP/UDP/ICMP 계층 3 연결이 있어야 합니다. 여전히 문제가 있는 경우 IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.
해결 단계: 호스트에는 호스트 전체의 모든 포트에 대한 TCP/UDP/ICMP 계층 3 연결이 있어야 합니다. 특정 포트에 대한 액세스를 차단하는 것은 호스트 전체의 통신을 차단할 수 있으므로 수행할 수 없습니다. 호스트 네트워크 요구사항을 검토하고 인프라 제공자의 호스트에서 포트를 차단 해제하십시오. 이 오류는 또한 호스트에 필수 RHEL 패키지가 설치되어 있지 않거나 필요한 CPU, 메모리, 디스크 공간 및 방화벽 포트가 확보되지 않음을 의미할 수 있습니다. 호스트가 모든 요구사항을 충족하는지 확인한 후 플랫폼 로그를 보십시오.

호스트 전체의 모든 포트에 대해 TCP/UDP/ICMP 계층 3 연결을 테스트하려면 다음을 수행하십시오.

사용자 위치에 연결되어 있지만 리소스에 지정되지 않은 호스트에 SSH로 연결하십시오.

호스트를 클러스터에 지정하지 않았거나, 지정이 실패한 경우에만 SSH로 시스템에 연결할 수 있습니다. 그렇지 않은 경우에는 보안을 위해 Satellite가 SSH를 통해 호스트에 로그인하는 기능을 사용 안함으로 설정합니다. 호스트를 제거한 후 운영 체제를 다시 로드하여 시스템에 SSH로 연결하는 기능을 복원할 수 있습니다.
TCP 연결을 확인하려면 netcat이 포트 10250의 다른 모든 호스트로부터 응답을 수신하는지 확인하십시오. 오퍼레이션이 제한시간을 초과하면 호스트 네트워크 요구사항을 검토하여 인프라 제공자의 호스트에서 포트를 차단 해제하십시오.
```
nc -zv <host_IP> 10250
```
ICMP 연결을 확인하려면 다른 모든 호스트에 대해 ping이 성공했는지 확인하십시오. 사용자 위치에 연결된 호스트의 각 IP 주소에 대해 이 단계를 반복하십시오. Ping 제한시간이 초과되면 호스트 네트워크 요구사항을 검토하여 인프라 제공자의 호스트에서 포트를 차단 해제하십시오.
```
ping <host_IP>
```
TCP 및 ICMP 연결 검사에서 문제가 발생하지 않으면 한 번에 하나의 호스트를 재부팅하여 모든 제어 플레인 호스트를 재부팅하십시오. 제어 플레인 호스트를 동시에 재부팅하지 마십시오. 그러면 제어 플레인 호스트에서 etcd가 실행되지 않습니다.

R0044: DNS 문제

위치 메시지: R0044: 하나 이상의 호스트에서 DNS 문제가 발견되었습니다. Verify that your DNS solution is working as expected. 여전히 문제가 있는 경우 IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.
해결 단계: 위치에 있는 하나 이상의 호스트가 DNS 조회를 해석할 수 없거나 검색 도메인이 예기치 않은 문제를 발생시키고 있습니다. DNS 솔루션이 기대한 대로 작동하고 있으며 모든 호스트가 호스트 네트워크 요구사항을 충족하는지 확인하십시오.

DNS 분석을 테스트하려면 다음을 수행하십시오.

사용자 위치에 연결되어 있지만 리소스에 지정되지 않은 호스트에 SSH로 연결하십시오.

호스트를 클러스터에 지정하지 않았거나, 지정이 실패한 경우에만 SSH로 시스템에 연결할 수 있습니다. 그렇지 않은 경우에는 보안을 위해 Satellite가 SSH를 통해 호스트에 로그인하는 기능을 사용 안함으로 설정합니다. 호스트를 제거한 후 운영 체제를 다시 로드하여 시스템에 SSH로 연결하는 기능을 복원할 수 있습니다.
DNS 분석이 제대로 작동하는지 확인하십시오.
```
dig +short +timeout=5 +nocookie cloud.ibm.com
```
DNS 구성에 추가된 검색 도메인이 있는 localhost가 아무것도 분석하지 않거나 127.0.0.1로만 분석하는지 확인하십시오. 각 호스트에 대한 DNS 분석을 관리하는 /etc/resolv.conf 파일에서 search ibm.com과 같은 다중 검색 도메인이 나열될 수 있습니다. 각 호스트의 Calico Typha 팟(Pod)은 localhost 분석을 사용하는 상태 검사를 실행합니다. 그러나 상태 검사가 localhost를 분석하려고 시도할 때 일부 검색 도메인이 추가되어 상태 검사가 실패할 수 있습니다. 상태 검사가 올바르게 실행될 수 있는지 확인하려면 나열된 검색 도메인이 127.0.0.1에 추가될 때 localhost IP 주소 이외의 값으로 분석되지 않는지 확인하십시오.

R0045: 호스트 읽기 전용 파일 시스템 문제

위치 메시지

R0045: 하나 이상의 호스트에서 읽기 전용 파일 시스템이 발견되었습니다. Replace the affected host(s).

해결 단계

영향을 받는 호스트에 대한 자세한 정보를 얻으려면 IBM Cloud Logs 위치 플랫폼 로그의 Satellite 설정을 참조하십시오.
영향을 받은 호스트를 제거하고 새 호스트를 다시 연결하십시오.
여전히 문제가 있으면 지원 케이스를 열고 Satellite 위치 ID를 포함시키십시오.

R0046: NTP 문제

위치 메시지: R0046: 하나 이상의 호스트에서 NTP 문제가 발견되었습니다. Verify that your NTP solution is working as expected.
해결 단계: 사용자 위치에 있는 하나 이상의 호스트에 해결해야 하는 NTP(Network Time Protocol) 문제가 있습니다.

호스트에서 NTP를 테스트하려면 다음을 수행하십시오.

사용자 위치에 연결되어 있지만 리소스에 지정되지 않은 호스트에 SSH로 연결하십시오.

호스트를 클러스터에 지정하지 않았거나, 지정이 실패한 경우에만 SSH로 시스템에 연결할 수 있습니다. 그렇지 않은 경우에는 보안을 위해 Satellite가 SSH를 통해 호스트에 로그인하는 기능을 사용 안함으로 설정합니다. 호스트를 제거한 후 운영 체제를 다시 로드하여 시스템에 SSH로 연결하는 기능을 복원할 수 있습니다.
호스트에서 보고한 시간이 실제 시간과 3분 이상 차이가 나지 없는지 확인하십시오. 시간이 3분 이상 차이가 나는 경우 인프라 제공자와 NTP 솔루션을 확인하십시오.
```
date +%s
```
이 단계를 반복하여 NTP 문제가 있는 호스트를 식별하십시오.

R0047: 위치 상태 검사

위치 메시지: R0047: IBM Cloud가 상태 확인 엔드포인트를 사용하여 위치의 상태를 확인할 수 없습니다.
해결 단계: IBM Cloud에서 내 위치의 상태를 확인할 수 없는 이유는 무엇입니까?의 내용을 참조하십시오.

R0048: etcd 백업 실패

위치 메시지: R0048: 전날에 사용자 위치의 클러스터에 대한 etcd 백업을 완료하지 못했습니다.
해결 단계: etcd 데이터는 Satellite 위치 제어 플레인에서 IBM Cloud Object Storage 인스턴스의 버킷으로 8시간마다 백업됩니다. 이 백업이 24시간 동안 3회 연속으로 실패하는 경우, Object Storage 버킷이나 서비스 인스턴스에 문제가 있거나, Satellite 위치와 Object Storage 인스턴스 간의 연결에 문제가 있는 것입니다.

문제점이 있는 위치를 판별하려면 다음을 수행하십시오.

위치 제어 플레인에 지정한 호스트가 위치를 관리하는 IBM Cloud Object Storage 지역의 IBM Cloud 엔드포인트에 액세스할 수 있는지 확인하십시오. 예를 들어, 호스트 방화벽에서 제어 평면 호스트로부터 다음 엔드포인트로의 아웃바운드 연결을 허용해야 합니다.

호스트가 Object Storage 엔드포인트에 대한 아웃바운드 연결에 필요합니다
지역	Object Storage 엔드포인트
`wdc`	`s3.us.cloud-object-storage.appdomain.cloud`
`lon`	`s3.eu.cloud-object-storage.appdomain.cloud`

etcd 데이터를 백업하는 Object Storage 서비스 인스턴스와 버킷이 사용 가능하고 삭제되지 않았는지 확인하십시오.
1. Satellite 콘솔에서 위치 이름을 클릭하십시오.
2. 위치 개요의 세부사항 절에서 Object Storage 버킷의 이름을 복사하십시오.
3. IBM Cloud 콘솔에서 IBM Cloud 리소스 목록 으로 이동합니다.
4. 스토리지 행을 펼치십시오.
5. 버킷을 작성했던 Object Storage 인스턴스를 찾으십시오. 위치 생성 시 버킷 이름을 지정하지 않았다면, 해당 위치에 대해 자동 생성된 버킷을 찾을 때까지 각 Object Storage 인스턴스를 확인해 보십시오.
6. 인스턴스 이름을 클릭하십시오. 버킷 목록 페이지가 열립니다.
7. 제어 플레인 etcd 백업의 버킷이 존재하는지 확인하십시오.
8. 서비스 인스턴스 또는 버킷이 삭제된 경우 지원 케이스를 열고 Satellite 위치 ID를 포함시키십시오.
제어 플레인 호스트가 Object Storage 엔드포인트에 도달하고 Object Storage 서비스 인스턴스 및 버킷이 존재하는 경우, 지원 케이스를 열어 백업 실패를 탐색하고 Satellite 위치 ID를 포함시키십시오.

R0049: Satellite Link IAM API 키 문제

위치 메시지

Link 터널 클라이언트에서 인증 문제가 발생하고 있습니다. IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.

이 오류는 해당 위치가 속한 리전 또는 리소스 그룹에 설정된 IAM API 키가 Satellite 또는 Kubernetes Service 에서 요구하는 권한을 가지고 있지 않기 때문에 발생하며, 대개 API 키 소유자의 권한이 변경되었거나 API 소유자가 더 이상 해당 계정에 속해 있지 않기 때문입니다.

해결 단계

Satellite 위치에 Red Hat OpenShift 클러스터가 있고, 귀하가 계정 소유자이거나 모든 Satellite 구성 요소에 대한 관리자 권한을 가진 사용자라면, API 키를 재설정하여 이 문제를 해결할 수 있습니다. API 키를 재설정하면 이전 키가 삭제됩니다. 다른 서비스가 이 API 키를 사용하고 있는지 확인하십시오.

IBM Cloud에 로그인하십시오. ibmcloud login.
위치가 관리되는 지역을 대상으로 지정하십시오. ibmcloud target -r <region>
위치가 있는 리소스 그룹을 대상으로 지정하십시오. ibmcloud target -g <resource-group>
해당 지역 또는 리소스 그룹에 대한 IAM API 키를 재설정하십시오. ibmcloud ks api-key reset --region <region>
API 키가 설정되었는지 검토하십시오. ibmcloud ks api-key info --cluster <roks_cluster_in_location>
지원 케이스를 열고 새로 고칠 클러스터가 포함된 위치를 요청하십시오. ibmcloud sat location ls 명령을 실행하여 찾을 수 있는 위치 ID를 포함하십시오.

사용자의 위치에 클러스터가 없는 경우 API키를 직접 재설정할 수 없습니다. 대신 지원 케이스를 열고 새로 고칠 위치를 요청하십시오. ibmcloud sat location ls 명령을 실행하여 찾을 수 있는 위치 ID를 포함하십시오.

R0050, R0051: Satellite Link 커넥터 문제

위치 메시지: Link 터널 클라이언트에서 토큰 인증 문제가 발생하고 있습니다. IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.; Link 터널 클라이언트가 위치 ID를 가져올 수 없습니다. IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.
해결 단계: 지원 케이스를 열고 Satellite 위치 ID를 포함하십시오.

R0052: Ingress 인증서 생성 문제

위치 메시지: 위치 엔드포인트에 대한 Ingress 인증서가 생성되지 않았습니다.
해결 단계: IBM Cloud 지원 센터에서 알림을 받았으며 이 문제를 해결하기 위해 작업 중입니다. 나중에 다시 시도하십시오.

R0056: 팟(Pod) 상태가 `terminating`에서 멈춤

위치 메시지: 팟(Pod)이 한 시간 이상 위치 제어 플레인 노드에서 종료 상태로 멈춰 있습니다.
해결 단계: 한 시간 이상 종료 상태로 남아 있는 팟(Pod)은 위치 제어 플레인의 상태가 정상이 아님을 나타냅니다. 위치 제어 플레인 호스트를 다시 시작하고 문제점이 해결되었는지 확인하십시오. 문제가 계속되면 단계에 따라 위치 제어 플레인 호스트를 교체하십시오.

제어 플레인 호스트를 업데이트하거나 대체하는 경우에는 동시에 여러 호스트를 지정하거나 제거하지 마십시오. 이렇게 하면 제어 플레인에 문제가 발생할 수 있습니다. 다른 호스트를 지정하거나 제거하기 전에 호스트 지정 또는 제거가 완료될 때까지 기다려야 합니다. 서비스 중단 가능성을 방지하려면, 호스트를 제거하기 전에 제어 플레인에 추가 호스트를 연결하고 할당해 두십시오.

제어 플레인에서 제거할 각 호스트에 대해 추가 호스트를 연결하십시오.
연결된 호스트를 지정 하십시오. 반드시 한 번에 하나의 호스트만 지정하고, 다른 호스트를 지정하기 전에 각 지정이 완료되도록 하십시오.
Satellite 위치에서 원래 호스트를 제거하십시오. 반드시 한 번에 하나의 호스트만 제거하고, 다른 호스트를 제거하기 전에 각 제거가 완료되도록 하십시오.

영향을 받는 구성 요소에 대한 자세한 내용은 IBM Cloud Logs 을 설정하고 R0056 오류 로그를 검토하세요.

R0057: IAM에 대한 아웃바운드 트래픽이 실패함

위치 메시지: IBM Cloud IAM에 대한 아웃바운드 트래픽이 실패했습니다. 모든 호스트 요구사항이 충족되었는지 확인하려면 호스트 시스템 요구사항을 참조하십시오. 자세한 정보는 IBM Cloud 플랫폼 로그에서 확인할 수 있습니다. 문제가 지속되면 IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.
해결 단계: 상태를 확인하고 호스트 시스템 요구사항이 충족되었는지 확인하십시오.

다음 명령을 실행하여 상태를 확인하십시오.
```
curl https://iam.cloud.ibm.com/healthz
```
이전 단계의 출력에 실패가 표시되면 호스트가 모든 시스템 요구사항을 충족하는지 확인하십시오.
시스템 요구 사항을 모두 충족했음에도 문제가 지속된다면, 지원 요청을 제출하고 Satellite 의 위치 ID를 기재해 주십시오. ibmcloud sat location ls 명령을 실행하여 위치 ID를 찾을 수 있습니다.

영향을 받는 구성 요소에 대한 자세한 내용은 IBM Cloud Logs 을 설정하고 R0057 오류 로그를 검토하세요.

R0058: DNS 등록이 실패함

위치 메시지: 이 이름을 가진 위치가 최근에 삭제되었습니다. 최근에 삭제된 위치의 위치 이름을 재사용하려는 경우에는 DNS 등록을 완료하는 데 1주일이 소요될 수 있습니다.
해결 단계: 이 위치 이름을 재사용할 필요가 없는 경우에는 이 위치를 삭제하고 고유한 이름을 가진 위치를 작성하십시오. 이 문제가 지속되면 지원 케이스를 열고 Satellite 위치 ID를 포함시키십시오.

R0059: IBM Cloud Container Registry에 대한 아웃바운드 트래픽이 실패했습니다.

위치 메시지: IBM Cloud Container Registry 으로의 아웃바운드 트래픽이 실패하고 있습니다. 모든 호스트 요구사항이 충족되는지 확인하려면 호스트 시스템 요구사항 을 참조하십시오. 자세한 정보는 IBM Cloud 플랫폼 로그에서 확인할 수 있습니다. 문제가 지속되면 IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.
해결 단계: 상태를 확인하고 호스트 시스템 요구사항이 충족되었는지 확인하십시오.

다음 명령을 실행하여 상태를 확인하십시오.
```
curl https://iam.cloud.ibm.com/healthz
```
이전 단계의 출력에 실패가 표시되면 호스트가 모든 시스템 요구사항을 충족하는지 확인하십시오.
시스템 요구 사항을 모두 충족했음에도 문제가 지속된다면, 지원 요청을 제출하고 Satellite 의 위치 ID를 기재해 주십시오. ibmcloud sat location ls 명령을 실행하여 위치 ID를 찾을 수 있습니다.

영향을 받는 구성 요소에 대한 자세한 내용은 IBM Cloud Logs 을 설정하고 R0059 오류 로그를 검토하세요.

R0061: IBM Cloud에서 Satellite 클러스터 API 서버에 연결할 수 없습니다.

위치 메시지: Satellite 클러스터 API 서버는 IBM Cloud에서 연결할 수 없습니다. 자세한 내용은 ‘ IBM Cloud 플랫폼 로그’를 참조하십시오. 문제가 지속되면 IBM Cloud 지원 센터에 문의하고 Satellite 위치 ID를 포함시키십시오.
해결 단계: 이 문제를 해결하려면 다음 단계를 따르십시오.

자세한 정보는 IBM Cloud 플랫폼 로그를 확인하십시오. 자세한 내용은 IBM Cloud Logs 설정 및 R0061 오류 로그 검토를 참조하세요.
호스트가 모든 시스템 요구사항 을 충족하는지 확인하십시오. 특히 IBM 및 링크 터널 클라이언트에 연결하기 위한 아웃바운드 연결의 " 인증서 표시 표시 를 확인하십시오.
시스템 요구 사항을 모두 충족했음에도 문제가 지속된다면, 지원 요청을 제출하고 Satellite 의 위치 ID를 기재해 주십시오. ibmcloud sat location ls 명령을 실행하여 위치 ID를 찾을 수 있습니다.

위치 오류 메시지

위치 오류 메시지

오류 메시지 및 로그 검토

R0001: 위치 준비됨

R0002, R0018, R0020, R0029, R0037, R0039, R0042: 위치 정보가 준비될 때까지 기다려 주세요

R0009: 복구할 수 없음

R0010, R0030, R0031, R0032: 제어 플레인에 호스트가 필요함

R0011, R0040, R0041: 제어 플레인 호스트 문제

R0012: 호스트가 3개 구역 모두에 있어야 함

R0013: 구역 사용 불가능

R0014: 제어 플레인에 대한 DNS 레코드

R0015, R0016: 호스트 문제

R0023, R0101: 위치가 준비될 때까지 대기

R0024, R0025: 클러스터 문제

R0026: 호스트 디스크 공간

R0033, R0034, R0035: 제어 플레인 용량 문제

R0036: 위치 하위 도메인 트래픽 라우팅

R0038, R0101: 위치에 진행 중인 클러스터 조작이 있습니다.

R0043: 계층 3 연결

R0044: DNS 문제

R0045: 호스트 읽기 전용 파일 시스템 문제

R0046: NTP 문제

R0047: 위치 상태 검사

R0048: etcd 백업 실패

R0049: Satellite Link IAM API 키 문제

R0050, R0051: Satellite Link 커넥터 문제

R0052: Ingress 인증서 생성 문제

R0056: 팟(Pod) 상태가 terminating에서 멈춤

R0057: IAM에 대한 아웃바운드 트래픽이 실패함

R0058: DNS 등록이 실패함

R0059: IBM Cloud Container Registry에 대한 아웃바운드 트래픽이 실패했습니다.

R0061: IBM Cloud에서 Satellite 클러스터 API 서버에 연결할 수 없습니다.

R0056: 팟(Pod) 상태가 `terminating`에서 멈춤