opennebula-cli 3.8.0.beta1

data/bin/onegroup

@@ -0,0 +1,137 @@
+#!/usr/bin/env ruby
+
+# -------------------------------------------------------------------------- #
+# Copyright 2002-2012, OpenNebula Project Leads (OpenNebula.org)             #
+#                                                                            #
+# Licensed under the Apache License, Version 2.0 (the "License"); you may    #
+# not use this file except in compliance with the License. You may obtain    #
+# a copy of the License at                                                   #
+#                                                                            #
+# http://www.apache.org/licenses/LICENSE-2.0                                 #
+#                                                                            #
+# Unless required by applicable law or agreed to in writing, software        #
+# distributed under the License is distributed on an "AS IS" BASIS,          #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   #
+# See the License for the specific language governing permissions and        #
+# limitations under the License.                                             #
+#--------------------------------------------------------------------------- #
+
+ONE_LOCATION=ENV["ONE_LOCATION"]
+
+if !ONE_LOCATION
+    RUBY_LIB_LOCATION="/usr/lib/one/ruby"
+else
+    RUBY_LIB_LOCATION=ONE_LOCATION+"/lib/ruby"
+end
+
+$: << RUBY_LIB_LOCATION
+$: << RUBY_LIB_LOCATION+"/cli"
+
+require 'command_parser'
+require 'one_helper/onegroup_helper'
+
+cmd=CommandParser::CmdParser.new(ARGV) do
+    usage "`onegroup` <command> [<args>] [<options>]"
+    version OpenNebulaHelper::ONE_VERSION
+
+    helper = OneGroupHelper.new
+
+    ########################################################################
+    # Global Options
+    ########################################################################
+    set :option, CommandParser::OPTIONS
+
+    list_options = CLIHelper::OPTIONS
+    list_options << OpenNebulaHelper::XML
+    list_options << OpenNebulaHelper::NUMERIC
+    list_options << OpenNebulaHelper::DESCRIBE
+
+    ########################################################################
+    # Formatters for arguments
+    ########################################################################
+    set :format, :groupid, OneGroupHelper.to_id_desc do |arg|
+        helper.to_id(arg)
+    end
+
+    set :format, :groupid_list, OneGroupHelper.list_to_id_desc do |arg|
+        helper.list_to_id(arg)
+    end
+
+    ########################################################################
+    # Commands
+    ########################################################################
+
+    create_desc = <<-EOT.unindent
+        Creates a new Group
+    EOT
+
+    command :create, create_desc, :name do
+        helper.create_resource(options) do |group|
+            group.allocate(args[0])
+        end
+    end
+
+    delete_desc = <<-EOT.unindent
+        Deletes the given Group
+    EOT
+
+    command :delete, delete_desc, [:range, :groupid_list] do
+        helper.perform_actions(args[0],options,"deleted") do |obj|
+            obj.delete
+        end
+    end
+
+    list_desc = <<-EOT.unindent
+        Lists Groups in the pool
+    EOT
+
+    command :list, list_desc, :options=>list_options do
+        helper.list_pool(options)
+    end
+
+    show_desc = <<-EOT.unindent
+        Shows information for the given Group
+    EOT
+
+    command :show, show_desc,[:groupid, nil], :options=>OpenNebulaHelper::XML do
+        group = args[0] || OpenNebula::Group::SELF
+        helper.show_resource(group,options)
+    end
+
+    quota_desc = <<-EOT.unindent
+        Set the quota limits for the group. If a path is not provided the editor 
+        will be launched to modify the current quotas.
+    EOT
+
+    command :quota, quota_desc, :groupid, [:file, nil] do
+        helper.perform_action(args[0], options, "modified") do |group|
+            str = OneQuotaHelper.set_quota(group, args[1])
+            rc  = group.set_quota(str)
+
+            if OpenNebula.is_error?(rc)
+                puts rc.message
+                exit -1
+            end
+        end
+    end  
+
+    batchquota_desc = <<-EOT.unindent
+        Sets the quota limits in batch for various groups. If a path is not
+        provided the editor will be launched to create new quotas.
+    EOT
+
+    command :batchquota, batchquota_desc, [:range, :groupid_list], [:file, nil] do
+        batch_str = OneQuotaHelper.get_batch_quota(args[1])
+
+        helper.perform_actions(args[0], options, "modified") do |group|
+            str = OneQuotaHelper.merge_quota(group, batch_str)
+
+            if OpenNebula.is_error?(str)
+                str
+            else
+                rc  = group.set_quota(str)
+                rc
+            end
+        end
+    end
+end

