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

11장 DSDL API 함수

이 장에서는 데이터 서비스 개발 라이브러리(DSDL) API 함수를 나열하고 이에 대해 간략하게 설명합니다. 각 DSDL 함수에 대한 전체 설명은 개별 3HA 설명서 페이지에 나와 있습니다. DSDL은 C 인터페이스만 제공하며 스크립트 기반 DSDL 인터페이스는 사용할 수 없습니다.

이 장은 다음 내용으로 구성되어 있습니다.

일반적 용도의 함수

이 절의 함수는 다양한 기능을 제공합니다. 이러한 함수를 사용하여 다음 작업을 수행할 수 있습니다.

DSDL 환경 초기화
자원, 자원 유형 및 자원 그룹 이름과 확장 등록 정보 값 검색
자원 그룹 페일오버와 재시작 및 자원 재시작
오류 문자열을 오류 메시지로 변환
시간 초과 이전에 명령 실행

초기화 함수

다음 함수는 호출 메소드를 초기화합니다.

scds_initialize(3HA) – 자원을 할당하고 DSDL 환경을 초기화합니다.
scds_close(3HA) – scds_initialize()가 할당한 자원을 비웁니다.

검색 함수

다음 함수는 자원, 자원 유형, 자원 그룹 및 확장 등록 정보에 대한 정보를 검색합니다.

scds_get_resource_type_name(3HA) – 호출 프로그램에 대한 자원 유형 이름을 검색합니다.
scds_get_resource_name(3HA) – 호출 프로그램에 대한 자원 이름을 검색합니다.
scds_get_resource_group_name(3HA) – 호출 프로그램에 대한 자원 그룹 이름을 검색합니다.
scds_get_ext_property(3HA) – 지정한 확장 등록 정보의 값을 검색합니다.
scds_free_ext_property(3HA) – scds_get_ext_property()가 할당한 메모리를 비웁니다.

다음 함수는 자원에 사용되는 SUNW.HAStoragePlus 자원에 대한 상태 정보를 검색합니다.

scds_hasp_check(3HA) – 자원에 사용되는 SUNW.HAStoragePlus 자원에 대한 상태 정보를 검색합니다. 자원에 대하여 정의된 Resource_dependencies 또는 Resource_dependencies_weak 시스템 등록 정보를 사용하여 자원이 의존하는 모든 SUNW.HAStoragePlus 자원의 상태(온라인 또는 오프라인)로부터 이 정보를 얻습니다. 자세한 내용은 SUNW.HAStoragePlus(5) 설명서 페이지를 참조하십시오.

페일오버 및 재시작 함수

다음 함수는 자원이나 자원 그룹을 페일오버하거나 재시작합니다.

scds_failover_rg(3HA) – 자원 그룹을 페일오버합니다.
scds_restart_rg(3HA) – 자원 그룹을 재시작합니다.
scds_restart_resource(3HA) – 자원을 재시작합니다.

실행 함수

다음 함수는 시간 초과 시 명령을 실행하고 오류 코드를 오류 메시지로 변환합니다.

scds_timerun(3HA) – 시간 초과 값에 도달하면 명령을 실행합니다.
scds_error_string(3HA) – 오류 코드를 오류 문자열로 변환합니다.

등록 정보 함수

이러한 함수는 일반적으로 사용되는 일부 확장 등록 정보를 비롯하여 관련 자원, 자원 그룹 및 자원 유형의 특정 등록 정보에 액세스하기 위한 일반 API를 제공합니다. DSDL은 명령줄 인자를 구문 분석하는 scds_initialize() 함수를 제공합니다. 그런 다음 DSDL은 관련 자원 유형, 자원 및 자원 그룹의 다양한 등록 정보를 캐싱합니다.

scds_property_functions(3HA) 설명서 페이지에서는 다음을 포함하여 이러한 함수에 대해 설명합니다.

scds_get_rt_property-name
scds_get_rs_property-name
scds_get_rg_property-name
scds_get_ext_property-name

네트워크 자원 액세스 함수

이 절에 나열된 함수는 자원 및 자원 그룹에서 사용하는 네트워크 자원을 검색, 인쇄 및 해제합니다. 이 절의 scds_get_ 함수는 RMAPI 함수를 사용하여 Network_resources_used 및 Port_list와 같은 특정 등록 정보를 쿼리하지 않고 네트워크 자원을 검색하는 편리한 방법을 제공합니다. scds_print_name() 함수는 scds_get_name () 함수가 반환하는 데이터 구조의 값을 인쇄합니다. scds_free_name () 함수는 scds_get_ name() 함수에서 할당한 메모리를 비웁니다.

호스트 이름 함수

호스트 이름을 처리하는 함수는 다음과 같습니다.

scds_get_rs_hostnames(3HA) – 자원에 사용되는 호스트 이름 목록을 검색합니다.
scds_get_rg_hostnames(3HA) – 자원 그룹의 네트워크 자원에 사용되는 호스트 이름 목록을 검색합니다.
scds_print_net_list(3HA) – scds_get_rs_hostnames () 또는 scds_get_rg_hostnames()가 반환하는 호스트 이름 목록의 내용을 인쇄합니다.
scds_free_net_list(3HA) – scds_get_rs_hostnames() 또는 scds_get_rg_hostnames()에서 할당한 메모리를 비웁니다.

