Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

리소스 그룹은 장애가 발생했을 때에 페일오버 되는 리소스들의 집합을 말합니다.
MCCS는 노드간의 페일오버를 그룹 단위로 수행합니다. 따라서 페일오버가 되는 단위로 리소스들을 묶어 그룹으로 만들어야 합니다.
또한 하나의 클러스터에는 여러 개의 그룹을 생성할 수 있습니다.A resource group is a resource set where failover is performed when trouble occurs.
MCCS performs failover of nodes on a group basis. Thus, you need to group the resources in the unit of failover.In addition, within a cluster, you can create multiple groups.

 

Column
width350px
Panel

이 페이지의 주요 내용Table of Contents

Table of Contents
maxLevel4

리소스 그룹 속성

그룹의 속성은 그룹의 상태 뷰와 속성 뷰에서 파악할 수 있습니다.
MCCS 웹콘솔의 그룹 관리 뷰에서 그룹 선택 후 오른쪽의 '그룹 속성값' 탭의 상세 정보를 볼수 있습니다.

회색으로 표기된 값은 읽기 전용입니다. 이 값들은 그룹 상태를 나타내기 위한 정보입니다.
흰색으로 표기된 값은 사용자에 의해 정의 된 또는 수정가능한 값입니다. 

Image Removed

[그림] 그룹 속성 화면

...

Resource Group Attribute

Group attribute can be identified from Group Attributes view and Group State view.
From the group management view of MCCS web console, select group, then select the ‘Group Attributes’ tab located on right top of detailed information panel.

The values of gray colored are for read only. They just contain and show the information of group state. The values of white colored are configurable by user definition.

Image Added

[Figure] Group Attribute View

 

 

AttributeDescriptionTypeDefaultEditNote
ActionState

It represents the action status for the ongoing group.
Resource online in progress: STARTING
Resource offline in progress: STOPPING
Online/offline: WATCHING

STRING X

 

AutoDisabled

자동비활성화 된 상태입니다.
노드에서 엔진이 운영 중이거나, 그룹내의 리소스에 대한 모니터링이 완료되진 않은 경우,
리소스의 배타적 실행을 보장 할 수 없는 경우에 true로 나타냅니다Automatically disabled.
If a engine is being operated or monitoring of the resources in a group is not finished, it cannot guarantee exclusive execution of the resource and it is set to True.

BOOLEAN false 
AutoFailover그룹 내에 장애가 발생하였을 때 자동으로 페일오버 할 것인지를 결정합니다Determine whether to perform automatic failover when trouble occurs within the group.BOOLEANtrueO 
AutoFaultClearTIme

장애 발생 후에 페일오버가 되고 이 시간 값만큼 정상 온라인을 유지하면
그룹의 모든 장애 상태를 제거합니다A failover occurs after trouble is detected, and it remains online for the given time limit. After that, all the trouble status will be removed.
'0'
인 경우는 장애를 제거하지 않은 상태를 말합니다implies that troubles are not removed.

INTEGER0초0 secO 
AutoRestart

그룹이 감지 전용 리소스 장애로 시작되지 못한 경우에 그 리소스가 정상화 되거나
노드 상태가 정상 상태로 변경될 경우에 자동으로 다시 시작할지를 결정합니다.
AutoStart가 true로 설정되어야만 동작합니다If a group is not started because of failures in resource for detection, determine whether to automatically start it when the resource or node is normalized.
It will operate properly only if AutoStart is set to true.

BOOLEANfalseO 
*AutoStart엔진이 시작되면 그룹을 자동으로 시작하는지를 알려줍니다When the engine starts, it will notify when the group will be started automatically.BOOLEANtrueO 
BatchAfterOnline

그룹을 온라인 한 후에 실행할 배치 파일을 설정합니다.
배치 파일의 성공, 실패 여부가 그룹의 진행상황에는 영향을 받지 않습니다Set the batch file to run after a group goes online.
Whether the batch file is successful or failed, it does not affect the progress of a group.

