Merge branch 'master' into 8099-babysit-all-srun
[arvados.git] / services / api / lib / crunch_dispatch.rb
1 require 'open3'
2 require 'shellwords'
3
4 class CrunchDispatch
5   extend DbCurrentTime
6   include ApplicationHelper
7   include Process
8
9   EXIT_TEMPFAIL = 75
10   EXIT_RETRY_UNLOCKED = 93
11   RETRY_UNLOCKED_LIMIT = 3
12
13   class LogTime < Time
14     def to_s
15       self.utc.strftime "%Y-%m-%d_%H:%M:%S"
16     end
17   end
18
19   def initialize
20     @crunch_job_bin = (ENV['CRUNCH_JOB_BIN'] || `which arv-crunch-job`.strip)
21     if @crunch_job_bin.empty?
22       raise "No CRUNCH_JOB_BIN env var, and crunch-job not in path."
23     end
24
25     @docker_bin = ENV['CRUNCH_JOB_DOCKER_BIN']
26     @docker_run_args = ENV['CRUNCH_JOB_DOCKER_RUN_ARGS']
27     @cgroup_root = ENV['CRUNCH_CGROUP_ROOT']
28
29     @arvados_internal = Rails.configuration.git_internal_dir
30     if not File.exists? @arvados_internal
31       $stderr.puts `mkdir -p #{@arvados_internal.shellescape} && git init --bare #{@arvados_internal.shellescape}`
32       raise "No internal git repository available" unless ($? == 0)
33     end
34
35     @repo_root = Rails.configuration.git_repositories_dir
36     @arvados_repo_path = Repository.where(name: "arvados").first.server_path
37     @authorizations = {}
38     @did_recently = {}
39     @fetched_commits = {}
40     @git_tags = {}
41     @node_state = {}
42     @pipe_auth_tokens = {}
43     @running = {}
44     @todo = []
45     @todo_job_retries = {}
46     @job_retry_counts = Hash.new(0)
47     @todo_pipelines = []
48   end
49
50   def sysuser
51     return act_as_system_user
52   end
53
54   def refresh_todo
55     if @runoptions[:jobs]
56       @todo = @todo_job_retries.values + Job.queue.select(&:repository)
57     end
58     if @runoptions[:pipelines]
59       @todo_pipelines = PipelineInstance.queue
60     end
61   end
62
63   def each_slurm_line(cmd, outfmt, max_fields=nil)
64     max_fields ||= outfmt.split(":").size
65     max_fields += 1  # To accommodate the node field we add
66     @@slurm_version ||= Gem::Version.new(`sinfo --version`.match(/\b[\d\.]+\b/)[0])
67     if Gem::Version.new('2.3') <= @@slurm_version
68       `#{cmd} --noheader -o '%n:#{outfmt}'`.each_line do |line|
69         yield line.chomp.split(":", max_fields)
70       end
71     else
72       # Expand rows with hostname ranges (like "foo[1-3,5,9-12]:idle")
73       # into multiple rows with one hostname each.
74       `#{cmd} --noheader -o '%N:#{outfmt}'`.each_line do |line|
75         tokens = line.chomp.split(":", max_fields)
76         if (re = tokens[0].match /^(.*?)\[([-,\d]+)\]$/)
77           tokens.shift
78           re[2].split(",").each do |range|
79             range = range.split("-").collect(&:to_i)
80             (range[0]..range[-1]).each do |n|
81               yield [re[1] + n.to_s] + tokens
82             end
83           end
84         else
85           yield tokens
86         end
87       end
88     end
89   end
90
91   def slurm_status
92     slurm_nodes = {}
93     each_slurm_line("sinfo", "%t") do |hostname, state|
94       # Treat nodes in idle* state as down, because the * means that slurm
95       # hasn't been able to communicate with it recently.
96       state.sub!(/^idle\*/, "down")
97       state.sub!(/\W+$/, "")
98       state = "down" unless %w(idle alloc down).include?(state)
99       slurm_nodes[hostname] = {state: state, job: nil}
100     end
101     each_slurm_line("squeue", "%j") do |hostname, job_uuid|
102       slurm_nodes[hostname][:job] = job_uuid if slurm_nodes[hostname]
103     end
104     slurm_nodes
105   end
106
107   def update_node_status
108     return unless Server::Application.config.crunch_job_wrapper.to_s.match /^slurm/
109     slurm_status.each_pair do |hostname, slurmdata|
110       next if @node_state[hostname] == slurmdata
111       begin
112         node = Node.where('hostname=?', hostname).order(:last_ping_at).last
113         if node
114           $stderr.puts "dispatch: update #{hostname} state to #{slurmdata}"
115           node.info["slurm_state"] = slurmdata[:state]
116           node.job_uuid = slurmdata[:job]
117           if node.save
118             @node_state[hostname] = slurmdata
119           else
120             $stderr.puts "dispatch: failed to update #{node.uuid}: #{node.errors.messages}"
121           end
122         elsif slurmdata[:state] != 'down'
123           $stderr.puts "dispatch: SLURM reports '#{hostname}' is not down, but no node has that name"
124         end
125       rescue => error
126         $stderr.puts "dispatch: error updating #{hostname} node status: #{error}"
127       end
128     end
129   end
130
131   def positive_int(raw_value, default=nil)
132     value = begin raw_value.to_i rescue 0 end
133     if value > 0
134       value
135     else
136       default
137     end
138   end
139
140   NODE_CONSTRAINT_MAP = {
141     # Map Job runtime_constraints keys to the corresponding Node info key.
142     'min_ram_mb_per_node' => 'total_ram_mb',
143     'min_scratch_mb_per_node' => 'total_scratch_mb',
144     'min_cores_per_node' => 'total_cpu_cores',
145   }
146
147   def nodes_available_for_job_now(job)
148     # Find Nodes that satisfy a Job's runtime constraints (by building
149     # a list of Procs and using them to test each Node).  If there
150     # enough to run the Job, return an array of their names.
151     # Otherwise, return nil.
152     need_procs = NODE_CONSTRAINT_MAP.each_pair.map do |job_key, node_key|
153       Proc.new do |node|
154         positive_int(node.properties[node_key], 0) >=
155           positive_int(job.runtime_constraints[job_key], 0)
156       end
157     end
158     min_node_count = positive_int(job.runtime_constraints['min_nodes'], 1)
159     usable_nodes = []
160     Node.all.select do |node|
161       node.info['slurm_state'] == 'idle'
162     end.sort_by do |node|
163       # Prefer nodes with no price, then cheap nodes, then expensive nodes
164       node.properties['cloud_node']['price'].to_f rescue 0
165     end.each do |node|
166       if need_procs.select { |need_proc| not need_proc.call(node) }.any?
167         # At least one runtime constraint is not satisfied by this node
168         next
169       end
170       usable_nodes << node
171       if usable_nodes.count >= min_node_count
172         return usable_nodes.map { |node| node.hostname }
173       end
174     end
175     nil
176   end
177
178   def nodes_available_for_job(job)
179     # Check if there are enough idle nodes with the Job's minimum
180     # hardware requirements to run it.  If so, return an array of
181     # their names.  If not, up to once per hour, signal start_jobs to
182     # hold off launching Jobs.  This delay is meant to give the Node
183     # Manager an opportunity to make new resources available for new
184     # Jobs.
185     #
186     # The exact timing parameters here might need to be adjusted for
187     # the best balance between helping the longest-waiting Jobs run,
188     # and making efficient use of immediately available resources.
189     # These are all just first efforts until we have more data to work
190     # with.
191     nodelist = nodes_available_for_job_now(job)
192     if nodelist.nil? and not did_recently(:wait_for_available_nodes, 3600)
193       $stderr.puts "dispatch: waiting for nodes for #{job.uuid}"
194       @node_wait_deadline = Time.now + 5.minutes
195     end
196     nodelist
197   end
198
199   def fail_job job, message, skip_lock: false
200     $stderr.puts "dispatch: #{job.uuid}: #{message}"
201     begin
202       Log.new(object_uuid: job.uuid,
203               event_type: 'dispatch',
204               owner_uuid: job.owner_uuid,
205               summary: message,
206               properties: {"text" => message}).save!
207     rescue
208       $stderr.puts "dispatch: log.create failed"
209     end
210
211     if not skip_lock and not have_job_lock?(job)
212       begin
213         job.lock @authorizations[job.uuid].user.uuid
214       rescue ArvadosModel::AlreadyLockedError
215         $stderr.puts "dispatch: tried to mark job #{job.uuid} as failed but it was already locked by someone else"
216         return
217       end
218     end
219
220     job.state = "Failed"
221     if not job.save
222       $stderr.puts "dispatch: save failed setting job #{job.uuid} to failed"
223     end
224   end
225
226   def stdout_s(cmd_a, opts={})
227     IO.popen(cmd_a, "r", opts) do |pipe|
228       return pipe.read.chomp
229     end
230   end
231
232   def git_cmd(*cmd_a)
233     ["git", "--git-dir=#{@arvados_internal}"] + cmd_a
234   end
235
236   def get_authorization(job)
237     if @authorizations[job.uuid] and
238         @authorizations[job.uuid].user.uuid != job.modified_by_user_uuid
239       # We already made a token for this job, but we need a new one
240       # because modified_by_user_uuid has changed (the job will run
241       # as a different user).
242       @authorizations[job.uuid].update_attributes expires_at: Time.now
243       @authorizations[job.uuid] = nil
244     end
245     if not @authorizations[job.uuid]
246       auth = ApiClientAuthorization.
247         new(user: User.where('uuid=?', job.modified_by_user_uuid).first,
248             api_client_id: 0)
249       if not auth.save
250         $stderr.puts "dispatch: auth.save failed for #{job.uuid}"
251       else
252         @authorizations[job.uuid] = auth
253       end
254     end
255     @authorizations[job.uuid]
256   end
257
258   def internal_repo_has_commit? sha1
259     if (not @fetched_commits[sha1] and
260         sha1 == stdout_s(git_cmd("rev-list", "-n1", sha1), err: "/dev/null") and
261         $? == 0)
262       @fetched_commits[sha1] = true
263     end
264     return @fetched_commits[sha1]
265   end
266
267   def get_commit src_repo, sha1
268     return true if internal_repo_has_commit? sha1
269
270     # commit does not exist in internal repository, so import the
271     # source repository using git fetch-pack
272     cmd = git_cmd("fetch-pack", "--no-progress", "--all", src_repo)
273     $stderr.puts "dispatch: #{cmd}"
274     $stderr.puts(stdout_s(cmd))
275     @fetched_commits[sha1] = ($? == 0)
276   end
277
278   def tag_commit(commit_hash, tag_name)
279     # @git_tags[T]==V if we know commit V has been tagged T in the
280     # arvados_internal repository.
281     if not @git_tags[tag_name]
282       cmd = git_cmd("tag", tag_name, commit_hash)
283       $stderr.puts "dispatch: #{cmd}"
284       $stderr.puts(stdout_s(cmd, err: "/dev/null"))
285       unless $? == 0
286         # git tag failed.  This may be because the tag already exists, so check for that.
287         tag_rev = stdout_s(git_cmd("rev-list", "-n1", tag_name))
288         if $? == 0
289           # We got a revision back
290           if tag_rev != commit_hash
291             # Uh oh, the tag doesn't point to the revision we were expecting.
292             # Someone has been monkeying with the job record and/or git.
293             fail_job job, "Existing tag #{tag_name} points to commit #{tag_rev} but expected commit #{commit_hash}"
294             return nil
295           end
296           # we're okay (fall through to setting @git_tags below)
297         else
298           # git rev-list failed for some reason.
299           fail_job job, "'git tag' for #{tag_name} failed but did not find any existing tag using 'git rev-list'"
300           return nil
301         end
302       end
303       # 'git tag' was successful, or there is an existing tag that points to the same revision.
304       @git_tags[tag_name] = commit_hash
305     elsif @git_tags[tag_name] != commit_hash
306       fail_job job, "Existing tag #{tag_name} points to commit #{@git_tags[tag_name]} but this job uses commit #{commit_hash}"
307       return nil
308     end
309     @git_tags[tag_name]
310   end
311
312   def start_jobs
313     @todo.each do |job|
314       next if @running[job.uuid]
315
316       cmd_args = nil
317       case Server::Application.config.crunch_job_wrapper
318       when :none
319         if @running.size > 0
320             # Don't run more than one at a time.
321             return
322         end
323         cmd_args = []
324       when :slurm_immediate
325         nodelist = nodes_available_for_job(job)
326         if nodelist.nil?
327           if Time.now < @node_wait_deadline
328             break
329           else
330             next
331           end
332         end
333         cmd_args = ["salloc",
334                     "--chdir=/",
335                     "--immediate",
336                     "--exclusive",
337                     "--no-kill",
338                     "--job-name=#{job.uuid}",
339                     "--nodelist=#{nodelist.join(',')}"]
340       else
341         raise "Unknown crunch_job_wrapper: #{Server::Application.config.crunch_job_wrapper}"
342       end
343
344       cmd_args = sudo_preface + cmd_args
345
346       next unless get_authorization job
347
348       ready = internal_repo_has_commit? job.script_version
349
350       if not ready
351         # Import the commit from the specified repository into the
352         # internal repository. This should have been done already when
353         # the job was created/updated; this code is obsolete except to
354         # avoid deployment races. Failing the job would be a
355         # reasonable thing to do at this point.
356         repo = Repository.where(name: job.repository).first
357         if repo.nil? or repo.server_path.nil?
358           fail_job job, "Repository #{job.repository} not found under #{@repo_root}"
359           next
360         end
361         ready &&= get_commit repo.server_path, job.script_version
362         ready &&= tag_commit job.script_version, job.uuid
363       end
364
365       # This should be unnecessary, because API server does it during
366       # job create/update, but it's still not a bad idea to verify the
367       # tag is correct before starting the job:
368       ready &&= tag_commit job.script_version, job.uuid
369
370       # The arvados_sdk_version doesn't support use of arbitrary
371       # remote URLs, so the requested version isn't necessarily copied
372       # into the internal repository yet.
373       if job.arvados_sdk_version
374         ready &&= get_commit @arvados_repo_path, job.arvados_sdk_version
375         ready &&= tag_commit job.arvados_sdk_version, "#{job.uuid}-arvados-sdk"
376       end
377
378       if not ready
379         fail_job job, "commit not present in internal repository"
380         next
381       end
382
383       cmd_args += [@crunch_job_bin,
384                    '--job-api-token', @authorizations[job.uuid].api_token,
385                    '--job', job.uuid,
386                    '--git-dir', @arvados_internal]
387
388       if @cgroup_root
389         cmd_args += ['--cgroup-root', @cgroup_root]
390       end
391
392       if @docker_bin
393         cmd_args += ['--docker-bin', @docker_bin]
394       end
395
396       if @docker_run_args
397         cmd_args += ['--docker-run-args', @docker_run_args]
398       end
399
400       if have_job_lock?(job)
401         cmd_args << "--force-unlock"
402       end
403
404       $stderr.puts "dispatch: #{cmd_args.join ' '}"
405
406       begin
407         i, o, e, t = Open3.popen3(*cmd_args)
408       rescue
409         $stderr.puts "dispatch: popen3: #{$!}"
410         sleep 1
411         next
412       end
413
414       $stderr.puts "dispatch: job #{job.uuid}"
415       start_banner = "dispatch: child #{t.pid} start #{LogTime.now}"
416       $stderr.puts start_banner
417
418       @running[job.uuid] = {
419         stdin: i,
420         stdout: o,
421         stderr: e,
422         wait_thr: t,
423         job: job,
424         buf: {stderr: '', stdout: ''},
425         started: false,
426         sent_int: 0,
427         job_auth: @authorizations[job.uuid],
428         stderr_buf_to_flush: '',
429         stderr_flushed_at: Time.new(0),
430         bytes_logged: 0,
431         events_logged: 0,
432         log_throttle_is_open: true,
433         log_throttle_reset_time: Time.now + Rails.configuration.crunch_log_throttle_period,
434         log_throttle_bytes_so_far: 0,
435         log_throttle_lines_so_far: 0,
436         log_throttle_bytes_skipped: 0,
437       }
438       i.close
439       @todo_job_retries.delete(job.uuid)
440       update_node_status
441     end
442   end
443
444   # Test for hard cap on total output and for log throttling.  Returns whether
445   # the log line should go to output or not.  Modifies "line" in place to
446   # replace it with an error if a logging limit is tripped.
447   def rate_limit running_job, line
448     message = false
449     linesize = line.size
450     if running_job[:log_throttle_is_open]
451       running_job[:log_throttle_lines_so_far] += 1
452       running_job[:log_throttle_bytes_so_far] += linesize
453       running_job[:bytes_logged] += linesize
454
455       if (running_job[:bytes_logged] >
456           Rails.configuration.crunch_limit_log_bytes_per_job)
457         message = "Exceeded log limit #{Rails.configuration.crunch_limit_log_bytes_per_job} bytes (crunch_limit_log_bytes_per_job). Log will be truncated."
458         running_job[:log_throttle_reset_time] = Time.now + 100.years
459         running_job[:log_throttle_is_open] = false
460
461       elsif (running_job[:log_throttle_bytes_so_far] >
462              Rails.configuration.crunch_log_throttle_bytes)
463         remaining_time = running_job[:log_throttle_reset_time] - Time.now
464         message = "Exceeded rate #{Rails.configuration.crunch_log_throttle_bytes} bytes per #{Rails.configuration.crunch_log_throttle_period} seconds (crunch_log_throttle_bytes). Logging will be silenced for the next #{remaining_time.round} seconds.\n"
465         running_job[:log_throttle_is_open] = false
466
467       elsif (running_job[:log_throttle_lines_so_far] >
468              Rails.configuration.crunch_log_throttle_lines)
469         remaining_time = running_job[:log_throttle_reset_time] - Time.now
470         message = "Exceeded rate #{Rails.configuration.crunch_log_throttle_lines} lines per #{Rails.configuration.crunch_log_throttle_period} seconds (crunch_log_throttle_lines), logging will be silenced for the next #{remaining_time.round} seconds.\n"
471         running_job[:log_throttle_is_open] = false
472       end
473     end
474
475     if not running_job[:log_throttle_is_open]
476       # Don't log anything if any limit has been exceeded. Just count lossage.
477       running_job[:log_throttle_bytes_skipped] += linesize
478     end
479
480     if message
481       # Yes, write to logs, but use our "rate exceeded" message
482       # instead of the log message that exceeded the limit.
483       line.replace message
484       true
485     else
486       running_job[:log_throttle_is_open]
487     end
488   end
489
490   def read_pipes
491     @running.each do |job_uuid, j|
492       job = j[:job]
493
494       now = Time.now
495       if now > j[:log_throttle_reset_time]
496         # It has been more than throttle_period seconds since the last
497         # checkpoint so reset the throttle
498         if j[:log_throttle_bytes_skipped] > 0
499           message = "#{job_uuid} ! Skipped #{j[:log_throttle_bytes_skipped]} bytes of log"
500           $stderr.puts message
501           j[:stderr_buf_to_flush] << "#{LogTime.now} #{message}\n"
502         end
503
504         j[:log_throttle_reset_time] = now + Rails.configuration.crunch_log_throttle_period
505         j[:log_throttle_bytes_so_far] = 0
506         j[:log_throttle_lines_so_far] = 0
507         j[:log_throttle_bytes_skipped] = 0
508         j[:log_throttle_is_open] = true
509       end
510
511       j[:buf].each do |stream, streambuf|
512         # Read some data from the child stream
513         buf = ''
514         begin
515           # It's important to use a big enough buffer here. When we're
516           # being flooded with logs, we must read and discard many
517           # bytes at once. Otherwise, we can easily peg a CPU with
518           # time-checking and other loop overhead. (Quick tests show a
519           # 1MiB buffer working 2.5x as fast as a 64 KiB buffer.)
520           #
521           # So don't reduce this buffer size!
522           buf = j[stream].read_nonblock(2**20)
523         rescue Errno::EAGAIN, EOFError
524         end
525
526         # Short circuit the counting code if we're just going to throw
527         # away the data anyway.
528         if not j[:log_throttle_is_open]
529           j[:log_throttle_bytes_skipped] += streambuf.size + buf.size
530           streambuf.replace ''
531           next
532         elsif buf == ''
533           next
534         end
535
536         # Append to incomplete line from previous read, if any
537         streambuf << buf
538
539         bufend = ''
540         streambuf.each_line do |line|
541           if not line.end_with? $/
542             if line.size > Rails.configuration.crunch_log_throttle_bytes
543               # Without a limit here, we'll use 2x an arbitrary amount
544               # of memory, and waste a lot of time copying strings
545               # around, all without providing any feedback to anyone
546               # about what's going on _or_ hitting any of our throttle
547               # limits.
548               #
549               # Here we leave "line" alone, knowing it will never be
550               # sent anywhere: rate_limit() will reach
551               # crunch_log_throttle_bytes immediately. However, we'll
552               # leave [...] in bufend: if the trailing end of the long
553               # line does end up getting sent anywhere, it will have
554               # some indication that it is incomplete.
555               bufend = "[...]"
556             else
557               # If line length is sane, we'll wait for the rest of the
558               # line to appear in the next read_pipes() call.
559               bufend = line
560               break
561             end
562           end
563           # rate_limit returns true or false as to whether to actually log
564           # the line or not.  It also modifies "line" in place to replace
565           # it with an error if a logging limit is tripped.
566           if rate_limit j, line
567             $stderr.print "#{job_uuid} ! " unless line.index(job_uuid)
568             $stderr.puts line
569             pub_msg = "#{LogTime.now} #{line.strip}\n"
570             j[:stderr_buf_to_flush] << pub_msg
571           end
572         end
573
574         # Leave the trailing incomplete line (if any) in streambuf for
575         # next time.
576         streambuf.replace bufend
577       end
578       # Flush buffered logs to the logs table, if appropriate. We have
579       # to do this even if we didn't collect any new logs this time:
580       # otherwise, buffered data older than seconds_between_events
581       # won't get flushed until new data arrives.
582       write_log j
583     end
584   end
585
586   def reap_children
587     return if 0 == @running.size
588     pid_done = nil
589     j_done = nil
590
591     if false
592       begin
593         pid_done = waitpid(-1, Process::WNOHANG | Process::WUNTRACED)
594         if pid_done
595           j_done = @running.values.
596             select { |j| j[:wait_thr].pid == pid_done }.
597             first
598         end
599       rescue SystemCallError
600         # I have @running processes but system reports I have no
601         # children. This is likely to happen repeatedly if it happens at
602         # all; I will log this no more than once per child process I
603         # start.
604         if 0 < @running.select { |uuid,j| j[:warned_waitpid_error].nil? }.size
605           children = @running.values.collect { |j| j[:wait_thr].pid }.join ' '
606           $stderr.puts "dispatch: IPC bug: waitpid() error (#{$!}), but I have children #{children}"
607         end
608         @running.each do |uuid,j| j[:warned_waitpid_error] = true end
609       end
610     else
611       @running.each do |uuid, j|
612         if j[:wait_thr].status == false
613           pid_done = j[:wait_thr].pid
614           j_done = j
615         end
616       end
617     end
618
619     return if !pid_done
620
621     job_done = j_done[:job]
622
623     # Ensure every last drop of stdout and stderr is consumed.
624     read_pipes
625     # Reset flush timestamp to make sure log gets written.
626     j_done[:stderr_flushed_at] = Time.new(0)
627     # Write any remaining logs.
628     write_log j_done
629
630     j_done[:buf].each do |stream, streambuf|
631       if streambuf != ''
632         $stderr.puts streambuf + "\n"
633       end
634     end
635
636     # Wait the thread (returns a Process::Status)
637     exit_status = j_done[:wait_thr].value.exitstatus
638     exit_tempfail = exit_status == EXIT_TEMPFAIL
639
640     $stderr.puts "dispatch: child #{pid_done} exit #{exit_status}"
641     $stderr.puts "dispatch: job #{job_done.uuid} end"
642
643     jobrecord = Job.find_by_uuid(job_done.uuid)
644
645     if exit_status == EXIT_RETRY_UNLOCKED or (exit_tempfail and @job_retry_counts.include? jobrecord.uuid)
646       # Only this crunch-dispatch process can retry the job:
647       # it's already locked, and there's no way to put it back in the
648       # Queued state.  Put it in our internal todo list unless the job
649       # has failed this way excessively.
650       @job_retry_counts[jobrecord.uuid] += 1
651       exit_tempfail = @job_retry_counts[jobrecord.uuid] <= RETRY_UNLOCKED_LIMIT
652       if exit_tempfail
653         @todo_job_retries[jobrecord.uuid] = jobrecord
654       else
655         $stderr.puts("dispatch: job #{jobrecord.uuid} exceeded node failure retry limit -- giving up")
656       end
657     end
658
659     if !exit_tempfail
660       @job_retry_counts.delete(jobrecord.uuid)
661       if jobrecord.state == "Running"
662         # Apparently there was an unhandled error.  That could potentially
663         # include "all allocated nodes failed" when we don't to retry
664         # because the job has already been retried RETRY_UNLOCKED_LIMIT
665         # times.  Fail the job.
666         jobrecord.state = "Failed"
667         if not jobrecord.save
668           $stderr.puts "dispatch: jobrecord.save failed"
669         end
670       end
671     else
672       # If the job failed to run due to an infrastructure
673       # issue with crunch-job or slurm, we want the job to stay in the
674       # queue. If crunch-job exited after losing a race to another
675       # crunch-job process, it exits 75 and we should leave the job
676       # record alone so the winner of the race can do its thing.
677       # If crunch-job exited after all of its allocated nodes failed,
678       # it exits 93, and we want to retry it later (see the
679       # EXIT_RETRY_UNLOCKED `if` block).
680       #
681       # There is still an unhandled race condition: If our crunch-job
682       # process is about to lose a race with another crunch-job
683       # process, but crashes before getting to its "exit 75" (for
684       # example, "cannot fork" or "cannot reach API server") then we
685       # will assume incorrectly that it's our process's fault
686       # jobrecord.started_at is non-nil, and mark the job as failed
687       # even though the winner of the race is probably still doing
688       # fine.
689     end
690
691     # Invalidate the per-job auth token, unless the job is still queued and we
692     # might want to try it again.
693     if jobrecord.state != "Queued" and !@todo_job_retries.include?(jobrecord.uuid)
694       j_done[:job_auth].update_attributes expires_at: Time.now
695     end
696
697     @running.delete job_done.uuid
698   end
699
700   def update_pipelines
701     expire_tokens = @pipe_auth_tokens.dup
702     @todo_pipelines.each do |p|
703       pipe_auth = (@pipe_auth_tokens[p.uuid] ||= ApiClientAuthorization.
704                    create(user: User.where('uuid=?', p.modified_by_user_uuid).first,
705                           api_client_id: 0))
706       puts `export ARVADOS_API_TOKEN=#{pipe_auth.api_token} && arv-run-pipeline-instance --run-pipeline-here --no-wait --instance #{p.uuid}`
707       expire_tokens.delete p.uuid
708     end
709
710     expire_tokens.each do |k, v|
711       v.update_attributes expires_at: Time.now
712       @pipe_auth_tokens.delete k
713     end
714   end
715
716   def parse_argv argv
717     @runoptions = {}
718     (argv.any? ? argv : ['--jobs', '--pipelines']).each do |arg|
719       case arg
720       when '--jobs'
721         @runoptions[:jobs] = true
722       when '--pipelines'
723         @runoptions[:pipelines] = true
724       else
725         abort "Unrecognized command line option '#{arg}'"
726       end
727     end
728     if not (@runoptions[:jobs] or @runoptions[:pipelines])
729       abort "Nothing to do. Please specify at least one of: --jobs, --pipelines."
730     end
731   end
732
733   def run argv
734     parse_argv argv
735
736     # We want files written by crunch-dispatch to be writable by other
737     # processes with the same GID, see bug #7228
738     File.umask(0002)
739
740     # This is how crunch-job child procs know where the "refresh"
741     # trigger file is
742     ENV["CRUNCH_REFRESH_TRIGGER"] = Rails.configuration.crunch_refresh_trigger
743
744     # If salloc can't allocate resources immediately, make it use our
745     # temporary failure exit code.  This ensures crunch-dispatch won't
746     # mark a job failed because of an issue with node allocation.
747     # This often happens when another dispatcher wins the race to
748     # allocate nodes.
749     ENV["SLURM_EXIT_IMMEDIATE"] = CrunchDispatch::EXIT_TEMPFAIL.to_s
750
751     if ENV["CRUNCH_DISPATCH_LOCKFILE"]
752       lockfilename = ENV.delete "CRUNCH_DISPATCH_LOCKFILE"
753       lockfile = File.open(lockfilename, File::RDWR|File::CREAT, 0644)
754       unless lockfile.flock File::LOCK_EX|File::LOCK_NB
755         abort "Lock unavailable on #{lockfilename} - exit"
756       end
757     end
758
759     @signal = {}
760     %w{TERM INT}.each do |sig|
761       signame = sig
762       Signal.trap(sig) do
763         $stderr.puts "Received #{signame} signal"
764         @signal[:term] = true
765       end
766     end
767
768     act_as_system_user
769     User.first.group_permissions
770     $stderr.puts "dispatch: ready"
771     while !@signal[:term] or @running.size > 0
772       read_pipes
773       if @signal[:term]
774         @running.each do |uuid, j|
775           if !j[:started] and j[:sent_int] < 2
776             begin
777               Process.kill 'INT', j[:wait_thr].pid
778             rescue Errno::ESRCH
779               # No such pid = race condition + desired result is
780               # already achieved
781             end
782             j[:sent_int] += 1
783           end
784         end
785       else
786         refresh_todo unless did_recently(:refresh_todo, 1.0)
787         update_node_status unless did_recently(:update_node_status, 1.0)
788         unless @todo.empty? or did_recently(:start_jobs, 1.0) or @signal[:term]
789           start_jobs
790         end
791         unless (@todo_pipelines.empty? and @pipe_auth_tokens.empty?) or did_recently(:update_pipelines, 5.0)
792           update_pipelines
793         end
794       end
795       reap_children
796       select(@running.values.collect { |j| [j[:stdout], j[:stderr]] }.flatten,
797              [], [], 1)
798     end
799     # If there are jobs we wanted to retry, we have to mark them as failed now.
800     # Other dispatchers can't pick them up because we hold their lock.
801     @todo_job_retries.each_key do |job_uuid|
802       job = Job.find_by_uuid(job_uuid)
803       if job.state == "Running"
804         fail_job(job, "crunch-dispatch was stopped during job's tempfail retry loop")
805       end
806     end
807   end
808
809   def fail_jobs before: nil
810     act_as_system_user do
811       threshold = nil
812       if before == 'reboot'
813         boottime = nil
814         open('/proc/stat').map(&:split).each do |stat, t|
815           if stat == 'btime'
816             boottime = t
817           end
818         end
819         if not boottime
820           raise "Could not find btime in /proc/stat"
821         end
822         threshold = Time.at(boottime.to_i)
823       elsif before
824         threshold = Time.parse(before, Time.now)
825       else
826         threshold = db_current_time
827       end
828       Rails.logger.info "fail_jobs: threshold is #{threshold}"
829
830       if Rails.configuration.crunch_job_wrapper == :slurm_immediate
831         # [["slurm_job_id", "slurm_job_name"], ...]
832         squeue = File.popen(['squeue', '-h', '-o', '%i %j']).readlines.map do |line|
833           line.strip.split(' ', 2)
834         end
835       else
836         squeue = []
837       end
838
839       Job.where('state = ? and started_at < ?', Job::Running, threshold).
840         each do |job|
841         Rails.logger.debug "fail_jobs: #{job.uuid} started #{job.started_at}"
842         squeue.each do |slurm_id, slurm_name|
843           if slurm_name == job.uuid
844             Rails.logger.info "fail_jobs: scancel #{slurm_id} for #{job.uuid}"
845             scancel slurm_id
846           end
847         end
848         fail_job(job, "cleaned up stale job: started before #{threshold}",
849                  skip_lock: true)
850       end
851     end
852   end
853
854   protected
855
856   def have_job_lock?(job)
857     # Return true if the given job is locked by this crunch-dispatch, normally
858     # because we've run crunch-job for it.
859     @todo_job_retries.include?(job.uuid)
860   end
861
862   def did_recently(thing, min_interval)
863     if !@did_recently[thing] or @did_recently[thing] < Time.now - min_interval
864       @did_recently[thing] = Time.now
865       false
866     else
867       true
868     end
869   end
870
871   # send message to log table. we want these records to be transient
872   def write_log running_job
873     return if running_job[:stderr_buf_to_flush] == ''
874
875     # Send out to log event if buffer size exceeds the bytes per event or if
876     # it has been at least crunch_log_seconds_between_events seconds since
877     # the last flush.
878     if running_job[:stderr_buf_to_flush].size > Rails.configuration.crunch_log_bytes_per_event or
879         (Time.now - running_job[:stderr_flushed_at]) >= Rails.configuration.crunch_log_seconds_between_events
880       begin
881         log = Log.new(object_uuid: running_job[:job].uuid,
882                       event_type: 'stderr',
883                       owner_uuid: running_job[:job].owner_uuid,
884                       properties: {"text" => running_job[:stderr_buf_to_flush]})
885         log.save!
886         running_job[:events_logged] += 1
887       rescue => exception
888         $stderr.puts "Failed to write logs"
889         $stderr.puts exception.backtrace
890       end
891       running_job[:stderr_buf_to_flush] = ''
892       running_job[:stderr_flushed_at] = Time.now
893     end
894   end
895
896   def scancel slurm_id
897     cmd = sudo_preface + ['scancel', slurm_id]
898     puts File.popen(cmd).read
899     if not $?.success?
900       Rails.logger.error "scancel #{slurm_id.shellescape}: $?"
901     end
902   end
903
904   def sudo_preface
905     return [] if not Server::Application.config.crunch_job_user
906     ["sudo", "-E", "-u",
907      Server::Application.config.crunch_job_user,
908      "LD_LIBRARY_PATH=#{ENV['LD_LIBRARY_PATH']}",
909      "PATH=#{ENV['PATH']}",
910      "PERLLIB=#{ENV['PERLLIB']}",
911      "PYTHONPATH=#{ENV['PYTHONPATH']}",
912      "RUBYLIB=#{ENV['RUBYLIB']}",
913      "GEM_PATH=#{ENV['GEM_PATH']}"]
914   end
915 end