morpheus-cli 3.6.31 → 3.6.32

data/lib/morpheus/cli/key_pairs.rb

@@ -94,10 +94,10 @@ class Morpheus::Cli::KeyPairs
 
       @key_pairs_interface.setopts(options)
       if options[:dry_run]
-        if val.to_s =~ /\A\d{1,}\Z/
-          print_dry_run @key_pairs_interface.dry.get(account_id, id.to_i)
+        if args[0].to_s =~ /\A\d{1,}\Z/
+          print_dry_run @key_pairs_interface.dry.get(account_id, args[0])
         else
-          print_dry_run @key_pairs_interface.dry.list(account_id, {name: name.to_s})
+          print_dry_run @key_pairs_interface.dry.list(account_id, {name: args[0]})
         end
         return 0
       end

data/lib/morpheus/cli/library_container_types_command.rb

@@ -380,6 +380,10 @@ class Morpheus::Cli::LibraryContainerTypesCommand
         end
 
       end
+      # avoid API bug in 3.6.3
+      if payload['containerType']
+        payload['containerType']['config'] ||= {}
+      end
       @library_container_types_interface.setopts(options)
       if options[:dry_run]
         print_dry_run @library_container_types_interface.dry.create(layout_id, payload)
@@ -445,14 +449,16 @@ class Morpheus::Cli::LibraryContainerTypesCommand
         return 1
       end
       # construct payload
+      passed_options = options[:options] ? options[:options].reject {|k,v| k.is_a?(Symbol) } : {}
       payload = nil
       if options[:payload]
         payload = options[:payload]
+        payload.deep_merge!({'containerType' => passed_options}) unless passed_options.empty?
       else
-        payload = {}
+        payload = {'containerType' =>  {} }
         # option_types = update_layout_option_types(instance_type)
         # params = Morpheus::Cli::OptionTypes.prompt(option_types, options[:options], @api_client, options[:params])
-        payload.deep_merge!(options[:options].reject {|k,v| k.is_a?(Symbol) }) if options[:options]
+        payload.deep_merge!({'containerType' => passed_options}) unless passed_options.empty?
         
         # ENVIRONMENT VARIABLES
         if evars
@@ -475,9 +481,8 @@ class Morpheus::Cli::LibraryContainerTypesCommand
           # prompt
         end
 
-        if params.empty?
-          puts optparse
-          exit 1
+        if params.empty? && passed_options.empty?
+          raise_command_error "Specify at least one option to update.\n#{optparse}"
         end
 
         # payload = {'containerType' => params}

data/lib/morpheus/cli/mixins/provisioning_helper.rb

@@ -293,6 +293,7 @@ module Morpheus::Cli::ProvisioningHelper
       arbitrary_options.delete('layout')
       arbitrary_options.delete('servicePlan')
       arbitrary_options.delete('description')
+      arbitrary_options.delete('environment')
       arbitrary_options.delete('instanceContext')
       arbitrary_options.delete('tags')
       payload.deep_merge!(arbitrary_options)
@@ -306,7 +307,12 @@ module Morpheus::Cli::ProvisioningHelper
     payload['instance']['description'] = v_prompt['description'] if !v_prompt['description'].empty?
 
     # Environment
-    v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'instanceContext', 'fieldLabel' => 'Environment', 'type' => 'select', 'required' => false, 'selectOptions' => instance_context_options()}], options[:options])
+    if options[:environment]
+      options[:options]['environment'] = options[:environment]
+    elsif options[:options]['instanceContext'] && !options[:options]['environment']
+      options[:options]['environment'] = options[:options]['instanceContext']
+    end
+    v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'environment', 'fieldLabel' => 'Environment', 'type' => 'select', 'required' => false, 'selectOptions' => get_available_environments()}], options[:options])
     payload['instance']['instanceContext'] = v_prompt['instanceContext'] if !v_prompt['instanceContext'].empty?
 
     # Tags
@@ -384,7 +390,7 @@ module Morpheus::Cli::ProvisioningHelper
     # prompt for resource pool
     has_zone_pools = layout["provisionType"] && layout["provisionType"]["id"] && layout["provisionType"]["hasZonePools"]
     if has_zone_pools
