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

GDS 개요

GDS는 간단한 네트워크 인식 및 네트워크 비인식 응용 프로그램을 Sun Cluster RGM(Resource Group Management) 프레임워크에 연결하여 가용성을 높이거나 확장 가능하게 만드는 기법입니다. 이 기법에서는 일반적인 방법으로 응용 프로그램의 가용성을 높이거나 확장 가능하게 만들 때처럼 에이전트를 코딩할 필요가 없습니다.

GDS는 사전에 컴파일된 하나의 데이터 서비스입니다. 사전 컴파일된 데이터 서비스와 해당 구성 요소, 콜백 메소드(rt_callbacks(1HA)) 구현 및 자원 유형 등록 파일(rt_reg(4))을 수정할 수 없습니다.

사전 컴파일된 자원 유형

일반 데이터 서비스 자원 유형 SUNW.gdsSUNWscgds 패키지에 포함되어 있습니다. scinstall 유틸리티는 클러스터 설치 중에 이 패키지를 설치합니다(scinstall( 1M) 설명서 페이지 참조). SUNWscgds 패키지에는 다음과 같은 파일이 포함되어 있습니다.


# pkgchk -v SUNWscgds 

/opt/SUNWscgds 
/opt/SUNWscgds/bin 
/opt/SUNWscgds/bin/gds_monitor_check 
/opt/SUNWscgds/bin/gds_monitor_start 
/opt/SUNWscgds/bin/gds_monitor_stop 
/opt/SUNWscgds/bin/gds_probe 
/opt/SUNWscgds/bin/gds_svc_start 
/opt/SUNWscgds/bin/gds_svc_stop 
/opt/SUNWscgds/bin/gds_update 
/opt/SUNWscgds/bin/gds_validate 
/opt/SUNWscgds/etc 
/opt/SUNWscgds/etc/SUNW.gds

GDS 사용의 장점 및 단점

GDS는 SunPlex Agent Builder 생성 소스 코드 모델(scdscreate(1HA) 설명서 페이지 참조)이나 표준 Sun Cluster 관리 명령 사용 시 다음과 같은 장점이 있습니다.

GDS를 사용하면 많은 장점이 있지만 사용하는 것이 적절하지 않은 경우가 있습니다. GDS는 다음과 같은 경우에 사용하는 기법이 아닙니다.

GDS를 사용하는 서비스를 만드는 방법

GDS를 사용하는 서비스를 만드는 다음 두 가지 방법이 있습니다.

GDS 및 SunPlex Agent Builder

SunPlex Agent Builder를 사용하고 GDS를 생성된 소스 코드의 유형으로 선택합니다. 지정된 응용 프로그램을 위한 자원을 구성하는 스크립트 세트를 만드는 데는 사용자 입력이 사용됩니다.

GDS 및 표준 Sun Cluster 관리 명령

이 메소드에서는 SUNWscgds에서 사전 컴파일된 데이터 서비스 코드를 사용하지만 시스템 관리자는 표준 Sun Cluster 관리 명령을 사용하여 자원을 만들고 구성해야 합니다. scrgadm( 1M)scswitch( 1M) 설명서 페이지를 참조하십시오.

GDS 기반 서비스 구성에 사용할 방법 선택

Sun Cluster 관리 명령을 사용하여 GDS를 사용하는 고가용성 서비스를 만드는 방법Sun Cluster 관리 명령을 사용하여 GDS를 사용하는 확장 가능 서비스를 만드는 방법의 절차에서 설명하는 것처럼 필요한 scrgadmscswitch 명령을 실행하려면 많은 양을 입력해야 합니다.

SunPlex Agent Builder를 통해 GDS를 사용하면 scrgadmscswitch 명령을 대신 실행해주는 스크립트를 만들기 때문에 간단하게 처리할 수 있습니다.

GDS에서 이벤트를 기록하는 방법

GDS를 사용하면 GDS에서 GDS가 시작되는 스크립트로 전달되는 관련 정보를 기록할 수 있습니다. 이 관련 정보에는 시작, 검사 및 중지 메소드의 상태와 등록 정보 변수가 포함됩니다. 이 정보를 사용하여 스크립트에서 문제 또는 오류를 진단하거나 다른 목적으로 적용할 수 있습니다.

Log_level 등록 정보에 설명된 Log_level 등록 정보를 사용하여 GDS가 기록하는 메시지의 수준 또는 유형을 지정합니다. NONE, INFO 또는 ERR을 지정할 수 있습니다.

GDS 로그 파일

