class OpenNebula::MarketPlaceApp

Constants

MARKETPLACEAPP_METHODS

Constants and Class Methods

MARKETPLACEAPP_STATES
MARKETPLACEAPP_TYPES
SHORT_MARKETPLACEAPP_STATES
SHORT_MARKETPLACEAPP_TYPES

Public Class Methods

build_xml(pe_id=nil) click to toggle source

Creates a MarketPlace description with just its identifier this method should be used to create plain MarketPlace objects. id the id of the user

Example:

app = MarketPlaceApp.new(MarketPlace.build_xml(3),rpc_client)
# File lib/opennebula/marketplaceapp.rb, line 61
def MarketPlaceApp.build_xml(pe_id=nil)
    if pe_id
        app_xml = "<MARKETPLACEAPP><ID>#{pe_id}</ID></MARKETPLACEAPP>"
    else
        app_xml = "<MARKETPLACEAPP></MARKETPLACEAPP>"
    end

    XMLElement.build_xml(app_xml,'MARKETPLACEAPP')
end
new(xml, client) click to toggle source

Class constructor

Calls superclass method
# File lib/opennebula/marketplaceapp.rb, line 72
def initialize(xml, client)
    super(xml, client)
end

Public Instance Methods

allocate(description, mp_id) click to toggle source

Allocates a new MarketPlace in OpenNebula

@param description [String] The template of the marketplace app @param mp_id [Integer] The id of the marketplace to create the app

@return [Integer, OpenNebula::Error] the new ID in case of

success, error otherwise
Calls superclass method
# File lib/opennebula/marketplaceapp.rb, line 94
def allocate(description, mp_id)
    super(MARKETPLACEAPP_METHODS[:allocate], description, mp_id)
end
chmod(owner_u, owner_m, owner_a, group_u, group_m, group_a, other_u, other_m, other_a) click to toggle source

Changes the marketplace app permissions. Each [Integer] argument must be 1 to allow, 0 deny, -1 do not change

@return [nil, OpenNebula::Error] nil in case of success, Error

otherwise
Calls superclass method
# File lib/opennebula/marketplaceapp.rb, line 140
def chmod(owner_u, owner_m, owner_a, group_u, group_m, group_a, other_u,
        other_m, other_a)
    super(MARKETPLACEAPP_METHODS[:chmod], owner_u, owner_m, owner_a,
        group_u, group_m, group_a, other_u, other_m, other_a)
end
chmod_octet(octet) click to toggle source

Changes the marketplace app permissions.

@param octet [String] Permissions octed , e.g. 640 @return [nil, OpenNebula::Error] nil in case of success, Error

otherwise
Calls superclass method
# File lib/opennebula/marketplaceapp.rb, line 131
def chmod_octet(octet)
    super(MARKETPLACEAPP_METHODS[:chmod], octet)
end
chown(uid, gid) click to toggle source

Changes the owner/group

@param uid [Integer] the new owner id. Set to -1 to leave the current one @param gid [Integer] the new group id. Set to -1 to leave the current one

@return [nil, OpenNebula::Error] nil in case of success, Error

otherwise
Calls superclass method
# File lib/opennebula/marketplaceapp.rb, line 122
def chown(uid, gid)
    super(MARKETPLACEAPP_METHODS[:chown], uid, gid)
end
delete() click to toggle source

Deletes the marketplace app

Calls superclass method
# File lib/opennebula/marketplaceapp.rb, line 99
def delete()
    super(MARKETPLACEAPP_METHODS[:delete])
end
disable() click to toggle source

Enables this app

# File lib/opennebula/marketplaceapp.rb, line 229
def disable
    return call(MARKETPLACEAPP_METHODS[:enable], @pe_id, false)
end
enable() click to toggle source

Enables this app

# File lib/opennebula/marketplaceapp.rb, line 224
def enable
    return call(MARKETPLACEAPP_METHODS[:enable], @pe_id, true)
end
export(options={}) click to toggle source

Exports this app to a suitable OpenNebula object @param appid [Integer] id of the marketplace app @param options [Hash] to control the export behavior

dsid [Integer] datastore to save images
name [String] of the new object
vmtemplate_name [String] name for the VM Template, if the App has one

@return [Hash, OpenNebula::Error] with the ID and type of the created objects. Instead of an ID, the array may contain OpenNebula::Error with specific object creation errors