포트 목록 함수

포트 목록을 처리하는 함수는 다음과 같습니다.

scds_get_port_list(3HA) – 자원에 사용되는 포트-프로토콜 쌍의 목록을 검색합니다.
scds_print_port_list(3HA) – scds_get_port_list()가 반환하는 포트-프로토콜 쌍 목록의 내용을 인쇄합니다.
scds_free_port_list(3HA) – scds_get_port_list()에서 할당한 메모리를 비웁니다.

네트워크 주소 함수

네트워크 주소를 처리하는 함수는 다음과 같습니다.

scds_get_netaddr_list(3HA) – 자원에 사용되는 네트워크 주소 목록을 검색합니다.
scds_print_netaddr_list(3HA) – scds_get_netaddr_list()가 반환하는 네트워크 주소 목록의 내용을 인쇄합니다.
scds_free_netaddr_list(3HA) – scds_get_netaddr_list()에서 할당한 메모리를 비웁니다.

TCP 연결을 사용한 오류 모니터

이 절의 함수는 TCP 기반 모니터를 사용 가능하게 합니다. 일반적으로 오류 모니터는 이러한 함수를 사용하여 서비스에 대한 간단한 소켓 연결을 설정하고 상태를 확인하기 위해 데이터를 읽어 서비스에 기록한 다음 서비스와의 연결을 끊습니다.

함수는 다음과 같습니다.

scds_fm_tcp_connect(3HA) – IPv4 주소 지정만 사용하는 프로세스에 TCP 연결을 설정합니다.
scds_fm_net_connect(3HA) – IPv4 또는 IPv6 주소 지정을 사용하는 프로세스에 TCP 연결을 설정합니다.
scds_fm_tcp_read(3HA) – TCP 연결을 사용하여 모니터 중인 프로세스에서 데이터를 읽습니다.
scds_fm_tcp_write(3HA) – TCP 연결을 사용하여 모니터 중인 프로세스에 데이터를 씁니다.
scds_simple_probe(3HA) – 프로세스에 대한 TCP 연결을 설정하고 종료하여 프로세스를 검사합니다. 이 함수는 IPv4 주소만 처리합니다.
scds_simple_net_probe(3HA) – 프로세스에 대한 TCP 연결을 설정하고 종료하여 프로세스를 검사합니다. 이 함수는 IPv4 또는 IPv6 주소를 처리합니다.
scds_fm_tcp_disconnect(3HA) – 모니터 중인 프로세스에 대한 연결을 종료합니다. 이 함수는 IPv4 주소만 처리합니다.
scds_fm_net_disconnect(3HA) – 모니터 중인 프로세스에 대한 연결을 종료합니다. 이 함수는 IPv4 또는 IPv6 주소를 처리합니다.

PMF 함수

이러한 함수는 PMF(Process Monitor Facility) 기능을 캡슐화합니다. PMF를 통해 모니터하기 위한 DSDL 모델은 pmfadm에 대해 암시적 tag 값을 만들어 사용합니다. 자세한 내용은 pmfadm(1M) 설명서 페이지를 참조하십시오.

또한 PMF 기능은 Restart_interval , Retry_count 및 action_script(pmfadm에 대한 - t, -n 및 -a 옵션)에 대해 암시적 값을 사용합니다. 더욱 중요한 점은 DSDL이 재시작 또는 페일오버 결정을 계산하기 위해 PMF에서 확인된 프로세스 실패 기록을 오류 모니터에서 감지된 응용 프로그램 실패 기록에 연결한다는 것입니다.

함수는 다음과 같습니다.

scds_pmf_get_status(3HA) – 지정한 인스턴스가 PMF의 제어 하에 모니터되고 있는지 확인합니다.
scds_pmf_restart_fm(3HA) – PMF를 사용하여 오류 모니터를 재시작합니다.
scds_pmf_signal(3HA) – PMF의 제어 하에 실행 중인 프로세스에 지정한 신호를 보냅니다.
scds_pmf_start(3HA) – PMF의 제어 하에 지정한 프로그램(오류 모니터 포함)을 실행합니다.
scds_pmf_stop(3HA) – PMF의 제어 하에 실행 중인 프로세스를 종료합니다.
scds_pmf_stop_monitoring(3HA) – PMF의 제어 하에 실행 중인 프로세스 모니터를 중지합니다.

오류 모니터 함수

이 절의 함수는 실패 기록을 유지하고 Retry_count 및 Retry_interval 등록 정보와 함께 평가하여 미리 지정된 오류 모니터 모델을 제공합니다.

함수는 다음과 같습니다.

scds_fm_sleep(3HA) – 오류 모니터 제어 소켓에서 메시지를 대기합니다.
scds_fm_action(3HA) – 검사가 완료된 후 작업을 수행합니다.
scds_fm_print_probes(3HA) – 시스템 로그에 검사 상태 정보를 씁니다.

유틸리티 함수

이 절의 함수를 사용하면 메시지 및 디버깅 메시지를 시스템 로그에 기록할 수 있습니다.

scds_syslog(3HA) – 시스템 로그에 메시지를 씁니다.
scds_syslog_debug(3HA) – 시스템 로그에 디버깅 메시지를 씁니다.