aspera-cli 4.0.0.pre2 → 4.2.0

data/docs/test_env.conf

@@ -1,16 +1,16 @@
 ---
 config:
-  version: 4.0.0.pre1
+  version: 4.0.0
 default:
   config: cli_default
-  aoc: tst_aoc
+  aoc: tst_aoc1
   faspex: tst_faspex
-  faspex5: tst_faspex5
-  shares: tst_shares
+  faspex5: tst_faspex5_boot
+  shares: tst_shares_1
   shares2: tst_shares2
   node: tst_node
   server: tst_server
-  orchestrator: orch_eudemo
+  orchestrator: tst_orch
   console: tst_console
   preview: tst_ak_preview
   ats: tst_ats
@@ -19,7 +19,6 @@ default:
 cli_default:
   interactive: your value here
   smtp: your value here
-  ascp_path: your value here
 local_user:
   ssh_keys: your value here
 smtp_config:
@@ -31,7 +30,7 @@ smtp_config:
   from_name: your value here
   username: your value here
   password: your value here
-tst_aoc:
+tst_aoc1:
   url: your value here
   username: your value here
   auth: your value here
@@ -48,10 +47,18 @@ tst_node_faspex:
   url: your value here
   username: your value here
   password: your value here
-tst_faspex5:
+tst_faspex5_boot:
   url: your value here
+  auth: your value here
   username: your value here
   password: your value here
+tst_faspex5:
+  url: your value here
+  auth: your value here
+  client_id: your value here
+  client_secret: your value here
+  private_key: your value here
+  username: your value here
 tst_shares:
   url: your value here
   username: your value here
@@ -79,7 +86,7 @@ tst_server:
 tst_server_bykey:
   url: your value here
   username: your value here
-orch_eudemo:
+tst_orch:
   url: your value here
   username: your value here
   password: your value here
@@ -94,6 +101,7 @@ tst_ak_preview:
   url: your value here
   username: your value here
   password: your value here
+  mimemagic: your value here
 tst_node_preview:
   url: your value here
   username: your value here
@@ -110,6 +118,8 @@ misc:
   faspex_publink_send_to_fxuser: your value here
   faspex_publink_send_to_dropbox: your value here
   shares_upload: your value here
+  console_smart_id: your value here
+  console_smart_file: your value here
   orch_workflow_id: your value here
   file_dcm: your value here
   file_pdf: your value here
@@ -122,6 +132,7 @@ misc:
   aoc_publink_recv_from_aocuser: your value here
   aoc_publink_send_shd_inbox: your value here
   aoc_publink_send_aoc_user: your value here
+  aoc_publink_send_use_pass: your value here
   aoc_publink_folder: your value here
   aoc_shbx_ws: your value here
   aoc_shbx_name: your value here
@@ -137,4 +148,5 @@ misc:
   email_internal: your value here
   email_external: your value here
   aoc_org: your value here
-  aoc_user: your value here
+  aoc_user_email: your value here
+  http_gw_fqdn_port: your value here

data/docs/transfer_spec.html

@@ -28,7 +28,7 @@ arg: related ascp argument or env var suffix (PASS for ASPERA_SCP_PASS)
 </p>
 <p>
 UNDER CONSTRUCTION<br/>
-<a href="https://developer.ibm.com/api/view/aspera-prod:ibm-aspera:title-IBM_Aspera#id90944">Documentation&rarr;Node API&rarr;/opt/transfers</a><br/>
+<a href="https://developer.ibm.com/apis/catalog/?search=aspera">Aspera API Documentation</a>&rarr;Node API&rarr;/opt/transfers<br/>
 </p>
 
 <table>

data/lib/aspera/aoc.rb

@@ -9,6 +9,8 @@ module Aspera
     private
     @@use_standard_ports = true
 
+    API_V1='api/v1'
+
     PRODUCT_NAME='Aspera on Cloud'
     # Production domain of AoC
     PROD_DOMAIN='ibmaspera.com'
@@ -42,11 +44,6 @@ module Aspera
     FILES_APP='files'
     PACKAGES_APP='packages'
 