data/bin/onehost

@@ -0,0 +1,205 @@
+#!/usr/bin/env ruby
+
+# -------------------------------------------------------------------------- #
+# Copyright 2002-2012, OpenNebula Project Leads (OpenNebula.org)             #
+#                                                                            #
+# Licensed under the Apache License, Version 2.0 (the "License"); you may    #
+# not use this file except in compliance with the License. You may obtain    #
+# a copy of the License at                                                   #
+#                                                                            #
+# http://www.apache.org/licenses/LICENSE-2.0                                 #
+#                                                                            #
+# Unless required by applicable law or agreed to in writing, software        #
+# distributed under the License is distributed on an "AS IS" BASIS,          #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   #
+# See the License for the specific language governing permissions and        #
+# limitations under the License.                                             #
+#--------------------------------------------------------------------------- #
+
+ONE_LOCATION=ENV["ONE_LOCATION"]
+
+if !ONE_LOCATION
+    RUBY_LIB_LOCATION="/usr/lib/one/ruby"
+else
+    RUBY_LIB_LOCATION=ONE_LOCATION+"/lib/ruby"
+end
+
+$: << RUBY_LIB_LOCATION
+$: << RUBY_LIB_LOCATION+"/cli"
+
+require 'command_parser'
+require 'one_helper/onehost_helper'
+require 'one_helper/onecluster_helper'
+
+cmd=CommandParser::CmdParser.new(ARGV) do
+    usage "`onehost` <command> [<args>] [<options>]"
+    version OpenNebulaHelper::ONE_VERSION
+
+    helper = OneHostHelper.new
+
+    ########################################################################
+    # Global Options
+    ########################################################################
+    set :option, CommandParser::OPTIONS
+
+    IM = {
+    :name   => "im",
+    :short  => "-i im_mad",
+    :large  => "--im im_mad" ,
+    :description => "Set the information driver for the host",
+    :format => String
+    }
+
+    VMM = {
+    :name   => "vm",
+    :short  => "-v vmm_mad",
+    :large  => "--vm vmm_mad" ,
+    :description => "Set the virtualization driver for the host",
+    :format => String
+    }
+
+    VNET = {
+    :name   => "net",
+    :short  => "-n vnet_mad",
+    :large  => "--net vnet_mad" ,
+    :description => "Set the network driver for the host",
+    :format => String
+    }
+
+    CREAT_OPTIONS = [ IM, VMM, VNET, OneClusterHelper::CLUSTER ]
+
+    ########################################################################
+    # Formatters for arguments
+    ########################################################################
+
+    set :format, :hostid, OneHostHelper.to_id_desc do |arg|
+        helper.to_id(arg)
+    end
+
+    set :format, :hostid_list, OneHostHelper.list_to_id_desc do |arg|
+        helper.list_to_id(arg)
+    end
+
+    ########################################################################
+    # Commands
+    ########################################################################
+
+    create_desc = <<-EOT.unindent
+        Creates a new Host
+    EOT
+
+    command :create, create_desc, :hostname, :options=>CREAT_OPTIONS do
+        if options[:im].nil? or options[:vm].nil? or options[:net].nil?
+            STDERR.puts "Drivers are mandatory to create a host:"
+            STDERR.puts "\t -i information driver"
+            STDERR.puts "\t -v hypervisor driver"
+            STDERR.puts "\t -n network driver"
+            exit -1
+        end
+
+        cid = options[:cluster] || ClusterPool::NONE_CLUSTER_ID
+
+        helper.create_resource(options) do |host|
+                host.allocate(args[0],
+                              options[:im],
+                              options[:vm],
+                              options[:net],
+                              cid)
+        end
+    end
+
+    delete_desc = <<-EOT.unindent
+        Deletes the given Host
+    EOT
+
+    command :delete, delete_desc, [:range, :hostid_list] do
+        helper.perform_actions(args[0],options,"deleted") do |host|
+            host.delete
+        end
+    end
+
+    enable_desc = <<-EOT.unindent
+        Enables the given Host
+    EOT
+
+    command :enable, enable_desc, [:range,:hostid_list] do
+        helper.perform_actions(args[0],options,"enabled") do |host|
+            host.enable
+        end
+    end
+
+    disable_desc = <<-EOT.unindent
+        Disables the given Host
+    EOT
+
+    command :disable, disable_desc, [:range,:hostid_list] do
+        helper.perform_actions(args[0],options,"disabled") do |host|
+            host.disable
+        end
+    end
+
+    update_desc = <<-EOT.unindent
+        Update the template contents. If a path is not provided the editor will
+        be launched to modify the current content.
+    EOT
+
+    command :update, update_desc, :hostid, [:file, nil] do
+        helper.perform_action(args[0],options,"updated") do |host|
+            str = OpenNebulaHelper.update_template(args[0], host, args[1])
+            host.update(str)
+        end
+    end
+
+    sync_desc = <<-EOT.unindent
+        Synchronizes probes in /var/lib/one/remotes ($ONE_LOCATION/var/remotes
+        in self-contained installations) with Hosts.
+        The copy is performed the next time the Host is monitored
+    EOT
+
+    command :sync, sync_desc do
+        if ONE_LOCATION
+            FileUtils.touch "#{ONE_LOCATION}/var/remotes"
+        else
+            FileUtils.touch "/var/lib/one/remotes"
+        end
+        0
+    end
+
+    list_desc = <<-EOT.unindent
+        Lists Hosts in the pool
+    EOT
+
+    command :list, list_desc,
+            :options=>CLIHelper::OPTIONS+OpenNebulaHelper::OPTIONS+
+            [OpenNebulaHelper::DESCRIBE] do
+        helper.list_pool(options)
+    end
+
+    show_desc = <<-EOT.unindent
+        Shows information for the given Host
+    EOT
+
+    command :show, show_desc, :hostid,
+            :options=>OpenNebulaHelper::XML do
+        helper.show_resource(args[0],options)
+    end
+
+    top_desc = <<-EOT.unindent
+        Lists Hosts continuously
+    EOT
+
+    command :top, top_desc,
+            :options=>CLIHelper::OPTIONS+OpenNebulaHelper::OPTIONS do
+        helper.list_pool(options, true)
+    end
+
+    flush_desc = <<-EOT.unindent
+        Disables the host and reschedules all the running VMs in it.
+    EOT
+
+    command :flush, flush_desc, [:range,:hostid_list] do
+        helper.perform_actions(args[0],options,"flush") do |host|
+            host.flush
+        end
+    end
+end

