cloudbox-server 0.0.1

data/lib/receiver/crowbar_shell_api.rb

@@ -0,0 +1,643 @@
+# This file is part of cloudbox-server project
+# Author: mbr (INGENSI)
+# Created: 21/08/13 16:28
+
+# You are a good developer if you document this class
+
+require 'common/color'
+require 'receiver/connector'
+require 'rubygems'
+require 'common/cloudbox_exceptions'
+require 'json'
+require 'fileutils'
+require 'pathname'
+require 'net/scp'
+
+module Receiver
+  # Allows to connects to an API Crowbar by the Shell command
+  # @author mbretaud
+  class CrowbarShellAPI < Connector
+
+    public
+    # Copy the Barclamp Vcluster for create a new vcluster
+    # @param [String] src The source of the barclamp
+    # @param [String] dest The destination of the new barclamp
+    # @param [String] cluster_name The name of the vcluster
+    # @param [String] network The network address
+    # @param [String] mask The mask address
+    # @param [String] vlan_id The id of the vlan
+    # @param [String] cpu The cpu weight
+    # @param [String] ram The ram capacity
+    # @param [String] description The description of the barclamp, it role
+    # @param [String] verbose The verbose command
+    # @author mbretaud
+    def copy_barclamp(src, dest, cluster_name, network, mask, vlan_id, cpu, ram, description, verbose)
+      vcluster_mask = "vclusterMask"
+      vcluster_network = "vclusterNetwork"
+      vcluster_id_vlan = "vclusterIdvlan"
+      vcluster_name = "vclusterName"
+      vcluster_ram = "vclusterRam"
+      vcluster_cpu = "vclusterCpu"
+      vcluster_desc = "vclusterDescription"
+
+      output = ""
+
+      if verbose == "-v"
+        verbose = true
+      else
+        verbose = false
+      end
+
+      unless File.directory?(src)
+        raise Common::DirectoryNotFound.new("Source directory doesn't exists or is not accessible")
+      end
+
+
+      if File.directory?(dest)
+        raise Common::DirectoryAlreadyExist.new("Destination directory already exists." )
+      end
+
+
+      unless FileUtils.mkdir_p(dest)
+        raise Common::DirectoryCreateError.new("An error occurred while trying to create destination directory.")
+      end
+
+      src_name = Pathname.new(src).basename
+      dest_name= Pathname.new(dest).basename
+
+      if verbose
+        output += "Copying barclamp from '#{src_name}' to '#{dest_name}'.\n"
+        output += "(#{src} -> #{dest})\n"
+      end
+
+      FileUtils.cp_r src + "/.", dest
+
+      if verbose
+        output += "Directories renaming...\n"
+      end
+
+      Dir.glob("#{dest}/**/*") do |dir|
+        if File.directory? dir
+          dirname = Pathname.new(dir).basename.to_s
+          if (match = dirname.match(/(.*)(#{src_name})(.*)/))
+            # @todo maybe replace name by nil because it is never used
+            before, name, after = match.captures
+            new_dir_path = Pathname.new(dir).parent.to_s + "/" + before + dest_name + after
+            if verbose
+              output += "Moving #{dir} to #{new_dir_path}.\n"
+            end
+            FileUtils.mv dir, new_dir_path
+          end
+        end
+      end
+
+      if verbose
+        output += "File renaming...\n"
+      end
+
+      Dir.glob("#{dest}/**/*") do |file|
+        unless File.directory? file
+          filename = Pathname.new(file).basename.to_s
+          if (match = filename.match(/(.*)(#{src_name})(.*)/))
+            # @todo maybe replace name by nil because it is never used
+            before, name, after = match.captures
+            new_file_path = Pathname.new(file).parent.to_s + "/" + before + dest_name + after
+            if verbose
+              output += "Moving #{file} to #{new_file_path}.\n"
+            end
+            FileUtils.mv file, new_file_path
+            file = new_file_path
+          end
+
+          f = File.read(file)
+          if  filename == "default.rb" or filename == "bc-template-vcluster.json" or filename == "crowbar.yml"
+            content = f.gsub(/(#{vcluster_mask})/, mask.to_s)
+            content = content.gsub(/(#{vcluster_network})/, network.to_s)
+            content = content.gsub(/(#{vcluster_id_vlan})/, vlan_id.to_s)
+            content = content.gsub(/(#{vcluster_name})/, cluster_name.to_s)
+            content = content.gsub(/(#{vcluster_ram})/, ram.to_s)
+            content = content.gsub(/(#{vcluster_cpu})/, cpu.to_s)
+            content = content.gsub(/(#{vcluster_desc})/, description.to_s)
+            f = File.new(file, "w")
+            f.write(content)
+            f.close
+          end
+          f = File.read(file)
+          if f.match(/(.*)(#{src_name})(.*)/i)
+            if verbose
+              output += "Modifying file #{file}\n"
+            end
+            content = f.gsub(/(#{src_name})/, dest_name)
+            content = content.gsub(/(#{src_name.to_s.capitalize})/, dest_name.to_s.capitalize)
+            f = File.new(file, "w")
+            f.write(content)
+            f.close
+          end
+        end
+      end
+
+      if verbose
+        output += "Done\n"
+      end
+
+      return output
+    end
+
+    public
+    # Erase all data into all hard disks on the node and unmount partitions of /dev.
+    # @param node_name The name of the node
+    # @return out The output displays
+    # @author mbretaud
+    # @todo Change the way to execute the command "erase hard disk" (i.e. having a shell connector to execute shell commands to a distant node)
+    def erase_node_hard_disk(node_name)
+      @logger.info("Receiver::CrowbarShellApi   Remove the node '#{node_name}' with crowbar...")
+
+      output = ""
+      begin
+        output += upload_file("cb-lib-node-erase-hard-disk.sh", File.dirname(__FILE__) + "/../common", "/root", node_name, "root", "crowbar") + "\n"
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Uploading the file 'cb-lib-node-erase-hard-disk.sh' into the node '#{node_name}'...")
+        @logger.debug(e.message)
+        raise Common::UploadError.new("Error: Uploading the file 'cb-lib-node-erase-hard-disk.sh' into the node '#{node_name}'!")
+      end
+
+      @logger.info("Receiver::CrowbarShellApi   Uploading the file 'cb-lib-node-erase-hard-disk.sh' into the node '#{node_name}'...")
+
+      begin
+        execute_ssh("chmod 777 ~/cb-lib-node-erase-hard-disk.sh; ~/cb-lib-node-erase-hard-disk.sh", node_name, "root", "crowbar")
+        output += "Execute the file 'cb-lib-node-erase-hard-disk.sh' into the node '#{node_name}'!\n"
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the ssh command '#{command}'")
+        @logger.debug(e.message)
+        output += "Error: Execute the file 'cb-lib-node-erase-hard-disk.sh' into the node '#{node_name}' : " + e.message + "\n"
+        raise Common::SSHError.new("Error: Execute the file 'cb-lib-node-erase-hard-disk.sh' into the node '#{node_name}' : " + e.message + "")
+      end
+
+      @logger.info("Receiver::CrowbarShellApi   Changed the chmod of the file 'cb-lib-node-erase-hard-disk.sh'...")
+      @logger.info("Receiver::CrowbarShellApi   Execute the file 'cb-lib-node-erase-hard-disk.sh'...")
+
+      return output
+    end
+
+    public
+    # Erase a node in the server Crowbar
+    # @param node_name The name of the node
+    # @author mbretaud
+    def erase_node_server(node_name)
+      command = "updatedb"
+      output = ""
+      begin
+        output += execute_shell_command(command) + "\n"
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the command '#{command}'")
+        @logger.debug(e.message)
+        raise Common::EraseNodeError.new("Error: Erase the node '#{node_name}' in the server Crowbar.")
+      end
+
+      @logger.info("Receiver::CrowbarShellApi   Executing the command '#{command}'...")
+
+      command = "locate #{node_name} | grep -v \"/var/lib/ganglia/rrds/Crowbar\" | grep -v \".rrd\""
+
+      begin
+        list_files = execute_shell_command(command)
+        list_files.each { |file|
+          if File.exist?(file)
+            File.chmod(0777, file)
+            File.delete(file)
+          end
+
+          if File.directory?(file)
+            FileUtils.rm_rf(file)
+          end
+        }
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the command '#{command}'")
+        @logger.debug(e.message)
+        raise Common::EraseNodeError.new("Error: Erase the node '#{node_name}' in the server Crowbar.")
+
+      end
+
+      @logger.info("Receiver::CrowbarShellApi   Executing the command '#{command}'...")
+      @logger.info("Receiver::CrowbarShellApi   Erase the node '#{node_name}' in the server Crowbar...")
+
+      return output
+    end
+
+    public
+    # Execute a Shell command
+    # @param command The command to execute
+    # @return the return to the command
+    # @author mbretaud
+    def execute_shell_command(command)
+      @logger.info("Receiver::CrowbarShellApi   Execute the command '#{command}'.")
+      begin
+        result = `#{command}`
+        if $?.to_i > 0
+          @logger.info("Receiver::CrowbarShellApi   Error: Executing the ssh command '#{command}'")
+          @logger.error("Receiver::CrowbarShellApi   Error: Install the barclamp  to the server crowbar...")
+          raise Common::ExecuteShellError.new("Error: Execute the shell command '#{command}'")
+        end
+      rescue => e
+
+        @logger.info("Error: Executing the command '#{command}'")
+        @logger.debug(e.message)
+        raise Common::ExecuteShellError.new("Error: Executing the command '#{command}':#{e.message}")
+      end
+      return result
+    end
+
+    public
+    # Execute a SSH command
+    # @param command The command to execute
+    # @param host The ip of the host
+    # @param login The login of the host
+    # @param password the password of the host
+    # @return results The resultat of the execution of the command ssh
+    # @raise StandardError
+    # @raise TimeoutError
+    # @author mbretaud
+    def execute_ssh(command, host, login, password)
+      begin
+        results = {}
+
+        Timeout::timeout(2) do
+          begin
+            Net::SSH.start(host, login, :password => password) do |ssh|
+              results[command] = ssh.exec!(command)
+            end
+          rescue Net::SSH::HostKeyMismatch => e
+            e.remember_host!
+            retry
+          rescue StandardError => e
+            raise e
+          end
+        end
+
+        @logger.info("Receiver::CrowbarShellApi   Execute the ssh command '#{command}'.")
+        return results
+      rescue Timeout::Error => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Execute the ssh command '#{command}'.")
+        @logger.info("Receiver::CrowbarShellApi   Error: Timed out trying to get a connection.")
+        @logger.debug(e.message)
+        raise e
+      end
+    end
+
+    private
+    # Check is the variable is Json format
+    # @param data to check
+    # @author mbretaud
+    def is_json(data)
+      JSON.parse data
+      @logger.info("Receiver::CrowbarShellApi   The data is a JSON format.")
+      return true
+    rescue JSON::ParserError => e
+      @logger.info("Receiver::CrowbarShellApi   The data is not a JSON format.")
+      @logger.debug(e.message)
+      return false
+    end
+
+    public
+    # Install a node with crowbar
+    # @param node_name the name of  node
+    # @return Boolean  true is successful and false if error
+    # @author mbretaud
+    def node_install(node_name)
+      command = "crowbar_machines -U crowbar -P crowbar allocate #{node_name}"
+      begin
+        @logger.info("Receiver::CrowbarShellApi   Install the node '#{node_name}' with crowbar...")
+        return execute_shell_command(command)
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Install the node '#{node_name}' with crowbar...")
+        @logger.debug(e.message)
+        raise Common::NodeInstallError.new("Execute the shell command '#{command}'.")
+      end
+    end
+
+    public
+    # display a information of node
+    # @param node_name the name of  node
+    # @return Boolean  true is successful and false if error
+    # @author mbretaud
+    def node_info(node_name)
+      command = "crowbar_machines show #{node_name}"
+      begin
+        @logger.info("Receiver::CrowbarShellApi   Display informations of the node '#{node_name}' with crowbar...")
+        infos = execute_shell_command(command)
+        return JSON.parse(infos)
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Display informations of the node '#{node_name}' with crowbar...")
+        @logger.debug(e.message)
+        raise Common::NodeInfoError.new("Execute the shell command '#{command}'.")
+      end
+    end
+
+    public
+    # remove node of the crowbar admin
+    # @param node_name the name of node
+    # @author mbretaud
+    # @return Boolean  true is successful and false if error
+    def node_delete(node_name)
+      command = "crowbar_machines -U crowbar -P crowbar delete #{node_name}"
+      begin
+        @logger.info("Receiver::CrowbarShellApi   Remove the node '#{node_name}' with crowbar...")
+        return execute_shell_command(command)
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Remove the node '#{node_name}' with crowbar...")
+        @logger.debug(e.message)
+        raise Common::NodeDeleteError.new("Execute the shell command '#{command}'.")
+      end
+    end
+
+    public
+    # Retrieves the list of nodes according to the status.
+    # @param status The status wanted
+    # @return list_nodes_filter The list of node
+    # @author mbretaud
+    def node_list_nodes(status = nil)
+      @logger.info("Receiver::CrowbarShellApi : Retrieves the list of nodes according to the status '#{status}'.")
+      command = "crowbar_node_state -U crowbar -P crowbar status"
+      list_nodes = execute_shell_command(command)
+
+      hostname = `hostname -s`
+      cluster_name = `hostname`
+
+      if cluster_name.include? '.'
+        cluster_name = cluster_name.split('.')
+        cluster_name.delete_at(0)
+        cluster_name = ".#{cluster_name.collect { |e| e }.join('.').strip}"
+      else
+        cluster_name = ""
+      end
+
+      if is_list_empty(list_nodes)
+        @logger.info("Receiver::CrowbarShellApi   Warning: The list of nodes is empty...")
+        return nil
+      else
+        list_nodes_filter = Array.new
+
+        list_nodes.each { |node|
+          node_name = node.split(" ").at(0).strip.to_s
+          status_node = node.split.drop(1).join(' ').strip.to_s
+
+          if node_name.strip.to_s != hostname.strip.to_s
+            if status.nil?
+              node_to_display = "#{node_name}#{cluster_name} #{status_node}"
+              list_nodes_filter << node_to_display
+            else
+              if status.strip.to_s == status_node.strip.to_s
+                node_to_display = "#{node_name}#{cluster_name} #{status_node}"
+                list_nodes_filter << node_to_display
+              end
+            end
+          end
+        }
+
+        return list_nodes_filter
+      end
+    end
+
+    private
+    # Check if the list is empty or not
+    # @param list The list of elements
+    # @return true The list is empty
+    # @author mbretaud
+    def is_list_empty(list) # @wtf so useless method xD
+      if !list.nil? && list.length > 0
+        return false
+      end
+      return true
+    end
+
+    public
+    # Reinstall a node with crowbar
+    # @param node_name the name of node
+    # @return Boolean  true is successful and false if error
+    # @author mbretaud
+    def node_reinstall(node_name)
+      command = "crowbar_machines -U crowbar -P crowbar reinstall #{node_name}"
+      begin
+        @logger.info("Receiver::CrowbarShellApi   Reinstall the node '#{node_name}' with crowbar...")
+        return execute_shell_command(command)
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Reinstall the node '#{node_name}' with crowbar...")
+        @logger.debug(e.message)
+        raise Common::NodeReinstallError.new("Error: Execute the shell command '#{command}'.")
+      end
+    end
+
+    # @todo WARNING: cluster_name never used
+    public
+    # Set the list of nodes to the proposal.
+    # @param cluster_name name of cluster
+    # @param  barclamp_name name of barclamp
+    # @param node_list List of node
+    # @return Boolean true is successful and false if error
+    # @author mbretaud
+    def set_cluster_machine(cluster_name, barclamp_name, node_list)
+      @logger.info("Receiver::CrowbarShellApi   Set the list of nodes to the proposal...")
+      output = ""
+
+      begin
+        command = "crowbar #{barclamp_name} proposal show default"
+        json = execute_shell_command(command)
+        p = JSON.parse(json)
+
+        node_list.each do |node|
+          unless p['deployment'][barclamp]['elements'][role].include? node
+            p['deployment'][barclamp]['elements'][role].push(node)
+          end
+
+          json = p.to_json
+          cmd = "crowbar #{barclamp_name} proposal edit default --data '#{json}"
+          execute_shell_command(cmd)
+        end
+        output += "Set the list of nodes to the proposal...\n"
+        return output
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Set the list of nodes to the proposal...")
+        @logger.debug(e.message)
+        raise Common::SetClusterMachineError.new("Error: Execute the shell command '#{command}'.")
+      end
+    end
+
+    public
+    # reboot node with crowbar shell
+    # @param node_name the name of node
+    # @return Output of crowbar command
+    # @author mbretaud
+    def reboot_node(node_name)
+      begin
+        execute_ssh("/sbin/reboot", node_name, "root", "crowbar")
+        @logger.info("Receiver::CrowbarShellApi   Reboot the node '#{node_name}'...")
+        return "Reboot the node '#{node_name}'...\n"
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the ssh command '/sbin/reboot'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Reboot the node '#{node_name}'...")
+        @logger.debug(e.message)
+        raise Common::NodeRebootError.new("Error: Execute the shell command '#{command}'.")
+      end
+    end
+
+    # create proposal for a barclamp
+    # @param barclamp_name The name of barclamp
+    # @return boolean true is successful and false if error
+    def create_proposal(barclamp_name)
+      command = "crowbar #{barclamp_name} proposal create default" # @todo Copier coller FAIL
+      output = ""
+
+      begin
+        execute_shell_command(command)
+        @logger.info("Receiver::CrowbarShellApi   Create the proposal 'default' for the barclamp '#{barclamp_name}'...")
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Executing the ssh command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Create the proposal 'default' for the barclamp '#{barclamp_name}'...")
+        @logger.debug(e.message)
+        raise Common::CreateProposalError.new("Execute the shell command '#{command}'.")
+      end
+
+      return "Execute the shell command '#{command}'.\n"
+    end
+
+    public
+    # install a barclamp to th server crowbar
+    # @param barclamp_name the name of barclamp
+    # @return the output of crowbar's command
+    # @author mbretaud
+    def reload_service(barclamp_name)
+      barclamps_path = "/opt/dell/barclamps"
+      output = ""
+
+      command = "barclamp_install.rb #{barclamps_path}/#{barclamp_name}"
+      begin
+        execute_shell_command(command)
+        @logger.info("Receiver::CrowbarShellApi   Install the barclamp '#{barclamp_name}' to the server crowbar...")
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the ssh command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Install the barclamp '#{barclamp_name}' to the server crowbar...")
+        @logger.debug(e.message)
+        raise Common::BarclampInstallError.new("Execute the shell command '#{command}'.")
+        return output
+      end
+
+      output += "Execute the shell command '#{command}'.\n"
+
+      command = "service crowbar restart"
+      begin
+        execute_shell_command(command)
+        @logger.info("Receiver::CrowbarShellApi   Reboot the server crowbar...")
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the ssh command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Reboot the server crowbar...")
+        @logger.debug(e.message)
+        raise Common::ReloadServiceError.new("Execute the shell command '#{command}'.")
+      end
+
+      output += "Execute the shell command '#{command}'.\n"
+
+      return output
+    end
+
+    public
+    # Upload a file to a remote server
+    # @param file_name The name of the file
+    # @param file_path The path of the file
+    # @param destination_path The destination path to upload
+    # @param host The ip of the host
+    # @param login The login of the host
+    # @param password The password of the host
+    # @raise SCPError
+    # @raise TimeoutError
+    # @author mbretaud
+    def upload_file(file_name, file_path, destination_path, host, login, password)
+      begin
+        Timeout::timeout(2) do
+          # use a persistent connection to transfer files
+          Net::SCP.start(host, login, :password => password) do |scp|
+            begin
+              # upload a file to a remote server
+              scp.upload! "#{file_path}/#{file_name}", destination_path
+              @logger.info("Receiver::CrowbarShellApi   Upload the file '#{file_name}' to a remote server '#{host}'...")
+            rescue Net::SCP::Error => e
+              @logger.info("Receiver::CrowbarShellApi   Error: Upload the file '#{file_name}' to a remote server '#{host}'.")
+              @logger.debug(e.message)
+              raise e
+            end
+          end
+        end
+      rescue Timeout::Error => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Timed out trying to get a connection to upload the file '#{file_name}'.")
+        @logger.debug(e.message)
+        raise e
+      end
+      return "Upload the file '#{file_name}' to a remote server '#{host}'...\n"
+    end
+
+
+    public
+    # Get the informations about the vcluster
+    # @param vcluster_name The name of the vlcuster
+    # @param proposal_name The name of the proposal
+    # @return The informations about the vcluster
+    # @raise Error Execute the shell command
+    # @author mbretaud
+    def vcluster_info(vcluster_name, proposal_name)
+      barclamp_name = "cb#{vcluster_name}"
+      command = "crowbar #{barclamp_name} proposal show #{proposal_name}"
+      begin
+        info_vcluster = execute_shell_command(command)
+
+        if is_json(info_vcluster)
+          @logger.info("Receiver::CrowbarShellApi   Get the informations about the vcluster '#{vcluster_name}'...")
+          return JSON.parse(info_vcluster)
+        else
+          @logger.info("Receiver::CrowbarShellApi   Error: The informations are not in JSON format...")
+          @logger.info("Receiver::CrowbarShellApi   Error: Get the informations about the vcluster '#{vcluster_name}'...")
+          return nil
+        end
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the ssh command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Get the informations about the vcluster '#{vcluster_name}'...")
+        @logger.debug(e.message)
+        raise Common::ClusterInfoError.new("The vcluster '#{vcluster_name}' doesn't exists or the proposal is not created.")
+      end
+    end
+
+    public
+    # Displays a list of vclusters
+    # @param vcluster_name The name of the vlcuster
+    # @param proposal_name The name of the proposal
+    # @return info_vcluster The informations about the vcluster
+    # @raise Error Execute the shell command
+    # @author mbretaud
+    def vcluster_ls(vcluster_name, proposal_name)
+      barclamp_name = "cb#{vcluster_name}"
+      command = "crowbar #{barclamp_name} proposal show #{proposal_name}"
+      begin
+        list_vcluster = execute_shell_command(command)
+        @logger.info("Receiver::CrowbarShellApi   Get the list of vclusters...")
+        return JSON.parse(list_vcluster)
+      rescue => e
+        @logger.info("Receiver::CrowbarShellApi   Error: Executing the ssh command '#{command}'")
+        @logger.info("Receiver::CrowbarShellApi   Error: Get the list of vclusters...")
+        @logger.debug(e.message)
+        raise Common::ClusterLsError.new("The vcluster '#{vcluster_name}' doesn't exists or the proposal is not created.")
+      end
+    end
+
+    public
+    # Delete a vcluster
+    # @param vcluster_name The name of the vlcuster
+    # @return
+    # @raise
+    # @author mbretaud
+    def vcluster_delete(vcluster_name)
+      # @todo
+    end
+  end
+end