rbvmomi 2.0.0 → 2.0.1

data/examples/clone_vm.rb

@@ -1,88 +0,0 @@
-#!/usr/bin/env ruby
-
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'optimist'
-require 'rbvmomi'
-require 'rbvmomi/optimist'
-
-VIM = RbVmomi::VIM
-
-opts = Optimist.options do
-  banner <<-EOS
-Clone a VM.
-
-Usage:
-    clone_vm.rb [options] source_vm dest_vm
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-
-  opt :linked_clone, "Use a linked clone instead of a full clone"
-end
-
-Optimist.die("must specify host") unless opts[:host]
-ARGV.size == 2 or abort "must specify VM source name and VM target name"
-vm_source = ARGV[0]
-vm_target = ARGV[1]
-
-vim = VIM.connect opts
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or abort "datacenter not found"
-vm = dc.find_vm(vm_source) or abort "VM not found"
-
-if opts[:linked_clone]
-  # The API for linked clones is quite strange. We can't create a linked
-  # straight from any VM. The disks of the VM for which we can create a
-  # linked clone need to be read-only and thus VC demands that the VM we
-  # are cloning from uses delta-disks. Only then it will allow us to
-  # share the base disk.
-  #
-  # Thus, this code first create a delta disk on top of the base disk for
-  # the to-be-cloned VM, if delta disks aren't used already.
-  disks = vm.config.hardware.device.grep(VIM::VirtualDisk)
-  disks.select { |x| x.backing.parent == nil }.each do |disk|
-    spec = {
-      :deviceChange => [
-        {
-          :operation => :remove,
-          :device => disk
-        },
-        {
-          :operation => :add,
-          :fileOperation => :create,
-          :device => disk.dup.tap { |x|
-            x.backing = x.backing.dup
-            x.backing.fileName = "[#{disk.backing.datastore.name}]"
-            x.backing.parent = disk.backing
-          },
-        }
-      ]
-    }
-    vm.ReconfigVM_Task(:spec => spec).wait_for_completion
-  end
-
-  relocateSpec = VIM.VirtualMachineRelocateSpec(:diskMoveType => :moveChildMostDiskBacking)
-else
-  relocateSpec = VIM.VirtualMachineRelocateSpec
-end
-
-spec = VIM.VirtualMachineCloneSpec(:location => relocateSpec,
-                                   :powerOn => false,
-                                   :template => false)
-
-vm.CloneVM_Task(:folder => vm.parent, :name => vm_target, :spec => spec).wait_for_completion

data/examples/create_vm-1.9.rb

@@ -1,97 +0,0 @@
-#!/usr/bin/env ruby
-
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'optimist'
-require 'rbvmomi'
-require 'rbvmomi/optimist'
-
-VIM = RbVmomi::VIM
-
-opts = Optimist.options do
-  banner <<-EOS
-Create a VM.
-
-Usage:
-    create_vm-1.9.rb [options]
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-end
-
-Optimist.die("must specify host") unless opts[:host]
-vm_name = ARGV[0] or abort "must specify VM name"
-
-vim = VIM.connect opts
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or abort "datacenter not found"
-vmFolder = dc.vmFolder
-hosts = dc.hostFolder.children
-rp = hosts.first.resourcePool
-
-vm_cfg = {
-  name: vm_name,
-  guestId: 'otherGuest',
-  files: { vmPathName: '[datastore1]' },
-  numCPUs: 1,
-  memoryMB: 128,
-  deviceChange: [
-    {
-      operation: :add,
-      device: VIM.VirtualLsiLogicController(
-        key: 1000,
-        busNumber: 0,
-        sharedBus: :noSharing,
-      )
-    }, {
-      operation: :add,
-      fileOperation: :create,
-      device: VIM.VirtualDisk(
-        key: 0,
-        backing: VIM.VirtualDiskFlatVer2BackingInfo(
-          fileName: '[datastore1]',
-          diskMode: :persistent,
-          thinProvisioned: true,
-        ),
-        controllerKey: 1000,
-        unitNumber: 0,
-        capacityInKB: 4000000,
-      )
-    }, {
-      operation: :add,
-      device: VIM.VirtualE1000(
-        key: 0,
-        deviceInfo: {
-          label: 'Network Adapter 1',
-          summary: 'VM Network',
-        },
-        backing: VIM.VirtualEthernetCardNetworkBackingInfo(
-          deviceName: 'VM Network',
-        ),
-        addressType: 'generated'
-      )
-    }
-  ],
-  extraConfig: [
-    {
-      key: 'bios.bootOrder',
-      value: 'ethernet0'
-    }
-  ]
-}
-
-vmFolder.CreateVM_Task(:config => vm_cfg, :pool => rp).wait_for_completion