FILE O 
BatchBeforeOffline

그룹을 오프라인 하기 이전에 실행할 배치 파일을 설정합니다.
배치 파일의 성공, 실패 여부가 그룹의 진행상황에는 영향을 받지 않습니다.Set the batch file to run before a group goes offline.
Whether the batch file is successful or failed, it does not affect the progress of a group. 

FILE O 
BatchTimeout배치 파일의 실행 완료 제한 시간을 지정합니다Designate the time out for running the batch file.INTEGER300초300 secO 
Enabled

그룹 관리를 가능하게 합니다.
속성 값이 'false'로 설정되면 그룹을 제어할 수 없습니다It allows group to be managed.If the attribute value is set to 'false', a group cannot be controlled.

BOOLEANtrueO 
*Failover

장애로 인한 페일오버가 진행 중인지 나타냅니다Indicates whether there is an ongoing failover due to troubles.

BOOLEANfalseX 
GroupName등록한 그룹 이름을 나타냅니다It represents the registered name of group.NAME X 
Locked

영구잠금, 그룹을 잠금상태로 만들어 모든 동작과 명령을 제한한다.
영구잠금은 임시잠금과 다르게 서버 리부팅 후에도 잠금상태를 유지합니다Permanent locking. Lock a group to prohibit all commands and operation.
Unlike temporary locking permanent, locking is maintained even after the server reboots.

BOOLEANfalseX 
MaxDependencyLevel그룹 내에서 리소스간의 의존 관계를 설정 할 수 있는 상하의 최대 단계를 지정합니다Designate the max vertical level that sets the dependencies among the resources in a group.INTEGER20단계20 levelsX 
Monitored활성화 된 모든 리소스에 대한 감시가 완료되었는지 여부를 나타냅니다It indicates whether all the activated resources are monitored.BOOLEAN X 
OnlineCount

그룹 내에서 온라인 상태의 리소스 개수입니다.
'0'이면 그룹이 종료 상태인 것으로 판단합니다.
개수에는 모니터링 전용 리소스(네트워크 카드)는 포함되지 않습니다It is the number of resource online within a group. '0' means that a group is terminated.
The number of monitoring resources (network cards) is not included in the total number.

INTEGER X 
Parallel

그룹 병렬 속성입니다.
그룹에 속한 리소스가 하나 이상의 노드에서 동시에 시작될 수 있는지를 나타냅니다.
이 값은 변경할 수 없으며 최초 그룹을 생성할 때에 한번 만 설정 될 수 있습니다It is a group's parallel attributes.
It indicates whether the resources in a group can be started at more than one node at the same time.
The value cannot be changed. It can be set only once when you create a group for the first time.

BOOLEANfalseX 
PreActive이전에 그룹이 실행되었던 노드 이름을 알려줍니다It represents the name of node where a group was executed before.STRING X 
State노드의 그룹 상태(온라인, 오프라인, 장애, 미확인 등)을 알려주는 속성입니다The attribute represents the group status of node (online, offline, trouble, unchecked).STRING X 
TargetNodeList

그룹의 운영 대상이 되는 노드 목록입니다.
열거 된 순서대로 우선 순위가 놓으며 이는 페일오버할 때에 대상 노드를 선택하는 판단 기준이 됩니다It is the list of nodes in a group subject to operation. It is sorted in the increasing order of priority. This is the criterion used for selecting a target node when performing a failover.

STRING X 
TLocked

'임시 잠금' 상태를 알려주는 속성입니다.
Locked 값과 동작하는 것은 같지만 엔진이 재시작 되면 해제되는 임시 기능입니다.The attribute indicates the status of 'temporary locking'.
It operates in the same way as the locked value but it is a temporary function that will be cancelled when the engine restarts. 

BOOLEANfalseX 

 

* AutoStart (true/false)

