Section

Column

리소스란 하드웨어 또는 소프트웨어적으로 서비스 운영에 필요한 자원 요소를 말하며
네트워크 카드Resources are necessary H/W or S/W elements for service operation and they include network interface cards(NIC), 네트워크 주소( IP Address), 기본응용(Process), 서비스(Service), 디스크(Disk) 등을 말합니다.
MCCS에서는 리소스를 고가용성 운영 관리의 최소 단위로 사용합니다.
MCCS에서는 리소스를 생성할 때에 고유한 이름을 입력해야 하며, 이 이름으로 리소스들을 구분합니다.
그러므로 기존에 생성했던 이름이나 이미 예약된 키워드(예를 들면 네트워크 카드(NIC), 프로세스(process) 등)를 이름으로 사용할 수 없습니다.
리소스는 동작 형태에 따라 명령을 내릴 수 있는 일반 리소스(OnOff)와 모니터 전용 리소스(None)로 구분됩니다.
대부분의 리소스는 MCCS의 리소스의 상태에 따라서 Online 또는 Offline 할 수 있는 일반 리소스입니다.
이에 반해, 모니터 전용 리소스 는 Online 또는 Offline 할 수 없고 모니터만 가능한 리소스입니다.
예를 들어, 네트워크 카드는 물리적으로 존재하는지 혹은 정상 상태인지 감시만 할 수 있으며,
네트워크 주소는 온라인(online)/오프라인(offline) 명령으로 가상 IP(virtual IP)를 할당하거나 해제할 수 있습니다.
리소스들에 명령을 내리고 모니터링을 하는 작업은 해당 타입의 에이전트가 담당하게 됩니다addresses, processes, services, and disks.
In MCCS, resource is used as the minimum unit of operation management with high availability.
When you create a resource in MCCS, you must enter a unique name that is used to differentiate a resource from others.
Thus, the existing names or reserved keywords (for instance, network interface cards (NIC) or processes) cannot be used as names.
Depending on the type of operation, resources are classified into general resource (OnOff) that issue commands and monitor resources (None).
Most of resources are general resources that can go online or offline depending on the resource condition in MCCS.
To the contrary, monitor resources cannot go online or offline but they can only provide monitoring.
For instance, a network card can only monitor whether it exists physically or it is normal, and a network address can use an online/offline command to assign or cancel a virtual IP address.
Agents are responsible for commanding and monitoring resources.

Column

width	350px

Panel

이 페이지의 주요 내용

Table of Contents

maxLevel	4

Resource Attribute

리소스 속성은 리소스가 동작을 취하거나 상태를 판단할 때 참조하는 값입니다Resource attribute is a reference value used when the resource takes some actions or determines the status.
Resource attribute can be identified from Resource Attributes view of MCCS web console. From the group management view of MCCS web console, select the resource, then select ‘Resource Attributes’ tab located on the top of detailed information panel.
The values of gray colored are read only. They just contain and show the information of resource state. The values of white colored are configurable by user definition. Below is description of some of them.

...

