/
7. Resource

7. Resource

Resources are necessary H/W or S/W elements for service operation and they include network interface cards(NIC), 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.

Table of Contents

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.

[Figure] Resource Attribute View


AttributeDescriptionTypeDefaultEditNote
 Key Attribute*CriticalWhen a failure occurs in the resource it indicated whether to failover the whole group.BOOLEAN X 
*Enabled

It is used when deciding whether to manage the resource. 
Resource Enable : true
Resource Disable: false

BOOLEAN X 
General AttributeAgentState

It indicates the agent state of the resource.
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. 

INTEGER300secO 
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 
FailoverableIt indicates whether the resource is in the state to be failover.BOOLEAN X 
GroupIt is the name of the group which the resource belongsSTRING X 
LastOnline

It is name of the node on which state of the resource is online lastly.

STRING   
Monitored

Depending on the 'MonitorTimeout', attribute values for the resource types, it record periodically whether each node's monitoring is finished.

BOOLEAN X 
NoAction

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 
ResNameIt 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. 

INTEGER0O 
StateIt is the resource state of each node.STRING X 
TypeIt is the name of the agent type of the resource.STRING X 

 

*Critical

This attribute shows to failover (true) or not (false) when failure has occured.
Default is set as true, and most of the resources are set as a true value. For resources that is not as important or resources that cannot be failover are set as false.
Critical values affects failover mode group only, does not affect parallel mode group. Critical attribute can be considered alone but there are many things to be considered if it has linked dependency among resources.
For an example, none critical resource on which critical resource(parent) depends, group failover will be occurred because one of critical resource cannot be provide proper service.

 

*Enabled

It shows resources are enabled which can be monitored, online and offline as state.
A resource cannot be used right after it has been created, and it must be checked ‘enable’, when has been successful configured to be used.
Agent, a MCCS component is in detached state when create a resource for the first time. In this state, Resource and group is disabled which cannot be managed like online, offline, switch and etc.
If you check  'enable' after completing the configuration, agent executes the probing stage in which flaws in the configuration are detected. If it is considered normally configured, both the resource and agent turn into offline state.

 

*BatchAfterOffline / BatchAfterOnline / BatchBeforeOnline / BatchBeforeOffline

It is used when there is additional command to be sent before the resource is online or after the resource is offline. Name of the user created batch or script file with path name is registered as value.
For an example, if an application that leads many child processes has gone offline by command, but child processes were not terminated normally. When this happens, a script file is needed to be used so that child processes can be all terminated. 
This command does not affect group Online/Offline of MCCS. In other words, MCCS does the group online even though the command has failed. Only result of the command execution write in the log.

 

*BatchTimeout

BatchTimeout can be defined the timeout value of the result of batch execution.
It avoids a deadlock when exceptional situation occurs during the execution of scripts and other resources cannot be controlled.
If the script is not executed when offline or online attempts are made, stop further procedures and wait for the control of the administrator.



Resource State

[Figure] Resource State View


The resource state can be checked on resource state view of MCCS console.
From the group management view of MCCS console, select the resource and select ‘Resource Status’ tab from detailed information panel. The resource status will be shown.
Resource states are as below;

Online

Resource is running.

Offline

Resource has been stopped.

Fault

Resource has been failed.

Unknown

Resource is not being monitored since it is not enabled.

 

 

Resource Control

[Figure] Resource Control Menus



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.

 

Group Failover for failure

This is about Critical attribute, and this can be checked through the check mark in front of this.
If this value is checked, that means when failure occurs, group will failover to the other node. This is not the case for the parallel group. 

 

Probe Now

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.


Online

You can bring a resource online by using this. 

From here, there are sub menus per node so that nodes to be online can be selected. Sub menus can be 'Enabled' or 'Disabled' according to the resource state per node.
For example, failover mode group cannot send enabled command when it is online in the temporary node. This is because failover mode group should only have one node online and if there is one node that is already online, online menu is not enabled.
However, in case of parallel mode group, it is all enabled if it is not in an online state.

Failover mode group should only have one node online and so node that is online can start the Online command. 
When this is selected, you can choose appropriate node from the sub menu which shows nodes list. When the resource is already online state, all of the node icons will be disabled at failover mode group.
But the node will be enabled which the resource isn’t online state at parallel mode group.

If there is a fault mark in the resource, in which that has been failed, it should be cleared first before sending the that is online. This is because MCCS regards cause of the fault is not identified yet.

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

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.

 

 

 

Copy and Paste Resource

It is an annoyance if attribute value is entered whenever a new resource is created.
When you add a new resource same as type of resource which is already exist, you can use this function.
Copied resource maintain same values as original one and can be pasted on any group.
After paste the resource, you can edit the values.

Attribute values that is copied resource are basically same as original resource.
Therefore, attribute of pasted resource should be edited according to the situation so that it does not duplicate with copied resource.

 

Resource Copy

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

  2. Right click on the group to be paste and select "Paste Resource". 

Resource Paste

Select the network adaptor for the resource to newly add and name the resource.

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'.

Depending on the resource type, you need to enter extra information if necessary.

 

CLI Use (mcres command)

It sends MCCS resources related commands. Commands such as add, delete, online, offline, edit of resource can be done.

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

 

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

OptionDescription

-h

It prints help menu.

-uDesignate the user account ID.
-pwEnter 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

Add testResource of application resource type on testGroup.

 

mcres -u admin -pw password -add testResource -t resourceType -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

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)]

 

It monitors testResource every 10 seconds. 

 

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

 

modify

Modify a value of attribute of testResource in a node. 

 

mcres -u admin -pw password -modify testResource -a attribute 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

 

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

 

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

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]

 

Set a User’ attribute of the testResource to administrator

 

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

 

online 

Bring online testResource on testNode.

 

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

 

offline

Take offline testResource on testNode

 

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

 

offlineprop

Take offline the resource including its parent resource(s) of testResource on testNode

 

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

 

probe

Probe testResource on testNode.

 

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


clear

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

 

 

 

Related content