다음 두 GDS 로그 파일은 /var/cluster/logs/DS/resource_group_name/ resource_name 디렉토리에 있습니다.

다음 예에서는 start_stop_log.txt에 포함된 정보의 유형을 보여줍니다.

10/20/2004 12:38:05 phys-node-1 START-INFO> Start succeeded. [/home/brianx/sc/start_cmd]
10/20/2004 12:42:11 phys-node-1 STOP-INFO> Successfully stopped the application

다음 예에서는 probe_log.txt에 포함된 정보의 유형을 보여줍니다.

10/20/2004 12:38:15 phys-node-1 PROBE-INFO> The GDS monitor (gds_probe) has been started
10/20/2004 12:39:15 phys-node-1 PROBE-INFO> The probe result is 0
10/20/2004 12:40:15 phys-node-1 PROBE-INFO> The probe result is 0
10/20/2004 12:41:15 phys-node-1 PROBE-INFO> The probe result is 0

필수 GDS 등록 정보

응용 프로그램이 네트워크 비인식 응용 프로그램인 경우 Start_command 확장 등록 정보와 Port_list 등록 정보를 모두 제공해야 합니다. 응용 프로그램이 네트워크 인식 응용 프로그램인 경우 Port_list 등록 정보만 제공해야 합니다.

Start_command 확장 등록 정보

Start_command 확장 등록 정보에서 지정한 시작 명령에서 응용 프로그램을 시작합니다. 이 명령은 쉘에 바로 전달되어 응용 프로그램을 시작할 수 있도록 인자가 지정된 UNIX 명령이어야 합니다.

Port_list 등록 정보

Port_list 등록 정보는 응용 프로그램이 수신하는 포트 목록을 식별합니다. Port_list 등록 정보는 SunPlex Agent Builder에 의해 작성되는 시작 스크립트에 지정되어야 하며 표준 Sun Cluster 관리 명령을 사용할 경우에는 scrgadm 명령에 지정되어야 합니다.

선택적 GDS 등록 정보

다음 목록에는 선택적 GDS 등록 정보가 포함되어 있습니다.

Network_resources_used 등록 정보

이 등록 정보의 기본값은 null입니다. 응용 프로그램이 하나 이상의 주소에 바인드되어야 하는 경우에는 이 등록 정보를 지정해야 합니다. 이 등록 정보가 생략되거나 Null로 지정되면 응용 프로그램이 모든 주소에서 수신하는 것으로 처리됩니다.

GDS 자원을 구성하기 전에 LogicalHostname 또는 SharedAddress 자원이 이미 구성되어 있어야 합니다. LogicalHostname 또는 SharedAddress 자원을 구성하는 방법에 대한 정보는 Sun Cluster Data Services Planning and Administration Guide for Solaris OS를 참조하십시오.

값을 지정하려면 자원 이름을 하나 이상 지정하십시오. 각 자원 이름은 하나 이상의 LogicalHostname이나 하나 이상의 SharedAddress를 포함할 수 있습니다. 자세한 내용은 r_properties (5) 설명서 페이지를 참조하십시오.

Stop_command 등록 정보

중지 명령은 응용 프로그램을 중지하고 응용 프로그램이 완전히 중지된 다음에만 반환되어야 합니다. 이 명령은 쉘에 바로 전달되어 응용 프로그램을 중지시킬 수 있도록 완성된 UNIX 명령이어야 합니다.

Stop_command 확장 등록 정보를 입력하면 GDS 중지 메소드는 중지 시간 초과 값의 80% 상태에서 중지 명령을 실행합니다. 중지 명령의 실행 결과와 관계없이 GDS 중지 메소드는 중지 시간 초과 값의 15% 상태에서 SIGKILL을 전송합니다. 남은 5%의 시간은 작업 관리 오버헤드를 위해 예약됩니다.

중지 명령이 생략되면 GDS가 Stop_signal에 지정된 신호를 사용하여 응용 프로그램을 중지시킵니다.

Probe_command 등록 정보

검사 명령으로 지정된 응용 프로그램의 상태를 주기적으로 검사합니다. 이 명령은 쉘에 바로 전달되어 응용 프로그램을 검사할 수 있도록 인자가 지정된 UNIX 명령이어야 합니다. 검사 명령을 실행하면 응용 프로그램이 정상일 경우 종료 상태 0을 반환합니다.