시스템 부팅 단계에서 새롭게 클러스터 연결을 시작할 때에 그룹을 자동으로 시작할 것인지를 결정합니다.
(MCCS 서비스를 다시 시작하는 경우이거나 한 노드만 재시작하여 이미 운영중인 MCCS에 연결하는 경우는 무시됩니다.)
병렬 그룹인 경우는 로컬 노드에서 오프라인 상태나 일부 온라인 상태면 자동으로 시작합니다.
페일오버 그룹은 타깃 노드에서 우선 순위가 가장 높은 노드부터 자동으로 시작합니다. 잠금이나 장애 상태인 그룹은 시작되지 않습니다.

 

리소스에 따른 그룹 자동 시작 옵션

...

1.모든 원격 노드 가 FAULTED상태가 아니어야 한다.
2.노드가 모두 클러스터에 합류되어야 합니다.
3.미러 디스크의 상태가 MIRRORING 또는 MIRROR_RESYNCING 이어야 합니다.
4.롤이 한 노드에서는 Source, 다른 노드에서는 Target 이어야 합니다. Source상태의 노드를 소스 노드로 결정.
5.미러롤이 Source 인 노드로 Online 시도합니다.
5.그룹내에 여러개의 미러디스크 리소스가 있다면, 리소스들은 한 노드에 모두 source이어야 Online이 가능 합니다.

...

1.양 노드가 부팅 될 경우는 먼저 부팅한 노드로 자동 시작됩니다.
2.부트 모드이어야 한다.
3.그룹의 노드의 상태가 ONLINE상태가 아니어야 한다.

*Failover (true/false)

장애로 인한 페일오버가 진행 중인지를 나타냅니다.
true로 설정된 상태에서 다음과 같은 경우가 발생하면 false로 재설정됩니다.

  • 잠금 명령에 의해 Locked/TLocked 속성이 true로 설정되었을 때 
  • 초기화 명령(Flush)이 전달되었을 때
  • 그룹이 온라인 상태가 되었을 때

 

 

그룹상태

그룹 상태는 해당 리소스들의 상태에 따라 결정됩니다.
하지만 모니터링 전용 리소스들은 그룹 상태에 영향을 미치지 않습니다.
왜냐하면 모니터링 전용 리소스의 그룹을 어떤 노드에서 시작하든지 온라인 상태여야 하기 때문입니다.
그룹 상태는 기본적으로 다음과 같습니다.

Image Removed

[그림] 그룹 상태 화면

온라인

모든 리소스들이 온라인 되어 있는 상태입니다.

오프라인

모든 리소스들이 오프라인 되어 있는 상태입니다.
화면상에서는 회색 톤의 비활성화 된 아이콘으로 표시됩니다.
모니터링 전용 리소스는 활성화된 상태로 나타나지만 그룹의 오프라인 상태와는 무관합니다. (네트워크 어댑터 같은 경우)

일부 동작

일부 리소스들이 온라인 되어 있는 상태를 말하며 녹색으로 체크 표시 되어 나타납니다.
모니터링 전용 리소스는 상태 결정에서 제외되기 때문에 일부 동작 상태에 영향을 미치지 않습니다.

장애

그룹 내에서 한 개의 리소스라도 장애가 발생되었으면 그 그룹은 장애 상태로 간주되며 붉은 색으로 체크 표시되어 나타납니다.
그러나, 장애 상태는 현재 장애가 발생 중이라는 것을 의미하지는 않습니다. 장애가 발생했었다는 사실을 알려줄 뿐이며 관리자의 분석 및 처리를 기다리는 상태를 의미합니다.
관리자가 장애 상태를 직접 해제하거나 AutoFaultClearTime 같은 속성 값으로 인해 해제되지 않는 이상 장애 상태는 계속 남아 있습니다.

 

 

CLI 사용(mcgroup 명령)

그룹에 관한 명령을 전달합니다. 그룹에 대해 추가, 삭제, 온라인, 오프라인, 속성 편집 등의 명령을 내릴 수 있습니다.

...