-      resource_pool_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'config', 'fieldName' => 'resourcePoolId', 'type' => 'select', 'fieldLabel' => 'Resource Pool', 'optionSource' => 'zonePools', 'required' => true, 'skipSingleOption' => true, 'description' => 'Select resource pool.'}],options[:options],api_client,{groupId: group_id, zoneId: cloud_id, cloudId: cloud_id, instanceTypeId: instance_type['id'], planId: service_plan["id"]})
+      resource_pool_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'config', 'fieldName' => 'resourcePoolId', 'type' => 'select', 'fieldLabel' => 'Resource Pool', 'optionSource' => 'zonePools', 'required' => true, 'skipSingleOption' => true, 'description' => 'Select resource pool.'}],options[:options],api_client,{groupId: group_id, siteId: group_id, zoneId: cloud_id, cloudId: cloud_id, instanceTypeId: instance_type['id'], planId: service_plan["id"], layoutId: layout["id"]})
       if resource_pool_prompt['config'] && resource_pool_prompt['config']['resourcePoolId']
         payload['config'] ||= {}
         payload['config']['resourcePoolId'] = resource_pool_prompt['config']['resourcePoolId']
@@ -1185,7 +1191,26 @@ module Morpheus::Cli::ProvisioningHelper
     }
   end
 
-  def instance_context_options
+  def get_available_environments(refresh=false)
+    if !@available_environments || refresh
+      begin
+        option_results = options_interface.options_for_source('environments',{})
+        @available_environments = option_results['data'].collect {|it|
+          {"code" => (it["code"] || it["value"]), "name" => it["name"], "value" => it["value"]}
+        }
+      rescue RestClient::Exception => e
+        # if e.response && e.response.code == 404
+          Morpheus::Logging::DarkPrinter.puts "Unable to determine available environments, using default options" if Morpheus::Logging.debug?
+          @available_environments = get_static_environments()
+        # else
+        #   raise e
+        # end
+      end
+    end
+    return @available_environments
+  end
+
+  def get_static_environments
     [{'name' => 'Dev', 'value' => 'dev'}, {'name' => 'Test', 'value' => 'qa'}, {'name' => 'Staging', 'value' => 'staging'}, {'name' => 'Production', 'value' => 'production'}]
   end
 

data/lib/morpheus/cli/networks_command.rb

@@ -36,6 +36,9 @@ class Morpheus::Cli::NetworksCommand
     params = {}
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage()
+      opts.on( '-c', '--cloud CLOUD', "Cloud" ) do |val|
+        options[:cloud] = val
+      end
       opts.on('--cidr VALUE', String, "Filter by cidr, matches beginning of value.") do |val|
         params['cidr'] = val
       end
@@ -46,6 +49,12 @@ class Morpheus::Cli::NetworksCommand
     connect(options)
     begin
       params.merge!(parse_list_options(options))
+      cloud = nil
+      if options[:cloud]
+        cloud = find_cloud_by_name_or_id(options[:cloud])
+        return 1 if cloud.nil?
+        params['zoneId'] = cloud['id']
+      end
       @networks_interface.setopts(options)
       if options[:dry_run]
         print_dry_run @networks_interface.dry.list(params)
@@ -65,6 +74,9 @@ class Morpheus::Cli::NetworksCommand
       end
       title = "Morpheus Networks"
       subtitles = []
+      if cloud
+        subtitles << "Cloud: #{cloud['id']}"
+      end
       subtitles += parse_list_subtitles(options)
       print_h1 title, subtitles
       if networks.empty?

data/lib/morpheus/cli/recent_activity_command.rb

@@ -31,12 +31,12 @@ class Morpheus::Cli::RecentActivityCommand
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = usage
       opts.on('--start TIMESTAMP','--start TIMESTAMP', "Start timestamp. Default is 30 days ago.") do |val|
-        options[:start] = parse_time(val).iso8601
+        options[:start] = parse_time(val).utc.iso8601
       end
       opts.on('--end TIMESTAMP','--end TIMESTAMP', "End timestamp. Default is now.") do |val|
-        options[:end] = parse_time(val).iso8601
+        options[:end] = parse_time(val).utc.iso8601
       end
-      build_common_options(opts, options, [:account, :list, :json, :yaml, :csv, :fields, :dry_run, :remote])
+      build_common_options(opts, options, [:account, :query, :list, :json, :yaml, :csv, :fields, :dry_run, :remote])
     end
     optparse.parse!(args)
     connect(options)
@@ -45,6 +45,12 @@ class Morpheus::Cli::RecentActivityCommand
       account_id = account ? account['id'] : nil
       params = {}
       params.merge!(parse_list_options(options))
+      if options[:start]
+        params['start'] = options[:start]
+      end
+      if options[:end]
+        params['end'] = options[:end]
+      end
       @dashboard_interface.setopts(options)
       if options[:dry_run]
         print_dry_run @dashboard_interface.dry.recent_activity(account_id, params)

