[VCS] hagrp

[LEE SOO IN]

hagrp (Version 7.0)

NAME	hagrp – VCS 서비스 그룹 운영 수행
SYNOPSIS	hagrp -add group hagrp -delete group hagrp -link parent_group child_group dependency hagrp -local group attr hagrp -global group attr                value           ... | key ... | { key value } hagrp -unlink parent_group child_group hagrp -clear group [-sys system] [-clus cluster | -localclus] hagrp -clearadminwait [-fault] group -sys system hagrp -flush [-force] group -sys system [-clus cluster | -localclus] hagrp -forecast group [ -verbose] hagrp -online [-force] [-nopre] group -sys system [-checkpartial system] [-clus cluster | -localclus] hagrp -online [-force] group -any [-clus cluster | -localclus] hagrp -online group -site site hagrp -online [-propagate] group -sys system hagrp -online [-propagate] group -any hagrp -online [-propagate] group -site site hagrp -offline [-force] [-ifprobed] group -sys system [-clus cluster | -localclus] hagrp -offline [-force] [-ifprobed] group -any [-clus cluster | -localclus] hagrp -offline group -site site hagrp -offline [-propagate] group -sys system hagrp -offline [-propagate] group -any hagrp -offline [-propagate] group -site site hagrp -switch group -to system [-clus cluster | -localclus [-nopre]] hagrp -switch group -any [-clus cluster | -localclus] hagrp -switch group -site site hagrp -freeze group -persistent hagrp -freeze group [-clus cluster | -localclus] hagrp -unfreeze group -persistent hagrp -unfreeze group [-clus cluster | -localclus] hagrp -enable group [-sys system] hagrp -disable group [-sys system] hagrp -autoenable group -sys system hagrp -enableresources group hagrp -disableresources group hagrp -ignore -group -clus cluster hagrp -display [group(s)] [-attribute attribute(s)] [-sys system(s)] [-clus cluster | -localclus] hagrp -state [group(s)] [-sys system(s)] [-clus cluster | -localclus] hagrp -list [conditional(s)] [-clus cluster | -localclus] hagrp -value group attr [system] [-clus cluster | -localclus] hagrp -dep [group(s)] hagrp -resources group [-clus cluster | -localclus] hagrp -wait group attribute value[-clus cluster] [-sys system] [-time timeout] hagrp -help [-modify | -link | -list] hagrp -modify modify_options hagrp -migrate service_group -to system
AVAILABILITY	VRTSvcs
DESCRIPTION	서비스 그룹은 VCS에서 가용성이 높은 컴퓨터 서비스의 인스턴스이다. 그룹은 디스크, 볼륨 또는 데이터베이스와 같은 다양한 리소스 유형의 하나 이상의 리소스(resource)로 구성된다. 각 그룹에 대한 정보를 보고 관리하려면 hagrp 명령을 사용한다. 명령행에서 “-“ 및 “%”문자를 지정하는 방법에 대해서는 NOTES를 참조하기 바랍니다.
OPTIONS	-add group 클러스터에 서비스 그룹을 추가 -delete group 서비스 그룹 삭제. (서비스)그룹에는 리소스가 전혀 없어야 한다. 리소스를 삭제하기 위해서는 hares 명령을 사용한다. -link parent_group child_group dependency 서비스 그룹 간의 종속성(또는 상관관계)를 지정한다. 변수 종속성(dependency)는 다음 중 하나이다. online global [ firm | soft ] 부모 그룹(parent group)이 온라인 상태가 되기 전에 자식 그룹(child group)은 클러스터의 일부 시스템에서 온라인 상태이어야 한다. 종속성의 firm 설정에서, 자식 그룹에 오류가 발생하면 자식 그룹이 다른 시스템으로 장애 조치(failover)될 때까지 오프라인 상태가 되어야 한다. 그러면, 부모 그룹은 온라인 상태가 복귀 할 수 있다. VCS가 클러스터에서 자식 그룹을 온라인으로 가여 올 수 없을 경우, 부모 그룹은 오프라인 상태를 유지한다. 종속성을 soft로 설정하면, 자식 그룹에서 오류가 발생하고 장애 조치되는 경우 부모 그룹은 온라인 상태를 유지한다. VCS가 클러스터에서 자식 그룹을 온라인 상태로 만들 수 없으면 부모 그룹은 온라인 상태를 유지한다. online local [ firm | soft | hard ] 부모 그룹이 온라인 상태가 되기 전에 자식 그룹이 클러스터의 동일한 시스템에서 온라인 상태이어야 한다. 종속성을 firm에 설정하고 자식 그룹에 장애(fault)가 발생하면 부모 그룹이 오프라인 상태가 되어야 한다. 자식 그룹이 장애 조치를 수행하면 부모 그룹은 하위 시스템과 동일한 시스템에서 온라인으로 돌아온다. VCS가 클러스터에서 하위 그룹을 온라인으로 가져올 수 없으면 부모 그룹은 오프라인 상태를 유지한다. 종속성이 soft로 설정된 경우 자식 그룹에 오류가 발생하면 자식 그룹이 클러스터의 다른 시스템으로 장애 조치할 때까지 부모 그룹이 로컬 시스템에서 계속 실행된다. 이때 부모 그룹은 자식 그룹과 동일한 상태로 가져올 수 없으면 부모 그룹은 온라인 상태를 유지한다. 종속성을 hard로 설정한 상태에서는 자식 그룹에 장애가 발생하면 부모 그룹은 오프라인 상태가 되어야 한다. 자식 그룹이 장애 조치를 수행하면 부모 그룹은 하위 시스템으로 온라인 상태로 돌아간다. 부모 그룹이 잘못되면 자식 그룹이 오프라인 상태가 되어야 한다. 자식 그룹이 장애 조치를 수행하면 부모 그룹은 하위 시스템과 동일한 시스템에서 온라인으로 돌아온다. online remote [ firm | soft ] 부모는 온라인 상태가 되기 전에 클러스터의 다른 시스템에서 온라인 상태이어야 한다. 종속성을 firm으로 설정하면, 자식 그룹에 장애가 발생하면 부모 그룹이 오프라인 상태가되어야 한다. 자식 그룹이 클러스터의 다른 시스템으로 장애 조치를 수행하면 부모 그룹은 온라인 상태인 시스템 이외의 시스템에서 온라인으로 돌아간다. VCS가 클러스터에서 자식 그룹을 온라인으로 만들 수 없으면 부모 그룹은 오프라인 상태를 유지한다. 종속성을 soft로 설정하면 자식 그룹에 장애가 발생하면 VCS가 부모 그룹이 실행되고 있는 시스템으로 자식 그룹을 장애 조치하려고 시도하지 않는 한 부모 그룹은 계속 온라인 상태를 유지한다. 이 경우 부모 그룹은 오프라인으로 전환되어 다른 곳에서 온라인 상태가 된다. 자식 그룹을 클러스터의 어느 곳으로도 온라인 상태로 만들 수 없으면 부모는 온라인 상태를 유지한다. online site [ firm | soft ] 부모 그룹이 온라인 상태가 되기 전에 자식 그룹은 클러스터의 동일한 사이트에 연결된 시스템에서 온라인 상태이어야 한다. 종속성을 firm으로 설정하면 자식 그룹에 장애가 발생하면 부모 그룹은 오프라인 상태가 어야 한다. 자식이 장애 조치를 수행하면 부모 그룹은 자식과 동일한 사이트에서 온라인으로 돌아온다. VCS가 클러스터에서 자식 그룹을 온라인으로 만들 수 없으면 부모 그룹은 오프라인 상태를 유지한다. 종속성을 soft로 설정하면 자식 그룹이 다른 사이트로 장애 조치를 수행하면 부모 그룹이 하위 사이트와 동일한 사이트로 장애 조치된다. 그러나 자식 그룹이 동일한 사이트의 다른 시스템으로 장애 조치를 수행하면 부모 그룹은 같은 사이트에서 온라인 상태를 유지한다. offline local 부모 그룹이 온라인 상태가 되기 전에 동일한 시스템에서 자식 그룹이 오프라인 상태이어야 한다. 마찬가지로 자식 그룹이 온라인 상태라 되기 전에 부모 그룹이 동일한 시스템에서 오프라인 이어야 한다. 그룹 종속성 트리(group dependency tree)는 최대 5단계까지 가능하며 offline local 및 online hard를 제외하고 종속성이 있는 상위 그룹에는 둘 이상의 하위가 있을 수 있다. 병렬 하위 그룹에 종속된 병렬 상위 그룹은 online global 또는 online remote 종속성에서 지원되지 않는다. 장애 조치 하위 그룹에 종속된 병렬 상위 그룹의 구성은 온라인 로컬 종속성에서 지원되지 않는다. -local group attr 서비스 그룹의 속성을 지역화(localization)한다. 이 명령은 전역(global) 속성의 범위를 로컬(local) 속성으로 변경한다. 즉, 현재 속성 값은 키(key)가 그룹의 시스템인 연관체로 변환된다.\(cqs SysyemList attribute). PreOnline, ContainerInfo, TriggersEnabled 및 UserAssoc 속성들은 명령을 사용하여 지역화(localization)될 수 있다. 지역화된 속성들은 SystemList의 각 시스템에 대해 다른 값을 가질 수 있다. -global group attr value ... | key ... | {key value} 로컬(local) 속성의 범위(scope)-하나의 그룹에서 모든 시스템에 대해 실행하도록 구성된 값 또는 값의 집합을 가짐-를 글로벌(global) 속성의 범위-모든 시스템에 대한 단일 값 또는 값 집합-로 변경한다. 이 값은 명령에 지정된 값이다. 예를 들어, 로컬(local) 및 전역(global) 범위로 PreOnline 특성을 정의 할 수 없다. PreOnline, ContainerInfo, TriggersEnabled 및 UserAssoc 속성은 명령을 사용하여 전역으로 만들 수 있다. -unlink parent_group child_group 두 서비스 그룹 간의 종속성을 제거한다. 종속성은 지정되지 않는다. -clear group [-sys system] [-clus cluster | -localclus] 상태를 faulted에서 offline으로 변경하여 지정된 그룹에 있는 오류(faulted)가 있는 비 지속성 리소스을 모두 정리(clear)한다. 시스템을 지정하지 않으면 그룹의 SystemList에 있는 모든 시스템에서 모든 지원이 정리된다. 오류(faulted)가 없고 비 지속적인 리소스가 존재할 경우 메시지를 출력한다. Global Cluster 옵션이 사용 중이면 명령은 지정된 시스템이나 지정된 클러스터에 대해 비 지속성 오류(faulted) 리소스를 정리한다. 특정 클러스터를 지정하기 위해서는 –clus 또는 –localclus 옵션을 사용한다. –localclus 옵션은 명령을 실행하는 클러스터를 지정한다. 이름이 클러스터 간에 고유한 시스템이 아닐 경우, 클러스터의 이름을 지정한다. 다른 클러스터에서 전역(global) 서비스 그룹만 정리할 수 있다. -clearadminwait [-fault] group –sys system 지정된 시스템의 지정된 그룹에 있는 모든 리소스의 ADMIN_WAIT 상태를 정리한다. 리소스의 ADMIN_WAIT 상태가 계속되면, -fault 옵션을 사용하여 ADMIN_WAIT 상태를 지운다. 상태는 ResAdminWait 트리거가 호출된 이유에 따라 ONLINE | UNABLE_TO_OFFLINE 또는 FAULTED로 설정한다. 또한, 리소스가 ADMIN_WAIT 상태일 경우, hastop 명령은 –force 옵션을 필요로 한다. -flush [-force] group –sys system [-clus cluster | -localclus] 서비스 그룹을 플러쉬(flush)하고 적당한 조치를 취한다. 그룹에 있는 모든 리소스들은 waiting to go online이 자동으로 not waiting으로 전환한다. waiting to go offline 상태로 남아 있는 리소스들은 상태를 유지한다. waiting to go offline 상태에서 리소스들에 대해서는 –force 옵션은 리소스 상태를 not waiting로 전환하기 위해 사용될 수 있다. 장애 처리(failover) 또는 서비스 전환(switch) 진행사항들은 취소된다. Global Cluster Option에서 사용할 경우, 명령은 로컬 또는 원격의 지정된 시스템에서 글로벌 서비스 그룹을 플러쉬하고 적당한 조치를 취한다. 특정 클러스터를 지정하기 위해 –clus 또는 –localclus 옵션을 사용한다. –localclus 옵션은 명령을 실행하는 클러스터를 지정한다. 이름이 클러스터 간에 고유한 시스템이 아닐 경우, 클러스터의 이름을 지정한다. 글로벌 서비스 그룹에 대해서만 다른 클러스터에서 플러쉬 할 수 있다. -forecast group [-verbose] 가상 시스템 리소스가 없는 서비스 그룹의 경우 –forecast 옵션은 온라인 노드, 대상 노드 및 서비스 그룹에 대한 정책 옵션 또는 그룹 FailOverPolicy 속성 중 하나를 사용하여 지정된 FailOverPolicy 값을 표시한다. 대상 노드는 HostAvailableForecast 특성 값을 기반으로 평가된다. 가상 시스템 리소스가 있는 서비스 그룹의 경우 대상 노드에 대한 –forecast 옵션은 ServerAvailableForecast 특성 값을 기반으로 한다. -verbose 옵션은 온라인 노드, 대상 노드 및 서비스 그룹에 대한 FailOverPolicy 속성 값을 표시한다. 또한 MeterWeight 및 부하(load) 속성 값을 표시한다. BiggestAvailable 정책은 대상 노드를 선택할 때 MeterWeight 및 부하(load) 특성을 고려해야 한다. MeterWeight 특성이 그룹 수준에서 구성되지 않은 경우 해당 값은 Cluster :: Meterweight 특성에서 검색됩니다. –verbose 옵션은 대상 노드 선택시 고려하는 시스템이 표시된다. 예측 Free / Total Capacity는 시스템이 그룹에 대한 부하(load) 요구 사항을 충족시키는 지 여부에 따라 시스템의 사용 가능한 총 용량을 표시한다. 시스템 가중치 속성은 시스템의 사용 가능한 용량과 MeterWeight 속성을 기반으로 계산된 숫자이다. 이 명령은 또한 대상 시스템에 별표(*)를 표시한다. -online [-force] [-nopre] group –sys system ][-checkpartial system] [-clus cluster | localclus] 리소스를 지정된 시스템에서 온라인으로 가져와서 서비스 그룹을 시작한다. AutoStart 속성이 0으로 설정된 리소스는(기본 값은 1)은 AutoStart가 1로 설정된 리소스에 의존하지 않는 한 이 명령으로 시작되지 않는다. –nopre 옵션은 다시 Preonline 트리거를 실행하지 않고 온라인 서비스 그룹을 가지고 사용자 정의 Preonline 이벤트 트리거 스크립트 내에서 사용할 수 있다. -checkpartial 옵션은 장애 조치 중에 Preonline 트리거에 의해 사용된다. 하나의 시스템(system1) 에서 Preonline=1로 구성된 서비스 그루이 다른 시스템(system2)으로 장애 조치(failover) 이전에 system1의 온라인 리소스만 system2에서 온라인 상태가 된다. GCO(Clobal Cluster Option)이 사용하는 경우, 명령은 지정된 클러스터의 지정된 시스템에서 지정된 전역 서비스 그룹(Global service group)을 온라인 상태로 만든다. 특정 클러스터를 지정하기 위해 –clus 또는 –localclus 옵션을 사용한다. –localclus 옵션은 명령어를 실행하는 클러스터를 지정한다. –force 옵션은 그룹에 대한 권한을 가진 다른 클러스터에 결합(fault)이 있을 때 클러스터의 글로벌 그룹을 온라인화 하는데 사용될 수 있다. 이름이 클러스터 간에 공유하지 않은 시스템의 경우, 클러스터의 이름을 지정한다. 글로벌 서비스 그룹만 다른 클러스터에서 온라인 상태로 만들 수 있다. -online [-force] group –any [-clus cluster | -localclus] -any 옵션은 그룹의 FailOverPolicy 속성의 값에 따라, 클러스터에서 가장 적절한 시스템에서(best possible system)으로 리소스를 온라인으로 가져옴으로써 서비스 그룹을 시작하기 위해 사용된다. 병렬 서비스 그룹(parallel service group)으로 구성된 경우 클러스터의 여러 시스템에서 온라인으로 전환된다. 하이브리드(hybrid) 서비스 그룹(Parallel 속성이 2로 설정된 그룹)은 각 사이트의 모든 시스템에서 온라인 상태가 된다. AutoStart 속성이 0으로 설정된 리소스(기본 값은 1)은 AutoStart가 1로 설정된 리소스가 리소스에 의존하지 않는 한 이 명령은 지정된 클러스터의 모든 시스템에서 지정된 전역 서비스 그룹을 온라인 상태로 생성한다. 특정 클러스터를 지정하기 위해 –clus 또는 –localclus 옵션을 사용한다. –localclus 옵션은 명령어를 실행하는 클러스터를 지정한다. –force 옵션은 그룹에 대한 권한을 가진 다른 클러스터에 결합(fault)이 있을 때 클러스터의 글로벌 그룹을 온라인화 하는데 사용될 수 있다. 글로벌 서비스 그룹만 다른 클러스터에서 온라인 상태로 만들 수 있다. -online group –site site -site 옵션은 온라인 리소스를 가져와서 사이트의 모든 시스템에서 서비스 그룹을 시작하는데 사용할 수 있다. AutoStart 속성이 0으로 설정된 리소스(기본 값은 1)은 AutoStart가 1로 설정된 리소스에 의존하지 않은 한 이 명령으로 시작되지 않는다. 서비스 그룹이 병렬(Parallel 속성이 1로 설정된 그룹)인 경우 서비스 그룹은 사이트의 모든 시스템에서 온라인 상태가 된다. -online [-propagate] group –sys system -propagate 옵션을 사용하며 온라인 그룹을 가져올 때, 그 요구하는 하위 그룹도 모두 온라인 상태를 지정한다. AutoStart 속성이 0으로 설정된 리소스(기본 값은 1)은 AutoStart가 1로 설정된 리소스가 리소스에 의존하지 않는 한 이 명령으로 시작되지 않는다. 예를 들어, G1이 G3에 의존하는 G2에 의존하는 경우, G1이 –propagate 옵션과 함께 온라인 상태가 되면 G2와 G3은 온라인이 아닌 경우 온라인이 된다. –propagate 옵션은 로컬 하드(local hard), 로컬 펌(local firm), 로컬 소프트(local soft), 글로벌 펌(global firm), 글로벌 소프트(global soft), 원격 펌(remote firm), 원격 소프트(remote soft), 사이트 소프트(site soft) 및 사이트 펌(site firm) 종속성이 있는 모든 하위 그룹에 적용된다. 지정된 서비스 그루이 현재 온라인 상태가되거나 오프라인 상태이거나 다른 시스템으로 장애가 진행 중일 수 없다. -online [-propagate] group –any -any 옵션은 그룹의 FailOverPolic 속성의 값에 따라, 클러스터에 최상의 시스템, 온라인 서비스 그룹 및 필요한 하위 그룹을 가지고 사용할 수 있다. 병렬 서비스 그룹은 구성된 경우 클러스터의 여러 시스템에서 온라인으로 전환된다. AutoStart 속성이 0으로 설정된 리소스(기본 값은 1)은 AutoStart가 1로 설정된 리소스가 리소스에 의존하지 않는 한 이 명령으로 시작되지 않는다. 예를 들어, G1이 G3에 의존하는 G2에 의존하는 경우, G1이 –propagate 옵션과 함께 온라인 상태가 되면 G2와 G3은 온라인이 아닌 경우 온라인이 된다. –propagate 옵션은 로컬 하드(local hard), 로컬 펌(local firm), 로컬 소프트(local soft), 글로벌 펌(global firm), 글로벌 소프트(global soft), 원격 펌(remote firm), 원격 소프트(remote soft), 사이트 소프트(site soft) 및 사이트 펌(site firm) 종속성이 있는 모든 하위 그룹에 적용된다. 지정된 서비스 그루이 현재 온라인 상태가되거나 오프라인 상태이거나 다른 시스템으로 장애가 진행 중일 수 없다. -online [-propagate] group –site site -propagate 옵션은 그룹 및 모든 하위 그룹을 온라인으로 전환하도록 지정한다. 사우이 그룹은 사이트의 모든 시스템에서 온라인 상태가 된다. 그러나 자식 그룹은 종속성 유형에 따라 시스템에서 온라인 상태가 된다. 전역 종속성 유형(Global dependency option)이 있는 하위 그룹은 클러스터의 모든 시스템에서 온라인 상태가 되는 반면 사이트 종속성이 있는 하위 그룹은 동일한 사이트의 모든 시스템에서 온라인 상태가 된다. AutiStart 속성이 0으로 설정된 리소스(기본 값은 1)은 AutoStart가 1로 설정된 리소스가 리소스에 의존하지 않는 한 이 명령에 의해 시작되지 않는다. 예를 들어, G1이 G3에 의존하는 G2에 의존하는 경우, G1이 –propagate 옵션과 함께 온라인 상태가 되면 G2와 G3은 온라인이 아닌 경우 온라인이 된다. –propagate 옵션은 로컬 하드(local hard), 로컬 펌(local firm), 로컬 소프트(local soft), 글로벌 펌(global firm), 글로벌 소프트(global soft), 원격 펌(remote firm), 원격 소프트(remote soft), 사이트 소프트(site soft) 및 사이트 펌(site firm) 종속성이 있는 모든 하위 그룹에 적용된다. -offline [-force] [-ifprobed] group –sys system [-clus cluster | -localclus] 지정된 시스템에서 리소스를 오프라인으로 가져가는 서비스 그룹을 중지한다. –force 옵션은 ClusterService 그룹을 오프라인해야 한다. 참고적으로, GCO(Global Cluster Option)을 사용 중인 경우, GlobalService 그룹을 오프라인화하지 않는 것이 좋다. 글로벌 클러스터 옵션이 사용 중이면 명령은 지정된 클러스터의 지정된 시스템에서 지정된 전역 서비스 그룹(Global service group)을 오프라인으로 생성한다. 특정 클러스터를 지정하기 위해 –clus 또는 –localclus 옵션을 사용한다. –localclus 옵션은 명령어를 실행하는 클러스터를 지정한다. –force 옵션은 그룹에 대한 권한을 가진 다른 클러스터에 결합(fault)이 있을 때 클러스터의 글로벌 그룹을 온라인화 하는데 사용될 수 있다. 글로벌 서비스 그룹만 다른 클러스터에서 오프라인으로 전환 할 수 있다. -offline [-force] [-ifprobed] group –any [-clus cluster | -localclus] -any 옵션은 클러스터 내 모든 시스템에서 해당 리소스를 오프라인으로 서비스 그룹을 중지할 수 있다. –force 옵션은 ClusterService 그룹을 오프라인해야 한다. 참고적으로, GCO(Global Cluster Option)을 사용 할 경우, GlobalService 그룹을 오프라인으로 설정하지 않는 것이 좋다. 글로벌 클러스터를 사용하는 경우 명령은 지정된 클러스터의 시스템에서 지정된 전역 서비스 그룹을 오프라인으로 만든다. 특정 클러스터를 지정하기 위해 –clus 또는 –localclus 옵션을 사용한다. –localclus 옵션은 명령어를 실행하는 클러스터를 지정한다. –force 옵션은 그룹에 대한 권한을 가진 다른 클러스터에 결합(fault)이 있을 때 클러스터의 글로벌 그룹을 온라인화 하는데 사용될 수 있다. 글로벌 서비스 그룹만 다른 클러스터에서 오프라인으로 전환할 수 있다. -offline group –site site 사이트의 모든 시스템에서 지정된 서비스 그룹을 중지한다 -offline [-propagate] group –sys system -propagte 옵션을 사용하면 그룹을 오프라인으로 가져올 때, 하드(hard) 및 펌(firm) 의존성과의 필요한 부모 그룹을 모두 오프라인으로 전환되는 것을 지정한다. 소프트(soft) 종속성을 가진 부모는 하위 그룹이 오프라인 일 때도 온라인 상태를 유지할 수 있기 때문에 소프트(soft) 종속성을 가진 부모는 오프라인으로 전환되지 않는다. 예를 들어, G1에 G2에 대한 펌(firm) 종속성이 있고, G2에 G3에 대한 펌(form) 종속성이 있는 경우, 오프라인 G3에 –propagte 옵션을 사용하여 명령을 실행하면 G1, G2 및 G3이 오프라인 상태가 된다. –propagate 옵션은 로컬 하드(local hard), 로컬 펌(local firm), 로컬 소프트(local soft), 글로벌 펌(global firm), 글로벌 소프트(global soft), 원격 펌(remote firm), 원격 소프트(remote soft), 사이트 소프트(site soft) 및 사이트 펌(site firm) 종속성이 있는 모든 상위 그룹에 적용된다. -offline [-propagate] group –any -any 옵션은 클러스터 내 모든 시스템의 그룹 및 하드(hard) 및 펌(firm) 종속 오프라인과의 필요한 부모 그룹의 모든 것을 가져오는데 사용할 수 있다. 소프트(soft) 종속성을 가진 부모는 하위 그룹이 오프라인 일 때도 온라인 상태를 유지할 수 있기 때문에 소프트 종속성을 가진 부모는 오프라인으로 전환되지 않는다. 예를 들어, G1에 G2에 대한 펌(firm) 종속성이 있고 G2에 G3에 대한 펌(form) 종속성이 있는 경우, 오프라인 G3에 –propgate 옵션을 사용하여 명령을 실행하면 G1, G2 및 G3이 오프라인 상태가 된다. –propagate 옵션은 로컬 하드(local hard), 로컬 펌(local firm), 로컬 소프트(local soft), 글로벌 펌(global firm), 글로벌 소프트(global soft), 원격 펌(remote firm), 원격 소프트(remote soft), 사이트 소프트(site soft) 및 사이트 펌(site firm) 종속성이 있는 모든 상위 그룹에 적용된다. -offline [-propagate] group –site site -propagte 옵션은 그룹을 오프라인으로 설정하고 필요한 모든 상위 그룹을 오프라인으로 지정한다. 그룹은 사이트의 모든 시스템에서 오프라인으로 전환된다. 그러나 상위 그룹은 종속성 유형에 따라 오프라인 상태가 된다. 전역 종속성을 가진 상위 그룹은 클러스터의 모든 시스템에서 모든 시스템에서 오프라인으로 전환된다. 소프트(sofr) 종속성을 가진 부모는 하위 그룹이 오프라인 일 때도 온라인 상태를 유지할 수 있기 때문에 소프트 종속성을 가진 부모는 오프라인으로 전환되지 않는다. 예를 들어, G1에 G2에 대한 펌(form) 종속성이 있는 경우 오프라인 G3에 –propagate 옵션을 사용하여 명령을 실행하면 G1, G2 및 G3이 오프라인 상태가 된다. –propagate 옵션은 로컬 하드(local hard), 로컬 펌(local firm), 로컬 소프트(local soft), 글로벌 펌(global firm), 글로벌 소프트(global soft), 원격 펌(remote firm), 원격 소프트(remote soft), 사이트 소프트(site soft) 및 사이트 펌(site firm) 종속성이 있는 모든 상위 그룹에 적용된다. -switch group –to system [-clus cluster | -localclus [-nopre]] 서비스 그룹이 활성화된 시스템에서 지정된 시스템으로 전환된다. 이는 장애 조치(failover) 그룹(Parallel 특성이 0으로 설정된 그룹)에만 적용된다. 글로벌 클러스터를 사용하는 경우 명령은 글로벌 서비스 그룹을 시스템에서 지정된 원격 클러스터의 지정된 시스템으로 전환한다. 특정 클러스터를 지정하기 위해 –clus 또는 –localclus 옵션을 사용한다. –localclus 옵션은 명령어를 실행하는 클러스터를 지정한다. 글로벌 서비스 그룹만 다른 클러스터내에서 또는 다른 클러스터 간에 전환 할 수 있다. 원격 클러스터의 글로벌 그룹 정의에서 PreSwitch 그룹 속성 값을 1로 설정하면 VCS 엔진이 PreSwitch 작업을 지원하는 리소스에 대해 PreSwitch 작업을 호출한다. 모든 작업이 성공하면 엔진이 서비스 그룹을 정상적으로 전환한다. 장애 조치 중 하나라도 실패하면 엔진은 스위치 조작을 중단한다. 자세한 내용은 클러스터 서버 관리자 가이드를 참조하기 바랍니다. -nopre 옵션은 VCS 엔진은 PreSwitch 서비스 그룹 속성의 값에 관계없이 서비스 그룹을 전환해야 함을 나타낸다. -switch group –any [-clus cluster | -localclus] -any 옵션은 그룹의 FailOberPolicy 속성의 값에 따라, 현재 온라인 상태가 되는 최상의 시스템으로 서비스 그룹을 전환할 수 있다. 글로벌 클러스터를 사용하는 경우 명령은 글로벌 서비스 그룹을 시스템에서 로컬 또는 원격의 지정된 클러스터에 있는 시스템으로 전환한다. 특정 클러스터를 지정하기 위해 –clus 또는 –localclus 옵션을 사용한다. –localclus 옵션은 명령어를 실행하는 클러스터를 지정한다. 글로벌 서비스 그룹만 다른 클러스터에서 클러스터 내에서 또는 클러스터 간에 전환할 수 있다. –any 옵션은 VCS 엔진은 1로 PreSwitch 그룹 속성의 값을 설정한 경우에도 모든 리소스의 PreSwitch 조치를 호출하지 않는다. 이 명령을 실행하여 클러스터 전체에서 병렬 글로벌 서비스 그룹을 전환하면 VCS는 원격 클러스터의 가능한 모든 노드에서 병렬 서비스 그룹을 온라인 상태로 만든다. -switch group –site site -switch 옵션은 사이트의 모든 시스템에 활성화되어 있는 시스템에서 서비스 그룹을 전환할 수 있다. 스위치 작업은 장애 조치 그룹(Parallel 특성이 0으로 설정된 그룹)에만 적용된다. -freeze group –persistent 서비스 그룹 고정(onlining, offlineing 및 failover 비활성화). –persistent 플래그는 시스템이 재부팅 된 후 상태 고정 유지를 나타내거나, 또는 엔진이 정지되고 다시 시작된다. 이 옵션을 사용하려면 클러스터 구성 모드를 읽기/기록 모드로 설정해야 한다. -freeze group [-clus cluster | -localclus] 서비스 그룹의 상태를 고정한다(onlining, offlineing 및 failover를 못하게 한다). Global Cluster Option이 사용 중이면 명령은 지정된 클러스터의 지정된 글로벌 서비스 그룹을 고정시킨다. 특정 클러스터를 표시하기 위해 –clus 또는 localclus 옵션을 선택 사용한다. –localclus 옵션은 명령이 실행되는 클러스터를 지정한다. 글로벌 서비스 그룹만 다른 클러스터에서 상태 유지(freeze)될 수 있다. -unfreeze group –persistent 서비스 그룹의 상태 유지(freeze)를 해제한다(onlining, offlineing 및 failover가 다시 활성화 된다). –persistent 플래그는 시스템이 재부트 되었거나 또는 VCS 엔진이 정지 또는 재 시작한 이후에 상태 유지 기능이 해제되었음을 가리킨다. 이 옵션을 사용하려면 클러스터 구성 모드를 읽기/기록 모드로 설정해야 한다. -unfreeze group [-clus cluster | -localclus] 서비스 그룹의 상태 유지(freeze)를 해제한다(onlining, offlineing 및 failover가 다시 활성화 된다). Global Cluster Option을 사용 중인 경우 이 명령은 지정된 클러스터의 지정된 글로벌 서비스 그룹의 상태 고정을 해제한다. 특정 클러스터를 표시하기 위해 –clus 또는 localclus 옵션을 선택 사용한다. –localclus 옵션은 명령이 실행되는 클러스터를 지정한다. 글로벌 서비스 그룹만 다른 클러스터에서 상태 유지(freeze)를 해제 할 수 있다. -enable group [-sys system] 서비스 그룹을 사용 가능하게 한다.   -disable group [-sys system] 서비스 그룹을 사용할 수 없게 한다. -autoenable group –sys system VCS는 주어진 시스템에서 주어진 서비스 그룹의 상태를 알지 못하면 해당 시스템에 대해 AudoDisabled 속성을 1로 설정하여 해당 서비스 그룹을 자동 비활성화로 표시한다. VCS가 해당 시스템에서 실행되고 있지 않거나 해당 시스템의 서비스 그룹에 있는 모든 리소스가 아직 탐색 되지 않은 경우에 발생할 수 있다. 자동 비활성화되는 경우 서비스 그룹을 온라인 또는 장애 조치(failover)할 수 없다. 이 동작을 재정의하려면 autoenable 옵션을 사용하여 시스템의 서비스 그룹에 대한 AutoDisabled 플래그를 지울 수 있다. 예를 들어, «hagrp –autoenable foo –sys bar»는 시스템에서 서비스 그룹 foo에 대해 AutoDisabled 플래그를 지운다. 주의할 것은, VCS가 자동 비활성화 한 후에 그룹을 수동으로 온라인 상태로 만들려면 AutoDisabled 속성이 VCS에 의해 1로 설정된 시스템에서 그룹이 완전히 또는 부분적으로 활성화되어 있지 않은지 확인하도록 한다. 특히 여러 시스템에서 활성화되어 손상될 수 있는 모든 리소스가 지정된 시스템에서 동작이 중지되었는지 확인하도록 한다. 그런 다음 각 시스템의 AudoDisabled 속성을 지우도록 한다. # hagrp –autoenable service_group –s system_name -enableresources group 서비스 그룹의 모든 리소스를 활성화 한다. 에이전트는 그룹의 리소스를 모니터링 한다. -disableresources group 서비스 그룹의 모든 리소스를 비활성화 한다. 에이전트는 그룹의 리소스를 모니터링 하지 않는다. -ignore group –clus cluster -ignore 옵션은 지정된 원격 클러스터에서 오프라인으로 선택한 원격 그룹을 표시한다. 지정된 원격 클러스터 장애(faulted) 상태에 있다. 이 옵션은 haclus 명령의 –status 및 -failover 옵션과 함께 사용된다. 이렇게 하면 로컬 클러스터에서 볼 때 오류가 발생한 클러스터의 그룹을 무시한다. 무시된 그룹은 haclus 명령의 –status 및 –failover 옵션 출력에 나열되지 않는다. -display [group(s)] [-attribute attribute(s)] [-sys system(s)] [-clus cluster | -localclus] 지정된 그룹(그룹이 지정되지 않은 경우 모든 그룹)에 대한 속성 및 값을 표시한다. 시스템이 지정된 경우 지정된 시스템에 지정된 그룹의 속성(attribute) 및 값(value)를 표시한다 클러스터가 지정되면 지정된 클러스터에 지정된 그룹의 속성과 값을 표시한다. 글로벌 클러스터 옵션을 사용 중인 경우, 이 명령은 모든 클러스터의 모든 시스템에 대해 지정된 정보를 표시한다. 특정 클러스터를 나타내기 위해 –clus 또는 –lcoalclus 옵션을 사용한다. –localclus 옵션은 명령이 발행되는 클러스터를 지정한다. 이름이 클러스터 간에 고유하지 않은 시스템의 경우, 클러스터의 이름을 지정한다. 글로벌 그룹의 속성 값만 클러스터에 표시 될 수 있다. -state [group(s)] [-sys system(s)] [-clus cluster | -localclus] 지정된 클러스터에서 지정된 시스템의 지정된 그룹(또는 시스템이 지정되지 않은 경우 모든 시스템)의 현재 상태를 표시한다. Global Cluster 옵션을 사용 중인 경우 명령은 지정된 시스템의 상태를 나열한다. 특정 클러스터를 표시하는 옵션을 선택하기 위해 –clus 또는 –localclus를 사용한다. –localclus 옵션은 명령이 실행되는 클러스터를 지정한다. 이름이 클러스터간에 고유하지 않은 시스템의 경우, 클러스터의 이름을 지정한다. 전역 그룹의 상태만 클러스터에 표시될 수 있다. -list group attr system [-clus cluster | -localclus] 지정된 조건문과 값이 일치하는 그룹 목록을 표시한다. 조건문은 세가지 형식을 취할 수 있다. Attribute=Value         Attribute!=Value                  Attribute=~Value 여러 조건문은 AND 논리를 의미한다. 조건문을 지정하지 않으면 클러스터의 모든 그룹이 나열된다. 글로벌 클러스터 옵션을 사용 중인 경우 이 명령은 모든 클러스터의 지정된 그로벌 그룹을 나열한다. 특정 클러스터를 표시하는 옵션을 선택하기 위해 –clus 또는 –localclus를 사용한다. –localclus 옵션은 명령이 실행되는 클러스터를 지정한다. 글로벌 그룹에 대해서만 클러스터를 통해 표시할 수 있다. -value group attr system [-clus cluster | - localclus] -value 옵션은 단일 그룹 속성의 값을 제공한다. 예를 들어, hagrp –value groupX state sysb –clus C2는 원격 클러스터 C2에서 시스템 sysb에 있는 groupX에 대한 상태(state) 속성의 값을 표시한다. 클러스터가 지정되지 않으면 로컬 클러스터가 고려된다. 로컬 속성 값에는 시스템 이름을 지정해야 하지만 전역 속성 값에는 지정하지 않아야 한다. –value 옵션은 하나의 특정 송성 값이 필요한 경우 많은 속성 값의 테이블이 필요한 –display 옵션 대신에 사용된다. 글로벌 클러스터 옵션을 사용 중인 경우 이 명령은 모든 클러스터의 속성 값을 표시한다. 특정 클러스터를 표시하는 옵션을 선택하기 위해 –clus 또는 –localclus를 사용한다. –localclus 옵션은 명령이 실행되는 클러스터를 지정한다. 이름이 클러스터 간에 공유하지 않은 시스템의 경우, 클러스터의 이름을 지정한다. 전역 그룹의 속성 값만 클러스터 전체에 표시될 수 있다. -dep [group(s)] 그룹간 종속성을 표시한다. -resource group [-clus cluster | -localclus] 서비스 그룹의 리소스를 나열한다. 글로벌 클러스터의 경우 –clus 또는 –localclus 옵션을 사용하여 특정 클러스터를 나타낸다. –localclus 옵션은 명령이 실행되는 클러스터를 지정한다. -wait group attribute value [-clus cluster] [-sys system] [-time timeout] -wait 옵션은 속성 값이 지정된 대로 변경 될 때가지 또는 시간 초과가 만료 될 때가지 스크립트에서 hagrp 명령을 차단하도록 지시하는 데 사용된다. 제한 시간을 지정하지 않으면 명령 줄 인터페이스가 무기한 차단된다. timeout은 초를 지정하는 정수이다. See EXAMPLES를 참조하도록 한다. –wait 옵션은 스칼라(scalar) 속성 변경 시에만 사용할 수 있다. –sys 옵션은 속성의 범위가 로컬 일 때에만 적용될 수 있다. –clus 옵션은 글로벌 클러스터 환경에서 –wait 옵션을 적용할 때만 적용된다. 원격 클러스터와 스칼라 그룹 수준 속성은 hagrp –display –clus remote_cluster 명령을 사용하여 표시할 수 있는 수준으로 제한된다. -help [-modify | -link | -list] hagrp 사용에 대한 정보를 표시한다. –modify 옵션은 특정 도움말을 수정한다. –link 옵션은 링크 특정 도움말을 제공한다. –list 옵션은 목록 특정 도움말을 제공한다. -modify modify_options -modify 옵션을 사용하면 서비스 그룹의 속성을 수정할 수 있다. 속성을 수정하기 전에 구성을 읽기-기록 모드로 설정해야 한다. 일부 속성(예: ProbesPending)은 VCS 내부에 있으므로 수정할 수 없다. main.cf에서 구성할 수 있는 모든 속성을 수정할 수 있다. 스칼라 속성의 기존 값을 수정할 수 있다. 벡터, 키 목록 또는 연관 속성에 대해 이미 정의 된 값을 변경하려며 –modify를 사용할 수 없다. 벡터, 키 목록 및 연관 속성의 경 –add, -delete, -update 또는 –delete –keys인  modify_option 중 하나를 사용한다. –modify 명령의 허가된 목록은 다음을 참조하기 바랍니다. # hagrp –help –modify를 사용하여 명령을 표시할 수 있다. SCALAR hagrp –modify group attr value [-sys system] VECTOR 속성에 값이 없는 경우에만 다음 명령을 사용한다. hagrp –modify group attr value ... [-sys system] 값이 정의된 벡터 속성의 경우 다음 작업만 허용된다. hagrp –modify group attr –add value ... [-sys system] hagrp –modify group attribute –insert index value ... [-sys system] -insert 옵션을 사용하여 지정된 인덱스에 하나 이상의 값을 추가할 수 있다. 여기에 유효한 정수를 입력해야 한다. index 값의 최대 수91)에 이르기 까지 다양할 수 있다. hagrp –modify group attr –delete key ... [-sys system] hagrp –modify group attr –delete -keys ... [-sys system] KEYLIST 속성에 값이 없는 경우에만 다음 명령을 사용한다. hagrp –modify group attr key... [-sys system] hagrp –modify group attribute –insert index key ... [-sys system] -inset 옵션을 사용하여 지정된 인덱스에 하나 이상의 값을 추가할 수 있다. index에 유효한 정수를 입력해야 한다. 범위는 1에서 키에 대한 최대 값 수까지 이다. hagrp –modify group attr –delete key ... [-sys system] hagrp –modify group attr –delete keys ... [-sys system] ASSOCIATION 속성에 값이 없는 경우에만 다음 명령을 사용한다. hagrp –modify group attr {key value}... [-sys system] 값이 정의된 연관 속성의 경우 다음 조작만 허용된다. hagrp –modify group attr –add {key value} ... [-sys system] hagrp –modify group attr –update {key value} ... [-sys system] hagrp –modify group attr –delete key... [-sys system] hagrp –modify group attr –delete –keys [-sys system] -migrate service_group –to system 시스템에서 다른 시스템으로 서비스 그룹을 마이그레이션한다. 마이그레이션 명령은 실시간 마이그레이션을 지원하는 리소스가 포함된 서비스 그룹에만 적용할 수 있다.
EXAMPLES	mars01 시스템에서 서비스 그룹 dg_grp를 온라인으로 가져오기 # hagrp –online db_grp –sys mars01 스크립트에서 –wait 옵션을 사용하여 시스템 mag01에서 서비스 그룹 dg_grp이 ONLINE 될 때가지 hagrp 명령을 차단 지시 #hagrp –wait db_grp State ONLINE –sys mars01 시스템 mars01, mars02 및 mars03에서 상위 그룹 db_grp은 자식 그룹 vol_grp에 온라인 online local firm dependency, vol_grp는 자식 그룹 dj_grp에 online local firm dependency로 구성되어 있다. 시스템 mars01에서 부모 그룹 db_grp 및 필요한 모든 하위 그룹을 온라인 상태로 만들려면: # hagrp –online –propagate db_grp –sys mars01 시스템 mars01, mars02 및 amrs03에서 상위 그룹 db_grp은 그룹 vol_grp에 online local firm dependency, vol_grp는 그룹 dk_grp에 online local firm dependency 구성되어 있다. 자식 그룹 dk_grp 및 모든 종속 상위 그룹을 오프라인으로 만들려면: # hagrp –offline –propagate dk_grp –any # hagrp –forecast group –verbose의 샘플 명령 결과: 다음 출력은 가상 시스템 리소스가 없는 서비스 그룹에 대한 것이다. Target Node         node 1 Online Node(s)      FailOverPolicy      BiggestAvailable Total MeterWeight    16.00                     CPU(Units)  Mem(Units) Swap(Units)    MeterWeight           10           5           1                                  CPU(CPU)    Mem(MB)    Swap(MB)       Load                 2.00        1200.00   1200.00         Forecasted Free/Total Capacity(%free)       Systems CPU(CPU)        Mem(MB)               .... *node 1 3.96/4.00(99)%  1276.00/2896.00(44)%  node 2  4.00/4.00(100)% 1331.00/2896.00(45)%  node 3  3.98/4.00(99)%  1284.00/2896.00(44)%           Swap (MB)        SCPU (CPU)    SMEM (MB)                                                                                                                                                                                                           2553.00/2560.00(99)%                   -                                                                     -     1529.00/1536.00(99)%                   -                                                                            -                                                                                                                    1529.00/1536.00(99)%                   -                                                                            -                                                                         Loads Met        SysWeight/Total MeterWeight                                                                          Yes                 15.69/16.00                                                                          Yes                 15.60/16.00                                                                           Yes                    15.37/16.00 # hagrp –forecast VirtualMachineGroup –policy BiggestAvailable -verbose 다음 출력은 가상 시스템 리소스가 있는 서비스 그룹에 대한 것이다. Target Node            Node1 Online Node(s)         Node2 FailOverPolicy         BiggestAvailable Total MeterWeight      20.00                         CPU(Units) Mem(Units) Swap(Units)  SCPU(Units)     SMem(Units) MeterWeight             -           -          -                        10              10                        CPU(CPU)   Mem(MB)   Swap(MB)      SCPU(CPU)       SMem(MB) Load                    -           -          -            12.00           4096.00                         Forecasted Free/Total Capacity(%free) Systems                 CPU(CPU)                Mem(MB)            Swap(MB)                                                        *Node1                    -                       -                     -                                Node3                    -                       -                     -                                                            SCPU(CPU)               SMem(MB)                         47.00/128.00(36%)       17600.00/65526.00(26%)                         12.00/128.00(9%)        9504.00/65526.00(14%)                         Loads Met       SysWeight/Total MeterWeight                         Yes             20.00/20.00                         Yes             7.95/20.00 # hagrp –forecast group의 샘플 명령 출력: Target Node   node 1 Online Node(s)            - FailOverPolicy            BiggestAvailable
NOTES	VCS 엔진이 일부 hagrp 명령을 거부 할 수 있다. 예를 들어, 그룹이 클러스터의 다른 곳에서 온라인 상태이거나 해당 시스템에서 그룹에 오류가 발생하면 VCS에서 시스템의 자애 조치 서비스 그룹을 온라인으로 만들 수 없다. 명령을 사용하여 대시(“-“)로 시작하는 속성 값을 지정하거나 수정하는 경우, 값 앞에 퍼센트 기호(“%”)를 붙인다. 예를 들어, -y를 %-y로 지정한다. 마찬가지로 백분율 기호로 시작하는 값 앞에 다른 백분율 기호를 붙인다.
SEE ALSO	hares(1M), haclus(1M), haconf(1M0