Determine whether to automatically start a group when making a new connection to a cluster in the system booting phase. (If the MCCS service is restarted or a single node is restarted to connect to operating MCCS, it will be ignored.) If a parallel group is offline at a local node or some members are online, it will automatically start. In case of a failover group, the node with the highest priority will be automatically started first. In case of locking or troubles, a group will not be started.

 

Group auto start option for each resource

PrerequisiteIn case there is mirror diskIn case there is not mirror disk

AutoStart should be set to true.

1. None of the remote nodes should be FAULTED.
2. All the nodes should be merged into a cluster.
3. The mirror disk condition should be MIRRORING or IRROR_RESYNCING.
4. The role at a node should be a source and a target at another node. A node in the source condition is selected as a source node.
5. Try to make the node with the mirror role equal to source to go online.
6. If there are multiple mirror disk resources within a group, resources should be all sources to a single node before they can go online.

1. If the both nodes are booted, the first booted node will be automatically started.
2. Should be in boot mode.
3. Group's node status should not be online.

 

 

*Failover (true/false)

It indicates whether there is an ongoing failover due to troubles. When it is set to true, if the following event occurs, it is reset to false.

  • The locking command sets the Locked/TLocked attribute to false.
  • The initialization command (Flush) is sent.
  • A group goes online.

 

Group State

The state of the group is determined by the state of the resources.
However, the status of persistent resources like Ethernet adapter do not affect on the status of group because these resources should be online on both nodes commonly.
Basically the group may have the following states.

Image Added

[Figure] Group State View

Online

This is a state where all the resources are online.

Offline

This is a state where all the resources are offline.
They are displayed on the console window as gray colored icons. 
But a Persistent Resources (e.g. Ethernet adapter) still remain online with colored icon regardless the group offline.

Partial

This is a state where only some of the resources are online and shows as a green check marks.
A persistent resources are excluded from state determination, they do not affect the partial online state.

Faulted

This is a state where one or more resources are failed and the group will also be regarded as faulted. It shows in red check marks.
The failure state does not mean that a failure is occurring at present. It only shows that a failure occurred, and refers to waiting for the administrator's analysis and actions.
Unless the administrator directly clears the failure state, and uses an attribute like 'AutoFaultClearTime' to cancel it, the failure state will remained.

 

 

CLI Use (mcgroup command)

It sends the commands related to MCCS group. Group related commands such as add, delete, online, offline, attribute edit can be done.

Info

When you install MCCS, the initial user account ID is set to 'admin' and the password is set to 'password'.
When you run the CLI command, you need to enter the ID and the password. Otherwise, the above initial ID and password will be used.
Thus, when you change the initial user password, you must enter the ID/password in the CLI command as options.

 

Syntax

 

mcgroup [-u userid -pw password] [-ip node_ip_address] [-p port] -command [ group ] [-a attribute] [-r resource] [-n node]

 

Options

그룹이나 리소스의 의존성을 표시합니다
옵션Option설명Description

-h

도움말을 출력합니다It prints help menu.

-u사용자 ID를 지정합니다Designate the user ID.
-pw사용자  패스워드를 지정합니다

Enter the user password.

-ip명령을 실행하기 위해 접근할 IP를 지정합니다.
생략 시 로컬 노드에 대해서 명령을 실행하기 위해 접근합니다

It defines the node to access to execute command. If omitted, it will access to execute command for local node.

-p

명령을 실행하기 위해 접근할 포트를 지정합니다.
생략 시 기본 포트로 접근하며, 핫빗 포트가 변경이 되면 명령 실행 시 포트를 지정해 주어야 합니다.

-groupcommand

그룹에 내릴 명령을 지정합니다.It specifies the port to access to execute command.
If omitted, it will access to the default value and when you define specific port number as heartbeat, enter this followed by --p. 

-groupcommand

It defines group command.  
(add, delete, online, offline, move, clear, flush, modify, list, lock, unlock, state, monitor)

group작업의

대상이 되는 그룹을 지정합니다.It enters name of the group. 

-a

-dep

