Difference between revisions of "Programmatic Administration Interface"
Manuele.simi (Talk | contribs) (→Managing a gCube Hosting Node (gHN)) |
Manuele.simi (Talk | contribs) (→Managing a gCube Hosting Node (gHN)) |
||
Line 24: | Line 24: | ||
== Managing a gCube Hosting Node (gHN) == | == Managing a gCube Hosting Node (gHN) == | ||
+ | |||
+ | === Shut down === | ||
+ | |||
'''Target''': Shut down the node | '''Target''': Shut down the node | ||
+ | |||
'''Component(s) to contact''': [[GHN_Manager|gHNManager]] on the gHN | '''Component(s) to contact''': [[GHN_Manager|gHNManager]] on the gHN | ||
− | '''Operation(s) to invoke''': | + | |
− | '''How to find it (them)''': query on the IS that looks for a RI of the gHN | + | '''How to find it (them)''': query on the IS that looks for a RI of the gHNManager running on the gHN |
+ | |||
+ | '''Operation(s) to invoke''': [[GHN_Manager#Requesting_the_gHN_shutdown|shutdown]] | ||
+ | |||
+ | '''Parameters''': <code>setClean=false</code>, <code>setRestart=false</code> | ||
+ | |||
+ | === Restart === | ||
+ | |||
+ | '''Target''': Restart the node and preserve its state | ||
+ | |||
+ | '''Component(s) to contact''': [[GHN_Manager|gHNManager]] on the gHN | ||
+ | |||
+ | '''How to find it (them)''': query on the IS that looks for a RI of the gHNManager running on the gHN | ||
+ | |||
+ | '''Operation(s) to invoke''': [[GHN_Manager#Requesting_the_gHN_restart|shutdown]] | ||
+ | |||
+ | '''Parameters''': <code>setClean=false</code>, <code>setRestart=true</code> | ||
+ | |||
+ | |||
+ | === Restart and Clean === | ||
+ | |||
+ | '''Target''': Restart the node and preserve its state | ||
+ | |||
+ | '''Component(s) to contact''': [[GHN_Manager|gHNManager]] on the gHN | ||
+ | |||
+ | '''How to find it (them)''': query on the IS that looks for a RI of the gHNManager running on the gHN | ||
+ | |||
+ | '''Operation(s) to invoke''': [[GHN_Manager#Requesting_the_gHN_restart|shutdown]] | ||
+ | |||
+ | '''Parameters''': <code>setClean=true</code>, <code>setRestart=true</code> | ||
== Managing a Running Instance (RI) == | == Managing a Running Instance (RI) == |
Revision as of 15:52, 20 July 2010
This section describes the programming interfaces that allow to configure, manage and control nodes, services, applications and resources in a gCube infrastructure. As the gCube technology is deployed as a distributed system, there exist several APIs to manage the different areas of the system. This section is a single point of reference for all these APIs by grouping them for their logical purpose.
This section includes the following topics:
Managing a gCube Hosting Node (gHN) | Describes operations related to manage a node of the infrastructure: how to shut it down or restart it (with and without deleting its state), how to add a new scope and remove an existing scope. |
Managing a Running Instance (RI) | Describes operation related to running instance management: how to add a new scope and remove an existing scope, how to deploy and undeploy them |
Adding / Removing a Scope to a gCube Resource (different from gHN and RI) |
Describes how to add and delete scopes to gCube Resources that are not nodes or service's instances. |
Creating / Deleting a gCube Resource (different from gHN and RI) |
Describes how to manage gCube Resources. There are specific actions for each class of resource. |
Editing a gCube Resource | Describes how to change the representation of gCube Resources in the Information System. Depending on the resource type, different components have to be contacted for this. |
Banning a gCube Resource | Describes how to instruct the Information System to exclude certain gCube resource from a given scope. This operation is available for VO-Managers and makes sense especially for nodes and running instances, when the decision to join or not a scope is partially under the control of Site Managers. |
For each of them, a detailed explanation is provided about which component(s) must be contacted for doing what and which are the scope propagation rules.
Managing a gCube Hosting Node (gHN)
Shut down
Target: Shut down the node
Component(s) to contact: gHNManager on the gHN
How to find it (them): query on the IS that looks for a RI of the gHNManager running on the gHN
Operation(s) to invoke: shutdown
Parameters: setClean=false
, setRestart=false
Restart
Target: Restart the node and preserve its state
Component(s) to contact: gHNManager on the gHN
How to find it (them): query on the IS that looks for a RI of the gHNManager running on the gHN
Operation(s) to invoke: shutdown
Parameters: setClean=false
, setRestart=true
Restart and Clean
Target: Restart the node and preserve its state
Component(s) to contact: gHNManager on the gHN
How to find it (them): query on the IS that looks for a RI of the gHNManager running on the gHN
Operation(s) to invoke: shutdown
Parameters: setClean=true
, setRestart=true