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

자원 등록 정보

표 A–2에서는 Sun Cluster에서 정의한 자원 등록 정보에 대해 설명합니다. 등록 정보 값은 다음과 같이 범주 열로 범주화됩니다.

표 A–2에서는 또한 다음과 같이 업데이트 가능 여부 열의 자원 등록 정보를 업데이트할 수 있는지 여부 및 그 시점을 나열합니다.

None 또는 False

불가 

True 또는 Anytime

언제든지 

At_creation

해당 자원이 클러스터에 추가될 때 

When_disabled

해당 자원이 비활성화될 때 

표 A–2 자원 등록 정보

등록 정보 이름 

설명 

업데이트 가능 여부  

범주 

Affinity_timeout (정수)

자원의 모든 서비스에 지정된 클라이언트 IP 주소의 연결을 동일한 서버 노드로 전송하는 시간(초)입니다.  

Load_balancing_policyLb_sticky 또는 Lb_sticky_wild일 경우에만 이 등록 정보가 해당됩니다. 그리고 Weak_affinity를 false (기본값)로 설정해야 합니다.

이 등록 정보는 확장 가능 서비스에서만 사용합니다.  

언제든지 

선택적 

Cheap_probe_interval (정수)

자원에 대한 빠른 오류 검사 호출 사이의 시간(초)입니다. 등록 정보가 RTR 파일에 선언되어 있는 경우 RGM에서만 등록 정보를 만들고 관리자가 사용할 수 있습니다. 

기본값이 RTR 파일에 지정되지 않았다면 이 등록 정보는 선택적입니다. 자원 유형 파일에 Tunable 속성이 지정되지 않은 경우 해당 등록 정보에 대한 Tunable 값은 When_disabled입니다.

Default 속성이 RTR 파일의 등록 정보 선언에 지정되지 않은 경우 이 등록 정보는 필수적입니다.

비활성화된 경우  

조건적 

Extension properties 

해당 자원 유형의 RTR 파일에 선언된 확장명 등록 정보입니다.. 이 자원 유형의 구현 방식에 따라 이 등록 정보가 정의됩니다. 확장 등록 정보에 대해 설정할 수 있는 개별 속성에 대한 자세한 내용은 표 A–4를 참조하십시오.

특정 등록 정보에 따라 다름 

조건적 

Failover_mode (enum)

가능한 설정은 NONE, SOFT HARD입니다. 자원에 대한 Start, Stop 또는 Monitor_stop 메소드 호출 실패에 대한 응답으로 RGM에서 자원 그룹을 재배치하거나 노드를 중단할지 여부를 제어합니다. NONE은 메소드 실패 시 RGM에서 자원 상태를 설정하고 운영자 작업을 대기해야 함을 나타냅니다. SOFTStart 메소드 실패 시 RGM에서 자원 그룹을 다른 노드로 재배치해야 함을 나타내는 반면, Stop 또는 Monitor_stop 메소드의 실패 시 RGM에서 자원을 STOP_FAILED 상태로 설정하고 자원 그룹을 ERROR_STOP_FAILED 상태로 설정하며 운영자 작업을 대기해야 함을 나타냅니다. Stop 또는 Monitor_stop 실패의 경우 NONE 설정과 SOFT 설정은 동일합니다. HARDStart 메소드 실패 시 그룹을 재배치하고 Stop 또는 Monitor_stop 메소드 실패 시 클러스터 노드를 중단하여 자원을 강제로 중지해야 함을 나타냅니다.

기본값은 NONE입니다.

언제든지  

선택적 

Load_balancing_policy (문자열)

사용 중인 로드 균형 조정 정책을 정의하는 문자열입니다. 이 등록 정보는 확장 가능 서비스에 대해서만 사용 가능합니다. Scalable 등록 정보가 RTR 파일에 선언된 경우 RGM에서 자동으로 이 등록 정보를 만듭니다. Load_balancing_policy에 설정될 수 있는 값은 다음과 같습니다.

Lb_weighted (기본값). Load_balancing_weights 등록 정보에 설정된 가중치에 따라 여러 노드로 로드를 분산합니다. Lb_sticky. 확장 가능 서비스의 해당 클라이언트(클라이언트 IP 주소로 식별)는 항상 같은 클러스터 노드로 전송됩니다. Lb_sticky_wild. 와일드카드 sticky 서비스의 IP 주소에 연결되는 해당 클라이언트(클라이언트의 IP 주소로 식별됨)는 포트 번호와 관계없이 항상 같은 클러스터 노드로 전송됩니다.