Attribute		Description	Type	Default	Edit	Note
Key Attribute	*Critical	When a failure occurs in the resource it indicated whether to failover the whole group.	BOOLEAN		X
Key Attribute	*Enabled	It is used when deciding whether to manage the resource. Resource Enable : true Resource Disable: false	BOOLEAN		X
General Attribute	*AgentState	It indicates the agent state of the resource 사용자가 임의로 수정할 수 없으며, MCCS엔진에서 모든 노드의 에이전트 상태를 수집한 후에 나타냅니다.	STRING		X		BatchAfterOffline	This is a batch . A user cannot modify it on their own. It is displayed after collecting all the agent status for all the nodes in the MCCS engine.	STRING		X
	BatchAfterOffline	This is a batch command to be executed after a resource is taken offline. Success or failure of the batch file does not affect group procedure. Also, it still operates regardless of other resource online or offline.	FILE		O
	BatchAfterOnline	This is a batch command to be executed after a resource is brought online. Success or failure of batch does not affect group procedure. Also, it still operates regardless of other resource online or offline.	FILE		O
	BatchBeforeOffline	This is a batch command to be executed before a resource is brought online. Success or failure of batch does not affect group procedure. Also, it still operates regardless of other resource online or offline.	FILE		O
	BatchBeforeOnline	This is a batch command to be executed before a resource is taken offline. Success or failure of batch does not affect group procedure. Also, it still operates regardless of other resource online or offline.	FILE		O
	BatchTimeout	It is the waiting time until execution of batch command completes. If execution result is over this time, it is considered as a failure.	INTEGER	300sec	O
	*CleanProgram	This program is executed to initialize related resources and state when a failure occurs to a resource. This program must be written separately.	FILE		O
	Failoverable	It indicates whether the resource is in the state to be failover.	BOOLEAN		X
	*Group	It is the name of the group which the resource belongs	STRING		X
	LastOnline	It is name of the node on which state of the resource is online lastly.	STRING
	*Monitored	리소스타입 속성값인 '모니터링 시간 제한'(MonitorTimeout) 설정값에 따라 각 노드의 모니터가 완료 되었는지 주기적으로 기록합니다.	BOOLEAN Depending on the 'MonitorTimeout', attribute values for the resource types, it record periodically whether each node's monitoring is finished.	BOOLEAN		X
	*NoAction	리소스의 동작(Action) 속성을 나타냅니다. 이 속성이 true라면 리소스는 온라인, 오프라인 같은 명령을 내릴 수 없고 감시 기능만 가능한 모니터전용리소스 입니다. 네트워크 카드의 경우가 false 입니다.	BOOLEAN		X		*ResName	It is the name of the resource.	NAME	It represents the action attribute of the resource. If the attribute is set to true, the resource cannot go online or offline but it is rather a monitor resource that can only monitor. A network card is set to false.	BOOLEAN	X
	*ResName	It is the name of the resource.	NAME		X
	Restartlimit	It shows the number to restart before failover when the resource is determined as a failure.	INTEGER	0	O
	*State	It is the resource state of each node.	STRING		X
	*Type	It is the name of the agent type of the resource.	STRING		X

...

[Figure] Resource Control Menus

MCCS에서 리소스를 다루기 위한 명령은 관리 콘솔에서 왼쪽 뷰의 리소스를 선택한 후에 마우스의 오른쪽 클릭으로 생성된 팝업 화면에서 선택할 수 있습니다.
또 다른 곳은 그룹을 선택한 후에 '리소스 의존성' 탭에서 해당 리소스에 마우스의 오른쪽을 클릭하면 리소스와 같은 팝업 화면을 생성시킬 수 있습니다.
이 외에도 콘솔의 메뉴 항목이나 툴 바 메뉴에서 명령을 내릴 수 있으며 CLI 로도 가능합니다.If you want to use the resource handling commands in MCCS, go to the management console and select the resource in the left view and right click with your mouse button to launch the pop up window.
Alternatively, select group and right click with your mouse button on the resource in the 'Resource Dependency' tab to launch the same pop up as resource.
Also, you can use the commands in the console menu or tool bar. CLI can be used as well.

Enable Resource

This can be checked by checking of there is a enabled check mark in front of the command. This can also be checked by checking on the Enabled value in the Resource Attribute. If the resource is disabled, resource state cannot be monitored.
If the attribute value is incorrect, this will be failed. For example, when type a wrong path name in the process of application, monitoring whether it is online or offline is impossible. Therefore, whenever this is failed, attribute value should be checked first.

...

When an agent monitors the resource state, it probes that periodically.
But when you use ‘Probe Now’, the agent probes the resource right away that this is ready to use. When you modify a value of resource attribute, this may not be applied right away. ㅌ
But you can verify this modification is applied by using this right away.

...

There are some considerations for dependency as well. To online a resource, if there is a child resource, child resource should be online state first. Since there is a dependency, if the child resource is not online state, parent resource cannot be online as well.
When the child resource should be online state first. Since there is a dependency, if the child resource is not online state, parent resource cannot be online as well.
When the child resource exists, you should check that is online state before the resource bring online.

Offline

리소스를 오프라인 시킵니다.
시작 명령과 마찬가지로 노드를 선택할 수 있는 서브 메뉴가 존재하며 온라인 상태인 노드가 있어야만 활성화되는 명령입니다.
종료할 때 주의할 점은 온라인 상태인 부모 리소스가 존재하는 경우입니다.
부모 리소스는 종료 명령을 주기 위해 선택된 리소스에 의존하고 있으므로, 정상적인 경우라면 시작 명령의 역순으로 부모 리소스부터 종료되어야 안전하게 종료됩니다.
따라서 MCCS에서는 종료 명령을 실행할 때에 온라인 상태인 부모 리소스가 존재하면 부모 리소스부터 종료시킬 것인지를 확인하고 진행합니다exists, you should check that is online state before the resource bring online.

