geohb(1M) (Sun Cluster Geographic Edition 참조 설명서)

Sun Cluster Geographic Edition 참조 설명서

geohb(1M)

이름 | 개관 | 설명 | 하위 명령 | 옵션 | 피연산자 | 확장 설명 | 종료 상태 | 예 | 속성 | 기타 참조

이름

geohb– 하트비트 메커니즘 구성 및 관리

개관

/usr/cluster/bin/geohb

-?

/usr/cluster/bin/geohb

-V

/usr/cluster/bin/geohb add-plugin

pluginname

heartbeatname

-p

property

-p

/usr/cluster/bin/geohb create

heartbeatname

-r

clusterlist

-p

property

-p

/usr/cluster/bin/geohb delete

heartbeatname

/usr/cluster/bin/geohb list

heartbeatname

/usr/cluster/bin/geohb modify-plugin

-p

property

-p

pluginname

heartbeatname

/usr/cluster/bin/geohb remove-plugin

pluginname

heartbeatname

/usr/cluster/bin/geohb set-prop

-p

property

-p

heartbeatname

설명

geohb 명령으로 하트비트 메커니즘을 구성하고 관리할 수 있습니다.

하트비트는 두 클러스터, 요청자 클러스터와 응답자 클러스터 사이의 모니터입니다. 파트너쉽을 작성하면 각 방향으로 하나씩, 두 개의 하트비트가 설정됩니다. 예를 들어 기본 클러스터 cluster-paris와 보조 클러스터 cluster-newyork 사이의 파트너쉽은 두 개의 하트비트를 포함합니다. 하나의 하트비트는 cluster-paris를 요청자로, cluster-newyork를 응답자로 갖습니다. 다른 하트비트는 cluster-newyork를 요청자로, cluster-paris를 응답자로 갖습니다.

Sun Cluster Geographic Edition 소프트웨어는 기본 플러그인으로서 TCP/UDP 플러그인을, 백업으로서 ping 플러그인을 기반으로 하는 기본 하트비트 메커니즘을 제공합니다. geohb 명령으로 하트비트를 구성하고 유지관리할 수 있습니다. 다음과 같은 작업을 수행할 수 있습니다.

파트너쉽에 참여하는 클러스터 사이에 하트비트 구성. 하트비트 구성은 연관된 플러그인의 구성을 포함합니다.
하트비트 등록 정보 작성 및 삭제.
하트비트와 연관된 플러그인 추가, 수정 및 제거.
하트비트 및 관련 플러그인의 현재 구성 검색.

파트너쉽에 대해 활성화된 클러스터에서 geohb 명령을 실행하십시오.

geohb 명령을 실행하여 하트비트 메커니즘을 구성 및 관리하려면 사용자에게 적당한 역할 기반 액세스 제어(RBAC) 권한 프로파일이 지정되어야 합니다.

루트 액세스가 있는 경우 모든 조작을 수행할 권한이 있습니다. 루트 액세스가 없는 경우 다음 RBAC 권한이 적용됩니다.

기본 Solaris 사용자. geopg list, geohb list 및 geops list와 같은 명령을 실행하여 Sun Cluster Geographic Edition 엔티티에 대한 정보를 읽을 수 있습니다.
Geo Management. 기본 Solaris 사용자 액세스를 갖는 사용자가 수행할 수 있는 모든 읽기 작업을 수행할 수 있습니다. 또한 geohb create, geopg switchover, geoadm start 및 geoadm stop과 같은 관리 및 구성 작업을 수행할 수 있습니다.

자세한 정보는 rbac(5) 매뉴얼 페이지 및 Sun Cluster Geographic Edition 시스템 관리 설명서의 “Sun Cluster Geographic Edition 소프트웨어와 RBAC”를 참조하십시오.

이 명령의 일반 형식은 다음과 같습니다.

geohb [subcommand] [options] [operands]

options가 옵션 -?, -o, -V 또는 -v를 지정한 경우에만 subcommand를 생략할 수 있습니다.

이 명령의 각 옵션에는 긴 형식과 짧은 형식이 있습니다. 각 옵션의 두 형식에는 이 매뉴얼 페이지의 OPTIONS 절에 있는 옵션의 설명이 제공됩니다.

하위 명령

다음 하위 명령이 지원됩니다.

add-plugin

