morpheus-cli 5.0.0 → 5.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b7e5399fa687da8ee714dc1bfe80cd72c2f01bf15cb465f1e6e576df53aa0a84
-  data.tar.gz: d5fe9c71d49308c5f7f92e47b134647712c302f833d7e77a55431bcec2e3036f
+  metadata.gz: 30d7a10e197c41b49f453d0d43fa28027e8759e8a889b531045626b0ad2157f8
+  data.tar.gz: f5bc8ef27e0c29feb0fbd9005ce7d013746ecdf005c92a049ff7537301c1fcbf
 SHA512:
-  metadata.gz: a0904e36c4240d638d87862cefffd681241868a8cd06730eef6ddac921d4fb288a27043d365b4ba94b3223fa6be41b783f2b9aaa570e490b731528c6b282b5ff
-  data.tar.gz: b05b484d490e4829e20bba8d942acef387346cc03e214cd1c04d96a2cfca603d971d20054cb3bb9f9024d5bf977864b543d3c6d599089765f55426aa317a4f0e
+  metadata.gz: 616bb0355ed1a3a6c07f26a8e6aa291cb99f7208f754c94146d8ac08ffc735c7231c081fd4e56bf0c6490c2a0931e10995332023e46f66314213c3af0e5e8545
+  data.tar.gz: ae11e6b85aa13a6349dc54e6d9421cbe9cde6071332de409570e6796dd2a09da3d932c349652de6adfe5321c88816f066c25aeebc651e6a63bd9106cddde15a3

data/Dockerfile

@@ -1,5 +1,5 @@
 FROM ruby:2.5.1
 
-RUN gem install morpheus-cli -v 5.0.0
+RUN gem install morpheus-cli -v 5.0.1
 
 ENTRYPOINT ["morpheus"]

data/lib/morpheus/api/api_client.rb

@@ -342,10 +342,18 @@ class Morpheus::APIClient
     Morpheus::AuthInterface.new({url: @base_url, client_id: @client_id}).setopts(@options)
   end
 
+  def forgot
+    Morpheus::ForgotPasswordInterface.new(common_interface_options).setopts(@options)
+  end
+
   def whoami
     Morpheus::WhoamiInterface.new(common_interface_options).setopts(@options)
   end
 
+  def search
+    Morpheus::SearchInterface.new(common_interface_options).setopts(@options)
+  end
+
   def user_settings
     Morpheus::UserSettingsInterface.new(common_interface_options).setopts(@options)
   end
@@ -768,6 +776,10 @@ class Morpheus::APIClient
     Morpheus::CatalogItemTypesInterface.new(common_interface_options).setopts(@options)
   end
 
+  def usage
+    Morpheus::UsageInterface.new(common_interface_options).setopts(@options)
+  end
+
   def billing
     Morpheus::BillingInterface.new(common_interface_options).setopts(@options)
   end

data/lib/morpheus/api/billing_interface.rb

@@ -6,6 +6,7 @@ class Morpheus::BillingInterface < Morpheus::APIClient
     "/api/billing"
   end
 
+  # this is an alias for /usage
   def list(params={})
     execute(method: :get, url: "#{base_path}", params: params)
   end

data/lib/morpheus/api/deploy_interface.rb

@@ -18,7 +18,7 @@ class Morpheus::DeployInterface < Morpheus::APIClient
     execute(method: :get, url: "#{base_path}", params: params)
   end
 
-  def get(instance_id, id, params={})
+  def get(id, params={})
     validate_id!(id)
     execute(method: :get, url: "#{base_path}/#{id}", params: params)
   end

data/lib/morpheus/api/deployments_interface.rb

@@ -40,7 +40,8 @@ class Morpheus::DeploymentsInterface < Morpheus::RestInterface
     if destination.empty? || destination == "/" || destination == "." || destination.include?("../")
       raise "#{self.class}.upload_file() passed a bad destination: '#{destination}'"
     end
-    url = "#{@base_url}/#{base_path}/#{deployment_id}/versions/#{id}/files"
+    # url = "#{@base_url}/#{base_path}/#{deployment_id}/versions/#{id}/files"
+    url = "#{base_path}/#{deployment_id}/versions/#{id}/files"
     if !destination.to_s.empty?
       url += "/#{destination}"
     end
@@ -57,4 +58,22 @@ class Morpheus::DeploymentsInterface < Morpheus::RestInterface
     execute(method: :post, url: url, headers: headers, payload: payload, params: params, timeout: 172800)
   end
 