기본값은 Lb_weighted입니다.

생성 시  

조건적/선택적 

Load_balancing_weights (문자열 배열)

확장 가능한 자원에만 해당합니다. Scalable 등록 정보가 RTR 파일에 선언된 경우 RGM에서 자동으로 이 등록 정보를 만듭니다. 형식은 weight@node, weight@node입니다. 여기서 weight는 지정된 node로 분산된 로드의 상대적인 분량을 반영하는 정수입니다. 노드에 분산되는 로드의 분수는 이 노드에 대한 가중치를 모든 가중치의 합으로 나눈 것입니다. 예를 들어, 1@1,3@2는 노드 1에서 1/4의 로드를 수신하고, 노드 2에서 3/4의 로드를 수신하도록 지정합니다. 기본값인 빈 문자열(“”)은 균등하게 분산되도록 설정합니다. 명시적으로 가중치가 할당되지 않은 노드는 기본 가중치인 1을 수신합니다.

Tunable 속성이 자원 유형 파일에 지정되지 않은 경우 등록 정보에 대한 Tunable 값은 Anytime입니다. 이 등록 정보를 변경하면 새 연결에 대한 분산에만 적용됩니다.

기본값은 빈 문자열(“”)입니다. 

언제든지  

조건적/선택적 

유형의 모든 콜백 메소드에 대한 method_timeout(정수)

RGM이 메소드의 호출이 실패했다고 결정할 때까지의 경과 시간(초)입니다.  

메소드가 RTR 파일에 선언된 경우 기본값은 3,600 (1시간)입니다. 

언제든지 

조건적/ 

선택적 

Monitored_switch (enum)

클러스터 관리자가 관리 유틸리티를 사용하여 모니터를 활성화하거나 비활성화할 경우 RGM에서 Enabled 또는 Disabled로 설정합니다. Disabled로 설정된 경우에는 다시 활성화될 때까지 모니터는 Start 메소드를 호출하지 않습니다. 해당 자원에 모니터 콜백 메소드가 없는 경우에는 이 등록 정보가 존재하지 않습니다.

기본값은 Enabled입니다.

불가 

쿼리 전용 

Network_resources_used (문자열 배열)

자원이 사용하는 논리 호스트 이름이나 공유 주소 네트워크 자원의 목록입니다. 확장 가능 서비스의 경우 이 등록 정보는 반드시 별도 자원 그룹에 존재하는 공유 주소 자원을 참조해야 합니다. 페일오버 서비스의 경우, 이 등록 정보는 같은 자원 그룹에 존재하는 논리 호스트 이름이나 공유 주소 자원을 참조합니다. Scalable 등록 정보가 RTR 파일에 선언된 경우 RGM에서 자동으로 이 등록 정보를 만듭니다. Scalable이 RTR 파일에 선언되지 않은 경우 RTR 파일에 명시적으로 선언될 때까지 Network_resources_used를 사용할 수 없습니다.

Tunable 속성이 자원 유형 파일에 지정되지 않은 경우 해당 등록 정보에 대한 Tunable 값은 At_creation입니다.

생성 시  

조건적/필수적 

On_off_switch (enum)

클러스터 관리자가 관리 유틸리티를 사용하여 모니터를 활성화하거나 비활성화할 경우 RGM에서 Enabled 또는 Disabled로 설정합니다. 비활성화인 경우에는 다시 활성화될 때까지 어떠한 콜백도 호출되지 않습니다.

기본값은 Disabled입니다.

불가  

쿼리 전용 

Port_list (문자열 배열)

서버가 수신 중인 포트 번호 목록입니다. 각 포트 번호에 추가되는 숫자는, 예를 들어 Port_list=80/tcp처럼 해당 포트에서 사용되는 프로토콜입니다. Scalable 등록 정보가 RTR 파일에 선언된 경우 RGM에서 자동으로 Port_list를 만듭니다. 그렇지 않으면 이 등록 정보는 RTR 파일에 명시적으로 선언될 때까지는 사용할 수 없습니다.

