fog 1.20.0 → 1.21.0

data/lib/fog/xenserver/examples/creating_servers.md

@@ -17,10 +17,10 @@ using SSH. The code also assumes that you have a file storage repository mounted
 somewhere in /var/run/sr-mount/#{sr-UUID} (the standard XenServer base directory
 for mounted storage repositories).
 
-    require 'fog'                                                               
+    require 'fog'
     require 'net/scp'
     require 'uuidtools'
-    
+
     #
     # Create the connection to the XenServer host
     #
@@ -34,7 +34,7 @@ for mounted storage repositories).
 
 We'll be uploading the image to the "Local File SR" storage repository, so
 we need the reference to this SR (Storage Repository):
-  
+
     sr = xenserver.storage_repositories.find { |sr| sr.name ==  "Local File SR" }
 
 XenServer uses UUIDs to store images in the storage repositories, so we will
@@ -48,7 +48,7 @@ emulate that behavior, creating a new UUID for our image and uploading it.
 
 
 To upload the new image using SCP, we need the destination directory, where the
-SR is mounted. In our case, the storage repository mount point is 
+SR is mounted. In our case, the storage repository mount point is
 /var/run/sr-mount/#{sr.uuid} (where sr.uuid is the UUID of the storage
 repository). We will upload the new image there:
 
@@ -59,18 +59,18 @@ repository). We will upload the new image there:
     # source image, located in the current directory
     source = 'ubuntu.vhd'
     # Use the XenServer root credentials to upload
-    Net::SSH.start('xenserver-test', 'root', :password => 'secret') do |ssh|              
-      ssh.scp.upload!(source, destination) do |ch, name, sent, total|              
+    Net::SSH.start('xenserver-test', 'root', :password => 'secret') do |ssh|
+      ssh.scp.upload!(source, destination) do |ch, name, sent, total|
         # print progress
-        p = (sent.to_f * 100 / total.to_f).to_i.to_s                        
-        print "\rProgress: #{p}% completed"                     
-      end                                                                   
-    end 
+        p = (sent.to_f * 100 / total.to_f).to_i.to_s
+        print "\rProgress: #{p}% completed"
+      end
+    end
 
 We need to let the XenServer know, that there's a new image:
 
     sr.scan
- 
+
 Now that XenServer is aware of the new image, get its reference
 and set the image name attribute to 'ubuntu-template'
 
@@ -84,12 +84,12 @@ Good! the image is ready to be used.
 We have the image ready to be used by our new template.
 
 Templates are regular servers, so let's create one with 512 MB of RAM, 1 CPU
-and a network card. The main difference with a regular server from an API 
+and a network card. The main difference with a regular server from an API
 point of view is that we will not start it.
 
 We will also create the template as PV (paravirtual):
 
-    server_mem = (512 * 1024 * 1024).to_s 
+    server_mem = (512 * 1024 * 1024).to_s
     server = xenserver.servers.new :name               => "ubuntu-template",
                                    # Required when using Server.new
                                    :affinity           => xenserver.hosts.first,
@@ -99,8 +99,8 @@ We will also create the template as PV (paravirtual):
                                    :pv_args            => '-- console=hvc0', # PV related
                                    :memory_static_max  => mem,
                                    :memory_static_min  => mem,
-                                   :memory_dynamic_max => mem,                       
-                                   :memory_dynamic_min => mem 
+                                   :memory_dynamic_max => mem,
+                                   :memory_dynamic_min => mem
     server.save
 
 We need to attach the disk image to a VBD and to the server
@@ -116,14 +116,14 @@ I have a network in my XenServer named "Pool-wide network associated with eth0"
 bridged to the physical eth0 NIC and I will attach the new NIC to that network.
 
 Don't be scared by the VIF creation code. There are easier ways to create a
-VIF, and we'll be dealing with that and some other cases in the networking 
+VIF, and we'll be dealing with that and some other cases in the networking
 tutorial (TODO).
 
 First, let's find the network since we'll need the reference.
 
     net = xenserver.networks.find { |n| n.name == 'Pool-wide network associated with eth0' }
 
-To create the VM VIF, we need to set some attributes and use the 
+To create the VM VIF, we need to set some attributes and use the
 create_vif_custom request:
 
     vif_attr = {
@@ -134,11 +134,11 @@ create_vif_custom request:
       'device'            => '0',
       'MTU'               => '0',
       'other_config'      => {},
-      'qos_algorithm_type' => 'ratelimit',                                 
+      'qos_algorithm_type' => 'ratelimit',
       'qos_algorithm_params' => {}
     }
     xenserver.create_vif_custom vif_attr
-    
+
 
 The template is now ready to be used and we can list it!
 

data/lib/fog/xenserver/examples/getting_started.md

@@ -6,7 +6,7 @@ First, create a connection to the XenServer host:
 
     require 'fog'
     require 'pp'
-    
+
     #
     # http://rubydoc.info/github/fog/fog/Fog/Compute/XenServer/Real
     #