+  # upload a file without multipart
+  # local_file is the full absolute local filename
+  # destination should be the full remote file path, including the file name.
+  def destroy_file(deployment_id, id, destination, params={})
+    if destination.empty? || destination == "/" || destination == "." || destination.include?("../")
+      raise "#{self.class}.upload_file() passed a bad destination: '#{destination}'"
+    end
+    # url = "#{@base_url}/#{base_path}/#{deployment_id}/versions/#{id}/files"
+    url = "#{base_path}/#{deployment_id}/versions/#{id}/files"
+    if !destination.to_s.empty?
+      url += "/#{destination}"
+    end
+    # use URI to escape path
+    uri = URI.parse(url)
+    url = uri.path
+    execute(method: :delete, url: url, params: params)
+  end
+
 end

data/lib/morpheus/api/forgot_password_interface.rb

@@ -0,0 +1,17 @@
+require 'morpheus/api/api_client'
+# There is no Authorization required for this API.
+class Morpheus::ForgotPasswordInterface < Morpheus::APIClient
+
+  def authorization_required?
+    false
+  end
+
+  def send_email(payload, params={})
+    execute(method: :post, url: "/api/forgot/send-email", params: params, payload: payload.to_json)
+  end
+
+  def reset_password(payload, params={})
+    execute(method: :post, url: "/api/forgot/reset-password", params: params, payload: payload.to_json)
+  end
+
+end

data/lib/morpheus/api/instances_interface.rb

@@ -218,6 +218,13 @@ class Morpheus::InstancesInterface < Morpheus::APIClient
     execute(opts)
   end
   
+  def snapshots(instance_id, params={})
+    url = "#{@base_url}/api/instances/#{instance_id}/snapshots"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
   def import_snapshot(id, params={}, payload={})
     url = "#{@base_url}/api/instances/#{id}/import-snapshot"
     headers = {:authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }

data/lib/morpheus/api/search_interface.rb

@@ -0,0 +1,13 @@
+require 'morpheus/api/rest_interface'
+
+class Morpheus::SearchInterface < Morpheus::APIClient
+
+  def base_path
+    "/api/search"
+  end
+
+  def list(params={})
+    execute(method: :get, url: "#{base_path}", params: params)
+  end
+
+end

data/lib/morpheus/api/servers_interface.rb

@@ -169,4 +169,11 @@ class Morpheus::ServersInterface < Morpheus::APIClient
     execute(opts)
   end
   
+  def snapshots(id, params={})
+    url = "#{@base_url}/api/servers/#{id}/snapshots"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
 end

data/lib/morpheus/api/usage_interface.rb

@@ -0,0 +1,18 @@
+require 'morpheus/api/api_client'
+
+class Morpheus::UsageInterface < Morpheus::APIClient
+
+  def base_path
+    "/api/usage" # not /usages ?
+  end
+
+  def list(params={})
+    execute(method: :get, url: "#{base_path}", params: params)
+  end
+
+  def get(id, params={})
+    validate_id!(id)
+    execute(method: :get, url: "#{base_path}/#{id}", params: params)
+  end
+
+end

data/lib/morpheus/cli.rb

@@ -74,9 +74,11 @@ module Morpheus
       load 'morpheus/cli/setup.rb'
       load 'morpheus/cli/login.rb'
       load 'morpheus/cli/logout.rb'
+      load 'morpheus/cli/forgot_password.rb'
       load 'morpheus/cli/whoami.rb'
       load 'morpheus/cli/access_token_command.rb'
       load 'morpheus/cli/user_settings_command.rb'
+      load 'morpheus/cli/search_command.rb'
       load 'morpheus/cli/dashboard_command.rb'
       load 'morpheus/cli/recent_activity_command.rb' # deprecated, removing soon
       load 'morpheus/cli/activity_command.rb'
@@ -94,11 +96,12 @@ module Morpheus
       load 'morpheus/cli/tasks.rb'
       load 'morpheus/cli/workflows.rb'
       load 'morpheus/cli/deployments.rb'
+      load 'morpheus/cli/deploy.rb'
+      load 'morpheus/cli/deploys.rb'
       load 'morpheus/cli/instances.rb'
       load 'morpheus/cli/containers_command.rb'
       load 'morpheus/cli/apps.rb'
       load 'morpheus/cli/blueprints_command.rb'