data/lib/morpheus/cli/remote.rb

@@ -74,7 +74,7 @@ EOT
       columns = [
         {:active => {:display_name => "", :display_method => lambda {|it| it[:active] ? "=>" : "" } } },
         # {:name => {display_method: lambda {|it| it[:active] ? "#{green}#{it[:name]}#{reset}#{cyan}" : it[:name] }, :width => 16 } },
-        {:name => {display_method: lambda {|it| it[:name] }, :width => 16 } },
+        {:name => {display_method: lambda {|it| it[:name] } } },
         {:url => {display_method: lambda {|it| it[:host] || it[:url] }, :width => 40 } },
         {:version => lambda {|it| it[:build_version] } },
         {:status => lambda {|it| format_appliance_status(it, cyan) } },

data/lib/morpheus/cli/reports_command.rb

@@ -104,6 +104,9 @@ class Morpheus::Cli::ReportsCommand
       opts.on('--rows', '--rows', "Print Report Data rows too.") do
         options[:show_data_rows] = true
       end
+      opts.on('--view', '--view', "View report result in web browser too.") do
+        options[:view_report] = true
+      end
       build_common_options(opts, options, [:json, :yaml, :csv, :fields, :outfile, :dry_run, :remote])
       opts.footer = "Get details about a report result." + "\n"
                   + "[id] is required. This is the id of the report result."
@@ -166,11 +169,11 @@ class Morpheus::Cli::ReportsCommand
             if data_width < 0
               data_wdith = 10
             end
-            puts as_pretty_table(report_result['rows'], {
+            puts as_pretty_table(report_result['rows'], options[:include_fields] || {
               "ID" => lambda {|it| it['id'] },
               "SECTION" => lambda {|it| it['section'] },
               "DATA" => lambda {|it| truncate_string(it['data'], data_width) }
-            })
+            }, options.merge({:responsive_table => false}))
             
           else
             print yellow, "No report data found.", reset, "\n"
@@ -193,6 +196,9 @@ class Morpheus::Cli::ReportsCommand
           get(original_args)
         end
       end
+      if options[:view_report]
+        view([report_result['id']])
+      end
       return 0
     rescue RestClient::Exception => e
       print_rest_exception(e, options)
@@ -218,6 +224,9 @@ class Morpheus::Cli::ReportsCommand
       opts.on('--rows', '--rows', "Print Report Data rows too.") do
         options[:show_data_rows] = true
       end
+      opts.on('--view', '--view', "View report result in web browser when it is finished.") do
+        options[:view_report] = true
+      end
       build_common_options(opts, options, [:options, :payload, :json, :dry_run, :remote])
       opts.footer = "Run a report to generate a new result." + "\n" +
                     "[type] is required. This is code of the report type."
@@ -257,16 +266,27 @@ class Morpheus::Cli::ReportsCommand
         return 1 if report_type.nil?
         payload['report']['type'] = report_type['code']
 
-        # Report Types need to tell us what the available filters are...
+        # Report Types tell us what the available filters are...
+        report_option_types = report_type['optionTypes'] || []
+        # pluck out optionTypes like the UI does..
+        metadata_option_type = nil
+        if report_option_types.find {|it| it['fieldName'] == 'metadata' }
+          metadata_option_type = report_option_types.delete_if {|it| it['fieldName'] == 'metadata' }
+        end
 
-        # Start Date
-        v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'startDate', 'fieldLabel' => 'Start Date', 'type' => 'text', 'required' => false}], options[:options])
-        payload['report']['startDate'] = v_prompt['startDate'] unless v_prompt['startDate'].to_s.empty?
+        v_prompt = Morpheus::Cli::OptionTypes.prompt(report_option_types, options[:options], @api_client)
 
-        # End Date
-        v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'endDate', 'fieldLabel' => 'End Date', 'type' => 'text', 'required' => false}], options[:options])
-        payload['report']['endDate'] = v_prompt['endDate'] unless v_prompt['endDate'].to_s.empty?
+        if metadata_option_type
+          if !options[:options]['metadata']
+            metadata_filter = prompt_metadata(options)
+            if metadata_filter && !metadata_filter.empty?
+              payload['report']['metadata'] = metadata_filter
+            end
+          end
+        end
 
+        # payload.deep_merge!({'report' => v_prompt}) unless v_prompt.empty?
+        payload.deep_merge!(v_prompt) unless v_prompt.empty?
       end
 
       @reports_interface.setopts(options)
