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 : [<ServiceName> <ServiceClass> <version> <GHNId>]*
+
** DEPLOY :  
A property file containinig the deployment information can  be provided instead:
+
<ServiceName> <ServiceClass> <version> <GHNId>]*  
DEPLOY : <Property File>
+
property file containing the deployment information can  be provided instead:  
** UNDEPLOY_RI : [<RunningIstanceID>]*  
+
<Property File>
**UNDEPLOY_SA : [<ServiceName> <ServiceClass> <version> ]* <GHNId>
+
** UNDEPLOY_RI :  
A property file containinig the undeployment information can  be provided instead:
+
[<RunningIstanceID>]*  
 +
**UNDEPLOY_SA :  
 +
[<ServiceName> <ServiceClass> <version> ]* <GHNId>
 +
A property file containing the undeployment information can  be provided instead:
 
UNDEPLOY_SA : <Property File>
 
UNDEPLOY_SA : <Property File>
**UPGRADE_RI :[<RunningIstanceID>]*  
+
**UPGRADE_RI :
**UPGRADE_SA : [<ServiceName> <ServiceClass> <version> ]* <GHNId>  
+
[<RunningIstanceID>]*  
A property file containinig the upgrade information can  be provided instead:
+
**UPGRADE_SA :  
UPGRADE_SA : <Property File>
+
[<ServiceName> <ServiceClass> <version> ]* <GHNId>  
**ADD_SCOPE : <ResourceType> [<ResourceID>]*  
+
A property file containing the upgrade information can  be provided instead:
 +
**UPGRADE_SA :  
 +
<Property File>
 +
**ADD_SCOPE :  
 +
<ResourceType> [<ResourceID>]*  
 
<ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource
 
<ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource
** REMOVE_SCOPE : <ResourceType> [<ResourceID>]*  
+
** REMOVE_SCOPE :  
 +
<ResourceType> [<ResourceID>]*  
 
<ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource
 
<ResourceType> must be one of: GHN, RunningInstance, Collection, MetadataCollection, GenericResource
** REPORT : <deployment/undeployment ID>
+
** REPORT :  
 +
<deployment/undeployment ID>

Revision as of 09:49, 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>]* 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: UNDEPLOY_SA : <Property File>

    • UPGRADE_RI :

[<RunningIstanceID>]*

    • UPGRADE_SA :

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

    • UPGRADE_SA :

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