-      load 'morpheus/cli/deploys.rb'
       load 'morpheus/cli/license.rb'
       load 'morpheus/cli/instance_types.rb'
       load 'morpheus/cli/jobs_command.rb'

data/lib/morpheus/cli/cli_command.rb

@@ -309,6 +309,15 @@ module Morpheus
             opts.add_hidden_option('-a, --account') if opts.is_a?(Morpheus::Cli::OptionParser)
             opts.add_hidden_option('-A, --account-id') if opts.is_a?(Morpheus::Cli::OptionParser)
 
+          when :details
+            opts.on('-a', '--all', "Show all details." ) do
+              options[:details] = true
+            end
+            opts.on('--details', '--details', "Show more details" ) do
+              options[:details] = true
+            end
+            opts.add_hidden_option('--details')
+
           when :options
             options[:options] ||= {}
             opts.on( '-O', '--option OPTION', "Option in the format -O field=\"value\"" ) do |option|
@@ -602,13 +611,13 @@ module Morpheus
             end
             # opts.add_hidden_option('-H') if opts.is_a?(Morpheus::Cli::OptionParser)
             # opts.add_hidden_option('--header') if opts.is_a?(Morpheus::Cli::OptionParser)
-            opts.add_hidden_option('--headers') if opts.is_a?(Morpheus::Cli::OptionParser)
+            opts.add_hidden_option('-H, --header') if opts.is_a?(Morpheus::Cli::OptionParser)
 
           #when :timeout
             opts.on( '--timeout SECONDS', "Timeout for api requests. Default is typically 30 seconds." ) do |val|
               options[:timeout] = val ? val.to_f : nil
             end
-            # opts.add_hidden_option('--timeout') if opts.is_a?(Morpheus::Cli::OptionParser)
+            opts.add_hidden_option('--timeout') if opts.is_a?(Morpheus::Cli::OptionParser)
 
           when :auto_confirm
             opts.on( '-y', '--yes', "Auto Confirm" ) do
@@ -715,7 +724,7 @@ module Morpheus
           
 
           when :dry_run
-            opts.on('-d','--dry-run', "Dry Run, print the API request instead of executing it") do
+            opts.on('-d','--dry-run', "Dry Run, print the API request instead of executing it.") do
               # todo: this should print after parsing obv..
               # need a hook after parse! or a standard_handle(options) { ... } paradigm
               # either that or hook it up in every command somehow, maybe a hook on connect()
@@ -727,7 +736,7 @@ module Morpheus
               end
               options[:dry_run] = true
             end
-            opts.on(nil,'--curl', "Dry Run to output API request as a curl command.") do
+            opts.on(nil,'--curl', "Curl, print the API request as a curl command instead of executing it.") do
               # print once and dont munge json
               if !options[:dry_run] && !options[:json]
                 puts "#{cyan}#{bold}#{dark}DRY RUN#{reset}"
@@ -830,6 +839,10 @@ module Morpheus
         opts
       end
 
+      def prog_name
+        self.class.prog_name
+      end
+
       def command_name
         self.class.command_name
       end
@@ -870,14 +883,14 @@ module Morpheus
 
       def usage
         if !subcommands.empty?
-          "Usage: morpheus #{command_name} [command] [options]"
+          "Usage: #{prog_name} #{command_name} [command] [options]"
         else
-          "Usage: morpheus #{command_name} [options]"
+          "Usage: #{prog_name} #{command_name} [options]"
         end
       end
 
       def my_help_command
-        "morpheus #{command_name} --help"
+        "#{prog_name} #{command_name} --help"
       end
 
       def subcommand_usage(*extra)
@@ -888,7 +901,7 @@ module Morpheus
           extra.shift
         end
         #extra = ["[options]"] if extra.empty?
-        "Usage: morpheus #{command_name} #{subcommand_name} #{extra.join(' ')}".squeeze(' ').strip
+        "Usage: #{prog_name} #{command_name} #{subcommand_name} #{extra.join(' ')}".squeeze(' ').strip
       end
 
       # a string to describe the usage of your command
@@ -939,7 +952,7 @@ module Morpheus
         end
         cmd_method = subcommands[subcommand_name]
         if !cmd_method
-          error_msg = "'#{command_name} #{subcommand_name}' is not a morpheus command.\n#{full_command_usage}"
+          error_msg = "'#{command_name} #{subcommand_name}' is not a #{prog_name} command.\n#{full_command_usage}"
           raise CommandNotFoundError.new(error_msg)
         end
         self.send(cmd_method, args[1..-1])
