Solaris OS용 Sun Cluster 데이터 서비스 개발 안내서

C 함수

C 함수는 클러스터의 RGM에서 제어하는 서비스를 나타내는 자원 유형에 대한 콜백 메소드의 C 프로그램 구현에 사용됩니다. 이 함수를 사용하여 다음 작업을 수행할 수 있습니다.


주 –

이 절에서도 C 함수에 대한 간단한 설명을 제공하지만, C 함수에 대한 최종적인 참조는 3HA 설명서 페이지에서 제공합니다. 다른 설명이 없는 한 모든 함수에는 동일한 이름의 설명서 페이지가 있습니다. C 함수의 출력 인자와 반환 코드에 대한 자세한 내용은 scha_calls(3HA) 설명서 페이지를 참조하십시오.


자원 함수

이 함수는 RGM에서 관리하는 자원에 대한 정보를 액세스하고 모니터에서 인식한 자원 상태를 표시합니다.

scha_resource_open(), scha_resource_get ()scha_resource_close()

이 함수는 RGM에서 관리하는 자원에 대한 정보를 액세스합니다. scha_resource_open() 함수는 자원에 대한 액세스를 초기화하고 자원 정보를 액세스하는 scha_resource_get()에 대한 핸들을 반환합니다. scha_resource_close() 함수는 이 핸들을 무효화하고 scha_resource_get() 반환 값에 할당된 메모리를 해제합니다.

scha_resource_open()에서 자원 핸들을 반환한 후 클러스터 재구성이나 관리 작업을 통해 자원을 변경할 수 있습니다. 그 결과, scha_resource_get()이 핸들을 통해 가져온 정보가 부정확할 수 있습니다. 자원에 대한 클러스터 재구성이나 관리 작업의 경우 RGM은 scha_err_seqid 오류 코드를 scha_resource_get()으로 반환하여 자원 정보가 변경되었을 수 있음을 나타냅니다. 이것은 치명적인 오류 메시지가 아닙니다. 함수가 성공적으로 반환됩니다. 메시지를 무시하고 반환된 정보를 적용하도록 선택하거나, 현재 핸들을 닫고 새 핸들을 열어서 자원 정보에 액세스할 수 있습니다.

하나의 설명서 페이지에서 세 함수를 모두 설명합니다. 개별 함수 scha_resource_open(3HA), scha_resource_get(3HA) 또는 scha_resource_close(3HA)를 통해 이 설명서 페이지에 액세스할 수 있습니다.

scha_resource_setstatus()

RGM이 제어하는 자원의 StatusStatus_msg 등록 정보를 설정합니다. 자원의 모니터에서 이 함수를 사용하여 자원 상태를 나타냅니다.


주 –

scha_resource_setstatus()가 자원 모니터에 특별히 사용되지만 모든 프로그램에서 이를 호출할 수 있습니다.


자원 유형 함수

이 함수는 RGM에 등록된 자원 유형에 대한 정보를 액세스합니다.

scha_resourcetype_open(), scha_resourcetype_get ()scha_resourcetype_close()

scha_resourcetype_open() 함수는 자원에 대한 액세스를 초기화하고 자원 유형 정보를 액세스하는 scha_resourcetype_get()에 대한 핸들을 반환합니다. scha_resourcetype_close() 함수는 이 핸들을 무효화하고 scha_resourcetype_get() 반환 값에 할당된 메모리를 해제합니다.

scha_resourcetype_open()에서 자원 유형 핸들을 반환한 후 클러스터 재구성이나 관리 작업을 통해 자원 유형을 변경할 수 있습니다. 그 결과, scha_resourcetype_get()이 핸들을 통해 가져온 정보가 부정확할 수 있습니다. 자원 유형에 대한 클러스터 재구성이나 관리 작업의 경우 RGM은 scha_err_seqid 오류 코드를 scha_resourcetype_get()으로 반환하여 자원 유형 정보가 변경되었을 수 있음을 나타냅니다. 이것은 치명적인 오류 메시지가 아닙니다. 함수가 성공적으로 반환됩니다. 메시지를 무시하고 반환된 정보를 적용하도록 선택하거나, 현재 핸들을 닫고 새 핸들을 열어서 자원 유형 정보에 액세스할 수 있습니다.

하나의 설명서 페이지에서 세 함수를 모두 설명합니다. 개별 함수 scha_resourcetype_open(3HA), scha_resourcetype_get(3HA) 또는 scha_resourcetype_close(3HA)를 통해 이 설명서 페이지에 액세스할 수 있습니다.

자원 그룹 함수