@@ -284,6 +304,7 @@ class Morpheus::Cli::ReportsCommand
       print_args = [json_response['reportResult']['id']]
       print_args << "--refresh" if do_refresh
       print_args << "--rows" if options[:show_data_rows]
+      print_args << "--view" if options[:view_report]
       get(print_args)
       return 0
     rescue RestClient::Exception => e
@@ -296,9 +317,9 @@ class Morpheus::Cli::ReportsCommand
     options = {}
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage("[id]")
-      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :remote])
+      build_common_options(opts, options, [:dry_run, :remote])
       opts.footer = "View a report result in a web browser" + "\n" +
-                    "[id] is required. This is id of the report result."
+                    "[id] is required. This is the id of the report result."
     end
     optparse.parse!(args)
     if args.count != 1
@@ -590,5 +611,33 @@ class Morpheus::Cli::ReportsCommand
     out
   end
 
+  # Prompts user for metadata for report filter
+  # returns array of metadata objects {id: null, name: "MYTAG", value: "myvalue"}
+  def prompt_metadata(options={})
+    #puts "Configure Environment Variables:"
+    no_prompt = (options[:no_prompt] || (options[:options] && options[:options][:no_prompt]))
+    metadata_filter = {}
+    metadata_index = 0
+    has_another_metadata = options[:options] && options[:options]["metadata#{metadata_index}"]
+    add_another_metadata = has_another_metadata || (!no_prompt && Morpheus::Cli::OptionTypes.confirm("Add a metadata tag filter?", {default: false}))
+    while add_another_metadata do
+      field_context = "metadata#{metadata_index}"
+      metadata = {}
+      metadata['id'] = nil
+      metadata_label = metadata_index == 0 ? "Metadata Tag" : "Metadata Tag [#{metadata_index+1}]"
+      v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => field_context, 'fieldName' => 'name', 'type' => 'text', 'fieldLabel' => "#{metadata_label} Name", 'required' => true, 'description' => 'Metadata Tag Name.', 'defaultValue' => metadata['name']}], options[:options])
+      # todo: metadata.type ?
+      metadata['name'] = v_prompt[field_context]['name'].to_s
+      v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => field_context, 'fieldName' => 'value', 'type' => 'text', 'fieldLabel' => "#{metadata_label} Value", 'required' => true, 'description' => 'Metadata Tag Value', 'defaultValue' => metadata['value']}], options[:options])
+      metadata['value'] = v_prompt[field_context]['value'].to_s
+      metadata_filter[metadata['name']] = metadata['value']
+      metadata_index += 1
+      has_another_metadata = options[:options] && options[:options]["metadata#{metadata_index}"]
+      add_another_metadata = has_another_metadata || (!no_prompt && Morpheus::Cli::OptionTypes.confirm("Add another metadata tag filter?", {default: false}))
+    end
+
+    return metadata_filter
+  end
+
 end
 

data/lib/morpheus/cli/tenants_command.rb

@@ -42,7 +42,7 @@ class Morpheus::Cli::TenantsCommand
     options = {}
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage()
-      build_common_options(opts, options, [:list, :query, :json, :remote, :dry_run])
+      build_common_options(opts, options, [:list, :query, :json, :yaml, :csv, :fields, :dry_run, :remote])
       opts.footer = "List tenants (accounts)."
     end
     optparse.parse!(args)
@@ -56,23 +56,21 @@ class Morpheus::Cli::TenantsCommand
         return
       end
       json_response = @accounts_interface.list(params)
+      render_result = render_with_format(json_response, options, 'accounts')
+      return 0 if render_result
       accounts = json_response['accounts']
-      if options[:json]
-        print JSON.pretty_generate(json_response)
-        print "\n"
+      title = "Morpheus Tenants"
+      subtitles = []
+      subtitles += parse_list_subtitles(options)
+      print_h1 title, subtitles
+      if accounts.empty?
+        puts yellow,"No tenants found.",reset
       else
-        title = "Morpheus Tenants"
-        subtitles = []
-        subtitles += parse_list_subtitles(options)
-        print_h1 title, subtitles
-        if accounts.empty?
-          puts yellow,"No tenants found.",reset
-        else
-          print_accounts_table(accounts)
-          print_results_pagination(json_response)
-        end
-        print reset,"\n"
+        print_accounts_table(accounts)
+        print_results_pagination(json_response)
       end