@@ -1295,6 +1308,10 @@ module Morpheus
 
       module ClassMethods
 
+        def prog_name
+          "morpheus"
+        end
+
         def set_command_name(cmd_name)
           @command_name = cmd_name
           Morpheus::Cli::CliRegistry.add(self, self.command_name)

data/lib/morpheus/cli/commands/standard/curl_command.rb

@@ -41,7 +41,7 @@ class Morpheus::Cli::CurlCommand
       opts.on( '--progress', '--progress', "Display progress output by excluding the -s option." ) do
         show_progress = true
       end
-      build_common_options(opts, options, [:dry_run, :remote])
+      build_common_options(opts, options, [:dry_run, :json, :remote])
       opts.add_hidden_option('--curl')
       #opts.add_hidden_option('--scrub')
       opts.footer = <<-EOT
@@ -140,16 +140,14 @@ EOT
     print reset
     # print result
     curl_output = `#{curl_cmd}`
-    if options[:pretty]
+    if options[:pretty] || options[:json]
       output_lines = curl_output.split("\n")
       last_line = output_lines.pop
       if output_lines.size > 0
         puts output_lines.join("\n")
       end
       begin
-        json_data = JSON.parse(last_line)
-        json_string = JSON.pretty_generate(json_data)
-        puts json_string
+        puts as_json(JSON.parse(last_line), options)
       rescue => ex
         Morpheus::Logging::DarkPrinter.puts "failed to parse curl result as JSON data Error: #{ex.message}" if Morpheus::Logging.debug?
         puts last_line

data/lib/morpheus/cli/commands/standard/history_command.rb

@@ -6,7 +6,9 @@ require 'morpheus/cli/cli_command'
 class Morpheus::Cli::HistoryCommand
   include Morpheus::Cli::CliCommand
   set_command_name :'history'
-  set_command_hidden
+  set_command_description "View morpheus shell command history"
+  # hidden for now because it is a shell command, shouldnt just be shell command though
+  set_command_hidden 
 
   # todo: support all the other :list options too, not just max
   # AND start logging every terminal command, not just shell...

data/lib/morpheus/cli/commands/standard/man_command.rb

@@ -9,7 +9,7 @@ class Morpheus::Cli::ManCommand
 
   # this should be read only anyway...
   @@default_editor = "less" # ENV['EDITOR']
-  
+
   def handle(args)
     options = {}
     regenerate = false
@@ -28,6 +28,12 @@ class Morpheus::Cli::ManCommand
       opts.on('-g','--generate', "Regenerate the manual file") do
         regenerate = true
       end
+      opts.on('-o','--out FILE', "Write manual file to a custom location") do |val|
+        options[:outfile] = val
+      end
+      opts.on('--overwrite', '--overwrite', "Overwrite output file if it already exists.") do |val|
+        options[:overwrite] = true
+      end
       opts.on('-q','--quiet', "Do not open manual, for use with the -g option.") do
         options[:quiet] = true
       end
@@ -47,7 +53,8 @@ class Morpheus::Cli::ManCommand
       end
       opts.footer = <<-EOT
 Open the morpheus manual located at #{Morpheus::Cli::ManCommand.man_file_path}
-The -g switch be used to regenerate the file.
+The -g option can be used to regenerate the file.
+The --out FILE option be used to write the manual file to a custom location.
 EOT
     end
     optparse.parse!(args)
@@ -65,18 +72,35 @@ EOT
     end
 
     fn = Morpheus::Cli::ManCommand.man_file_path
+    if options[:outfile]
+      regenerate = true
+      fn = File.expand_path(options[:outfile])
+      if File.directory?(fn)
+        # if you give me a directory, could still work and use the default filename
+        # fn = File.join(fn, "CLI-Manual-#{Morpheus::Cli::VERSION}.md")
+        # raise_command_error "outfile is invalid. It is the name of an existing directory: #{fn}"
+        print_error "#{red}Output file '#{fn}' is invalid.#{reset}\n"
+        print_error "#{red}It is the name of an existing directory.#{reset}\n"
+        return 1
+      end
+      if File.exists?(fn) && options[:overwrite] != true
+        print_error "#{red}Output file '#{fn}' already exists.#{reset}\n"
+        print_error "#{red}Use --overwrite to overwrite the existing file.#{reset}\n"
+        return 1
+      end
+    end
+    exit_code, err = 0, nil
     if regenerate || !File.exists?(fn)
       #Morpheus::Logging::DarkPrinter.puts "generating manual #{fn} ..." if Morpheus::Logging.debug? && !options[:quiet]