-    CLIENT_RANDOM={
-      'aspera.global-cli-client' => 'frpmsRsG4mjZ0PlxCgdJlvONqBg4Vlpz_IX7gXmBMAfsgMLy2FO6CXLodKfKAuhqnCqSptLbe_wdmnm9JRuEPO-PpFqpq_Kb',
-      'aspera.drive' => 'UegzQ3LcbLht5dLYAXaR-7ZMnJ6-kwPEXWEXaqLSOMGmtzNA9r6kPFLElqBfq66BfgMabdO96k5sPXV-H8M3vsx9LbGlewF1'
-    }
-
     def self.get_client_info(client_name=CLIENT_APPS.first)
       client_index=CLIENT_APPS.index(client_name)
       raise "no such pre-defined client: #{client_name}" if client_index.nil?
@@ -68,9 +65,14 @@ module Aspera
       return organization,instance_domain
     end
 
+    # base API url depends on domain, which could be "qa.xxx"
+    def self.api_base_url(api_domain=PROD_DOMAIN)
+      return "https://api.#{api_domain}"
+    end
+
     def self.metering_api(entitlement_id,customer_id,api_domain=PROD_DOMAIN)
       return Rest.new({
-        :base_url => "https://api.#{api_domain}/metering/v1",
+        :base_url => "#{api_base_url(api_domain)}/metering/v1",
         :headers  => {'X-Aspera-Entitlement-Authorization' => Rest.basic_creds(entitlement_id,customer_id)}
       })
     end
@@ -121,12 +123,12 @@ module Aspera
       raise RuntimeError,'too many redirections'
     end
 
-    # @param :link,:url,:auth,:client_id,:client_secret,:scope,:redirect_uri,:private_key,:username,:subpath
+    # @param :link,:url,:auth,:client_id,:client_secret,:scope,:redirect_uri,:private_key,:username,:subpath,:password (for pub link)
     def initialize(opt)
       # access key secrets are provided out of band to get node api access
       # key: access key
       # value: associated secret
-      @secrets={}
+      @key_chain=nil
 
       # init rest params
       aoc_rest_p={:auth=>{:type =>:oauth2}}
@@ -147,12 +149,12 @@ module Aspera
 
       # get org name and domain from url
       organization,instance_domain=self.class.parse_url(opt[:url])
-      # this is the base API url (depends on domain, which could be "qa.xxx")
-      api_base_url="https://api.#{instance_domain}"
-      # base API URL
-      aoc_rest_p[:base_url]="#{api_base_url}/#{opt[:subpath]}"
+      # this is the base API url
+      api_url_base=self.class.api_base_url(instance_domain)
+      # API URL, including subpath (version ...)
+      aoc_rest_p[:base_url]="#{api_url_base}/#{opt[:subpath]}"
       # base auth URL
-      aoc_auth_p[:base_url] = "#{api_base_url}/#{OAUTH_API_SUBPATH}/#{organization}"
+      aoc_auth_p[:base_url] = "#{api_url_base}/#{OAUTH_API_SUBPATH}/#{organization}"
       aoc_auth_p[:client_id]=opt[:client_id]
       aoc_auth_p[:client_secret] = opt[:client_secret]
 
@@ -185,23 +187,19 @@ module Aspera
         aoc_auth_p[:jwt_subject]         = opt[:username]
         aoc_auth_p[:jwt_private_key_obj] = OpenSSL::PKey::RSA.new(private_key_PEM_string)
       when :url_token
+        aoc_auth_p[:password]=opt[:password] unless opt[:password].nil?
         # nothing more
       else raise "ERROR: unsupported auth method: #{aoc_auth_p[:grant]}"
       end
       super(aoc_rest_p)
     end
 
-    def add_secrets(secrets)
-      @secrets.merge!(secrets)
-      Log.log.debug("now secrets:#{secrets}")
+    def key_chain=(keychain)
+      raise "keychain already set" unless @key_chain.nil?
+      @key_chain=keychain
       nil
     end
 