+      print reset,"\n"
+      return 0
     rescue RestClient::Exception => e
       print_rest_exception(e, options)
       exit 1
@@ -113,7 +111,7 @@ class Morpheus::Cli::TenantsCommand
     options = {}
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage("[name]")
-      build_common_options(opts, options, [:json, :remote, :dry_run])
+      build_common_options(opts, options, [:json, :yaml, :csv, :fields, :outfile, :dry_run, :remote])
     end
     optparse.parse!(args)
     if args.count != 1
@@ -132,36 +130,35 @@ class Morpheus::Cli::TenantsCommand
       end
       account = find_account_by_name_or_id(args[0])
       exit 1 if account.nil?
-      if options[:json]
-        print JSON.pretty_generate({account: account})
-        print "\n"
-      else
-        print_h1 "Tenant Details"
-        print cyan
-        puts "ID: #{account['id']}"
-        puts "Name: #{account['name']}"
-        puts "Description: #{account['description']}"
-        puts "Subdomain: #{account['subdomain']}" if !account['subdomain'].to_s.empty?
-        puts "Currency: #{account['currency']}"
-        # puts "# Users: #{account['usersCount']}"
-        # puts "# Instances: #{account['instancesCount']}"
-        puts "Date Created: #{format_local_dt(account['dateCreated'])}"
-        puts "Last Updated: #{format_local_dt(account['lastUpdated'])}"
-        status_state = nil
-        if account['active']
-          status_state = "#{green}ACTIVE#{cyan}"
-        else
-          status_state = "#{red}INACTIVE#{cyan}"
-        end
-        puts "Status: #{status_state}"
-        # JD: pretty sure this is deprecated
-        # print_h2 "Tenant Instance Limits"
-        # print cyan
-        # puts "Max Storage (bytes): #{account['instanceLimits'] ? account['instanceLimits']['maxStorage'] : 0}"
-        # puts "Max Memory (bytes): #{account['instanceLimits'] ? account['instanceLimits']['maxMemory'] : 0}"
-        # puts "CPU Count: #{account['instanceLimits'] ? account['instanceLimits']['maxCpu'] : 0}"
-        print reset,"\n"
-      end
+
+      json_response = {'account' => account}
+      render_result = render_with_format(json_response, options, 'account')
+      return 0 if render_result
+
+      print_h1 "Tenant Details", [], options
+      
+      description_cols = {
+        "ID" => 'id',
+        "Name" => 'name',
+        "Description" => 'description',
+        "Subdomain" => 'subdomain',
+        "Currency" => 'currency',
+        "Created" => lambda {|it| format_local_dt(it['dateCreated']) },
+        "Updated" => lambda {|it| format_local_dt(it['lastUpdated']) },
+        "Status" => lambda {|it| 
+          status_state = nil
+          if account['active']
+            status_state = "#{green}ACTIVE#{cyan}"
+          else
+            status_state = "#{red}INACTIVE#{cyan}"
+          end
+          status_state
+        },
+      }
+      print_description_list(description_cols, account)
+
+      print reset,"\n"
+      return 0
     rescue RestClient::Exception => e
       print_rest_exception(e, options)
       exit 1

data/lib/morpheus/cli/version.rb

@@ -1,6 +1,6 @@
 
 module Morpheus
   module Cli
-    VERSION = "3.6.31"
+    VERSION = "3.6.32"
   end
 end

data/lib/morpheus/cli/wiki_command.rb