data/examples/create_vm.rb

@@ -1,97 +0,0 @@
-#!/usr/bin/env ruby
-
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'optimist'
-require 'rbvmomi'
-require 'rbvmomi/optimist'
-
-VIM = RbVmomi::VIM
-
-opts = Optimist.options do
-  banner <<-EOS
-Create a VM.
-
-Usage:
-    create_vm.rb [options]
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-end
-
-Optimist.die("must specify host") unless opts[:host]
-vm_name = ARGV[0] or abort "must specify VM name"
-
-vim = VIM.connect opts
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or abort "datacenter not found"
-vmFolder = dc.vmFolder
-hosts = dc.hostFolder.children
-rp = hosts.first.resourcePool
-
-vm_cfg = {
-  :name => vm_name,
-  :guestId => 'otherGuest',
-  :files => { :vmPathName => '[datastore1]' },
-  :numCPUs => 1,
-  :memoryMB => 128,
-  :deviceChange => [
-    {
-      :operation => :add,
-      :device => VIM.VirtualLsiLogicController(
-        :key => 1000,
-        :busNumber => 0,
-        :sharedBus => :noSharing
-      )
-    }, {
-      :operation => :add,
-      :fileOperation => :create,
-      :device => VIM.VirtualDisk(
-        :key => 0,
-        :backing => VIM.VirtualDiskFlatVer2BackingInfo(
-          :fileName => '[datastore1]',
-          :diskMode => :persistent,
-          :thinProvisioned => true
-        ),
-        :controllerKey => 1000,
-        :unitNumber => 0,
-        :capacityInKB => 4000000
-      )
-    }, {
-      :operation => :add,
-      :device => VIM.VirtualE1000(
-        :key => 0,
-        :deviceInfo => {
-          :label => 'Network Adapter 1',
-          :summary => 'VM Network'
-        },
-        :backing => VIM.VirtualEthernetCardNetworkBackingInfo(
-          :deviceName => 'VM Network'
-        ),
-        :addressType => 'generated'
-      )
-    }
-  ],
-  :extraConfig => [
-    {
-      :key => 'bios.bootOrder',
-      :value => 'ethernet0'
-    }
-  ]
-}
-
-vmFolder.CreateVM_Task(:config => vm_cfg, :pool => rp).wait_for_completion

data/examples/delete_disk_from_vm.rb

@@ -1,57 +0,0 @@
-#!/usr/bin/env ruby
-
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'optimist'
-require 'rbvmomi'
-require 'rbvmomi/optimist'
-
-VIM = RbVmomi::VIM
-
-opts = Optimist.options do
-  banner <<-EOS
-Delete a disk from a VM.
-
-Usage:
-    delete_disk_from_vm.rb [options] vm_name disk_unit_number
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-end
-
-Optimist.die("must specify host") unless opts[:host]
-ARGV.size == 2 or abort "must specify VM name and disk unit number"
-vm_name          = ARGV[0]
-disk_unit_number = ARGV[1].to_i
-
-vim = VIM.connect opts
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or abort "datacenter not found"
-vm = dc.find_vm(vm_name) or abort "VM not found"
-
-disk = vm.config.hardware.device.detect do |device|
-  device.kind_of?(VIM::VirtualDisk) && device.unitNumber == disk_unit_number
-end
-
-raise "Disk #{disk_unit_number} not found" if disk.nil?
-
-spec = VIM::VirtualMachineConfigSpec(
-  :deviceChange => [
-    VIM::VirtualDeviceConfigSpec(
-      :device        => disk,
-      :fileOperation => VIM.VirtualDeviceConfigSpecFileOperation(:destroy),
-      :operation     => VIM::VirtualDeviceConfigSpecOperation(:remove)
-    )
-  ]
-)
-
-vm.ReconfigVM_Task(:spec => spec).wait_for_completion

data/examples/extraConfig.rb

@@ -1,57 +0,0 @@
-# Copyright (c) 2011-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'optimist'
-require 'rbvmomi'
-require 'rbvmomi/optimist'
-
-VIM = RbVmomi::VIM
-CMDS = %w(list set)
-
-opts = Optimist.options do
-  banner <<-EOS
-View and modify VM extraConfig options.
-
-Usage:
-    extraConfig.rb [options] VM list
-    extraConfig.rb [options] VM set key=value [key=value...]
-
-Commands: #{CMDS * ' '}
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-
-  stop_on CMDS
-end
-
-vm_name = ARGV[0] or Optimist.die("no VM name given")
-cmd = ARGV[1] or Optimist.die("no command given")
-abort "invalid command" unless CMDS.member? cmd
-Optimist.die("must specify host") unless opts[:host]
-
-vim = VIM.connect opts
-
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or abort "datacenter not found"
-vm = dc.find_vm(vm_name) or abort "VM not found"
-
-case cmd
-when 'list'
-  vm.config.extraConfig.each { |x| puts "#{x.key}: #{x.value}" }
-when 'set'
-  extraConfig = ARGV[2..-1].map { |x| x.split("=", 2) }.map { |k,v| { :key => k, :value => v } }
-  vm.ReconfigVM_Task(:spec => VIM.VirtualMachineConfigSpec(:extraConfig => extraConfig)).wait_for_completion
-end