플러그인을 기존 하트비트에 추가합니다. 사용자 정의 플러그인을 지정하는 경우 Query_cmd 등록 정보를 사용하여 사용자 정의 플러그인 명령에 대한 경로도 지정해야 합니다.

create

하트비트를 작성합니다. geoadm(1M) 명령을 실행하여 하트비트 상태를 모니터링할 수 있습니다. 하트비트가 동작하게 하려면 원격 클러스터를 구성해야 합니다.

주 –

사용자 정의 하트비트를 작성하는 경우 파트너쉽이 손상 모드로 유지되는 것을 방지하려면 최소 하나의 플러그인을 추가해야 합니다.

delete

하트비트를 삭제합니다.

list

기존 구성 정보를 표시합니다.

modify-plugin

하트비트 플러그인 등록 정보를 수정합니다.

remove-plugin

플러그인을 하트비트에서 제거합니다.

set-prop

하트비트 등록 정보를 수정합니다.

옵션

다음과 같은 옵션이 지원됩니다.

-? --help

도움말 정보를 표시합니다. 이 옵션을 사용하면 다른 처리가 수행되지 않습니다.

하위 명령 없이 또는 하위 명령과 함께 이 옵션을 지정할 수 있습니다.

하위 명령 없이 이 옵션을 지정한 경우, 이 명령에 대한 하위 명령의 목록이 표시됩니다.

하위 명령과 함께 이 옵션을 지정한 경우, 하위 명령에 대한 사용법 옵션이 표시됩니다.

의문 부호는 일부 쉘에서 특수 문자로서 해석될 수 있습니다. 패턴 일치를 피하려면 따옴표(-"?") 또는 이스케이프 문자를 사용하십시오.

-p property --property property

하트비트 또는 하트비트 플러그인의 등록 정보를 지정합니다.

하트비트 등록 정보는 name=statement 쌍을 사용하여 값이 지정됩니다. 복수 명령문을 사용하여 여러 등록 정보를 한 번에 설정할 수 있습니다.

이들 등록 정보에 대한 값은 작성 시에 지정되며 런타임 시에 조정 가능합니다.

현재 정의된 등록 정보에 대해서는 확장 설명을 참조하십시오.

-r clusterlist --remote-cluster clusterlist

로컬 클러스터가 하트비트 모니터링을 설정하는 원격 클러스터의 이름을 지정합니다.

-V --version

명령의 버전을 표시합니다.

하위 명령, 피연산자 또는 기타 옵션을 사용하여 이 옵션을 지정하지 마십시오. 하위 명령, 피연산자 또는 기타 옵션이 무시됩니다. -V 옵션은 명령의 버전만을 표시합니다. 기타 작업은 수행되지 않습니다.

피연산자

다음 피연산자가 지원됩니다.

heartbeatname: 로컬 클러스터의 하트비트에 대한 식별자를 지정합니다. 지정된 식별자가 이미 존재하는 경우, 새 하트비트 작성을 시도하면 geohb create 명령은 실패합니다.
pluginname: 하트비트 플러그인의 이름을 지정합니다.

확장 설명

다음 절은 하트비트 및 하트비트 플러그인 등록 정보를 나열합니다.

하트비트 등록 정보

다음 하트비트 등록 정보를 지정할 수 있습니다.

Query_interval

하트비트 상태 요청 사이의 빈도를 초 단위로 지정합니다. 세 번의 Query_interval 기간이 응답 없이 지나가는 경우 플러그인은 긴급 모드로 들어갑니다. 추가 Query_interval 기간이 응답 없이 지나가는 경우 플러그인은 시간 초과하고 오류 모드로 들어갑니다.

선택적 등록 정보.

유형: 정수입니다.

조정 권고사항: 이 등록 정보의 값은 작성 시에 지정되며 런타임 시에 조정할 수 있습니다.

기본값: 120초.

하트비트 플러그인 등록 정보

하트비트 플러그인 등록 정보는 하트비트가 작동하는 방법을 판별합니다.

Plugin_properties

플러그인에 특정한 등록 정보 문자열을 지정합니다.

선택적 등록 정보.

유형: 문자열입니다.

조정 권고사항: 이 등록 정보의 값은 작성 시에 지정되며 런타임 시에 조정할 수 있습니다.

기본값: 기본 하트비트 플러그인인 tcp_udp_plugin 및 ping-plugin을 사용하는 하트비트의 경우를 제외하고는 없습니다.

