Difference between revisions of "Developer's Guide/ResourceManagerClient"

From Gcube Wiki
Jump to: navigation, search
(Usage)
(Usage)
Line 31: Line 31:
 
**'''REPORT''' : to get the deployment/undeplopyment report
 
**'''REPORT''' : to get the deployment/undeplopyment report
 
*''parameters'':
 
*''parameters'':
** DEPLOY :
+
==== DEPLOY ====
<ServiceName> <ServiceClass> <version> <GHNId>]*  
+
[<ServiceName> <ServiceClass> <version> <GHNId>]*  
property file containing the deployment information can  be provided instead:  
+
 
 +
A property file containing the deployment information can  be provided instead:  
 +
 
 
<Property File>
 
<Property File>
** UNDEPLOY_RI :
+
==== UNDEPLOY_RI ====
 
[<RunningIstanceID>]*  
 
[<RunningIstanceID>]*  
**UNDEPLOY_SA :
+
==== UNDEPLOY_SA ====
 
[<ServiceName> <ServiceClass> <version> ]* <GHNId>
 
[<ServiceName> <ServiceClass> <version> ]* <GHNId>
 
A property file containing the undeployment information can  be provided instead:
 
A property file containing the undeployment information can  be provided instead:
UNDEPLOY_SA : <Property File>
+
<Property File>
**UPGRADE_RI :
+
====UPGRADE_RI ====
 
[<RunningIstanceID>]*  
 
[<RunningIstanceID>]*  
**UPGRADE_SA :
+
====UPGRADE_SA ====
 
[<ServiceName> <ServiceClass> <version> ]* <GHNId>  
 
[<ServiceName> <ServiceClass> <version> ]* <GHNId>  
 
A property file containing the upgrade information can  be provided instead:
 
A property file containing the upgrade information can  be provided instead:
**UPGRADE_SA :
 
 
<Property File>
 
<Property File>
**ADD_SCOPE :
+
====ADD_SCOPE ====
 
<ResourceType> [<ResourceID>]*  
 
<ResourceType> [<ResourceID>]*  
 
<ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource
 
<ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource
** REMOVE_SCOPE :
+
==== REMOVE_SCOPE ====
 
<ResourceType> [<ResourceID>]*  
 
<ResourceType> [<ResourceID>]*  
 
<ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource
 
<ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource
** REPORT :
+
==== REPORT ====
 
<deployment/undeployment ID>
 
<deployment/undeployment ID>

Revision as of 11:47, 31 January 2011

Resource Manager Client

The Resource Manager Client library is a set of utilities which allows the management of a gCube infrastructure. It exploits and combines the functionalities exposed by the Resource Manager Service, giving Site/Infrastructure Administrators a powerful tool to easily perform the following infrastructure management operations:

  • Service Deployment
  • Service Undeployment
  • Service Upgrade
  • Add Scope to a Resource
  • Remove Scope from a Resource

Usage

The Library can be invoked by CLI using the following syntax:

ResourceManagerClient [options] scope  true/false [parameters...]

where :

  • scope : identifies the operation scope, thus the Resource Manager Service instance to contact. The Resource Manager service to contact for every type of operation is automatically discovered from the Infrastructure ISs.
  • true/false : specifies if the Resource Manager needs to be contacted in a secure way. If yes the user proxy is loaded from the environment ( the X509_USER_PROXY variable need to be set ) and attached to the service request.
  • options:
    • DEPLOY : to deploy one or more SAs
    • UNDEPLOY_RI : to undeploy one or more RunningInstance knowing the Ids.
    • UNDEPLOY_SA : to undeploy one or more SAs from the given scope
    • UPGRADE_RI : to upgrade one or more RIs in the given scope
    • UPGRADE_SA : to upgrade one or more SAs in the given scope.
    • ADD_SCOPE : to add one or more Resources to the given scope
    • REMOVE_SCOPE : to remove one or more Resources from the given scope
    • REPORT : to get the deployment/undeplopyment report
  • parameters:

DEPLOY

[<ServiceName> <ServiceClass> <version> <GHNId>]*

A property file containing the deployment information can be provided instead:

<Property File>

UNDEPLOY_RI

[<RunningIstanceID>]*

UNDEPLOY_SA

[<ServiceName> <ServiceClass> <version> ]* <GHNId> A property file containing the undeployment information can be provided instead: <Property File>

UPGRADE_RI

[<RunningIstanceID>]*

UPGRADE_SA

[<ServiceName> <ServiceClass> <version> ]* <GHNId> A property file containing the upgrade information can be provided instead: <Property File>

ADD_SCOPE

<ResourceType> [<ResourceID>]* <ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource

REMOVE_SCOPE

<ResourceType> [<ResourceID>]* <ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource

REPORT

<deployment/undeployment ID>