Offline

The resource goes offline.
Just like the start command, there is a sub menu where you can select a node.
The command is activated when there exists an online node.
You should note whether there are the parent resources online. The parent resource depends on the selected resource when it uses the Terminate command.
So, when you use the Terminate command, you should first terminate the parent resource which is in the reverse order of Start command.
Thus, when MCCS runs the Terminate command, if the online parent resource exists, it will first check whether to terminate the parent resource first.

Offline Propagation

You can take a resource offline by using this.
Similar to Online, you can choose appropriate node from the sub menu.
You can take a resource including parent resources offline by using this.

Clear Fault

장애가 발생한 리소스는 장애 표시를 남겨두고 관리자의 조치가 있기 전까지는 그 노드 내에서 해당 리소스를 시작할 수 없습니다.
다시 말해 관리자의 처리를 기다리는 상태로 남겨지게 되는데, 장애 해결을 한 후에 다시 MCCS 운영을 하기 위해서는 장애 표시를 제거해야 하며 이때에 이 명령을 사용합니다.
리소스 장애 표시 제거는 하나의 리소스만 해당되지만 그룹의 장애 표시 제거는 그룹 내의 모든 장애 표시를 제거할 수 있습니다The sign of failure is still displayed for the failed resource. Until the manager takes necessary actions, you cannot start the resource in the node.
In other words, it is waiting for the manager's actions. After troubleshooting, if you want to resume MCCS operation, the sign of failure should be removed.
Use the command for this purpose. 'Remove Sign of Resource Failure' is applicable to one resource but 'Remove Sign of Group Failure' is applicable to all the resources in the group.

Delete

You can delete a resource by using this.

...

Right click on the resource to be copy and select "Copy Resource".

[그림] 리소스 복사 화면Figure] Copy Resource View
Right click on the resource to be paste and select "Paste Resource".

[Figure] Paste Resource View

Resource Paste

새로 추가 할 리소스의 네트워크 어댑터를 선택하시고 리소스 이름을 명명하면 됩니다Select the network adaptor for the resource to newly add and name the resource.

Info
Copied resource name is defined which '_number'is added from original name by default and this can be editable. ex) Original name is 'UserProgram', copied name will be 'UserProgram_1'. When you copy this resource again, second copied name will be 'UserProgram_2'.

...

[Figure] Paste Network Card Resource View

CLI

...

Use (mcres

...

command)

It sends MCCS resources related commands. Commands such as add, delete, online, offline, edit of resource 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 와 password를 입력하지 않으면 , 위의 최초 사용자 계정의 id와 암호로 실행됩니다.
따라서 최초 사용자의 패스워드 변경시, 필수적으로 CLI 명령에 id와 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

mcres [-u userid -pw password] [-n node_ip_address] [-p port] -command [ resource ] [ -g group ] [ -n node]
mcres [-u userid -pw password] [-n node_ip_address] [-p port] -add [ resource ] [ -t resource_type ] [ -g group ]
mcres [-u userid -pw password] [-n node_ip_address] [-p port] -monitor [ group_name ] [ -t interval(seconds)]
mcres [-u userid -pw password] [-n node_ip_address] [-p port] -modify [ resource ] [-a attribute attribute_value] [ -g group ] [ -n node]

Options

옵션Option	설명Description
-h	It prints help menu.
-u	사용자 계정을 지정합니다Designate the user account ID.
-pw	사용자 Password를 지정합니다Create the user password.
-n	It defines the node to access to execute command. If omitted, it will access to execute command for local node.
-p	It defines 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.
-resourcecommand	It defines resource command. (add, delete, enable, disable, monitor, modify, link, unlink, local, Global, Online, Offline, Offlineprop, Probe, clear, list)
resource	It enters resource name.
-a	[list] It defines the attribute value that should be listed if it is command. [modify] It defines 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.
-t	It defines resource type when it is [-add] command. It specifies time interval when it is [-monitor] command.
-g	It defines group name to be managed.
-n	It defines node name to be managed.

Example

add