tcp_udp_plugin 플러그인의 경우 이 문자열의 형식이 remote_IP_address /UDP/2084[[/ipsec]], remote_IP_address/TCP/2084[[/ipsec]]로 사전 정의됩니다. remote_IP_address 인수는 파트너 클러스터의 IP 주소를 지정합니다. 선택적 /ipsec 문자열이 플러그인이 IPsec를 사용하도록 표시합니다.

ping-plugin의 경우, 이 문자열의 형식은 remote_IP_address로서 사전 정의되며, 여기서 remote_IP_address는 파트너 클러스터의 IP 주소를 지정합니다.

Query_cmd

하트비트 상태 요청을 위한 명령의 경로를 지정합니다.

플러그인이 사전 정의된 플러그인을 지정하지 않는 경우 필수 등록 정보.

유형: 문자열입니다.

조정 권고사항: 이 등록 정보의 값은 작성 시에 지정되며 런타임 시에 조정할 수 있습니다.

기본값: 없음.

Requester_agent

요청자 에이전트에 대한 절대 경로를 지정합니다.

선택적 등록 정보.

유형: 문자열입니다.

조정 권고사항: 기본 플러그인에 대한 이 등록 정보의 값은 테스트 목적을 제외하고 조정되지 않아야 합니다.

기본값: 없음.

Responder_agent

응답자 에이전트에 대한 절대 경로를 지정합니다.

선택적 등록 정보.

유형: 문자열입니다.

조정 권고사항: 기본 플러그인에 대한 이 등록 정보의 값은 테스트 목적을 제외하고 조정되지 않아야 합니다.

기본값: 없음.

유형

플러그인의 유형을 지정합니다. Primary 또는 Backup 중 하나로 설정합니다.

필수 등록 정보.

유형: 열거.

조정 권고사항: 이 등록 정보의 값은 작성 시에 지정되며 런타임 시에 조정할 수 있습니다.

기본값: 기본 하트비트 이름 ping_plugin을 갖는 하트비트의 경우를 제외하고, 없음. 이 경우에 기본 값은 Backup입니다.

종료 상태

다음 종료 값이 반환됩니다.

0: 명령이 성공적으로 완료되었으며, 원격 클러스터가 작동 중임을 표시합니다.
0이 아님: 오류가 발생했으며, 원격 클러스터가 하트비트 점검에 응답하지 않았음을 의미합니다.

예

예 1 하트비트 작성

다음 geohb 명령은 paris-to-newyork이라는 하트비트를 작성합니다. 이는 로컬 클러스터와 클러스터 cluster-newyork 간을 통신합니다.

# geohb create paris-to-newyork -r cluster-newyork

예 2 하트비트 플러그인 작성

다음 geohb 명령은 하트비트 paris-to-newyork에 대해 command1이라는 하트비트 플러그인을 작성합니다.

# geohb add-plugin command1 paris-to-newyork -p Query_cmd=/usr/bin/hb/

예 3 하트비트 수정

다음 geohb 명령은 cluster-paris와 cluster-newyork 간의 기본 하트비트에 대한 등록 정보를 수정합니다.

# geohb set-prop -p Query_interval=60 hb_cluster-paris~cluster-newyork

예 4 하트비트 플러그인 수정

다음 geohb 명령은 기본 TCP/UDP 플러그인인 tcp_udp_plugin의 등록 정보를 수정하여 TCP만 사용하도록 합니다.

# geohb modify-plugin -p Plugin_properties=paris-cluster/TCP/2084 \
tcp_udp_plugin hb_cluster-paris~cluster-newyork

예 5 하트비트에서 플러그인 삭제

다음 geohb 명령은 paris-to-newyork이라는 하트비트에서 command1이라는 플러그인을 삭제합니다.

# geohb remove-plugin command1 paris-to-newyork

속성

다음 속성의 설명에 대해서는 attributes(5)를 참조하십시오.

속성 유형	속성 값
구조	SPARC
가용성	SUNWscgctl
인터페이스 안정성	Evolving(발달)

기타 참조

rbac(5), geops(1M)

Sun Cluster Geographic Edition 3.1 2006Q4 최신 개정판 2007년 3월

이름 | 개관 | 설명 | 하위 명령 | 옵션 | 피연산자 | 확장 설명 | 종료 상태 | 예 | 속성 | 기타 참조