data/bin/oneimage

@@ -0,0 +1,311 @@
+#!/usr/bin/env ruby
+
+# -------------------------------------------------------------------------- #
+# Copyright 2002-2012, OpenNebula Project Leads (OpenNebula.org)             #
+#                                                                            #
+# Licensed under the Apache License, Version 2.0 (the "License"); you may    #
+# not use this file except in compliance with the License. You may obtain    #
+# a copy of the License at                                                   #
+#                                                                            #
+# http://www.apache.org/licenses/LICENSE-2.0                                 #
+#                                                                            #
+# Unless required by applicable law or agreed to in writing, software        #
+# distributed under the License is distributed on an "AS IS" BASIS,          #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   #
+# See the License for the specific language governing permissions and        #
+# limitations under the License.                                             #
+#--------------------------------------------------------------------------- #
+
+ONE_LOCATION=ENV["ONE_LOCATION"]
+
+if !ONE_LOCATION
+    RUBY_LIB_LOCATION="/usr/lib/one/ruby"
+else
+    RUBY_LIB_LOCATION=ONE_LOCATION+"/lib/ruby"
+end
+
+$: << RUBY_LIB_LOCATION
+$: << RUBY_LIB_LOCATION+"/cli"
+
+require 'command_parser'
+require 'one_helper/oneimage_helper'
+require 'one_helper/onedatastore_helper'
+
+cmd=CommandParser::CmdParser.new(ARGV) do
+    usage "`oneimage` <command> [<args>] [<options>]"
+    version OpenNebulaHelper::ONE_VERSION
+
+    helper = OneImageHelper.new
+
+    ########################################################################
+    # Global Options
+    ########################################################################
+    set :option, CommandParser::OPTIONS
+
+    list_options = CLIHelper::OPTIONS
+    list_options << OpenNebulaHelper::XML
+    list_options << OpenNebulaHelper::NUMERIC
+    list_options << OpenNebulaHelper::DESCRIBE
+
+    CREATE_OPTIONS = [OneDatastoreHelper::DATASTORE]
+
+    ########################################################################
+    # Formatters for arguments
+    ########################################################################
+    set :format, :groupid, OpenNebulaHelper.rname_to_id_desc("GROUP") do |arg|
+        OpenNebulaHelper.rname_to_id(arg, "GROUP")
+    end
+
+    set :format, :userid, OpenNebulaHelper.rname_to_id_desc("USER") do |arg|
+        OpenNebulaHelper.rname_to_id(arg, "USER")
+    end
+
+    set :format, :imageid, OneImageHelper.to_id_desc do |arg|
+        helper.to_id(arg)
+    end
+
+    set :format, :imageid_list, OneImageHelper.list_to_id_desc do |arg|
+        helper.list_to_id(arg)
+    end
+
+    set :format, :filterflag, OneImageHelper.filterflag_to_i_desc do |arg|
+        helper.filterflag_to_i(arg)
+    end
+
+    ########################################################################
+    # Commands
+    ########################################################################
+
+    create_desc = <<-EOT.unindent
+        Creates a new Image
+        Examples:
+          - using a template description file:
+
+            oneimage create -d default centOS.tmpl
+
+          - new image "arch" using a path of type centOS:
+
+            oneimage create -d default --name arch --path /tmp/arch.img
+
+          - new persistent image, OS type and qcow2 format:
+
+            oneimage create -d 1 --name ubuntu --path /tmp/ubuntu.qcow2 \\
+                            --prefix sd --type OS --driver qcow2 \\
+                            --description "A OS plain installation"
+
+          - a datablock image of 400MB:
+
+            oneimage create -d 1 --name data --type DATABLOCK --size 400 \\
+                            --fstype ext2
+
+    EOT
+
+    command :create, create_desc, [:file, nil], :options=>CREATE_OPTIONS +
+            OneImageHelper::TEMPLATE_OPTIONS do
+
+        if options[:datastore].nil?
+            STDERR.puts "Datastore to save the image is mandatory: "
+            STDERR.puts "\t -d datastore_id"
+            exit -1
+        end
+
+        if args[0] && OpenNebulaHelper.create_template_options_used?(options)
+            STDERR.puts "You can not use both template file and template"<<
+                " creation options."
+            next -1
+        end
+
+        helper.create_resource(options) do |image|
+            begin
+                if args[0]
+                    template=File.read(args[0])
+                else
+                    res = OneImageHelper.create_image_template(options)
+
+                    if res.first != 0
+                        STDERR.puts res.last
+                        next -1
+                    end
+
+                    template = res.last
+                end
+
+                image.allocate(template, options[:datastore])
+            rescue => e
+                STDERR.puts e.messsage
+                exit -1
+            end
+        end
+    end
+
+    clone_desc = <<-EOT.unindent
+        Creates a new Image from an existing one
+    EOT
+
+    command :clone, clone_desc, :imageid, :name do
+        helper.perform_action(args[0],options,"cloned") do |image|
+            res = image.clone(args[1])
+
+            if !OpenNebula.is_error?(res)
+                puts "ID: #{res}"
+            else
+                puts res.message
+            end
+        end
+    end
+
+    delete_desc = <<-EOT.unindent
+        Deletes the given Image
+    EOT
+
+    command :delete, delete_desc, [:range, :imageid_list] do
+        helper.perform_actions(args[0],options,"deleted") do |image|
+            image.delete
+        end
+    end
+
+    publish_desc = <<-EOT.unindent
+        DEPRECATED, use chmod instead. Publishes the given Image. A public Image
+        can be seen and used by other users in the Image's group.
+    EOT
+
+    command :publish, publish_desc, [:range,:imageid_list] do
+        helper.perform_actions(args[0],options,"published") do |image|
+            image.publish
+        end
+    end
+
+    unpublish_desc = <<-EOT.unindent
+        DEPRECATED, use chmod instead. Unpublishes the given Image. A private
+        Image can't be used by any other user.
+    EOT
+
+    command :unpublish, unpublish_desc, [:range,:imageid_list] do
+        helper.perform_actions(args[0],options,"unpublished") do |image|
+            image.unpublish
+        end
+    end
+
+    persistent_desc = <<-EOT.unindent
+        Makes the given Image persistent. A persistent Image saves the changes
+        made to the contents after the VM instance is shutdown (or in real time
+        if a shared FS is used). Persistent Images can be used by only
+        one VM instance at a time.
+    EOT
+
+    command :persistent, persistent_desc, [:range,:imageid_list] do
+        helper.perform_actions(args[0],options,"made persistent") do |image|
+            image.persistent
+        end
+    end
+
+    nonpersistent_desc = <<-EOT.unindent
+        Makes the given Image non persistent. See 'oneimage persistent'
+    EOT
+
+    command :nonpersistent, nonpersistent_desc, [:range,:imageid_list] do
+        helper.perform_actions(args[0],options,"made non persistent") do |image|
+            image.nonpersistent
+        end
+    end
+
+    update_desc = <<-EOT.unindent
+        Update the template contents. If a path is not provided the editor will
+        be launched to modify the current content.
+    EOT
+
+    command :update, update_desc, :imageid, [:file, nil] do
+        helper.perform_action(args[0],options,"modified") do |image|
+            str = OpenNebulaHelper.update_template(args[0], image, args[1])
+            image.update(str)
+        end
+    end
+
+    enable_desc = <<-EOT.unindent
+        Enables the given Image
+    EOT
+
+    command :enable, enable_desc, [:range,:imageid_list] do
+        helper.perform_actions(args[0],options,"enabled") do |image|
+            image.enable
+        end
+    end
+
+    chtype_desc = <<-EOT.unindent
+        Changes the Image's type
+    EOT
+
+    command :chtype, chtype_desc,[:range, :imageid_list], :type do
+        helper.perform_actions(args[0],options,"Type changed") do |image|
+            image.chtype(args[1])
+        end
+    end
+
+    disable_desc = <<-EOT.unindent
+        Disables the given Image
+    EOT
+
+    command :disable, disable_desc, [:range,:imageid_list] do
+        helper.perform_actions(args[0],options,"disabled") do |image|
+            image.disable
+        end
+    end
+
+    chgrp_desc = <<-EOT.unindent
+        Changes the Image group
+    EOT
+
+    command :chgrp, chgrp_desc,[:range, :imageid_list], :groupid do
+        helper.perform_actions(args[0],options,"Group changed") do |image|
+            image.chown(-1, args[1].to_i)
+        end
+    end
+
+    chown_desc = <<-EOT.unindent
+        Changes the Image owner and group
+    EOT
+
+    command :chown, chown_desc, [:range, :imageid_list], :userid,
+            [:groupid,nil] do
+        gid = args[2].nil? ? -1 : args[2].to_i
+        helper.perform_actions(args[0],options,
+                "Owner/Group changed") do |image|
+            image.chown(args[1].to_i, gid)
+        end
+    end
+
+    chmod_desc = <<-EOT.unindent
+        Changes the Image permissions
+    EOT
+
+    command :chmod, chmod_desc, [:range, :imageid_list], :octet do
+        helper.perform_actions(args[0],options,
+                "Permissions changed") do |image|
+            image.chmod_octet(args[1])
+        end
+    end
+
+    list_desc = <<-EOT.unindent
+        Lists Images in the pool
+    EOT
+
+    command :list, list_desc, [:filterflag, nil], :options=>list_options do
+        helper.list_pool(options, false, args[0])
+    end
+
+    show_desc = <<-EOT.unindent
+        Shows information for the given Image
+    EOT
+
+    command :show, show_desc, :imageid, :options=>OpenNebulaHelper::XML do
+        helper.show_resource(args[0],options)
+    end
+
+    top_desc = <<-EOT.unindent
+        Lists Images continuously
+    EOT
+
+    command :top, top_desc, [:filterflag, nil], :options=>list_options do
+        helper.list_pool(options, true, args[0])
+    end
+end