검사 명령의 종료 상태는 응용 프로그램의 장애 수준을 확인하는 데 사용됩니다. 검사 상태라고 부르는 이 종료 상태는 0(성공)과 100(완전한 실패) 사이의 정수이어야 합니다. 검사 상태는 특수 값 201일 수도 있습니다. 이 상태에서는 Failover_enabledFALSE 로 설정되어 있지 않은 경우 응용 프로그램이 바로 페일오버됩니다. 검사 상태는 GDS 검사 알고리즘(scds_fm_action(3HA) 설명서 페이지 참조)에서 응용 프로그램을 로컬로 다시 시작할 것인지 아니면 다른 노드로 페일오버할 것인지 결정하는 데 사용됩니다. 종료 상태가 201이면 응용 프로그램이 즉시 페일오버됩니다.

검사 명령을 생략하면 GDS에서 Network_resources_used 등록 정보 또는 scds_get_netaddr_list의 출력에서 파생되는 IP 주소 집합에서 응용 프로그램에 연결하는 간단한 자체 검사를 수행합니다(scds_get_netaddr_list(3HA) 설명서 페이지 참조). 연결에 성공하면 즉시 연결을 끊습니다. 연결과 연결 끊기가 모두 성공하면 응용 프로그램이 안정적으로 실행되는 것으로 판단할 수 있습니다.


주 –

GDS에 의해 제공되는 검사는 완전한 기능의 응용 프로그램 검사를 대신하여 간단한 기능만 합니다.


Start_timeout 등록 정보

이 등록 정보는 시작 명령에 대한 시작 시간 초과를 지정합니다. 자세한 내용은 Start_command 확장 등록 정보을 참조하십시오. Start_timeout의 기본값은 300초입니다.

Stop_timeout 등록 정보

이 등록 정보는 중지 명령에 대한 중지 시간 초과를 지정합니다. 자세한 내용은 Stop_command 등록 정보을 참조하십시오. Stop_timeout의 기본값은 300초입니다.

Probe_timeout 등록 정보

이 등록 정보는 검사 명령에 대한 시간 초과 값을 지정합니다. 자세한 내용은 Probe_command 등록 정보을 참조하십시오. Probe_timeout의 기본값은 30초입니다.

Child_mon_level 등록 정보


주 –

표준 Sun Cluster 관리 명령을 사용하는 경우 이 옵션을 사용할 수 있습니다. SunPlex Agent Builder를 사용하는 경우 이 옵션을 사용할 수 없습니다.


이 등록 정보는 PMF(Process Monitor Facility)를 통해 모니터되는 프로세스를 제어합니다. 이 등록 정보는 분기된 자식 프로세스에 대한 모니터 범위를 나타냅니다. 이 등록 정보는 pmfadm 명령의 -C 인자처럼 작동합니다. pmfadm(1M) 설명서 페이지를 참조하십시오.

이 등록 정보를 생략하거나 기본값 -1로 설정하면 pmfadm 명령에서 -C 옵션을 생략한 것과 동일한 기능을 합니다. 즉, 모든 자식(하위) 프로세스가 모두 모니터됩니다.

Failover_enabled 등록 정보

이 부울 확장 등록 정보는 자원의 페일오버 동작을 제어합니다. 이 확장 등록 정보가 true로 설정되면 retry_interval에 지정된 초 단위 시간 내에 시작 횟수가 retry_count를 초과할 경우에 응용 프로그램이 페일오버됩니다.

이 등록 정보가 false로 설정되면 retry_interval의 초 단위 시간 내에 재시작 횟수가 retry_count를 초과할 경우에 응용 프로그램이 다시 시작되거나 다른 노드로 페일오버되지 않습니다.

이 등록 정보를 사용하면 응용 프로그램 자원이 자원 그룹의 페일오버를 시작하지 못하게 설정할 수 있습니다. 이 등록 정보의 기본값은 true입니다.

Stop_signal 등록 정보

GDS는 이 정수 확장 등록 정보 값을 사용하여 PMF를 통해 응용 프로그램 중지에 사용한 신호를 확인합니다. 지정할 수 있는 정수 값 목록은 signal( 3HEAD) 설명서 페이지를 참조하십시오. 기본값은 15( SIGTERM)입니다.

Log_level 등록 정보

이 등록 정보는 GDS가 기록하는 진단 메시지의 수준 또는 유형을 지정합니다. 이 등록 정보에 대해 NONE, INFO 또는 ERR을 지정할 수 있습니다. NONE을 지정하면 GDS가 진단 메시지를 기록하지 않습니다. INFO를 지정하면 정보 메시지만 기록합니다. ERR을 지정하면 오류 메시지만 기록합니다. 기본적으로 GDS는 진단 메시지를 기록하지 않습니다(NONE).