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

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 RemovedImage Added

 

[Figure] Group Attribute View

 

 

AttributeDescriptionTypeDefaultEditNote
ActionState

현재 진행 중인 그룹의 액션 상태를 나타냅니다. 리소스 온라인 중 : STARTING 리소스 오프라인 중: STOPPING 온라인/ 오프라인 완료 상태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

장애 발생 후에 페일오버가 되고 이 속성의 시간 값만큼 정상 온라인을 유지하면 그룹의 모든 장애 상태를 제거합니다. '0'인 경우는 장애를 제거하지 않은 상태를 말합니다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

그룹 내에서 온라인 상태인 리소스의 개수입니다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에 연결하는 경우에는 무시됩니다.) 병렬 그룹인 경우는 로컬 노드에서 오프라인 상태이거나 일부 온라인 상태이면 자동으로 시작합니다. 페일오버 그룹은 타깃 노드에서 우선 순위가 가장 높은 노드부터 자동으로 시작합니다. 잠금이나 장애가 발생한 경우에는 그룹이 시작되지 않습니다.

 

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

...

AutoStart 가 true 로 설정되어 있어야 합니다.

...

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

...

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)

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

  • 잠금 명령에 의해 Locked/TLocked 속성이 true로 설정되었을 때
  • 초기화 명령(Flush)이 전달되었을 때

...

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 RemovedImage 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  
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

MCCS는 설치 시 최초 사용자 계정으로 ID는 When you install MCCS, the initial user account ID is set to 'admin' , 비밀번호는 and the password is set to 'password'인 계정이 생성됩니다. CLI 명령을 실행 시 ID 와 비밀번호를 입력하지 않으면 , 위의 최초 사용자 계정의 ID와 비밀번호로 실행됩니다. 따라서 최초 사용자의 비밀번호 변경 시, 필수적으로 CLI 명령에 ID와 비밀번호를 옵션으로 입력해야 합니다.
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

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

-p

It specifies the port to access to execute command.
If omitted, it will access to the default value which is 4321, 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

[list] 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

Bring online testGroup on testNode..

 

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

 

offline

Take offline testGroup on testNode

 

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

 

move

Switchover testGroup to testNode

 

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

 

clear

Remove fault mark on testGroup of testNode.

 

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

 

flush

Initiate all command for testGroup of testNode.

 

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

 

modify

Modify a value of attribute of testGroup on testNode.

 

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

 

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

Locks testGroup temporarily.

 

mcgroup -u admin -pw password -lock testGroup

 

Locks testGroup permanently.

 

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

 

unlock

Unlocks testGroup.

 

mcgroup -u admin -pw password -unlock testGroup

 

state

It prints state of testGroup of testNode.

 

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

 

monitor

Monitors testGroup state on every time interval.

 

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