-      Morpheus::Cli::ManCommand.generate_manual(options)
+      exit_code, err = Morpheus::Cli::ManCommand.generate_manual(options)
     end
     
     if options[:quiet]
-      return 0, nil
+      return exit_code, err
     end
     
     Morpheus::Logging::DarkPrinter.puts "opening manual file #{fn}" if Morpheus::Logging.debug? && !options[:quiet]
     
-    
     if open_as_link # not used atm
       link = "file://#{fn}"
       if RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/
@@ -138,6 +162,14 @@ EOT
     # todo: use pandoc or something else to convert the CLI-Manual.md to a man page
     # and install it, so the os command `man morpheus` will work too.
     fn = man_file_path()
+    if options[:outfile]
+      fn = File.expand_path(options[:outfile])
+      if File.exists?(fn) && options[:overwrite] != true
+        print_error "#{red}Output file '#{options[:outfile]}' already exists.#{reset}\n"
+        print_error "#{red}Use --overwrite to overwrite the existing file.#{reset}\n"
+        return 1, "output file already exists"
+      end
+    end
     if !Dir.exists?(File.dirname(fn))
       FileUtils.mkdir_p(File.dirname(fn))
     end
@@ -153,7 +185,7 @@ EOT
     begin
 
       manpage.print <<-ENDTEXT
-morpheus v#{Morpheus::Cli::VERSION}
+#{prog_name} v#{Morpheus::Cli::VERSION}
 
 ## NAME
 
@@ -170,17 +202,17 @@ morpheus v#{Morpheus::Cli::VERSION}
     This is a command line interface for managing a Morpheus Appliance.
     All communication with the remote appliance is done via the Morpheus API.
 
-    To get started, see the command `remote add` command.
+    Use the command `#{prog_name} remote add` to connect to your Morpheus appliance.
 
     To learn more, visit https://github.com/gomorpheus/morpheus-cli/wiki/Getting-Started
 
-    To learn more about the Morpheus Appliance, visit https://www.morpheusdata.com/features
+    To learn more about the Morpheus Appliance, visit https://www.morpheusdata.com
 
     To learn more about the Morpheus API, visit https://apidocs.morpheusdata.com
 
 ## GLOBAL OPTIONS
 
-    Morpheus supports a few global options.
+    There are several global options available.
 
     -v, --version                    Print the version.
         --noprofile                  Do not read and execute the personal initialization script .morpheus_profile
@@ -190,30 +222,42 @@ morpheus v#{Morpheus::Cli::VERSION}
 
 ## COMMON OPTIONS
 
-    There are some common options that many commands support. They work the same way for each command.
+    There are many common options that are supported by a most commands.
 
     -O, --option OPTION              Option value in the format -O var="value" (deprecated soon in favor of first class options)
     -N, --no-prompt                  Skip prompts. Use default values for all optional fields.
+        --payload FILE               Payload from a local JSON or YAML file, skip all prompting
+        --payload-dir DIRECTORY      Payload from a local directory containing 1-N JSON or YAML files, skip all prompting
+        --payload-json JSON          Payload JSON, skip all prompting
+        --payload-yaml YAML          Payload YAML, skip all prompting
     -j, --json                       JSON Output
     -d, --dry-run                    Dry Run, print the API request instead of executing it
-    -r, --remote REMOTE              Remote Appliance Name to use for this command. The active appliance is used by default.
-    -I, --insecure                   Allow for insecure HTTPS communication i.e. bad SSL certificate       
-    -y, --yes                        Auto confirm, skip any 'Are you sure?' confirmations.
-    -r, --quiet                      No Output, when successful.
+        --curl                       Dry Run to output API request as a curl command.
+        --scrub                      Mask secrets in output, such as the Authorization header. For use with --curl and --dry-run.
+    -r, --remote REMOTE              Remote name. The current remote is used by default.
+        --remote-url URL             Remote url. This allows adhoc requests instead of using a configured remote.
+    -T, --token TOKEN                Access token for authentication with --remote. Saved credentials are used by default.
+    -U, --username USERNAME          Username for authentication.
+    -P, --password PASSWORD          Password for authentication.
+    -I, --insecure                   Allow insecure HTTPS communication.  i.e. bad SSL certificate.
+    -H, --header HEADER              Additional HTTP header to include with requests.
+        --timeout SECONDS            Timeout for api requests. Default is typically 30 seconds.
+    -y, --yes                        Auto Confirm
+    -q, --quiet                      No Output, do not print to stdout
 
 ## MORPHEUS COMMANDS
 