[list] 명령일 경우 속성값을 나열할 속성을 지정합니다.
[modify] 명령일 경우 변경할 속성과 속성값을 지정합니다.
[attribute] 그룹의 속성을 지정합니다.
[attribute_value] 변경할 속성 값을 지정합니다.

-r

작업 할 리소스를 지정합니다.

-n

작업 할 노드명을 지정합니다.

-t시간주기를 지정합니다.

It defines the attribute value that should be listed if it is command.  
[modify] It lists the attribute and attribute value that should be changed if it is command. 
attribute : It defines the values of the group. 
attribute_value: It defines the values that should be changed.  

-r

It defines the resource to be managed.

-n

It defines node name to be managed.

-t

It defines the interval time.

-dep

It shows dependency of the group or the resource.

 

Example

add

그룹 Adds testGroup을 생성합니다.

 

mcgroup -u admin -pw password -add testGroup

 

delete

그룹 Delete testGroup을 삭제합니다.

 

mcgroup -u admin -pw password -delete testGroup

 

online

testNode에서 testGroup을 온라인 시킵니다Bring online testGroup on testNode..

 

mcgroup -u admin -pw password -online testGroup [-n testNode]

 

offline

testNode에서 testGroup을 오프라인 시킵니다.Take offline testGroup on testNode

 

mcgroup -u admin -pw password -offline testGroup [-n testNode]

 

move

testNode로 testGroup을 페일오버 시킵니다.Switchover testGroup to testNode

 

mcgroup -u admin -pw password -move testGroup [-n testNode]

 

clear

testNode에서 testGroup의 장애 표시를 제거합니다Remove fault mark on testGroup of testNode.

 

mcgroup -u admin -pw password -clear testGroup [-n testNode]

 

flush

testNode의 testGroup을 초기화 시킵니다Initiate all command for testGroup of testNode.

 

mcgroup -u admin -pw password -flush testGroup -n testNode

 

modify

testNode의 testGroup 속성을 수정합니다Modify a value of attribute of testGroup on testNode.

 

mcgroup -u admin -pw password -modify test -a attribute attribute_value -n testNode

 

testNode의 testGroup 속성인 AutoStart를 true로 변경합니다Modify the value of ‘AutoStart’ attribute of testGroup on testNode.

 

mcgroup -u admin -pw password -modify testGroup -a AutoStart true -n testNode

 

list

그룹 상태를 출력합니다Prints state of the group.

 

mcgroup -u admin -pw password -list [group [-all] | [-dep [-r resource]] | [-a attribute] [-n testNode]]

 

그룹의 모든 속성값을 출력합니다It shows all the attribute value of the group.

 

mcgroup -u admin -pw password [-ip node_ipaddress] [-p port] -list [group [ -all]]

 

그룹에 속한 리소스의 의존성을 보여줍니다.It shows dependency of resource that belongs to the group. 

 

mcgroup -u admin -pw password [-ip node_ipaddress] [-p port] -list [-dep [-r resource]]

 

...

It checks certain attribute value of the group. 

 

mcgroup -u admin -pw password [-ip node_ipaddress] [-p port] -list [-a attribute] [-n testNode]]

 

lock

testGroup을 임시 잠금 상태로 합니다Locks testGroup temporarily.

 

mcgroup -u admin -pw password -lock testGroup

 

testGroup을 영구 잠금 상태로 합니다Locks testGroup permanently.

 

mcgroup -u admin -pw password -lock testGroup -p

 

unlock

testGroup의 잠금 상태를 해제합니다Unlocks testGroup.

 

mcgroup -u admin -pw password -unlock testGroup

 

state

test Node의 testGroup 상태를 출력합니다It prints state of testGroup of testNode.

 

mcgroup -u admin -pw password -state testGroup [-n testNode]

 

monitor

Monitors testGroup 상태를 interval 간격으로 모니터링 합니다 state on every time interval.

 

mcgroup -u admin -pw password -monitor testGroup [-t interval(seconds)]