testGroup그룹에 복합 응용 타입으로 testResource 를 생성합니다. Add testResource of application resource type on testGroup.

mcres -u admin -pw password -add testResource -t Application -g testGroup

delete

Delete testResource 리소스를 삭제합니다.

mcres -u admin -pw password -delete testResource

enable

Enable testResource 리소스를 활성화시킵니다.

mcres -u admin -pw password -enable testResource

disable

Disable testResource 리소스를 비활성화 시킵니다.

mcres -u admin -pw password -disable testResource

monitor

testGroup 에 속한 모든 리소스를 interval 간격으로 모니터링 합니다. 주기가 지정되지 않은 경우에는 3초가 기본값으로 지정됩니다. It monitors a resource in every interval. If the period is not set, 3 sec is a default value.

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

testGroup을 10초 간격으로 모니터링 합니다It monitors testResource every 10 seconds.

mcres -u admin -pw password -monitor testGroup -t 10

modify

testResource 리소스의 attribute를 value 값으로 수정합니다Modify a value of attribute of testResource in a node.

mcres -u admin -pw password -modify testResource -a attribute value [ -n node

]

...

]

Modify a value of ‘User’ attribute of testResource to administrator in testNode.

mcres -u admin -pw password -modify testResource -a User administrator -n testGroup

link

리소스 간의 의존 관계를 생성합니다.
resource1을 부모로 resource2를 자식으로 의존 관계를 생성합니다Make a dependency link among resources.
Make a dependency link between the resource1 as parent and the resource2 as child.

mcres -u admin -pw password -

link resource1 resource2

unlink

...

link resource1 resource2

unlink

Delete a dependency link between the resource1 and the resource2.

mcres -u admin -pw password -unlink resource1 resource2

local

...

Set a value of attribute of the resource per node.
It is used locally so that other values can be inserted for attribute values of all the nodes.
(Modify command should be used to change the value.)

`mcres -u admin -pw password -local testResource -a attribute`

global

testResource 의 속성을 모든 노드들의 속성값에 대하여 공통된 값을 입력할 수 있도록 공용화 합니다Set a value of attribute of the testResource to all node.
It is used publicly so that values can be inserted with common values for all nodes.

mcres -u admin -pw password -global testResource -a attribute [value]

testResource 의 속성 User를 전체 속성으로 값을 administrator로 설정합니다Set a User’ attribute of the testResource to administrator.

mcres -u admin -pw password -global testResource -a User administrator

Online

testNode에 있는 testResource 리소스를 온라인 시킵니다Bring online testResource on testNode.

mcres -online testResource -n testNode

Offline

testNode의 testResource 리소스를 오프라인 시킵니다Take offline testResource on testNode.

mcres -u admin -pw password -offline testResource -n testNode

Offlineprop

testNode의 testResource 리소스의 자식 리소스를 오프라인 시킵니다Take offline the resource including its parent resource(s) of testResource on testNode.

mcres -u admin -pw password -offlineprop testResource -n testNode

Probe

testNode의 Probe testResource 리소스를 탐색합니다 on testNode.

mcres -u admin -pw password -probe testResource -n testNode

clear

testNode의 testResource 리소스의 에러를 제거합니다Remove fault mark on testResource of testNode.

mcres -u admin -pw password -clear testResource [ -n testNode]

list

현재 리소스 상태를 출력합니다Print current resource state.

mcres -u admin -pw password -list [resource [ -a attribute]] | [-g group [-a attribute]]

Version	Old Version 27	New Version 28
Changes made by	정은진	JuneL
Saved on	2014/09/04	2014/09/15

Content Comparison

Versions Compared

Key

Resource Attribute

Enable Resource

Offline

Offline

Offline Propagation

Clear Fault

Delete

Resource Paste

CLI

Use (mcres

command)

Syntax

Options

Example

add

delete

enable

disable

monitor

modify

link

unlink

unlink

local

Set a value of attribute of the resource per node. It is used locally so that other values can be inserted for attribute values of all the nodes. (Modify command should be used to change the value.) mcres -u admin -pw password -local testResource -a attribute

global

Online

Offline

Offlineprop

Probe

clear

list

Set a value of attribute of the resource per node.
It is used locally so that other values can be inserted for attribute values of all the nodes.
(Modify command should be used to change the value.)

`mcres -u admin -pw password -local testResource -a attribute`