Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

PTP/designs/rm view

< PTP‎ | designs
Revision as of 12:41, 9 May 2006 by Rsqrd.lanl.gov (Talk | contribs) (Package resourcemanager)

Overview

This is a preliminary design for the PTP Resource Management system. This is the design of the first phase product, which is limited in scope to viewing the state of the resource manager. This includes the machines, jobs, queues, and nodes that are under the resource manager's control. The classes currently in PTP will implement these new interfaces in addition to their previously implemented interfaces.

File:Ptp resource manager view.pdf

Package rm.core

For interfaces and abstract classes, the responsibilities and collaborations refer to concrete objects that are implementations of the interface or abstract class.

Interface: IRMResourceManager

Responsibilities
Proxy used to connect to the ResourceManagerHost's actual resource manager (ARM).
Retrieve list of machines, nodes, jobs, process, and queues from ARM.
Notify registered objects that the lists have changed, either in composition, or in their element's attributes due to changes propagated from the ARM
Collaborations
IRMResourceManagerHost
IRMResourceManagerListener
RMNodesChangedEvent
RMJobsChangedEvent
RMQueuesChangedEvent
RMMachinesChangedEvent
RMStructureChangedEvent
IRMMachine, IRMNode, IRMJob, IRMQueue

Abstract Class: ResourceManagerFactory

Responsibilities
Subclasses of the class are to create and load instances of IRMResourceManager
dispose of any resources acquired by factory objects
Collaborations
IRMResouceManager subclasses

Interface: IRMResourceManagerListener

Responsibilities
Registration site for Observer pattern to allow objects to be notified of changes in the IRMResourceManager's status
Collaborations
IRMResourceManager
RMStructureChangedEvent, RMMachinesChangedEvent, RMNodesChangedEvent, RMJobsChangedEvent, RMQueuesChangedEvent

Abstract Class: ResourceManagerEvent

Responsibilities
Determine type of changed in the IRMResourceManager's state
The type can be ADDED, MODIFIED, or REMOVED
Collaborations
IRMResourceManager
RMStructureChangedEvent, RMNodesChangedEvent, RMJobsChangedEvent, RMQueuesChangedEvent, RMMachinesChangedEvent

Class: RMStructureChangedEvent

Superclass
ResourceManagerEvent
Responsibilities
Event created when the ARM has had major structure changes (table columns may need to be recreated)
Collaborations
none

Class: RMNodesChangedEvent

Superclass
ResourceManagerEvent
Responsibilities
Event created when the ARM has added, modified, or removed nodes
Collaborations
IRMNode

Class: RMJobsChangedEvent

Superclass
ResourceManagerEvent
Responsibilities
Event created when the ARM has added, modified, or removed jobs
Collaborations
IRMJob

Class: RMMachinesChangedEvent

Superclass
ResourceManagerEvent
Responsibilities
Event created when the ARM has added, modified, or removed machines
Collaborations
IRMMachine

Class: RMQueuesChangedEvent

Superclass
ResourceManagerEvent
Responsibilities
Event created when the ARM has added, modified, or removed queues
Collaborations
IRMQueue

Class: ResourceManagerHost

Responsibilities
Determine which remote (or local) host's resource manager to proxy
Determine which resource manager on the host to proxy
Provide hosts's status
Collaborations
RMStatus

Interface: IRMMachine

Responsibilities
Provide the status information, i.e. attributes, for the ARM's associated machine
Set and provide specific attributes for a given attribute description
List all nodes associated with ARM's machine
Provide machine's status
Collaborations
IAttribute
IAttrDesc
RMStatus

Interface: IRMQueue

Responsibilities
Provide the status information, i.e. attributes, for the ARM's associated queue
Set and provide specific attributes for a given attribute description
List all nodes that may have jobs dispatched from this queue
Provide queue's status
Collaborations
IAttribute
IAttrDesc
RMStatus

Interface: IRMNode

Responsibilities
Provide the status information, i.e. attributes, for the ARM's associated node
Set and provide specific attributes for a given attribute description
List all jobs associated with ARM's node
List all queues that can run jobs on this node
Provide node's status
Collaborations
IAttribute
IAttrDesc
RMStatus

Interface: IRMJob

Responsibilities
Provide the status information, i.e. attributes, for the ARM's associated job
Set and provide specific attributes for a given attribute description
List all processes associated with ARM's job
Provide job's status
Collaborations
IAttribute
IAttrDesc
RMJobStatus

Interface: IRMProcess

Responsibilities
Provide the status information, i.e. attributes, for the ARM's associated process
Set and provide specific attributes for a given attribute description
Provide node on which the process runs
Collaborations
IAttribute
IAttrDesc

Interface: IAttribute

Responsibilities
Maintain the relationship between an attribute's value and its description
Specifies a strict-weak ordering of itself and other attributes
Provide a string representation of the attribute
Collaborations
IAttrDesc

Interface: IAttrDesc

Responsibilities
Provide a string description of the attribute
Provide a name of the attribute
Know the actual type of the attribute
Create new attributes of the correct type
Collaborations
IAttribute

Enumeration: RMStatus

Responsibilities
Provide consistent labeling of element status
OK element is up and able to accept jobs, etc.
DOWN element is down, reason will have to be provided in other attributes
UNAVAILABLE element is unable to accept jobs, etc., reason will have to be provied in other attributes
ALLOCATED_OTHER element is up but unable to accept jobs due to allocations by other users
UNKNOWN the status is unknown
Collaborations
ResourceManagerHost, IRMMachine, IRMNode, IRMQueue

Enumeration: RMJobStatus

Responsibilities
Provide consistent labeling of job status
PENDING job is pending in queue
RUNNING job is running normally
SUSPENDED job is suspended, reason will have to be provided in other attributes
DONE job has completed normally
EXIT job has completed abnormally, reason will have to be provide in other attributes
UNKNOWN job status is unknown
Collaborations
IRMJob

Back to the top