{ :vm => [ vm ids/OpenNebula::Error ],
  :vmtemplate => [ vmtemplates ids/OpenNebula::Error ],
  :image => [ vm ids/OpenNebula::Error ] }
# File lib/opennebula/marketplaceapp.rb, line 169
def export(options={})
    return Error.new("Missing datastore id") if options[:dsid].nil?
    return Error.new("Missing name to export app") if options[:name].nil?

    rc  = info
    return rc if OpenNebula.is_error?(rc)
    return Error.new("App is not in READY state") if state_str!="READY"

    case type_str
    when "IMAGE"
        if !self['APPTEMPLATE64'].nil?
            tmpl=Base64::decode64(self['APPTEMPLATE64'])
        else
            tmpl=""
        end

        name = options[:name] || "marketapp-#{self.id}"

        tmpl << "\n"
        tmpl << "NAME=\"" << name << "\"\n"
        tmpl << "FROM_APP=\""       << self['ID'] << "\"\n"

        image = Image.new(Image.build_xml, @client)
        rc    = image.allocate(tmpl, options[:dsid])

        return { :image => [rc] } if OpenNebula.is_error?(rc)

        image_id = image.id
        vmtpl_id = -1

        if !self['TEMPLATE/VMTEMPLATE64'].nil?
            tmpl=Base64::decode64(self['TEMPLATE/VMTEMPLATE64'])

            tmpl_name = options[:vmtemplate_name] || name

            tmpl << "\nNAME=\"#{tmpl_name}\"\n"
            tmpl << "DISK=[ IMAGE_ID = #{image.id} ]\n"

            vmtpl = Template.new(Template.build_xml, @client)
            rc    = vmtpl.allocate(tmpl)

            if OpenNebula.is_error?(rc)
                return { :image => [image_id], :vmtemplate => [rc] }
            end

            vmtpl_id = vmtpl.id
        end

        return { :image => [image_id], :vmtemplate => [vmtpl_id] }
    else
        return Error.new("App type #{app.type_str} not supported")
    end
end
info() click to toggle source

Retrieves the information of the given marketplace app

Calls superclass method
# File lib/opennebula/marketplaceapp.rb, line 81
def info()
    super(MARKETPLACEAPP_METHODS[:info], 'MARKETPLACEAPP')
end
Also aliased as: info!
info!()
Alias for: info
rename(name) click to toggle source

Renames this marketplace app

@param name [String] New name for the marketplace app

@return [nil, OpenNebula::Error] nil in case of success, Error

otherwise
# File lib/opennebula/marketplaceapp.rb, line 152
def rename(name)
    return call(MARKETPLACEAPP_METHODS[:rename], @pe_id, name)
end
short_state_str() click to toggle source

Returns the state of the marketplace app (string value)

# File lib/opennebula/marketplaceapp.rb, line 263
def short_state_str
    SHORT_MARKETPLACEAPP_STATES[state_str]
end
short_type_str() click to toggle source

Returns the marketplace app type (string value)

# File lib/opennebula/marketplaceapp.rb, line 248
def short_type_str
    SHORT_MARKETPLACEAPP_TYPES[type_str]
end
state() click to toggle source

Returns the state of the marketplace app (numeric value)

# File lib/opennebula/marketplaceapp.rb, line 253
def state
    self['STATE'].to_i
end
state_str() click to toggle source

Returns the state of the marketplace app (string value)

# File lib/opennebula/marketplaceapp.rb, line 258
def state_str
    MARKETPLACEAPP_STATES[state]
end
type() click to toggle source

Returns the marketplace app type

# File lib/opennebula/marketplaceapp.rb, line 238
def type
    self['TYPE'].to_i
end
type_str() click to toggle source

Returns the marketplace app type (string value)

# File lib/opennebula/marketplaceapp.rb, line 243
def type_str
    MARKETPLACEAPP_TYPES[type]
end
update(new_template, append=false) click to toggle source

Replaces the template contents

@param new_template [String] New template contents @param append [true, false] True to append new attributes instead of

replace the whole template

@return [nil, OpenNebula::Error] nil in case of success, Error

otherwise
Calls superclass method
# File lib/opennebula/marketplaceapp.rb, line 111
def update(new_template, append=false)
    super(MARKETPLACEAPP_METHODS[:update], new_template, append ? 1 : 0)
end