drbd 0.1.0 → 0.1.1

data/README.rdoc

@@ -10,34 +10,82 @@ Ruby wrapper for DRBD
 
 == Limitations
 
-* Just one-morning prototype
 * Best with drbd version > 8.3.7
+* Hostname used for connection must be one of hostnames in drbd.conf (FQDN ideally)
+* It'sJust one-morning's prototype, take patience
 * No tests
 * No documentation
 * Absolutely no warranty, use it at your own risk
 
+== Installation
+
+<code>gem install drbd</code>
 
-== How it works
 
+== How it works
+# simply fetch data from remote host
 d = Drbd.new("fqdn.domain.tld")
 
+# you can specify command to be executed 
+
+d = Drbd.new("fqdn.domain.tld", :command => 'sudo /sbin/drbdadm')
+
+# obtain array of configured resources
 r = d.resources.first
 
+# get resource name
 r.name
 
+# get resource protocol
+r.protocol
+
+# get hosts for resource
+r.hosts
+
+# get status for resource
+r.status
+
+# get node addresses
 r.hosts.map{|h| h.address }
 
+# get status
+# resource status is hash with keys: 
+# [:cs, :resynced_percent, :minor, :ro1, :ds1, :ro2, :ds2, :name]
 r.status
 
+# find resource by name
 r = d.find_resource_by_name("r0")
 
-r.consinstent?
-
+# find resource by backing disk
 r = d.find_resource_by_disk("/dev/volgroup-logvolume--name")
 
+# true if both of devices are UpToDate
+r.consinstent?
+
+# true if resynced_percent is present in status
 r.resync_running?
 
-r.status[:resynced_percent]
+# true if resource status is "Connected"
+r.up?
+
+# true if resource status is "Unconfigured"
+r.down?
+
+# perform drbdadm up on resource (use at your own risk!)
+r.up!
+
+# perform drbdadm down on resource (use at your own risk!)
+r.down!
+
+# perform forced drbdadm create-md on resource (use at your own risk!)
+r.init_metadata
+
+
+== TODO
+
+* Replace IO.popen("ssh ...") with native ruby net/ssh
+* Add states to actions (analyze exit status)
+* Test suite
 
 
 == Copyright

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/lib/drbd.rb

@@ -1,24 +1,29 @@
 require 'rubygems'
 require 'nokogiri'
 class DRBD
-  attr_reader :resources
+  attr_reader :resources, :host, :command
 
-  def initialize host
+  def initialize host, opts = {}
+    parse_opts opts
     @host = host
     load!
   end
 
+  def parse_opts opts
+    opts[:command].nil? ? @command = "sudo /sbin/drbdadm" : @command = opts[:command]
+  end
+
   def load!
     load_resources!
     load_status!
   end
 
   def load_resources!
-    @resources = Config.new(IO.popen("ssh #{@host} \"sudo /sbin/drbdadm dump-xml\"")).resources
+    @resources = Resource.load_config(IO.popen("ssh #{@host} \"#{@command} dump-xml\""), self)
   end
 
   def load_status!
-    raw_xml = IO.popen("ssh #{@host} \"sudo /sbin/drbdadm status\"")
+    raw_xml = IO.popen("ssh #{@host} \"#{@command} status\"")
     statuses = Status.new(raw_xml).resources
     set_resources_status statuses
   end
@@ -37,35 +42,33 @@ class DRBD
   def find_resource_by_disk disk_name
     @resources.select{|r| r.hosts.inject(false){|sum,h| (h.disk == disk_name && sum == false) ? true  : sum}}.first
   end
-
-  class Config
-    attr_reader :xml
-
-    def initialize xml
-      @xml = Nokogiri::XML(xml)
-    end
-
-    def resources
-      @xml.xpath("//config/resource").map{|r| Resource.new r }
-    end
-  end
-
+  
   class Host
-    attr_reader :name, :device, :disk, :address, :meta_disk
+    attr_reader :name, :device, :disk, :address, :meta_disk, :minor
     def initialize host
       @name = host['name']
       @device = host.xpath(".//device").text
+      @minor = host.xpath(".//device").attr("minor").value
       @disk = host.xpath(".//disk").text
       @address = host.xpath(".//address").text
+      @family = host.xpath(".//address").attr("family").value
+      @port = host.xpath(".//address").attr("port").value
       @meta_disk = host.xpath(".//meta-disk").text
     end
   end
   
   class Resource
-    attr_reader :name, :device, :disk, :address, :meta_disk, :hosts
+    attr_reader :name, :protocol,  :hosts, :drbd
     attr_accessor :status
-    def initialize nokogiri_resource
+    
+    def self.load_config raw, drbd
+      xml = Nokogiri::XML(raw)    
+      xml.xpath("//config/resource").map{|r| Resource.new r, drbd }
+    end
+    
+    def initialize nokogiri_resource, drbd
       xml = nokogiri_resource
+      @drbd = drbd
       @name = xml['name']
       @protocol = xml['protocol']
       @hosts = xml.xpath(".//host").to_a.map do |host_xml|
@@ -80,6 +83,53 @@ class DRBD
     def consistent?
       status[:ds1] == "UpToDate" && status[:ds2] == "UpToDate" && status[:resynced_percent] == nil
     end
+    
+    def up?
+      status[:cs] == "Connected" || status[:cs] == "SyncTarget"
+    end
+    
+    def down?
+      status[:cs] == "Unconfigured"
+    end 
+
+    def up!
+      args = "up #{self.name}"
+      command = "ssh #{drbd.host} \"#{drbd.command} #{args}\""
+      system(command)
+      drbd.load_status!
+    end
+    
+    def down!
+      args = "down #{self.name}"
+      command = "ssh #{drbd.host} \"#{drbd.command} #{args}\""
+      system(command)
+      drbd.load_status!
+    end
+    
+    def init_metadata!
+      if self.down?
+        #drbdmeta 0 v08 /dev/mapper/dikobraz-www--emailmaster--cz_root_meta 0 create-md 
+        command = "ssh #{drbd.host} \"sudo /sbin/drbdmeta --force #{local_minor} v08 #{local_host.meta_disk} 0 create-md\""
+        system(command)
+        return true
+      else
+        return false
+      end
+    end
+    
+    
+    def local_host
+      hosts.select{|h| h.name == drbd.host}.first
+    end
+     
+    def local_minor
+      retrurn nil if local_host == nil
+      local_host.minor
+    end
+    
+    def state
+      status[:cs]
+    end
   end
 
   class Status
@@ -105,3 +155,6 @@ class DRBD
   end
 end
 
+D = DRBD.new("dikobraz.vmin.cz")
+require 'irb'
+IRB.start

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: drbd
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: false
   segments: 
   - 0
   - 1
-  - 0
-  version: 0.1.0
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - Adam Kliment
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-17 00:00:00 +01:00
+date: 2011-01-18 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency