mu 5.7.2.3

data/lib/mu/command/cmd_netconfig.rb

@@ -0,0 +1,262 @@
+# Use these commands to access the legacy REST API for configuring Mu interfaces, network hosts, and routes
+require 'mu/api/netconfig'
+class Mu
+class Command
+class Cmd_netconfig < Command
+
+  attr_accessor :host, :username, :password, :api
+
+  # displays command-line help
+  def cmd_help argv
+    help
+  end
+
+  # returns a json representation of the specified element
+  #   * argv = command-line arguments, requires an element (-e) argument, such as 'interfaces', 'hosts' or 'routes' or 'interfaces/a1' or 'hosts/dell-9'
+  def cmd_get argv
+    setup argv
+    e = @hash['element']
+    response = @api.get(e)
+    msg JSON.pretty_generate(response)
+    return response
+  end
+
+  # modifies a network element
+  #   * argv = command-line arguments, requires a json configuration (-j) and the element (-e) to modify, such as 'interfaces', 'hosts' or 'routes' or 'interfaces/a1' or 'hosts/dell-9'
+  def cmd_modify argv
+    setup argv
+    json = @hash['json']
+    e = @hash['element']
+    response = @api.modify(json, e)
+    msg response
+    return response
+  end
+
+
+  # creates a new network element
+  #   * argv = command-line arguments, requires a json configuration (-j) and the element (-e) to modify, such as 'interfaces', 'hosts' or 'routes'
+  def cmd_create argv
+    setup argv
+    json = @hash['json']
+    e = @hash['element']
+    response = @api.create(json, e)
+    msg response
+    return response
+  end
+
+  # deletes an existing network element
+  #   * argv = command-line arguments, requires a json configuration (-j) and the element (-e) to modify, such as 'interfaces', 'hosts' or 'routes' or 'interfaces/a1' or 'hosts/dell-9'
+  def cmd_delete argv
+    setup argv
+    e = @hash['element']
+    response = @api.delete(e)
+    msg response
+    return response
+  end
+
+  # restores the network configuration from a file
+  #   * argv = command-line arguments, requires a path to a json configuration file (-f) , and a boolean (-b true|false) argument indicating whether or not existing elements should be cleared
+  def cmd_restore argv
+    setup argv
+    filepath = @hash['filepath']
+    clear_existing = to_boolean(@hash['boolean'])
+    response = @api.restore(filepath, clear_existing)
+    msg response
+    return response
+  end
+
+  # clears existing network configuration hosts
+  #   * argv = command-line arguments 
+  def cmd_clear_hosts argv
+    setup argv
+    response = @api.clear_hosts
+    msg JSON.pretty_generate(response)
+    return response
+  end
+
+  # resolves network configuration hosts
+  #   * argv = command-line arguments, requires the name (-n) of the host to resolve (determines its ip address and adds it to the network configuration)
+  def cmd_resolve_hosts argv
+    setup argv
+    name = @hash['name']
+    response = @api.resolve_hosts(name)
+     msg response
+    return response
+  end
+
+  # clears existing network interfaces
+  #   * argv = command-line arguments, require the names of the interfaces to clear (-i name)
+  def cmd_clear_interface argv
+    setup argv
+    interface = @hash['interfaces']
+    response = @api.clear_interface(interface)
+    msg response
+    return response
+  end
+
+  # clears existing vlan configurations
+  #  * argv = command-line arguments 
+  def cmd_clear_vlans argv
+    setup argv
+    response = @api.clear_vlans
+    msg response
+    return response
+  end
+
+  # clears existing network routes
+  #   * argv = command-line arguments 
+  def cmd_clear_routes argv
+    setup argv
+    response = @api.clear_routes
+    msg response
+    return response
+  end
+
+
+  # saves the network configuration to a file
+  #   * argv = command-line arguments, requires the element (-e element, such as 'interfaces', or -e all) to save, and a file name (-f) to save the settings to
+  def cmd_save argv
+    setup argv
+    e = @hash['elements']
+    filepath = @hash['filepath'] || "config.json"
+    response = @api.save(e, filepath)
+    msg response
+    return response
+  end
+
+private
+
+  def setup argv
+    parse_cli argv
+    @host = (@@mu_ip.nil?) ? "127.0.0.1" : @@mu_ip
+    @username  = (@@mu_admin_user.nil?) ? "admin" : @@mu_admin_user
+    @password  = (@@mu_admin_pass.nil?) ? "admin" : @@mu_admin_pass
+    @response = nil
+    @element = "" # sticky variable will hold a default element, the last element specified
+    @api = Netconfig.new(@host, @username, @password)
+    msg "Created Netconfig API object to :#{@host}", Logger::DEBUG
+  end
+  
+  def parse_cli argv
+      args = Array.new
+      @hash = {}
+      while not argv.empty?
+          args << argv.shift if argv.first[0,1] != '-' 
+
+          k = argv.shift
+
+          if [ '-b', '--boolean' ].member? k
+            @hash['boolean'] = shift(k, argv)
+            next
+          end
+
+          if [ '-e', '--element' ].member? k
+            @hash['element'] = shift(k, argv)
+            next
+          end
+
+          if [ '-f', '--filepath' ].member? k
+            @hash['filepath'] = shift(k, argv)
+            next
+          end
+
+          if [ '-h', '--help' ].member? k
+            help
+            exit
+          end
+
+          if [ '-i', '--interfaces' ].member? k
+            @hash['interfaces'] = shift(k, argv)
+            next
+          end
+
+          if [ '-j', '--json' ].member? k
+            @hash['json'] = shift(k, argv)
+            next
+          end
+
+          if [ '-m', '--mu_string' ].member? k
+             mu_string = shift(k, argv)
+             if mu_string =~ /(.+?):(.+?)@(.*)/
+               @@mu_admin_user = $1
+               @@mu_admin_pass = $2
+               @@mu_ip = $3
+             end
+             next
+          end
+
+          if [ '-n', '--name' ].member? k
+            @hash['name'] = shift(k, argv)
+            next
+          end
+
+          if [ '-o', '--output' ].member? k
+            $stdout.reopen(shift(k, argv), "w")
+            next
+          end
+
+          if [ '-r', '--routes' ].member? k
+            @hash['routes'] = shift(k, argv)
+            next
+          end
+
+          if [ '-v', '--verbose' ].member? k
+            $log.level = Logger::DEBUG
+            next
+          end
+      end
+
+      args
+  end
+
+  def help
+        helps = [
+            { :short => '-b', :long => '--boolean', :value => '<string>', :help => 'boolean arg' },
+            { :short => '-e', :long => '--element', :value => '<string>', :help => 'http string' },
+            { :short => '-f', :long => '--filepath', :value => '<string>', :help => 'filepath' },
+            { :short => '-h', :long => '--help', :value => '', :help => 'help on command line options' },
+            { :short => '-i', :long => '--interfaces', :value => '<string>', :help => 'interfaces/hosts' },
+            { :short => '-j', :long => '--json', :value => '<string>', :help => 'json object' },
+            { :short => '-m', :long => '--mu_string', :value => '<string>', :help => 'user, password, mu_ip in the form of admin:admin@10.9.8.7' },
+            { :short => '-n', :long => '--name', :value => '<string>', :help => 'host name' },
+            { :short => '-o', :long => '--output', :value => '<string>', :help => 'output logging to this file' },
+            { :short => '-v', :long => '--verbose', :value => '', :help => 'set Logger::DEBUG level' }
+        ]
+
+        cmds = [
+           "mu cmd_netconfig:clear_hosts",
+           "mu cmd_netconfig:clear_interfaces -i <interfaces>",
+           "mu cmd_netconfig:clear_routes",
+           "mu cmd_netconfig:clear_vlans",
+           "mu cmd_netconfig:create -j <json> -e <element>",
+           "mu cmd_netconfig:delete -e <element>",
+           "mu cmd_netconfig:get -e <element>",
+           "mu cmd_netconfig:help",
+           "mu cmd_netconfig:modify -j <json> -e <element>",
+           "mu cmd_netconfig:resolve_hosts -n <name>",
+           "mu cmd_netconfig:restore -f <filepath> [-b <clear_existing>]",
+           "mu cmd_netconfig:save -e <element> -f <filepath>",
+        ]
+
+        max_long_size = helps.inject(0) { |memo, obj| [ obj[:long].size, memo ].max }
+        max_value_size = helps.inject(0) { |memo, obj| [ obj[:value].size, memo ].max }
+        puts
+        puts "Usage: mu cmd_netconfig <options>"
+        puts
+        helps.each do |h|
+            puts "%-*s %*s %-*s %s" % [max_long_size, h[:long], 2, h[:short], max_value_size, h[:value], h[:help]]
+        end
+        puts
+        puts "Available Commands"
+        puts
+        cmds.each do | c |
+           puts c
+        end
+        puts
+    end
+
+end
+end # Command
+end # Mu
+
+

data/lib/mu/command/cmd_runscale.rb

@@ -0,0 +1,533 @@
+# Runs Mu Studio scenario msl files in Studio Scale, requiring that all interfaces and
+# hosts used in the scenario are specified on the command-line through the –i option.
+# Runs either a single msl file or a directory of msl files, and has command-line options
+# to specify the Mu parameters, the interfaces to use, and the pattern in which to run
+require 'mu/api/scale'
+class Mu
+class Command
+class Cmd_runscale < Command
+
+  attr_accessor :api, :params, :hosts, :addr_indexes, :offset_indexes
+
+  # displays command-line help
+  #  * argv = command-line arguments
+  def cmd_help argv
+     help
+  end
+
+  # sets up, executes, and closes a Studio Scale test
+  #   * argv = command-line arguments , requires a scenario (-s) argument
+  def cmd_run_file argv
+    setup argv
+
+    if not @hash['scenario']
+      msg "scenario required"
+      return help
+    else
+      if @hash['scenario'].include?(".msl")
+         scenario = @hash['scenario']
+      else # TODO: eventually, xml and mus file may be supported by scale api
+        msg "only .msl files are currently supported"
+        return help
+      end
+    end
+
+    if not @hash['dir']
+      @dir = ""
+      path = scenario
+    else
+      @dir = @hash['dir']
+      path = @dir + "/" + scenario
+    end
+
+    if !File.exists?(path)
+      raise "*** Error: File #{path} does not exist"
+    end
+
+    @api = Scale.new(@@mu_ip, @@mu_admin_user, @@mu_admin_pass)
+    @api.configure("pattern", @cmd_line_pattern)
+    @params = {}
+    @params["dir"] = @dir
+    @params["msl"] = scenario
+    @params["hosts"] = @cmd_line_hosts
+    run(scenario)
+    @api.release
+  end
+
+  # sets up, executes, and closes a Studio Scale test for each scenario (.msl file) found in the specified directory
+  #   * argv = command-line arguments, requires a directory (-d) argument
+  #   * optional -r argument for recursive directory search (default is a flat directory)
+  def cmd_run_dir argv
+    setup argv
+
+    if not @hash['dir']
+      return help
+    else
+      @dir = @hash['dir']
+    end
+
+    File.delete("app_id_status.json") if File.exists?("app_id_status.json")
+    File.delete("app_id_stats.csv") if File.exists?("app_id_stats.csv")
+
+    @api = Scale.new(@@mu_ip, @@mu_admin_user, @@mu_admin_pass)
+    @api.configure("pattern", @cmd_line_pattern)
+    @params = {}
+    @params["dir"] = @dir
+    @params["hosts"] = @cmd_line_hosts
+    Dir.chdir(@params["dir"])
+    File.delete("app_id_status.json") if File.exists?("app_id_status.json")
+    if @hash['recursive'].nil?
+      files = Dir.glob("*.msl")
+    else
+      files = Dir.glob("**/*.msl")
+    end
+    if !files.empty?
+       files.sort.each do | f |
+         run(f)
+         output_csv(f)
+         sleep 2
+       end
+     else
+       msg "no msl files found in #{@dir}"
+     end
+     @api.release
+ end
+
+private
+
+ def setup argv
+    parse_cli argv
+    @params = {}
+
+    if @hash['test']
+      @verify_only = true
+    else
+      @verify_only = false
+    end
+
+    if not @hash['testset']
+      @testset = ""
+    else
+      @testset = @hash['testset']
+    end
+
+    if not @hash['pattern']
+      @cmd_line_pattern = "{ \"iterations\": 1, \"intervals\": [ {\"iterations\":1, \"end\":100, \"start\":1, \"duration\":20 } ] }"
+    else
+      @cmd_line_pattern = @hash['pattern']
+    end
+
+    if not @hash['interfaces']
+      @cmd_line_hosts = "b1,b2"
+    else
+      @cmd_line_hosts = @hash['interfaces']
+    end
+
+  end
+
+ def run(scenario)
+    # assume the scenario and testset files are in dir unless they contain '/'
+    # in which case they are assumed to be absolute paths
+    if scenario.include?("/")
+      musl_file = scenario
+    else
+      musl_file = @params["dir"] + "/" + scenario
+    end
+    # msg musl_file, Logger::DEBUG
+    @api.configure("musl", File.read(musl_file))
+
+    unless @testset.empty?
+      if @testset.include?("/")
+        csv_file = @testset
+      else
+        csv_file = @params["dir"] + "/" + @testset
+      end
+      @api.configure("csv", File.read(csv_file))
+    end
+
+    File.delete("app_id_status.json") if File.exists?("app_id_status.json")
+    File.delete("app_id_stats.csv") if File.exists?("app_id_stats.csv")
+
+    configure_hosts
+
+    msg "verifying #{scenario} ..."
+    response = @api.verify
+    msg response, Logger::DEBUG
+    # sleep 3
+    v = parse_verify_response(response)
+    msg "#{v}", Logger::DEBUG
+    if v.nil?
+      msg "error in verify"
+      return
+    end
+    if @verify_only
+      msg v
+      return
+    end
+    msg "starting #{scenario} ..."
+    @api.start
+    start_time = Time.now.to_i
+    while true
+      sleep 5
+      status = @api.status
+      if !status.nil?
+        if !status["status"].nil?
+          if status["status"]["running"] == false
+            msg "running = #{status["status"]["running"]}", Logger::DEBUG
+            r = parse_status(status)
+            dump_status(status, musl_file)
+            return
+          else
+            r = parse_status(status)
+          end
+        else # status['status'].nil? ... no bonafide status was returned
+          time_now = Time.now.to_i
+          if time_now - start_time > 20
+             # puts "\nError: timing out after 20 seconds. Test had failed to start or verify"
+             break
+          end
+        end
+      end
+    end
+  ensure
+    msg "stopping #{scenario} ..."
+  end
+
+  def cmd_running?
+    if @api.nil?
+      msg "false"
+      return
+    end
+    
+    status = @api.status
+    if !status.nil?
+      if !status["status"].nil?
+        msg status["status"]["running"]
+      end
+    else
+      msg "false"
+    end
+  end           
+
+  def configure_hosts
+    @hosts = Array.new
+    @addr_indexes = Array.new
+    @offset_indexes = Array.new
+    hosts = @params["hosts"]
+    if !hosts.nil?
+      p = hosts.split(",")
+      p.each do | h |
+        if h.include?("-")  # b1-1000,b2-1 to indicate addr_count
+          q = h.split("-")
+          @hosts << q[0]
+          if q[1].include?(":") # -1000:20 to indicate offset within range
+            r = q[1].split(":")
+            @addr_indexes << r[0]
+            @offset_indexes << r[1]
+          else
+            @addr_indexes << q[1]
+            @offset_indexes << 1
+          end
+        else # default to the 1st addr index
+          @hosts << h
+          @addr_indexes << 1
+          @offset_indexes << 1
+        end
+      end
+    else
+      @hosts = ['b1','b2']
+      @addr_indexes = [1,1]
+      @offset_indexes = [1,1]
+    end
+
+    set_hosts_byname(@hosts, @addr_indexes, @offset_indexes)
+  end
+
+  def set_hosts_byname(hosts=@hosts, count=[1,1], offset=[1,1], v4=true)
+    new_hosts = Array.new
+    str = ""
+    hosts.each_with_index do |n, i|
+      if n.match(/^[ab][1-4]$/) or n.include?(".")  # possible vlan
+        if count[i] == 1 or count[i].nil?
+           str = "#{n}/*"
+        else
+           str = "#{n}/*,#{count[i]},#{offset[i]}"
+        end
+        msg "using host #{str}", Logger::DEBUG
+      else
+        @net = Netconfig.new
+        @net.setup(@hosts, @username, @password)
+        if v4
+          addr = @net.get("hosts/#{n}")['v4_addr']
+        else
+          addr = @net.get("hosts/#{n}")['v6_addr']
+        end
+        str = "#{addr}"
+        msg "using host #{str}", Logger::DEBUG
+      end
+      new_hosts << str
+    end
+    set_hosts(new_hosts)
+  end
+
+  # expects full strings: e.g. b1/12.89.0.1 ...
+  def set_hosts(hosts=["b1","b2"])
+    host_params = {}
+
+    # assign hosts to consecutive string keys, host_0, host_1, etc ...
+    hosts.each_with_index do | h, i |
+      host_params["host_#{i}"] = hosts[i]
+    end
+ 
+    # convert keys to symbols
+    # host_params.each_key { |k| host_params[k.to_sym] = host_params[k] }
+    new_host_params = {}
+    host_params.each_key { |k| new_host_params[k.to_sym] = host_params[k] }
+
+=begin
+    # add default host, set to host_1 if it exists, unless specified on the command-line
+    if @hash['default_host'].nil?
+      new_host_params[:default_host] = new_host_params[:host_1] unless new_host_params[:host_1].nil?
+    else
+      new_host_params[:default_host] = @hash['default_host'] if !@hash['default_host'].nil?
+    end
+=end
+    
+    @api.configure("hosts", new_host_params)
+
+  end
+
+  def dump_status(status, msl)
+    filename = "app_id_status.json"
+    f = File.open(filename, "a")
+    status["filename"] = msl
+    str = JSON.pretty_generate(status)
+    f.write(",") if !File.zero?(f) # if appending, we need to insert a comma
+    f.write(str)
+    f.close
+  end
+
+  def output_csv(msl_file)
+    filename = "app_id_stats.csv"
+    f = File.open(filename, "a")
+    doc = "#{msl_file},#{@executed},#{@errors.to_i},#{@timeouts.to_i},#{@client_tx_bytes},#{@client_tx_msgs},#{@client_rx_bytes},#{@client_rx_msgs},#{@server_tx_bytes},#{@server_tx_msgs},#{@server_rx_bytes},#{@server_rx_msgs}\n"
+    File.open(filename, 'a') {|f| f.write(doc) }
+  end
+
+  def parse_verify_response(response)
+    if response.nil? # || response.empty?
+      msg "*** error = no response received from /verify ***\n\n"
+      return nil
+    end
+    begin
+      msg JSON.pretty_generate(response), Logger::DEBUG
+      if !response["status"].nil?
+        if response["status"]["error"] == true
+          @error = response["status"]["error"]
+          @reason = response["status"]["reason"]
+          dump_status(response)
+          msg "*** Error = #{@error}, reason = #{@reason} ***\n\n"
+          return nil
+        end
+      end
+      msg "*** verify: okay ***", Logger::DEBUG
+      return "*** verify: okay ***"
+     rescue => e
+      msg e, Logger::DEBUG
+      return nil
+    end
+  end
+
+  def parse_status(status)
+    return nil if status.nil?
+    @reported_volume = 0
+    if !status["status"]["error"].nil?
+      if status["status"]["error"] == true
+        @error = status["status"]["error"]
+        @reason = status["status"]["reason"]
+        msg "*** Error = #{@error}, reason = #{@reason} ***\n\n"
+        return nil
+      end
+    end
+
+    @stats_summary = status["status"]["statistics"]["summary"]
+    @duration = @stats_summary["duration"]
+    @instances = @stats_summary["instances"]
+    @total_instances = @instances["total"]
+    @executed = @instances["executed"]
+    @timeouts = @instances["timeouts"]
+    @errors = @instances["errors"]
+    @asserts_failed = @stats_summary["asserts"]["failed"]
+    @server = @stats_summary["server"]
+    @server_tx_bytes = @server["tx"]["bytes"]
+    @server_tx_msgs = @server["tx"]["msgs"]
+    @server_rx_bytes = @server["rx"]["bytes"]
+    @server_rx_msgs = @server["rx"]["msgs"]
+    @client = @stats_summary["client"]
+    @client_tx_bytes = @client["tx"]["bytes"]
+    @client_tx_msgs = @client["tx"]["msgs"]
+    @client_rx_bytes = @client["rx"]["bytes"]
+    @client_rx_msgs = @client["rx"]["msgs"]
+    @scenarios = status["status"]["statistics"]["scenarios"]
+    @scenarios.each do | scenario |
+      @reported_volume = @reported_volume + scenario["volume"]
+    end
+
+    msg ""
+    msg "duration:           #{format_float(2, @duration)}"
+    msg "concurrency:        #{@reported_volume}"
+    msg "tests/sec:          #{format_float(2, @executed.to_f / @duration)}" if @duration.to_i > 0
+    msg "passed:             #{@executed}"
+    msg "errors:             #{@errors}"
+    msg "timeouts:           #{@timeouts}"
+    msg "client tx bytes/sec #{format_float(2, @client_tx_bytes.to_f / @duration)}" if @duration.to_i > 0
+    msg "client tx msgs/sec  #{format_float(2, @client_tx_msgs.to_f / @duration)}" if @duration.to_i > 0
+    msg "client rx bytes/sec #{format_float(2, @client_rx_bytes.to_f / @duration)}" if @duration.to_i > 0
+    msg "client rx msgs/sec  #{format_float(2, @client_rx_msgs.to_f / @duration)}" if @duration.to_i > 0
+    msg "server tx bytes/sec #{format_float(2, @server_tx_bytes.to_f / @duration)}" if @duration.to_i > 0
+    msg "server tx msgs/sec  #{format_float(2, @server_tx_msgs.to_f / @duration)}" if @duration.to_i > 0
+    msg "server rx bytes/sec #{format_float(2, @server_rx_bytes.to_f / @duration)}" if @duration.to_i > 0
+    msg "server rx msgs/sec  #{format_float(2, @server_rx_msgs.to_f / @duration)}" if @duration.to_i > 0
+    msg ""
+  end
+
+  def parse_cli argv
+      @hash = Hash.new
+      while not argv.empty?
+          break if argv.first[0,1] != '-'
+
+          k = argv.shift
+
+          if [ '-c', '--csv' ].member? k
+              @hash['testset'] = shift(k, argv)
+              next
+          end
+
+          if [ '-d', '--dir' ].member? k
+              @hash['dir'] = shift(k, argv)
+              next
+          end
+
+          if [ '-f', '--default_host' ].member? k
+              @hash['default_host'] = shift(k, argv)
+              next
+          end
+
+          if [ '-i', '--interfaces' ].member? k
+              @hash['interfaces'] = shift(k, argv)
+              next
+          end
+
+          if [ '-h', '--help' ].member? k
+              help
+              exit
+          end
+
+          if [ '-m', '--mu_string' ].member? k
+             mu_string = shift(k, argv)
+             if mu_string =~ /(.+?):(.+?)@(.*)/
+               @@mu_admin_user = $1
+               @@mu_admin_pass = $2
+               @@mu_ip = $3
+             end
+             next
+          end
+
+          if [ '-o', '--output' ].member? k
+            $stdout.reopen(shift(k, argv), "w")
+            next
+          end
+
+          if [ '-p', '--pattern' ].member? k
+            patterns = Array.new
+            pattern_string = shift(k, argv)
+            pstrings = pattern_string.split(",")
+            pstrings.each do | p |
+              if p =~ /(.+?)-(.+?):(.*)/ # e.g. 1-10000:60
+                start_vol = $1
+                end_vol = $2
+                duration = $3
+                patterns << "{\"iterations\":1, \"end\":#{end_vol}, \"start\":#{start_vol}, \"duration\":#{duration} }"
+              end
+            end
+            ps = "{ \"iterations\": 1, \"intervals\": ["
+            patterns.each do | p |
+              ps = ps + p + ","
+            end
+            ps = ps[0..ps.length-2] # remove final comma
+            ps = ps + "] }"
+            @hash['pattern'] = ps
+            next
+          end
+
+          if [ '-r', '--recursive'].member? k
+            @hash['recursive'] = true
+            next
+          end
+
+
+          if [ '-s', '--scenario' ].member? k
+              @hash['scenario'] = shift(k, argv)
+              next
+          end
+
+          if [ '-t', '--test' ].member? k
+              @hash['test'] = true
+              next
+          end
+          
+          if [ '-v', '--verbose' ].member? k
+            $log.level = Logger::DEBUG
+            next
+          end
+
+          raise ArgumentError, "Unknown option #{k}"
+      end
+
+      @hash
+  end
+
+  def help
+        helps = [
+            { :short => '-c', :long => '--csv', :value => '<string>', :help => 'name of the csv testset to run' },
+            { :short => '-d', :long => '--dir', :value => '<string>', :help => 'directory containing the scenario file' },
+            { :short => '-f', :long => '--default_host', :value => '<string>', :help => 'default_host setting' },
+            { :short => '-h', :long => '--help', :value => '', :help => 'help on command line options' },
+            { :short => '-i', :long => '--interfaces', :value => '<string>', :help => 'comma-separated list of interfaces, e.g. b1,b2 or b1-1000,b2 for ip range' },
+            { :short => '-m', :long => '--mu_string', :value => '<string>', :help => 'user, password, mu_ip in the form of admin:admin@10.9.8.7' },
+            { :short => '-o', :long => '--output', :value => '<string>', :help => 'output logging to this file' },
+            { :short => '-p', :long => '--pattern', :value => '<string>', :help => 'pattern in the form of comma-separated concurrency_start-end:duration patterns, e.g. 1-100:60,100-100:60,100-1:60' },
+            { :short => '-r', :long => '--recursive', :value => '', :help => 'for run_dir, recurse through sub-directories' },
+            { :short => '-s', :long => '--scenario', :value => '<string>', :help => 'scenario file to run' },
+            { :short => '-t', :long => '--test', :value => '', :help => 'do verify only' },
+            { :short => '-v', :long => '--verbose', :value => '', :help => 'set Logger::DEBUG level' }
+        ]
+
+        cmds = [
+           "mu cmd_runscale:help",
+           "mu cmd_runscale:run_file -s <scenario>  -i <hosts, e.g. a1,dell-9> -p <pattern, e.g. 1-1000:30>",
+           "mu cmd_runscale:run_dir -d <scenario_directory>",
+           "mu cmd_runscale:running?"
+        ]
+
+        max_long_size = helps.inject(0) { |memo, obj| [ obj[:long].size, memo ].max }
+        max_value_size = helps.inject(0) { |memo, obj| [ obj[:value].size, memo ].max }
+        puts
+        puts "Usage: mu cmd_runscale:<command> <options>"
+        puts
+        helps.each do |h|
+            puts "%-*s %*s %-*s %s" % [max_long_size, h[:long], 2, h[:short], max_value_size, h[:value], h[:help]]
+        end
+        puts
+        puts "Available Commands"
+        puts
+        cmds.each do | c |
+           puts c
+        end
+        puts
+    end
+
+end
+end # Command
+end # Mu
+