-    We divide morpheus into commands.  
-    Every morpheus command may have 0-N sub-commands that it supports. 
+    The morpheus executable is divided into commands.
+    Each morpheus command may have 0-N sub-commands that it supports. 
     Commands generally map to the functionality provided in the Morpheus UI.
        
     You can get help for any morpheus command by using the -h option.
 
-    The available commands and their options are also documented below.
+    The available commands and their options are documented below.
 ENDTEXT
       
       terminal = Morpheus::Terminal.new($stdin, manpage)
-      Morpheus::Logging::DarkPrinter.puts "appending command help `morpheus --help`" if Morpheus::Logging.debug? && !options[:quiet]
+      Morpheus::Logging::DarkPrinter.puts "appending command help `#{prog_name} --help`" if Morpheus::Logging.debug? && !options[:quiet]
 
       manpage.print "\n"
       manpage.print "## morpheus\n"
@@ -226,7 +270,7 @@ ENDTEXT
       Morpheus::Cli::CliRegistry.all.keys.sort.each do |cmd|
         cmd_klass = Morpheus::Cli::CliRegistry.instance.get(cmd)
         cmd_instance = cmd_klass.new
-        Morpheus::Logging::DarkPrinter.puts "appending command help `morpheus #{cmd} --help`" if Morpheus::Logging.debug? && !options[:quiet]
+        Morpheus::Logging::DarkPrinter.puts "appending command help `#{prog_name} #{cmd} --help`" if Morpheus::Logging.debug? && !options[:quiet]
         #help_cmd = "morpheus #{cmd} --help"
         #help_output = `#{help_cmd}`
         manpage.print "\n"
@@ -243,7 +287,7 @@ ENDTEXT
         subcommands = cmd_klass.visible_subcommands
         if subcommands && subcommands.size > 0
           subcommands.sort.each do |subcommand, subcommand_method|
-            Morpheus::Logging::DarkPrinter.puts "appending command help `morpheus #{cmd} #{subcommand} --help`" if Morpheus::Logging.debug? && !options[:quiet]
+            Morpheus::Logging::DarkPrinter.puts "appending command help `#{prog_name} #{cmd} #{subcommand} --help`" if Morpheus::Logging.debug? && !options[:quiet]
             manpage.print "\n"
             manpage.print "#### morpheus #{cmd} #{subcommand}\n"
             manpage.print "\n"
@@ -289,7 +333,7 @@ morpheus> remote list
 Morpheus Appliances
 ==================
 
-You have no appliances configured. See the `remote add` command.
+You have no appliances configured. See the `#{prog_name} remote add` command.
 
 ```
 
@@ -319,11 +363,10 @@ The `appliances` YAML file contains a list of known appliances, keyed by name.
 Example:
 ```yaml
 :qa:
-  :host: https://qa.mycoolsite.com
+  :host: https://qa.mymorpheus.com
   :active: true
 :production:
-  :host: https://morpheus.mycoolsite.com
-  :active: false
+  :host: https://mymorpheus.com
 ```
 
 ### credentials file
@@ -349,7 +392,7 @@ This may be inhibited by using the `--noprofile` option.
 
 ### .morpheusrc file
 
-When started as an interactive shell with the `morpheus shell` command,
+When started as an interactive shell with the `#{prog_name} shell` command,
 Morpheus reads and executes `$MORPHEUS_CLI_HOME/.morpheusrc` (if it exists). This may be inhibited by using the `--norc` option. 
 
 An example startup script might look like this:
@@ -357,20 +400,11 @@ An example startup script might look like this:
 ```
 # .morpheusrc
 
-# aliases
-alias our-instances='instances list -c "Our Cloud"'
-
-# switch to our appliance that we created with `remote add morphapp1`
-remote use morphapp1
-
-# greeting
-echo "Welcome back human,  have fun!"
-
-# print current user information
-whoami
-
-# print the list of instances in our cloud
-our-instances
+set-prompt "%cyan%username%reset@%magenta%remote %cyanmorpheus> %reset"
+version
+remote current
+echo "Welcome back %username"
+echo
 
 ```
 
@@ -383,7 +417,7 @@ ENDTEXT
       terminal = Morpheus::Terminal.new()
     end
 
-    return true
+    return 0, nil
   end
 
 end