Apache에 대한 이 등록 정보 설정은 Sun Cluster Data Service for Apache Guide for Solaris OS에 설명되어 있습니다.

생성 시  

조건적/ 

필수적 

R_description (문자열)

자원에 대한 간단한 설명입니다. 

기본값은 빈 문자열입니다. 

언제든지 

선택적 

Resource_name (문자열)

자원 인스턴스의 이름입니다. 이 이름은 클러스터 구성 내부에서 고유해야 하며 자원이 만들어진 후에는 변경할 수 없습니다.  

불가  

필수적 

Resource_project_name (문자열)

해당 자원과 관련된 Solaris 프로젝트 이름입니다. 이 등록 정보를 사용하여 CPU 공유, 자원 풀과 같은 Solaris 자원 관리 기능을 클러스터 데이터 서비스에 적용합니다. RGM에서 자원을 온라인으로 가져올 경우 이 프로젝트 이름으로 관련된 프로세스를 시작합니다. 등록 정보를 지정하지 않은 경우 자원을 포함하는 자원 그룹의 RG_project_name 등록 정보에서 프로젝트 이름을 가져옵니다(rg_properties(5) 참조). 등록 정보를 지정하지 않은 경우 RGM은 미리 정의된 프로젝트 이름 default를 사용합니다. 지정한 프로젝트 이름은 반드시 프로젝트 데이터베이스에 있어야 하고 사용자 root는 명명된 프로젝트의 구성원으로 구성되어야 합니다. 이 등록 정보는 Solaris 9 릴리스부터 지원됩니다.


주 –

이 등록 정보의 변경 사항은 자원이 재시작된 후에 적용됩니다.


기본값은 Null입니다. 

언제든지  

선택적 

각 클러스터 노드의 Resource_state (enum)

각 클러스터 노드에 대해 RGM에서 결정한 자원 상태입니다. 가능한 상태는 Online, Offline, Stop_failed, Start_failed, Monitor_failedOnline_not_monitored입니다.

이 등록 정보는 사용자가 구성할 수 없습니다. 

불가 

쿼리 전용 

Retry_count (정수)

실패한 경우 모니터가 자원을 다시 시작하기 위해 시도하는 횟수입니다. 등록 정보가 RTR 파일에 선언되어 있는 경우 RGM에서만 이 등록 정보를 만들고 관리자가 사용할 수 있습니다. 기본값이 RTR 파일에 지정된 경우 이 등록 정보는 선택적입니다. 

자원 유형 파일에 Tunable 속성이 지정되지 않은 경우 해당 등록 정보의 Tunable 값은 When_disabled입니다.

Default 속성이 RTR 파일의 등록 정보 선언에 지정되지 않은 경우 이 등록 정보는 필수적입니다.

비활성화된 경우 

조건적  

Retry_interval (정수)

장애가 발생한 자원을 재시작하기 위한 시도를 세는 시간(초)입니다. 자원 모니터는 이 등록 정보를 Retry_count와 함께 사용합니다. 등록 정보가 RTR 파일에 선언되어 있는 경우 RGM에서만 이 등록 정보를 만들고 관리자가 사용할 수 있습니다. 기본값이 RTR 파일에 지정된 경우 이 등록 정보는 선택적입니다.

자원 유형 파일에 Tunable 속성을 지정하지 않은 경우 해당 등록 정보의 Tunable 값은 When_disabled입니다.

Default 속성이 RTR 파일의 등록 정보 선언에 지정되지 않은 경우 이 등록 정보는 필수적입니다.

비활성화된 경우  

조건적 

Scalable (부울)

해당 자원이 확장 가능한지를 가리킵니다. 이 등록 정보가 RTR 파일에 선언된 경우에는 RGM에서 해당 유형의 자원에 대하여 다음과 같은 확장 가능 서비스 등록 정보를 자동으로 만듭니다. Network_resources_used, Port_list, Load_balancing_policy Load_balancing_weights. 이러한 등록 정보는 RTR 파일에 명시적으로 선언되지 않았다면 기본값을 사용합니다. Scalable의 기본값은—RTR 파일에서 선언된 경우 True입니다.

RTR 파일에 이 등록 정보가 선언된 경우 Tunable 속성을 At_creation으로 설정해야 합니다. 그렇지 않으면 자원 만들기가 실패합니다.