data/examples/lease_tool.rb

@@ -1,106 +0,0 @@
-#!/usr/bin/env ruby
-
-# Copyright (c) 2012-2017 VMware, Inc.  All Rights Reserved.
-# SPDX-License-Identifier: MIT
-
-require 'optimist'
-require 'rbvmomi'
-require 'rbvmomi/optimist'
-require 'rbvmomi/utils/leases'
-require 'yaml'
-
-VIM = RbVmomi::VIM
-CMDS = ['set_lease_on_leaseless_vms', 'show_expired_vms', 
-        'show_soon_expired_vms', 'kill_expired_vms']
-
-opts = Optimist.options do
-  banner <<-EOS
-Tool for managing leases on VMs where leases are stored in YAML on VM annotations.
-
-Usage:
-    lease_tool.rb [options] <cmd>
-
-Commands: #{CMDS * ' '}
-
-VIM connection options:
-    EOS
-
-    rbvmomi_connection_opts
-
-    text <<-EOS
-
-VM location options:
-    EOS
-
-    rbvmomi_datacenter_opt
-
-    text <<-EOS
-
-Other options:
-  EOS
-
-  opt :vm_folder_path, "Path to VM folder to deploy VM into", :type => :string
-  opt :force, "Really perform VMs. Used with kill_expired_vms"
-
-  stop_on CMDS
-end
-
-Optimist.die("must specify host") unless opts[:host]
-cmd = ARGV[0] or Optimist.die("no command given")
-Optimist.die("no vm folder path given") unless opts[:vm_folder_path]
-
-vim = VIM.connect opts
-dc = vim.serviceInstance.find_datacenter(opts[:datacenter]) or abort "datacenter not found"
-
-root_vm_folder = dc.vmFolder
-vm_folder = root_vm_folder.traverse(opts[:vm_folder_path], VIM::Folder)
-
-lease_tool = LeaseTool.new
-vms_props_list = (['runtime.powerState'] + lease_tool.vms_props_list).uniq
-inventory = vm_folder.inventory_flat('VirtualMachine' => vms_props_list) 
-inventory = inventory.select{|obj, props| obj.is_a?(VIM::VirtualMachine)}
-case cmd
-when 'set_lease_on_leaseless_vms'
-  lease_tool.set_lease_on_leaseless_vms(
-    inventory.keys, inventory,
-    :lease_minutes => 3 * 24 * 60 * 60 # 3 days
-  )
-when 'show_expired_vms'
-  vms = lease_tool.filter_expired_vms inventory.keys, inventory
-  vms.each do |vm, time_to_expiration|
-    puts "VM '#{inventory[vm]['name']}' is expired"
-  end  
-when 'kill_expired_vms'
-  vms = lease_tool.filter_expired_vms inventory.keys, inventory
-  vms.each do |vm, time_to_expiration|
-    puts "VM '#{inventory[vm]['name']}' is expired"
-    if !opts[:force]
-      puts "NOT killing VM '#{inventory[vm]['name']}' because --force not set"
-    else
-      puts "Killing expired VM '#{inventory[vm]['name']}'"
-      # Destroying VMs is very stressful for vCenter, and we aren't in a rush
-      # so do one VM at a time
-      if inventory[vm]['runtime.powerState'] == 'poweredOn'
-        vm.PowerOffVM_Task.wait_for_completion
-      end
-      vm.Destroy_Task.wait_for_completion
-    end
-  end  
-when 'show_soon_expired_vms'
-  vms = lease_tool.filter_expired_vms(
-    inventory.keys, inventory, 
-    :time_delta => 3.5 * 24 * 60 * 60, # 3.5 days 
-  )
-  # We could send the user emails here, but for this example, just print the
-  # VMs that will expire within the next 3.5 days
-  vms.each do |vm, time_to_expiration|
-    if time_to_expiration > 0
-      hours_to_expiration = time_to_expiration / (60.0 * 60.0) 
-      puts "VM '%s' expires in %.2fh" % [inventory[vm]['name'], hours_to_expiration]
-    else
-      puts "VM '#{inventory[vm]['name']}' is expired"
-    end
-  end  
-else
-  abort "invalid command"
-end