이 함수를 사용하여 자원 그룹에 대한 정보를 액세스하거나 자원 그룹을 다시 시작할 수 있습니다.

scha_resourcegroup_open(), scha_resourcegroup_get ()scha_resourcegroup_close()

이 함수는 RGM에서 관리하는 자원 그룹에 대한 정보를 액세스합니다. scha_resourcegroup_open() 함수에서 자원 그룹에 대한 액세스를 초기화하고 자원 그룹 정보를 액세스하는 scha_resourcegroup_get()에 대한 핸들을 반환합니다. scha_resourcegroup_close() 함수는 이 핸들을 무효화하고 scha_resourcegroup_get() 반환 값에 할당된 메모리를 해제합니다.

scha_resourcegroup_open()에서 자원 그룹 핸들을 반환한 후 클러스터 재구성이나 관리 작업을 통해 자원 그룹을 변경할 수 있습니다. 그 결과, scha_resourcegroup_get()이 핸들을 통해 가져온 정보가 부정확할 수 있습니다. 자원 그룹에 대한 클러스터 재구성이나 관리 작업의 경우 RGM은 scha_err_seqid 오류 코드를 scha_resourcegroup_get()으로 반환하여 자원 그룹 정보가 변경되었을 수 있음을 나타냅니다. 이것은 치명적인 오류 메시지가 아닙니다. 함수가 성공적으로 반환됩니다. 메시지를 무시하고 반환된 정보를 적용하도록 선택하거나, 현재 핸들을 닫고 새 핸들을 열어서 자원 그룹 정보에 액세스할 수 있습니다.

하나의 설명서 페이지에서 세 함수를 모두 설명합니다. 개별 함수 scha_resourcegroup_open(3HA), scha_resourcegroup_get(3HA)scha_resourcegroup_close(3HA)를 통해 이 설명서 페이지에 액세스할 수 있습니다.

scha_control()

RGM이 제어하는 자원 그룹의 재시작이나 다른 노드로의 재배치를 요청합니다. 이 함수에 대한 자세한 내용은 scha_control(3HA) 설명서 페이지를 참조하십시오.

클러스터 함수

이 함수는 클러스터에 대한 정보를 액세스하거나 반환합니다.

scha_cluster_open(), scha_cluster_get ()scha_cluster_close()

이 함수는 클러스터 이름, 노드 이름, ID, 상태, 자원 그룹 등의 클러스터에 대한 정보를 액세스합니다.

scha_cluster_open()에서 클러스터 핸들을 반환한 후 클러스터 재구성이나 관리 작업을 통해 클러스터를 변경할 수 있습니다. 그 결과, scha_cluster_get()이 핸들을 통해 가져온 정보가 부정확할 수 있습니다. 클러스터에 대한 클러스터 재구성이나 관리 작업의 경우 RGM은 scha_err_seqid 오류 코드를 scha_cluster_get()으로 반환하여 클러스터 정보가 변경되었을 수 있음을 나타냅니다. 이것은 치명적인 오류 메시지가 아닙니다. 함수가 성공적으로 반환됩니다. 메시지를 무시하고 반환된 정보를 적용하도록 선택하거나, 현재 핸들을 닫고 새 핸들을 열어서 클러스터 정보에 액세스할 수 있습니다.

하나의 설명서 페이지에서 세 함수를 모두 설명합니다. 개별 함수 scha_cluster_open(3HA), scha_cluster_get(3HA)scha_cluster_close(3HA)를 통해 이 설명서 페이지에 액세스할 수 있습니다.

scha_cluster_getlogfacility()

클러스터 로그로 사용 중인 시스템 로그 기능의 수를 반환합니다. syslog() Solaris 함수와 함께 반환된 값을 사용하여 이벤트와 상태 메시지를 클러스터 로그에 기록합니다. 이 함수에 대한 자세한 내용은 scha_cluster_getlogfacility(3HA) 설명서 페이지를 참조하십시오.

scha_cluster_getnodename()

함수가 호출된 클러스터 노드 이름을 반환합니다. 이 함수에 대한 자세한 내용은 scha_cluster_getnodename(3HA) 설명서 페이지를 참조하십시오.

유틸리티 함수

이 함수는 오류 코드를 오류 메시지로 변환합니다.

scha_strerror()

scha_ 함수 중 하나에서 반환한 오류 코드를 해당 오류 메시지로 변환합니다. logger 명령과 함께 이 함수를 사용하여 메시지를 Solaris 시스템 로그(syslog)에 기록합니다. 이 함수에 대한 자세한 내용은 scha_strerror(3HA) 설명서 페이지를 참조하십시오.