@@ -0,0 +1,461 @@
+require 'io/console'
+require 'rest_client'
+require 'optparse'
+require 'morpheus/cli/cli_command'
+require 'morpheus/cli/option_types'
+require 'json'
+
+class Morpheus::Cli::WikiCommand
+  include Morpheus::Cli::CliCommand
+  set_command_name :wiki
+  register_subcommands :list, :get, :view, :add, :update, :remove, :'categories'
+
+  def initialize()
+    # @appliance_name, @appliance_url = Morpheus::Cli::Remote.active_appliance
+  end
+
+  def connect(opts)
+    @api_client = establish_remote_appliance_connection(opts)
+    @wiki_interface = Morpheus::APIClient.new(@access_token,nil,nil, @appliance_url).wiki
+  end
+
+  def handle(args)
+    handle_subcommand(args)
+  end
+
+  def list(args)
+    options = {}
+    params = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage()
+      opts.on('--category VALUE', String, "Category") do |val|
+        params['category'] = val
+      end
+      build_common_options(opts, options, [:list, :query, :json, :yaml, :csv, :fields, :dry_run, :remote])
+    end
+    optparse.parse!(args)
+    if args.count != 0
+      raise_command_error "wrong number of arguments, expected 0 and got (#{args.count}) #{args}\n#{optparse}"
+    end
+    connect(options)
+    begin
+      params.merge!(parse_list_options(options))
+      @wiki_interface.setopts(options)
+      if options[:dry_run]
+        print_dry_run @wiki_interface.dry.list(params)
+        return 0
+      end
+      json_response = @wiki_interface.list(params)
+      render_result = render_with_format(json_response, options, 'pages')
+      return 0 if render_result
+      pages = json_response['pages']
+      unless options[:quiet]
+        title = "Morpheus Wiki Pages"
+        subtitles = []
+        if params['category']
+          subtitles << "Category: #{params['category']}"
+        end
+        subtitles += parse_list_subtitles(options)
+        print_h1 title, subtitles
+        if pages.empty?
+          print yellow,"No wiki pages found.",reset
+        else
+          columns = [
+            {"ID" => lambda {|page| page['id'] } },
+            {"NAME" => lambda {|page| page['name'] } },
+            {"CATEGORY" => lambda {|page| page['category'] } },
+            {"AUTHOR" => lambda {|page| page['updatedBy'] ? page['updatedBy']['username'] : '' } },
+            {"CREATED" => lambda {|page| format_local_dt(page['dateCreated']) } },
+            {"UPDATED" => lambda {|page| format_local_dt(page['lastUpdated']) } },
+          ]
+          if options[:include_fields]
+            columns = options[:include_fields]
+          end
+          print as_pretty_table(pages, columns, options)
+          print_results_pagination(json_response)
+        end
+        print reset,"\n"
+      end
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  def get(args)
+    options = {}
+    params = {}
+    open_wiki_link = false
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[name]")
+      opts.on('--view', '--view', "View wiki page in web browser too.") do
+        open_wiki_link = true
+      end
+      build_common_options(opts, options, [:query, :json, :yaml, :csv, :fields, :dry_run, :remote])
+    end
+    optparse.parse!(args)
+
+    if args.count != 1
+      raise_command_error "wrong number of arguments, expected 1 and got (#{args.count}) #{args}\n#{optparse}"
+    end
+
+    connect(options)
+    begin
+      @wiki_interface.setopts(options)
+      if options[:dry_run]
+        if args[0].to_s =~ /\A\d{1,}\Z/
+          print_dry_run @wiki_interface.dry.get(args[0])
+        else
+          print_dry_run @wiki_interface.dry.list({name: args[0].to_s})
+        end
+        return 0
+      end
+      page = find_wiki_page_by_name_or_id(args[0])
+      return 1 if page.nil?
+      json_response = {'page' => page}
+      render_result = render_with_format(json_response, options, 'page')
+      return 0 if render_result
+
+      unless options[:quiet]
+        print_h1 "Wiki Page Details"
+        print cyan
+
+        print_description_list({
+          "ID" => 'id',
+          "Name" => 'name',
+          "Category" => 'category',
+          "Ref Type" => 'refType',
+          "Ref ID" => 'refId',
+          #"Owner" => lambda {|it| it['account'] ? it['account']['name'] : '' },
+          "Created" => lambda {|it| format_local_dt(it['dateCreated']) },
+          "Created By" => lambda {|it| it['createdBy'] ? it['createdBy']['username'] : '' },
+          "Updated" => lambda {|it| format_local_dt(it['lastUpdated']) },
+          "Updated By" => lambda {|it| it['updatedBy'] ? it['updatedBy']['username'] : '' }
+        }, page)
+        print reset,"\n"
+
+        print_h2 "Page Content"
+        print cyan, page['content'], reset, "\n"
+
+      end
+      print reset,"\n"
+      if open_wiki_link
+        return view([page['id']])
+      end
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  def view(args)
+    options = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[id]")
+      build_common_options(opts, options, [:dry_run, :remote])
+      opts.footer = "View a wiki page in a web browser" + "\n" +
+                    "[id] is required. This is name or id of the wiki page."
+    end
+    optparse.parse!(args)
+    if args.count != 1
+      raise_command_error "wrong number of arguments, expected 1 and got (#{args.count}) #{args.join(' ')}\n#{optparse}"
+    end
+    connect(options)
+    begin
+      page = find_wiki_page_by_name_or_id(args[0])
+      return 1 if page.nil?
+
+      link = "#{@appliance_url}/login/oauth-redirect?access_token=#{@access_token}\\&redirectUri=/operations/wiki/#{page['urlName']}"
+
+      open_command = nil
+      if RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/
+        open_command = "start #{link}"
+      elsif RbConfig::CONFIG['host_os'] =~ /darwin/
+        open_command = "open #{link}"
+      elsif RbConfig::CONFIG['host_os'] =~ /linux|bsd/
+        open_command = "xdg-open #{link}"
+      end
+
+      if options[:dry_run]
+        puts "system: #{open_command}"
+        return 0
+      end
+
+      system(open_command)
+      
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  def add(args)
+    options = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[name] [options]")
+      build_option_type_options(opts, options, add_wiki_page_option_types)
+      build_common_options(opts, options, [:payload, :options, :json, :dry_run, :remote])
+    end
+    optparse.parse!(args)
+    if args.count > 1
+      raise_command_error "wrong number of arguments, expected 0-1 and got (#{args.count}) #{args}\n#{optparse}"
+    end
+    if args[0]
+      options[:options] ||= {}
+      options[:options]['name'] ||= args[0]
+    end
+    connect(options)
+    begin
+      # construct payload
+      passed_options = options[:options] ? options[:options].reject {|k,v| k.is_a?(Symbol) } : {}
+      payload = nil
+      if options[:payload]
+        payload = options[:payload]
+        payload.deep_merge!({'page' => passed_options}) unless passed_options.empty?
+      else
+        payload = {
+          'page' => {
+          }
+        }
+        # allow arbitrary -O options
+        payload.deep_merge!({'page' => passed_options}) unless passed_options.empty?
+        # prompt for options
+        params = Morpheus::Cli::OptionTypes.prompt(add_wiki_page_option_types, options[:options], @api_client, options[:params])
+        payload.deep_merge!({'page' => params}) unless params.empty?
+      end
+
+      @wiki_interface.setopts(options)
+      if options[:dry_run]
+        print_dry_run @wiki_interface.dry.create(payload)
+        return
+      end
+      json_response = @wiki_interface.create(payload)
+      if options[:json]
+        print JSON.pretty_generate(json_response)
+        print "\n"
+      else
+        display_name = json_response['page']  ? json_response['page']['name'] : ''
+        print_green_success "Wiki page #{display_name} added"
+        get([json_response['page']['id']])
+      end
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  def update(args)
+    options = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[name] [options]")
+      build_option_type_options(opts, options, update_wiki_page_option_types)
+      build_common_options(opts, options, [:payload, :options, :json, :dry_run, :remote])
+    end
+    optparse.parse!(args)
+
+    if args.count != 1
+      raise_command_error "wrong number of arguments, expected 1 and got (#{args.count}) #{args}\n#{optparse}"
+    end
+
+    connect(options)
+    begin
+
+      page = find_wiki_page_by_name_or_id(args[0])
+      return 1 if page.nil?
+
+      # construct payload
+      passed_options = options[:options] ? options[:options].reject {|k,v| k.is_a?(Symbol) } : {}
+      payload = nil
+      if options[:payload]
+        payload = options[:payload]
+        payload.deep_merge!({'page' => passed_options}) unless passed_options.empty?
+      else
+        payload = {
+          'page' => {
+          }
+        }
+        # allow arbitrary -O options
+        payload.deep_merge!({'page' => passed_options}) unless passed_options.empty?
+        # prompt for options
+        #params = Morpheus::Cli::OptionTypes.prompt(update_wiki_page_option_types, options[:options], @api_client, options[:params])
+        params = passed_options
+
+        if params.empty?
+          raise_command_error "Specify at least one option to update.\n#{optparse}"
+        end
+        if params["category"] && (params["category"].strip == "" || params["category"].strip == "null")
+          params["category"] = ""
+        end
+        payload.deep_merge!({'page' => params}) unless params.empty?
+      end
+      @wiki_interface.setopts(options)
+      if options[:dry_run]
+        print_dry_run @wiki_interface.dry.update(page['id'], payload)
+        return
+      end
+      json_response = @wiki_interface.update(page['id'], payload)
+      if options[:json]
+        print JSON.pretty_generate(json_response)
+        print "\n"
+      else
+        display_name = json_response['page'] ? json_response['page']['name'] : ''
+        print_green_success "Wiki page #{display_name} updated"
+        get([json_response['page']['id']])
+      end
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  def remove(args)
+    options = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[name]")
+      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :remote])
+    end
+    optparse.parse!(args)
+
+    if args.count != 1
+      raise_command_error "wrong number of arguments, expected 1 and got (#{args.count}) #{args}\n#{optparse}"
+    end
+
+    connect(options)
+    begin
+      page = find_wiki_page_by_name_or_id(args[0])
+      return 1 if page.nil?
+
+      unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to delete the page #{page['name']}?")
+        return 9, "aborted command"
+      end
+      @wiki_interface.setopts(options)
+      if options[:dry_run]
+        print_dry_run @wiki_interface.dry.destroy(page['id'])
+        return
+      end
+      json_response = @wiki_interface.destroy(page['id'])
+      if options[:json]
+        print JSON.pretty_generate(json_response)
+        print "\n"
+      else
+        print_green_success "Wiki page #{page['name']} removed"
+        # list([])
+      end
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  def categories(args)
+    options = {}
+    params = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage()
+      build_common_options(opts, options, [:list, :query, :json, :yaml, :csv, :fields, :dry_run, :remote])
+    end
+    optparse.parse!(args)
+    if args.count != 0
+      raise_command_error "wrong number of arguments, expected 0 and got (#{args.count}) #{args}\n#{optparse}"
+    end
+    connect(options)
+    begin
+      params.merge!(parse_list_options(options))
+      @wiki_interface.setopts(options)
+      if options[:dry_run]
+        print_dry_run @wiki_interface.dry.categories(params)
+        return 0
+      end
+      json_response = @wiki_interface.categories(params)
+      render_result = render_with_format(json_response, options, 'categories')
+      return 0 if render_result
+      categories = json_response['categories']
+      unless options[:quiet]
+        title = "Morpheus Wiki Categories"
+        subtitles = []
+        subtitles += parse_list_subtitles(options)
+        print_h1 title, subtitles
+        if categories.empty?
+          print yellow,"No wiki categories found.",reset,"\n"
+        else
+          columns = [
+            {"CATEGORY" => lambda {|page| page['name'] } },
+            {"# PAGES" => lambda {|it| it['pageCount'] } }
+          ]
+          if options[:include_fields]
+            columns = options[:include_fields]
+          end
+          print as_pretty_table(categories, columns, options)
+          #print_results_pagination(json_response)
+        end
+        print reset,"\n"
+      end
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  private
+  def find_wiki_page_by_name_or_id(val)
+    if val.to_s =~ /\A\d{1,}\Z/
+      return find_wiki_page_by_id(val)
+    else
+      return find_wiki_page_by_name(val)
+    end
+  end
+
+  def find_wiki_page_by_id(id)
+    raise "#{self.class} has not defined @wiki_interface" if @wiki_interface.nil?
+    begin
+      json_response = @wiki_interface.get(id)
+      return json_response['page']
+    rescue RestClient::Exception => e
+      if e.response && e.response.code == 404
+        print_red_alert "Wiki page not found by id #{id}"
+      else
+        raise e
+      end
+    end
+  end
+
+  def find_wiki_page_by_name(name)
+    raise "#{self.class} has not defined @wiki_interface" if @wiki_interface.nil?
+    pages = @wiki_interface.list({name: name.to_s})['pages']
+    if pages.empty?
+      print_red_alert "Wiki page not found by name #{name}"
+      return nil
+    elsif pages.size > 1
+      print_red_alert "#{pages.size} wiki pages found by name #{name}"
+      print as_pretty_table(pages, [:id,:name], {color:red})
+      print reset,"\n"
+      return nil
+    else
+      return pages[0]
+    end
+  end
+
+  def add_wiki_page_option_types
+    [
+      {'fieldName' => 'name', 'fieldLabel' => 'Name', 'type' => 'text', 'required' => true, 'displayOrder' => 1},
+      {'fieldName' => 'category', 'fieldLabel' => 'Category', 'type' => 'text', 'required' => false, 'displayOrder' => 2},
+      {'fieldName' => 'content', 'fieldLabel' => 'Content', 'type' => 'textarea', 'required' => true, 'displayOrder' => 3}
+    ]
+  end
+
+  def update_wiki_page_option_types
+    [
+      {'fieldName' => 'name', 'fieldLabel' => 'Name', 'type' => 'text', 'required' => false, 'displayOrder' => 1},
+      {'fieldName' => 'category', 'fieldLabel' => 'Category', 'type' => 'text', 'required' => false, 'displayOrder' => 2},
+      {'fieldName' => 'content', 'fieldLabel' => 'Content', 'type' => 'textarea', 'required' => false, 'displayOrder' => 3}
+    ]
+  end
+
+end