-    def has_secret(ak)
-      Log.log.debug("has key:#{ak} -> #{@secrets.has_key?(ak)}")
-      return @secrets.has_key?(ak)
-    end
-
     # additional transfer spec (tags) for package information
     def self.package_tags(package_info,operation)
       return {'tags'=>{'aspera'=>{'files'=>{
@@ -293,13 +291,14 @@ module Aspera
     # no scope: requires secret
     # if secret provided beforehand: use it
     def get_node_api(node_info,node_scope=nil)
+      # X-Aspera-AccessKey required for bearer token only
       node_rest_params={
         :base_url => node_info['url'],
         :headers  => {'X-Aspera-AccessKey'=>node_info['access_key']},
       }
-      ak_secret=@secrets[node_info['access_key']]
+      ak_secret=@key_chain.get_secret(node_info['access_key'],false)
       if ak_secret.nil? and node_scope.nil?
-        raise 'There must be at least one of: secret, node scope'
+        raise "There must be at least one of: 'secret' or 'scope' for access key #{node_info['access_key']}"
       end
       # if secret provided on command line or if there is no scope
       if !ak_secret.nil? or node_scope.nil?
@@ -312,7 +311,7 @@ module Aspera
         node_rest_params[:auth]=self.params[:auth].clone
         node_rest_params[:auth][:scope]=self.class.node_scope(node_info['access_key'],node_scope)
       end
-      return Rest.new(node_rest_params)
+      return Node.new(node_rest_params)
     end
 
     # check that parameter has necessary types
@@ -328,102 +327,82 @@ module Aspera
       return node_info,file_id
     end
 
-    # returns node api and folder_id from soft link
-    def read_asplnk(current_file_info)
-      new_node_api=get_node_api(self.read("nodes/#{current_file_info['target_node_id']}")[:data],SCOPE_NODE_USER)
-      return {:node_api=>new_node_api,:folder_id=>current_file_info['target_id']}
+    # add entry to list if test block is success
+    def process_find_files(entry,path)
+      begin
+        # add to result if match filter
+        @find_state[:found].push(entry.merge({'path'=>path})) if @find_state[:test_block].call(entry)
+        # process link
+        if entry[:type].eql?('link')
+          sub_node_info=self.read("nodes/#{entry['target_node_id']}")[:data]
+          sub_opt={method: process_find_files, top_file_id: entry['target_id'], top_file_path: path}
+          get_node_api(sub_node_info,SCOPE_NODE_USER).crawl(self,sub_opt)
+        end
+      rescue => e
+        Log.log.error("#{path}: #{e.message}")
+      end
+      # process all folders
+      return true
     end
 
-    # @returns list of file paths that match given regex
     def find_files( top_node_file, test_block )
       top_node_info,top_file_id=check_get_node_file(top_node_file)
       Log.log.debug("find_files: node_info=#{top_node_info}, fileid=#{top_file_id}")
-      result=[]
-      top_node_api=get_node_api(top_node_info,SCOPE_NODE_USER)
-      # initialize loop elements : list of folders to scan
-      # Note: top file id is necessarily a folder
-      items_to_explore=[{:node_api=>top_node_api,:folder_id=>top_file_id,:path=>''}]
-
-      while !items_to_explore.empty? do
-        current_item = items_to_explore.shift
-        Log.log.debug("searching #{current_item[:path]}".bg_green)
-        # get folder content
-        begin
-          folder_contents = current_item[:node_api].read("files/#{current_item[:folder_id]}/files")[:data]
-        rescue => e
-          Log.log.warn("#{current_item[:path]}: #{e.message}")
-          folder_contents=[]
+      @find_state={found: [], test_block: test_block}
+      get_node_api(top_node_info,SCOPE_NODE_USER).crawl(self,{method: :process_find_files, top_file_id: top_file_id})
+      result=@find_state[:found]
+      @find_state=nil
+      return result
+    end
+
+    def process_resolve_node_file(entry,path)
+      # stop digging here if not in right path
+      return false unless entry['name'].eql?(@resolve_state[:path].first)
+      # ok it matches, so we remove the match
+      @resolve_state[:path].shift
+      case entry['type']
+      when 'file'
+        # file must be terminal
+        raise "#{entry['name']} is a file, expecting folder to find: #{@resolve_state[:path]}" unless @resolve_state[:path].empty?
+        @resolve_state[:result][:file_id]=entry['id']
+      when 'link'
+        @resolve_state[:result][:node_info]=self.read("nodes/#{entry['target_node_id']}")[:data]
+        if @resolve_state[:path].empty?
+          @resolve_state[:result][:file_id]=entry['target_id']
+        else
+          get_node_api(@resolve_state[:result][:node_info],SCOPE_NODE_USER).crawl(self,{method: :process_resolve_node_file, top_file_id: entry['target_id']})
         end
-        # TODO: check if this is a folder or file ?
-        Log.dump(:folder_contents,folder_contents)
-        folder_contents.each do |current_file_info|
-          item_path=File.join(current_item[:path],current_file_info['name'])
-          Log.log.debug("looking #{item_path}".bg_green)
-          begin
-            # does item match ?
-            result.push(current_file_info.merge({'path'=>item_path})) if test_block.call(current_file_info)
-            # does it need further processing ?
-            case current_file_info['type']
-            when 'file'
-              Log.log.debug("testing : #{current_file_info['name']}")
-            when 'folder'
-              items_to_explore.push({:node_api=>current_item[:node_api],:folder_id=>current_file_info['id'],:path=>item_path})
-            when 'link' # .*.asp-lnk
-              items_to_explore.push(read_asplnk(current_file_info).merge({:path=>item_path}))
-            else
-              Log.log.error("unknown folder item type: #{current_file_info['type']}")
-            end
-          rescue => e
-            Log.log.error("#{item_path}: #{e.message}")
-          end
+      when 'folder'
+        if @resolve_state[:path].empty?
+          # found: store
+          @resolve_state[:result][:file_id]=entry['id']
+          return false
         end
+      else
+        Log.log.warn("unknown element type: #{entry['type']}")
       end
-      return result
+      # continue to dig folder
+      return true
     end
 
-    # @return node information (returned by API) and file id, from a "/" based path
+    # @return Array(node_info,file_id)   for the given path
+    # @param top_node_file       Array    [root node,file id]
+    # @param element_path_string String   path of element
     # supports links to secondary nodes
-    # input: Array(root node,file id), String path
-    # output: Array(node_info,file_id)   for the given path
-    def resolve_node_file( top_node_file, element_path_string='' )
-      Log.log.debug("resolve_node_file: top_node_file=#{top_node_file}, path=#{element_path_string}")
-      # initialize loop invariants
-      current_node_info,current_file_id=check_get_node_file(top_node_file)
-      items_to_explore=element_path_string.split(PATH_SEPARATOR).select{|i| !i.empty?}
-
-      while !items_to_explore.empty? do
-        current_item = items_to_explore.shift
-        Log.log.debug "searching #{current_item}".bg_green
-        # get API if changed
-        current_node_api=get_node_api(current_node_info,SCOPE_NODE_USER) if current_node_api.nil?
-        # get folder content
-        folder_contents = current_node_api.read("files/#{current_file_id}/files")
-        Log.dump(:folder_contents,folder_contents)
-        matching_folders = folder_contents[:data].select { |i| i['name'].eql?(current_item)}
-        #Log.log.debug "matching_folders: #{matching_folders}"
-        raise "no such folder: #{current_item} in #{folder_contents[:data].map { |i| i['name']}}" if matching_folders.empty?
-        current_file_info = matching_folders.first
-        # process type of file
-        case current_file_info['type']
-        when 'file'
-          current_file_id=current_file_info['id']
-          # a file shall be terminal
-          if !items_to_explore.empty? then
-            raise "#{current_item} is a file, expecting folder to find: #{items_to_explore}"
-          end
-        when 'link'
-          current_node_info=self.read("nodes/#{current_file_info['target_node_id']}")[:data]
-          current_file_id=current_file_info['target_id']
-          # need to switch node
-          current_node_api=nil
-        when 'folder'
-          current_file_id=current_file_info['id']
-        else
-          Log.log.warn("unknown element type: #{current_file_info['type']}")
-        end
+    def resolve_node_file( top_node_file, element_path_string )
+      top_node_info,top_file_id=check_get_node_file(top_node_file)
+      path_elements=element_path_string.split(PATH_SEPARATOR).select{|i| !i.empty?}
+      result={node_info: top_node_info, file_id: nil}
+      if path_elements.empty?
+        result[:file_id]=top_file_id
+      else
+        @resolve_state={path: path_elements, result: result}
+        get_node_api(top_node_info,SCOPE_NODE_USER).crawl(self,{method: :process_resolve_node_file, top_file_id: top_file_id})
+        not_found=@resolve_state[:path]
+        @resolve_state=nil
+        raise "entry not found: #{not_found}" if result[:file_id].nil?
       end
-      Log.log.info("resolve_node_file(#{element_path_string}): file_id=#{current_file_id},node_info=#{current_node_info}")
-      return {node_info: current_node_info, file_id: current_file_id}
+      return result
     end
 
   end # AoC

data/lib/aspera/cli/formater.rb

@@ -151,6 +151,8 @@ module Aspera
             else
               if user_asked_fields_list_str.start_with?('+')
                 result_default_fields(results,table_rows_hash_val).push(*user_asked_fields_list_str.gsub(/^\+/,'').split(','))
+              elsif user_asked_fields_list_str.start_with?('-')
+                result_default_fields(results,table_rows_hash_val).select{|i| ! user_asked_fields_list_str.gsub(/^\-/,'').split(',').include?(i)}
               else
                 user_asked_fields_list_str.split(',')
               end

data/lib/aspera/cli/main.rb

@@ -10,6 +10,7 @@ require 'aspera/persistency_folder'
 require 'aspera/log'
 require 'aspera/rest'
 require 'aspera/nagios'
+require 'aspera/secrets'
 
 module Aspera
   module Cli
@@ -21,18 +22,9 @@ module Aspera
       # name of application, also foldername where config is stored
       PROGRAM_NAME = 'ascli'
       GEM_NAME = 'aspera-cli'
-      # Container module of current class : Aspera::Cli
-      CLI_MODULE=Module.nesting[1].to_s
-      # Path to Plugin classes: Aspera::Cli::Plugins
-      PLUGINS_MODULE=CLI_MODULE+'::Plugins'
       VERBOSE_LEVELS=[:normal,:minimal,:quiet]
 
-      private_constant :PROGRAM_NAME,:GEM_NAME,:CLI_MODULE,:PLUGINS_MODULE,:VERBOSE_LEVELS
-
-      # find the root folder of gem where this class is
-      def self.gem_root
-        File.expand_path(CLI_MODULE.to_s.gsub('::','/').gsub(%r([^/]+),'..'),File.dirname(__FILE__))
-      end
+      private_constant :PROGRAM_NAME,:GEM_NAME,:VERBOSE_LEVELS
 
       # =============================================================
       # Parameter handlers
@@ -62,13 +54,22 @@ module Aspera
         @help_url='http://www.rubydoc.info/gems/'+GEM_NAME
         @gem_url='https://rubygems.org/gems/'+GEM_NAME
         # give command line arguments to option manager (no parsing)
-        @plugin_env[:options]=@opt_mgr=Manager.new(self.program_name,argv,app_banner())
+        app_main_folder=ENV[conf_dir_env_var]
+        # if env var undefined or empty
+        if app_main_folder.nil? or app_main_folder.empty?
+          user_home_folder=Dir.home
+          raise CliError,"Home folder does not exist: #{user_home_folder}. Check your user environment or use #{conf_dir_env_var}." unless Dir.exist?(user_home_folder)
+          app_main_folder=File.join(user_home_folder,Plugins::Config::ASPERA_HOME_FOLDER_NAME,PROGRAM_NAME)
+        end
+        @plugin_env[:options]=@opt_mgr=Manager.new(PROGRAM_NAME,argv,app_banner())
         @plugin_env[:formater]=Formater.new(@plugin_env[:options])
-        Rest.user_agent=self.program_name
+        Rest.user_agent=PROGRAM_NAME
         # must override help methods before parser called (in other constructors)
         init_global_options()
+        # secret manager
+        @plugin_env[:secret]=Aspera::Secrets.new
         # the Config plugin adds the @preset parser
-        @plugin_env[:config]=Plugins::Config.new(@plugin_env,self.program_name,@help_url,Aspera::Cli::VERSION)
+        @plugin_env[:config]=Plugins::Config.new(@plugin_env,PROGRAM_NAME,@help_url,Aspera::Cli::VERSION,app_main_folder)
         # the TransferAgent plugin may use the @preset parser
         @plugin_env[:transfer]=TransferAgent.new(@plugin_env)
         Log.log.debug('created plugin env'.red)
@@ -82,21 +83,21 @@ module Aspera
       end
 
       def app_banner
-        banner = "NAME\n\t#{self.program_name} -- a command line tool for Aspera Applications (v#{Aspera::Cli::VERSION})\n\n"
+        banner = "NAME\n\t#{PROGRAM_NAME} -- a command line tool for Aspera Applications (v#{Aspera::Cli::VERSION})\n\n"
         banner << "SYNOPSIS\n"
-        banner << "\t#{self.program_name} COMMANDS [OPTIONS] [ARGS]\n"
-        banner << "\n"
-        banner << "DESCRIPTION\n"
+        banner << "\t#{PROGRAM_NAME} COMMANDS [OPTIONS] [ARGS]\n"
+        banner << "\nDESCRIPTION\n"
         banner << "\tUse Aspera application to perform operations on command line.\n"
         banner << "\tDocumentation and examples: #{@gem_url}\n"
-        banner << "\texecute: #{self.program_name} conf doc\n"
+        banner << "\texecute: #{PROGRAM_NAME} conf doc\n"
         banner << "\tor visit: #{@help_url}\n"
-        banner << "\n"
-        banner << "COMMANDS\n"
-        banner << "\tTo list first level commands, execute: #{self.program_name}\n"
+        banner << "\nENVIRONMENT VARIABLES\n"
+        banner << "\t#{conf_dir_env_var}  config folder, default: $HOME/#{Plugins::Config::ASPERA_HOME_FOLDER_NAME}/#{PROGRAM_NAME}\n"
+        banner << "\t#any option can be set as an environment variable, refer to the manual\n"
+        banner << "\nCOMMANDS\n"
+        banner << "\tTo list first level commands, execute: #{PROGRAM_NAME}\n"
         banner << "\tNote that commands can be written shortened (provided it is unique).\n"
-        banner << "\n"
-        banner << "OPTIONS\n"
+        banner << "\nOPTIONS\n"
         banner << "\tOptions begin with a '-' (minus), and value is provided on command line.\n"
         banner << "\tSpecial values are supported beginning with special prefix, like: #{ExtendedValue.instance.modifiers.map{|m|"@#{m}:"}.join(' ')}.\n"
         banner << "\tDates format is 'DD-MM-YY HH:MM:SS', or 'now' or '-<num>h'\n\n"
@@ -140,7 +141,7 @@ module Aspera
         require @plugin_env[:config].plugins[plugin_name_sym][:require_stanza]
         # load default params only if no param already loaded before plugin instanciation
         env[:config].add_plugin_default_preset(plugin_name_sym)
-        command_plugin=Object::const_get(PLUGINS_MODULE+'::'+plugin_name_sym.to_s.capitalize).new(env)
+        command_plugin=Plugins::Config.plugin_new(plugin_name_sym,env)
         Log.log.debug("got #{command_plugin.class}")
         # TODO: check that ancestor is Plugin?
         return command_plugin
@@ -176,7 +177,7 @@ module Aspera
             # override main option parser with a brand new, to avoid having global options
             plugin_env=@plugin_env.clone
             plugin_env[:man_only]=true
-            plugin_env[:options]=Manager.new(self.program_name,[],'')
+            plugin_env[:options]=Manager.new(PROGRAM_NAME,[],'')
             get_plugin_instance_with_options(plugin_name_sym,plugin_env)
             # display generated help for plugin options
             @plugin_env[:formater].display_message(:error,plugin_env[:options].parser.to_s)
@@ -187,10 +188,14 @@ module Aspera
 
       protected
 
+      def conf_dir_env_var
+        return "#{PROGRAM_NAME}_home".upcase
+      end
+
       # early debug for parser
       # Note: does not accept shortcuts
       def early_debug_setup(argv)
-        Log.instance.program_name=self.program_name
+        Log.instance.program_name=PROGRAM_NAME
         argv.each do |arg|
           case arg
           when '--'
@@ -214,10 +219,6 @@ module Aspera
         return Main.result_nothing
       end
 
-      def options;@opt_mgr;end
-
-      def program_name;PROGRAM_NAME;end
-
       # this is the main function called by initial script just after constructor
       def process_command_line
         Log.log.debug('process_command_line')
@@ -231,16 +232,7 @@ module Aspera
           # load global default options and process
           @plugin_env[:config].add_plugin_default_preset(Plugins::Config::CONF_GLOBAL_SYM)
           @opt_mgr.parse_options!
-          # dual execution locking
-          lock_port=@opt_mgr.get_option(:lock_port,:optional)
-          if !lock_port.nil?
-            begin
-              # no need to close later, will be freed on process exit. must save in member else it is garbage collected
-              @tcp_server=TCPServer.new('127.0.0.1',lock_port.to_i)
-            rescue => e
-              raise CliError,"Another instance is already running (lock port=#{lock_port})."
-            end
-          end
+          @plugin_env[:config].periodic_check_newer_gem_version
           if @option_show_config and @opt_mgr.command_or_arg_empty?
             command_sym=Plugins::Config::CONF_PLUGIN_SYM
           else
@@ -264,6 +256,17 @@ module Aspera
             @plugin_env[:formater].display_results({:type=>:single_object,:data=>@opt_mgr.declared_options(false)})
             Process.exit(0)
           end
+          # locking for singkle execution (only after "per plugin" option, in case lock port is there)
+          lock_port=@opt_mgr.get_option(:lock_port,:optional)
+          if !lock_port.nil?
+            begin
+              # no need to close later, will be freed on process exit. must save in member else it is garbage collected
+              Log.log.debug("Opening lock port #{lock_port.to_i}")
+              @tcp_server=TCPServer.new('127.0.0.1',lock_port.to_i)
+            rescue => e
+              raise CliError,"Another instance is already running (#{e.message})."
+            end
+          end
           # execute and display
           @plugin_env[:formater].display_results(command_plugin.execute_action)
           # finish
@@ -271,11 +274,11 @@ module Aspera
         rescue CliBadArgument => e;          exception_info=[e,'Argument',:usage]
         rescue CliNoSuchId => e;             exception_info=[e,'Identifier']
         rescue CliError => e;                exception_info=[e,'Tool',:usage]
-        rescue Fasp::Error => e;             exception_info=[e,"FASP(ascp]"]
-        rescue Aspera::RestCallError => e; exception_info=[e,"Rest"]
-        rescue SocketError => e;             exception_info=[e,"Network"]
-        rescue StandardError => e;           exception_info=[e,"Other",:debug]
-        rescue Interrupt => e;               exception_info=[e,"Interruption",:debug]
+        rescue Fasp::Error => e;             exception_info=[e,'FASP(ascp)']
+        rescue Aspera::RestCallError => e;   exception_info=[e,'Rest']
+        rescue SocketError => e;             exception_info=[e,'Network']
+        rescue StandardError => e;           exception_info=[e,'Other',:debug]
+        rescue Interrupt => e;               exception_info=[e,'Interruption',:debug]
         end
         # cleanup file list files
         TempFileManager.instance.cleanup