@@ -15,8 +15,8 @@ First, create a connection to the XenServer host:
       :xenserver_url => 'xenserver-test',
       :xenserver_username => 'root',
       :xenserver_password => 'changeme',
-      :xenserver_defaults => { 
-        :template => "squeeze-test" 
+      :xenserver_defaults => {
+        :template => "squeeze-test"
       }
     })
 
@@ -34,7 +34,7 @@ Having that in mind, we can start doing things with out XenServer host.
 
 Listing all the servers (VMs):
 
-    conn.servers.all 
+    conn.servers.all
 
 This will return a list of Fog::Compute::XenServer::Server.
 
@@ -42,7 +42,7 @@ List all the servers whose name matches Ubuntu:
 
     conn.servers.all :name_matches => "Ubuntu"
 
-Listing the first server running (templates aren't included by default 
+Listing the first server running (templates aren't included by default
 in the list):
 
     server = conn.servers.first
@@ -65,7 +65,7 @@ ones found in the official Citrix documentation, and they are available at:
 
 http://rubydoc.info/github/fog/fog/Fog/Compute/XenServer/Server
 
-and 
+and
 
 https://github.com/fog/fog/blob/master/lib/fog/xenserver/models/compute/server.rb
 
@@ -145,7 +145,7 @@ Same thing applies to the virtual disk images:
     conn.vdis.all
 
 Listing Storage Repositories (Xen SRs), where the disk images are stored:
-    
+
     # http://docs.vmd.citrix.com/XenServer/6.0.0/1.0/en_gb/api/?c=SR
     conn.storage_repositories
 

data/lib/fog/xenserver/examples/networks-and-vlans.rb

@@ -1,4 +1,4 @@
-require 'fog'                                                               
+require 'fog'
 
 #
 # Create the connection to the XenServer host
@@ -16,7 +16,7 @@ xenserver = Fog::Compute.new({
 # will problably have many PIFs with device == bond0
 # but we need the one without a proper VLAN ID
 #
-bondmaster_pif = xenserver.pifs.find do |pif| 
+bondmaster_pif = xenserver.pifs.find do |pif|
   pif.vlan == "-1" and pif.device == "bond0"
 end
 

data/lib/fog/xenserver/examples/storage_repositories.md

@@ -7,7 +7,7 @@ http://docs.vmd.citrix.com/XenServer/6.0.0/1.0/en_gb/api/?c=SR
 Create the XenServer connection first, as usual:
 
 ```ruby
-require 'fog'                                                               
+require 'fog'
 require 'net/scp'
 require 'pp'
 
@@ -35,7 +35,7 @@ xenserver.storage_repositories.select { |sr| sr.content_type == 'iso' }
 Filter storage repositories by allowed operations:
 
 ```ruby
-rw_srs = xenserver.storage_repositories.select do |sr| 
+rw_srs = xenserver.storage_repositories.select do |sr|
   # Are we allowed to create a VDI here?
   sr.allowed_operations.include? 'vdi_create'
 end
@@ -69,7 +69,7 @@ sr.vdis.each do |vdi|
   puts vdi.virtual_size
   puts vdi.read_only
   # ["update", "resize", "destroy", "clone", "copy", "snapshot"],
-  puts vdi.allowed_operations 
+  puts vdi.allowed_operations
 end
 ```
 

data/lib/fog/xenserver/models/compute/guest_metrics.rb

@@ -3,13 +3,13 @@ require 'fog/core/model'
 module Fog
   module Compute
     class XenServer
-    
+
       class GuestMetrics < Fog::Model
         # API Reference here:
         # http://docs.vmd.citrix.com/XenServer/6.2.0/1.0/en_gb/api/?c=VM_guest_metrics
-        
+
         identity :reference
-        
+
         attribute :uuid
         attribute :disk
         attribute :last_updated
@@ -21,9 +21,9 @@ module Fog
         attribute :other_config
         attribute :pv_drivers_up_to_date,    :aliases => :PV_drivers_up_to_date
         attribute :pv_drivers_version,       :aliases => :PV_drivers_version
-        
+
       end
-      
+
     end
   end
 end

data/lib/fog/xenserver/models/compute/host.rb

@@ -58,7 +58,7 @@ module Fog
         attribute :__host_cpus,                         :aliases => :host_CPUs
         attribute :edition
         attribute :software_version
-        
+
         def pifs
           __pifs.collect { |pif| service.pifs.get pif }
         end
@@ -92,10 +92,10 @@ module Fog
         end
 
         #
-        # Reboot the host disabling it first unless auto_disable is 
+        # Reboot the host disabling it first unless auto_disable is
         # set to false
-        # 
-        # This function can only be called if there are no currently running 
+        #
+        # This function can only be called if there are no currently running
         # VMs on the host and it is disabled. If there are running VMs, it will
         # raise an exception.
         #
@@ -107,19 +107,19 @@ module Fog
           disable if auto_disable
           service.reboot_host(reference)
         end
-        
+
         #
-        # Puts the host into a state in which no new VMs can be started. 
+        # Puts the host into a state in which no new VMs can be started.
         # Currently active VMs on the host continue to execute.
         #
         # @see http://docs.vmd.citrix.com/XenServer/6.0.0/1.0/en_gb/api/?c=host
         #
-        def disable 
+        def disable
           service.disable_host(reference)
         end
-        
+
         #
-        # Puts the host into a state in which new VMs can be started. 
+        # Puts the host into a state in which new VMs can be started.
         #
         # @see http://docs.vmd.citrix.com/XenServer/6.0.0/1.0/en_gb/api/?c=host
         #
@@ -128,10 +128,10 @@ module Fog
         end
 
         #
-        # Shutdown the host disabling it first unless auto_disable is 
+        # Shutdown the host disabling it first unless auto_disable is
         # set to false.
         #
-        # This function can only be called if there are no currently running 
+        # This function can only be called if there are no currently running
         # VMs on the host and it is disabled. If there are running VMs, it will
         # raise an exception.
         #
@@ -143,7 +143,7 @@ module Fog
           disable if auto_disable
           service.shutdown_host(reference)
         end
-        
+
         def set_attribute(name, *val)
           data = service.set_attribute( 'host', reference, name, *val )
           # Do not reload automatically for performance reasons

data/lib/fog/xenserver/models/compute/host_cpu.rb

@@ -3,16 +3,16 @@ require 'fog/core/model'
 module Fog
   module Compute
     class XenServer
-    
+
       #
       # A physical CPU
       #
       # @see http://docs.vmd.citrix.com/XenServer/6.2.0/1.0/en_gb/api/?c=host_cpu
       #
       class HostCpu < Fog::Model
-        
+
         identity :reference
-        
+
         attribute :uuid
         attribute :family
         attribute :features
@@ -30,9 +30,9 @@ module Fog
         def host
           service.hosts.get __host
         end
-        
+
       end
-      
+
     end
   end
 end

data/lib/fog/xenserver/models/compute/host_metrics.rb

@@ -3,27 +3,27 @@ require 'fog/core/model'
 module Fog
   module Compute
     class XenServer
-    
+
       class HostMetrics < Fog::Model
         # API Reference here:
         # http://docs.vmd.citrix.com/XenServer/6.2.0/1.0/en_gb/api/?c=host_metrics
-        
+
         identity :reference
-        
+
         attribute :uuid
         attribute :live
         attribute :memory_free
         attribute :memory_total
         attribute :other_config
         attribute :last_updated
-        
+
         def initialize(attributes = {})
           super
           self.last_updated = attributes[:last_updated].to_time
         end
-        
+
       end
-      
+
     end
   end
 end

data/lib/fog/xenserver/models/compute/pbd.rb

@@ -28,7 +28,7 @@ module Fog
         def host
           service.hosts.get __host
         end
-        
+
         def unplug
           service.unplug_pbd reference
         end

data/lib/fog/xenserver/models/compute/pool.rb

@@ -63,7 +63,7 @@ module Fog
         def master
           service.hosts.get __master
         end
-        
+
         def set_attribute(name, *val)
           data = service.set_attribute( 'pool', reference, name, *val )
           # Do not reload automatically for performance reasons

data/lib/fog/xenserver/models/compute/storage_repository.rb

@@ -46,12 +46,12 @@ module Fog
         def destroy
           service.destroy_sr reference
         end
-        
+
         def save
           requires :name
           requires :type
 
-          # host is not a model attribute (not in XAPI at least), 
+          # host is not a model attribute (not in XAPI at least),
           # but we need it here
           host = attributes[:host]
           raise ArgumentError.new('host is required for this operation') unless
@@ -63,7 +63,7 @@ module Fog
           # create_sr request provides sane defaults if some attributes are
           # missing
           attr = service.get_record(
-            service.create_sr( host.reference, 
+            service.create_sr( host.reference,
                                   name,
                                   type,
                                   description || '',
@@ -74,10 +74,10 @@ module Fog
                                   sm_config || {}),
             'SR'
           )
-          merge_attributes attr 
+          merge_attributes attr
           true
         end
-        
+
         def set_attribute(name, *val)
           data = service.set_attribute( 'SR', reference, name, *val )
           # Do not reload automatically for performance reasons

data/lib/fog/xenserver/models/compute/vbd_metrics.rb

@@ -3,25 +3,25 @@ require 'fog/core/model'
 module Fog
   module Compute
     class XenServer
-    
+
       class VbdMetrics < Fog::Model
         # API Reference here:
         # http://docs.vmd.citrix.com/XenServer/6.2.0/1.0/en_gb/api/?c=VBD_metrics
-        
+
         identity :reference
-        
+
         attribute :uuid
         attribute :last_updated
         attribute :other_config
         attribute :io_read_kbs
         attribute :io_write_kbs
-        
+
         def initialize(attributes = {})
           super
           self.last_updated = attributes[:last_updated].to_time
         end
       end
-      
+
     end
   end
 end