RTR 파일에 이 등록 정보가 선언되지 않고 자원이 확장 불가능한 경우 클러스터 관리자는 이 등록 정보를 조정할 수 없고 RGM에서 확장 가능한 서비스 등록 정보를 설정하지 않습니다. 그러나 이러한 등록 정보는 확장 가능 서비스뿐 아니라 확장 불가능한 서비스에서도 유용하기 때문에 원하는 경우에는 Network_resources_usedPort_list 등록 정보를 RTR 파일에 명시적으로 선언할 수 있습니다.

생성 시  

선택적 

각 클러스터 노드의 Status (enum)

자원 모니터에 의해 설정됩니다. 가능한 값은 OK, degraded, faulted, unknownoffline입니다. 자원이 온라인일 경우 RGM에서 값을 unknown으로 설정하고, 오프라인일 경우 Offline으로 설정합니다.

불가 

쿼리 전용 

각 클러스터 노드의 Status_msg (문자열)

자원 모니터에 의해 Status 등록 정보와 동시에 설정됩니다. 이 등록 정보는 자원마다, 그리고 노드마다 설정할 수 있습니다. 자원이 오프라인일 경우 RGM은 이 자원을 빈 문자열로 설정합니다.

불가 

쿼리 전용 

Thorough_probe_interval (정수)

자원에 대한 높은 오버헤드 오류 검사 호출 사이의 시간(초)입니다. 등록 정보가 RTR 파일에 선언되어 있는 경우 RGM에서만 이 등록 정보를 만들고 관리자가 사용할 수 있습니다. 기본값이 RTR 파일에 지정된 경우 이 등록 정보는 선택적입니다. 

자원 유형 파일에 Tunable 속성이 지정되지 않은 경우 해당 등록 정보에 대한 Tunable 값은 When_disabled입니다.

Default 속성이 RTR 파일의 등록 정보 선언에 지정되지 않은 경우 이 등록 정보는 필수적입니다.

비활성화된 경우  

조건적 

Type (문자열)

이 자원이 인스턴스인 자원 유형입니다. 

불가 

필수적 

Type_version (문자열)

현재 이 자원과 관련된 자원 유형의 버전을 지정합니다. RGM은 RTR 파일에서 선언할 수 없는 이 등록 정보를 자동으로 만듭니다. 이 등록 정보 값은 해당 자원 유형의 RT_version 등록 정보와 같습니다. 자원을 만들 경우 자원 유형 이름의 접미어로 표시되더라도 Type_version 등록 정보가 명시적으로 지정되지 않습니다. 자원을 편집할 경우 Type_version을 새 값으로 변경할 수 있습니다.

조정 가능 여부는 다음에 의해 결정됩니다.

  • 자원 유형의 현재 버전

  • RTR 파일의 #$upgrade_from 지시어

설명을 참조하십시오. 

설명을 참조하십시오.  

UDP_affinity (부울)

True일 경우 현재 클라이언트에 대한 모든 TCP 트래픽을 처리하는 동일한 서버 노드에 지정된 클라이언트의 모든 UDP 트래픽이 전송됩니다. 

Load_balancing_policy Lb_sticky 또는 Lb_sticky_wild일 경우에만 이 등록 정보가 해당됩니다. 또한 Weak_affinity를 False (기본값)로 설정해야 합니다.

이 등록 정보는 확장 가능 서비스에서만 사용합니다. 

비활성화된 경우 

선택적 

Weak_affinity (부울)

True인 경우 약한 형태의 클라이언트 유사성을 활성화합니다. 그 결과 특정 클라이언트의 연결이 동일한 서버 노드로 전송되는데, 다음 경우는 제외됩니다. 

  • 오류 모니터 재시작, 자원 페일오버나 스위치오버 또는 실패 후 노드와 클러스터의 재결합 등의 이유로 Server Listener가 시작되는 경우

  • 관리 작업으로 인해 확장 가능한 자원에 대한 Load_balancing_weights가 변경된 경우

약한 유사성은 메모리 사용 및 프로세서 사이클 측면에서 기본 형태에 대한 낮은 오버헤드 대안을 제공합니다.  

Load_balancing_policyLb_sticky 또는 Lb_sticky_wild일 경우에만 이 등록 정보가 해당됩니다.

이 등록 정보는 확장 가능 서비스에서만 사용합니다.  

비활성화된 경우  

선택적