Red Hat Training
A Red Hat training course is available for RHEL 8
33장. 리소스 에이전트 OCF 반환 코드 해석
Pacemaker 리소스 에이전트는 OVS(Open Cluster Framework) 리소스 에이전트 API를 준수합니다. 다음 표에서는 OCF 반환 코드 및 Pacemaker에서 해석하는 방법을 설명합니다.
에이전트가 코드를 반환할 때 클러스터가 수행하는 첫 번째 작업은 예상되는 결과에 대해 반환 코드를 확인하는 것입니다. 결과가 예상 값과 일치하지 않으면 작업이 실패한 것으로 간주되고 복구 작업이 시작됩니다.
모든 호출의 경우 리소스 에이전트는 호출된 작업의 결과를 호출자로 알리는 정의된 반환 코드로 종료해야 합니다.
다음 표에 설명된 대로 실패 복구에는 세 가지 유형이 있습니다.
표 33.1. 클러스터에서 수행하는 복구 유형
| 유형 | 설명 | 클러스터에 의한 작업 |
|---|---|---|
| 소프트 | 일시적인 오류가 발생했습니다. | 리소스를 다시 시작하거나 새 위치로 이동합니다. |
| 하드 | 현재 노드에 고유할 수 있는 일시적이지 않은 오류입니다. | 리소스를 다른 위치로 이동하고 현재 노드에서 재시도하지 못하도록 합니다. |
| 치명적 | 발생하는 모든 클러스터 노드에 공통된 일시적이지 않은 오류(예: 잘못된 구성이 지정됨). | 리소스를 중지하고 클러스터 노드에서 시작되지 않도록 합니다. |
다음 표에서는 OCF 반환 코드를 제공하고 실패 코드가 수신될 때 클러스터가 시작될 때 클러스터가 시작됩니다.0이 예상 반환 값이 아닌 경우 0이 실패한 것으로 간주되는 경우 0을 반환하는 작업도 0(OCF 별칭 OCF_SUCCESS)으로 간주될 수 있습니다.
표 33.2. OCF 반환 코드
| 코드 반환 | OCF 레이블 | 설명 |
|---|---|---|
| 0 |
| * 작업이 성공적으로 완료되었습니다. 성공적인 start, stop, promote 및 demote 명령에 대해 예상되는 반환 코드입니다. * 예기치 않은 경우 유형: soft |
| 1 |
| *이 작업은 일반적인 오류를 반환했습니다. * 유형: soft * 리소스 관리자는 리소스를 복구하거나 새 위치로 이동하려고 시도합니다. |
| 2 |
| * 리소스의 구성이 이 컴퓨터에서 유효하지 않습니다. 예를 들어 노드에서 찾을 수 없는 위치를 참조합니다. * 유형: hard * 리소스 관리자가 리소스를 다른 위치로 이동하여 현재 노드에서 다시 수행되지 않도록 합니다. |
| 3 |
| * 요청된 작업이 구현되지 않았습니다. * 유형: hard |
| 4 |
| * 리소스 에이전트에 작업을 완료하는 데 충분한 권한이 없습니다. 예를 들어 에이전트에서 특정 파일을 열 수 없거나 특정 소켓에서 수신 대기하거나 디렉토리에 쓸 수 없기 때문일 수 있습니다. * 유형: hard * 별도로 구성하지 않는 한 리소스 관리자는 다른 노드에서 리소스를 다시 시작하여 이 오류로 인해 실패한 리소스를 복구하려고 합니다(권한 문제가 없을 수 있음). |
| 5 |
| * 작업이 실행된 노드에서 필수 구성 요소가 누락되었습니다. 이는 필수 바이너리가 실행 불가능하거나, 필수 구성 파일을 읽을 수 없기 때문일 수 있습니다. * 유형: hard * 별도로 구성하지 않는 한 리소스 관리자는 다른 노드에서 리소스를 다시 시작하여 이 오류로 인해 실패한 리소스를 복구하려고 시도합니다(필수 파일 또는 바이너리가 있을 수 있음). |
| 6 |
| * 로컬 노드의 리소스 구성이 유효하지 않습니다. * 유형: fatal *이 코드가 반환되면 Pacemaker는 서비스 구성이 다른 노드에서 유효하더라도 클러스터의 노드에서 리소스가 실행되지 않도록 합니다. |
| 7 |
| * 리소스가 안전하게 중지됩니다. 즉, 리소스가 정상적으로 종료되었거나 시작되지 않았음을 의미합니다. * 예기치 않은 경우 유형: soft * 클러스터는 작업을 위해 이를 반환하는 리소스를 중지하지 않습니다. |
| 8 |
| * 리소스가 승격된 역할에서 실행되고 있습니다. * 예기치 않은 경우 유형: soft |
| 9 |
| * 리소스는 승격된 역할에서(또는 있을 수 있음)이지만 실패했습니다. * 유형: soft * 리소스는 강등, 중지 후 다시 시작(및 승격될 수 있음)됩니다. |
| 190 | * (RHEL 8.4 이상) 서비스가 제대로 활성화되어 있는 것으로 밝혀지지만, 이러한 조건에서 향후 오류가 발생할 가능성이 높습니다. | |
| 191 | * (RHEL 8.4 이상) 리소스 에이전트는 역할을 지원하고 서비스는 승격된 역할에서 올바르게 활성화되지만, 이러한 조건에서 향후 오류가 발생할 가능성이 높습니다. | |
| 기타 | 해당 없음 | 사용자 지정 오류 코드. |
