Developer's Guide/ResourceManagerClient

From Gcube Wiki
Revision as of 10:49, 31 January 2011 by Andrea.manzi (Talk | contribs) (Usage)

Jump to: navigation, search

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>