#!/usr/bin/env python
from __future__ import print_function
import json
import argparse
import os
import sys
from emop.lib.emop_settings import EmopSettings
from emop.emop_query import EmopQuery
from emop.emop_submit import EmopSubmit
from emop.emop_run import EmopRun
from emop.emop_upload import EmopUpload
from emop.emop_transfer import EmopTransfer
# Needed to prevent the _JAVA_OPTIONS value from breaking some of
# the post processes that use Java
if os.environ.get("_JAVA_OPTIONS"):
del os.environ["_JAVA_OPTIONS"]
# TODO: Remove once verified globus API 0.10.18 removes need to disable proxy usage
# if os.environ.get("HTTPS_PROXY"):
# del os.environ["HTTPS_PROXY"]
# if os.environ.get("https_proxy"):
# del os.environ["https_proxy"]
[docs]def configprint(args, parser):
settings = EmopSettings(args.config_path)
print(settings.get_value(args.section, args.item))
[docs]def query(args, parser):
""" query command
The query subcommmand behavior is determined by the --pending-pages and
--avg-runtimes arguments.
When --pending-pages is passed the number of pending pages is printed. This query
can be modified via the --filters argument.
When --avg-runtimes is passed the log files from emop-controller are parsed and average runtimes
are printed.
"""
emop_query = EmopQuery(args.config_path)
# --pending-pages
if args.query_pending_pages:
pending_pages = emop_query.pending_pages_count(q_filter=args.filter)
if pending_pages == 0 or pending_pages:
print("Number of pending pages: %s" % pending_pages)
else:
print("ERROR: querying pending pages failed")
sys.exit(1)
# --avg-runtimes
if args.query_avg_runtimes:
avg_runtimes = emop_query.get_runtimes()
if avg_runtimes:
print("Pages completed: %d" % avg_runtimes["total_pages"])
print("Total Page Runtime: %d seconds" % avg_runtimes["total_page_runtime"])
print("Average Page Runtime: %d seconds" % avg_runtimes["average_page_runtime"])
print("Jobs completed: %d" % avg_runtimes["total_jobs"])
print("Average Job Runtime: %d seconds" % avg_runtimes["average_job_runtime"])
print("Processes:")
for process in avg_runtimes["processes"]:
print("\t%s completed: %d" % (process["name"], process["count"]))
print("\t%s Average: %d seconds" % (process["name"], process["avg"]))
print("\t%s Total: %d seconds" % (process["name"], process["total"]))
else:
print("ERROR: querying average page runtimes")
sys.exit(1)
sys.exit(0)
[docs]def submit(args, parser):
""" submit command
This command will submit jobs based on the various arguments.
Arguments used:
--num-jobs: Number of jobs to submit. The default value is determined based on optimization logic.
--pages-per-job: Number of pages per job. The default value if determined based on optimization logic.
--no-schedule: Currently unused
--sim: Simulate and print the job optimization and commands to use but do not actually submit jobs
--filter: Filter to use when querying pending pages
The default logic of this function is to determine optimal number of jobs and pages per job. Once this is determined
the necessary number of pages are reserved via Dashboard API. The returned API results are saved to a PROC_ID input file.
All the reserved job's PROC_IDs are then processed and a Globus transfer is initiated and a transfer job is submitted to wait
for the transfer to complete. All the reserved page PROC_IDs are submitted as batch jobs and will depend on the transfer job to
complete before they start.
"""
# Ensure --num-jobs and --pages-per-job are both present
# if either is used
if (args.num_jobs and not args.pages_per_job
or not args.num_jobs and args.pages_per_job):
print("--num-jobs and --pages-per-job must be used together")
parser.print_help()
sys.exit(1)
emop_submit = EmopSubmit(args.config_path)
emop_query = EmopQuery(args.config_path)
pending_pages = emop_query.pending_pages_count(q_filter=args.filter)
# Exit if no pages to run
if pending_pages == 0:
print("No work to be done")
sys.exit(0)
if not pending_pages:
print("Error querying pending pages")
sys.exit(1)
# Exit if the number of submitted jobs has reached the limit
if args.schedule:
current_job_count = emop_submit.scheduler.current_job_count()
if current_job_count >= emop_submit.settings.max_jobs:
print("Job limit of %s reached." % emop_submit.settings.max_jobs)
sys.exit(0)
# Optimize job submission if --pages-per-job and --num-jobs was not set
if not args.pages_per_job and not args.num_jobs:
num_jobs, pages_per_job = emop_submit.optimize_submit(pending_pages, current_job_count, sim=args.submit_simulate)
else:
num_jobs = args.num_jobs
pages_per_job = args.pages_per_job
if args.submit_simulate:
sys.exit(0)
# Verify transfers are possible
emop_transfer = EmopTransfer(args.config_path)
endpoint_check = emop_transfer.check_endpoints(fail_on_warn=True)
if not endpoint_check:
print("ERROR: Not all endpoints are activated or activation expires soon.")
sys.exit(1)
# Loop that performs the actual submission
proc_ids = []
for i in xrange(num_jobs):
proc_id = emop_submit.reserve(num_pages=pages_per_job, r_filter=args.filter)
if not proc_id:
print("ERROR: Failed to reserve page")
continue
proc_ids.append(proc_id)
if proc_ids:
if args.transfer:
task_id = emop_transfer.stage_in_proc_ids(proc_ids=proc_ids, wait=False)
transfer_job_id = emop_submit.scheduler.submit_transfer_job(task_id=task_id)
else:
transfer_job_id = None
for proc_id in proc_ids:
job_id = emop_submit.scheduler.submit_job(proc_id=proc_id, num_pages=pages_per_job, dependency=transfer_job_id)
emop_submit.set_job_id(proc_id=proc_id, job_id=job_id)
sys.exit(0)
[docs]def run(args, parser):
"""run command
The run command is intended to be executed on a compute node. This command performs the actual work
of OCRing pages based on the supplied --proc-id value. By default the run command will not run if it detects the PROC_ID
has already run, but this can be modified with --force-run. This is useful when a batch job has been requeued.
"""
emop_run = EmopRun(args.config_path, args.proc_id)
# Do not use run subcommand if not in a valid cluster job environment
# This prevents accidentally running resource intensive program on login nodes
if not emop_run.scheduler.is_job_environment():
print("Can only use run subcommand from within a cluster job environment")
sys.exit(1)
run_status = emop_run.run(force=args.force_run)
if run_status:
sys.exit(0)
else:
sys.exit(1)
[docs]def transfer_status(args, parser):
""" transfer status command
When no arguments are given this command will simply verify that both cluster and remote Globus endpoints
are activated and usable.
When the --task-id argument is passed this command will query the status of a Globus transfer task. The --wait argument
can be used to force this command to wait for the Globus transfer status to be SUCCEEDED or FAILED.
"""
emop_transfer = EmopTransfer(args.config_path)
if args.task_id:
status = emop_transfer.display_task(task_id=args.task_id, wait=args.wait)
else:
status = emop_transfer.check_endpoints()
if status:
sys.exit(0)
else:
sys.exit(1)
[docs]def transfer_in(args, parser):
""" transfer in command
The transfer in command will transfer files from a remote Globus endpoint to the cluster Globus endpoint.
When used with --proc-id, the files defined in the PROC_ID file will be transferred.
When used with --filter, the files returned by API query will be transferred.
"""
emop_transfer = EmopTransfer(args.config_path)
endpoint_check = emop_transfer.check_endpoints()
if not endpoint_check:
print("ERROR: Not all endpoints are activated.")
sys.exit(1)
if args.proc_id:
task_id = emop_transfer.stage_in_proc_ids(proc_ids=[args.proc_id], wait=args.wait)
if task_id:
print("Transfer submitted: %s" % task_id)
else:
print("Error: Failed to submit transfer")
elif args.filter:
emop_query = EmopQuery(args.config_path)
pending_pages = emop_query.pending_pages(q_filter=args.filter)#, r_filter='page.pg_image_path,pg_ground_truth_file')
task_id = emop_transfer.stage_in_data(data=pending_pages, wait=args.wait)
if task_id:
print("Transfer submitted: %s" % task_id)
else:
print("ERROR: Failed to submit transfer")
if task_id:
sys.exit(0)
else:
sys.exit(1)
[docs]def transfer_out(args, parser):
""" transfer out command
The transfer out command will transfer files from a cluster Globus endpoint to a remote Globus endpoint.
Currently this command will only transfer out when passed the --proc-id argument, and will parse the PROC_ID file
for files to transfer.
"""
emop_transfer = EmopTransfer(args.config_path)
endpoint_check = emop_transfer.check_endpoints()
if not endpoint_check:
print("ERROR: Not all endpoints are activated.")
if args.proc_id:
task_id = emop_transfer.stage_out_proc_id(proc_id=args.proc_id)
if task_id:
print("Transfer submitted: %s" % task_id)
sys.exit(0)
else:
print("ERROR: Failed to submit transfer")
sys.exit(1)
[docs]def transfer_test(args, parser):
"""transfer test command
The transfer test command can be used to verify transfers are functional between the cluster and remote Globus endpoints.
The tasks performed:
* Perform ls on /~/ on cluster endpoint
* Perform ls on /~/ on remote endpoint
* Transfer a test file from cluster endpoint to remote endpoint
* Display task and wait 2 minutes for task to complete
"""
_fail = False
emop_transfer = EmopTransfer(args.config_path)
status = emop_transfer.check_endpoints()
if not status:
sys.exit(1)
# ls_test_path = '/~/'
# print("Testing ls ability of %s:%s" % (emop_transfer.cluster_endpoint, ls_test_path))
# cluster_ls_data = emop_transfer.ls(emop_transfer.cluster_endpoint, ls_test_path)
# if not cluster_ls_data:
# print("ERROR: ls of %s:%s" % (emop_transfer.cluster_endpoint, ls_test_path))
# _fail = True
# print("Testing ls ability of %s:%s" % (emop_transfer.remote_endpoint, ls_test_path))
# remote_ls_data = emop_transfer.ls(emop_transfer.remote_endpoint, ls_test_path)
# if not remote_ls_data:
# print("ERROR: ls of %s:%s" % (emop_transfer.remote_endpoint, ls_test_path))
# _fail = True
#
# if _fail:
# sys.exit(1)
print("Generating test files")
test_input = "~/test-in.txt"
test_output = "~/test-out.txt"
test_input_path = os.path.expanduser(test_input)
test_file = open(test_input_path, "w+")
test_file.write("TEST")
test_file.close()
transfer_data = [{"src": test_input, "dest": test_output}]
task_id = emop_transfer.start(src=emop_transfer.cluster_endpoint, dest=emop_transfer.remote_endpoint, data=transfer_data, label="emop-test", wait=args.wait)
emop_transfer.display_task(task_id=task_id, wait=120)
[docs]def upload(args, parser):
""" upload command
The upload command will send data to the Dashboard API.
The --proc-id argument will upload contents of PROC_ID file
The --upload-file argument will upload the specified file
The --upload-dir argument will upload all JSON files directly under the specified directory.
"""
emop_upload = EmopUpload(args.config_path)
if args.proc_id:
upload_status = emop_upload.upload_proc_id(proc_id=args.proc_id)
elif args.upload_file:
upload_status = emop_upload.upload_file(filename=args.upload_file)
elif args.upload_dir:
upload_status = emop_upload.upload_dir(dirname=args.upload_dir)
if upload_status:
sys.exit(0)
else:
sys.exit(1)
[docs]def testrun(args, parser):
"""TESTRUN
Reserve pages, run pages and optionally upload pages
"""
emop_submit = EmopSubmit(args.config_path)
# Do not run testrun subcommand if not in a valid cluster job environment
# This prevents accidentally running resource intensive program on login nodes
if not emop_submit.scheduler.is_job_environment():
print("Can only use testrun subcommand from within a cluster job environment")
sys.exit(1)
# Reserve pages equal to --num-pages
proc_id = emop_submit.reserve(num_pages=args.testrun_num_pages, r_filter=args.filter)
if not proc_id:
print("Failed to reserve pages")
sys.exit(1)
# Run reserved pages
emop_run = EmopRun(args.config_path, proc_id)
run_status = emop_run.run(force=True)
if not run_status:
sys.exit(1)
# Exit if --no-upload
if args.testrun_no_upload:
sys.exit(0)
# Upload results
emop_upload = EmopUpload(args.config_path)
upload_status = emop_upload.upload_proc_id(proc_id=proc_id)
if not upload_status:
sys.exit(1)
sys.exit(0)
[docs]def setup_parser():
# Define defaults and values used for command line options
default_config_path = os.path.join(os.path.dirname(os.path.realpath(__file__)), 'config.ini')
# Define command line options
parser = argparse.ArgumentParser(formatter_class=argparse.ArgumentDefaultsHelpFormatter)
subparsers = parser.add_subparsers(dest='mode')
parser_configprint = subparsers.add_parser('configprint')
parser_query = subparsers.add_parser('query')
parser_submit = subparsers.add_parser('submit')
parser_run = subparsers.add_parser('run')
parser_upload = subparsers.add_parser('upload')
parser_testrun = subparsers.add_parser('testrun')
parser_transfer = subparsers.add_parser('transfer')
subparsers_transfer = parser_transfer.add_subparsers(dest='transfer_mode')
parser_transfer_status = subparsers_transfer.add_parser('status')
parser_transfer_out = subparsers_transfer.add_parser('out')
parser_transfer_in = subparsers_transfer.add_parser('in')
parser_transfer_test = subparsers_transfer.add_parser('test')
proc_id_args = '--proc-id',
proc_id_kwargs = {
'help': 'job proc-id',
'dest': 'proc_id',
'action': 'store',
'type': str
}
filter_args = '--filter',
filter_kwargs = {
'help': 'filter to apply',
'dest': 'filter',
'action': 'store',
'default': '{}',
'type': json.loads
}
wait_args = '--wait',
wait_kwargs = {
'help': 'number of seconds to wait for process to finish',
'dest': 'wait',
'action': 'store',
'default': 0,
'type': int
}
# Global config options
parser.add_argument('-c', '--config',
help="path to config file",
dest="config_path",
action="store",
default=default_config_path,
type=str)
# configprint args
parser_configprint.add_argument('--section',
help="config section",
dest="section",
required=True)
parser_configprint.add_argument('--item',
help="config item",
dest="item",
required=True)
parser_configprint.set_defaults(func=configprint)
# query args
parser_query.add_argument(*filter_args, **filter_kwargs)
parser_query.add_argument('--pending-pages',
help="query number of pending pages",
dest="query_pending_pages",
action="store_true")
parser_query.add_argument('--avg-runtimes',
help="query average runtimes of completed jobs",
dest="query_avg_runtimes",
action="store_true")
parser_query.set_defaults(func=query)
# submit args
parser_submit.add_argument(*filter_args, **filter_kwargs)
parser_submit.add_argument('--pages-per-job',
help='number of pages per job',
dest='pages_per_job',
action='store',
type=int)
parser_submit.add_argument('--num-jobs',
help='number jobs to submit',
dest='num_jobs',
action='store',
type=int)
parser_submit.add_argument('--sim',
help='simulate job submission',
dest='submit_simulate',
action='store_true')
parser_submit.add_argument('--no-schedule',
help='disable submitting to scheduler',
dest='schedule',
action='store_false',
default=True)
parser_submit.add_argument('--no-transfer',
help='disable initiating transfer',
dest='transfer',
action='store_false',
default=True)
parser_submit.set_defaults(func=submit)
# run args
parser_run.add_argument(*proc_id_args, required=True, **proc_id_kwargs)
parser_run.add_argument('--force-run',
help='Force run even if output exists',
dest='force_run',
action='store_true')
parser_run.set_defaults(func=run)
# upload args
upload_group = parser_upload.add_mutually_exclusive_group(required=True)
upload_group.add_argument(*proc_id_args, **proc_id_kwargs)
upload_group.add_argument('--upload-file',
help='path to payload file to upload',
dest='upload_file',
action='store',
type=str)
upload_group.add_argument('--upload-dir',
help='path to payload directory to upload',
dest='upload_dir',
action='store',
type=str)
parser_upload.set_defaults(func=upload)
# transfer status args
parser_transfer_status.add_argument(*wait_args, **wait_kwargs)
parser_transfer_status.add_argument('--task-id',
help='task ID to query',
dest='task_id',
action='store',
type=str)
parser_transfer_status.set_defaults(func=transfer_status)
# transfer in args
parser_transfer_in.add_argument(*proc_id_args, **proc_id_kwargs)
parser_transfer_in.add_argument(*filter_args, **filter_kwargs)
parser_transfer_in.add_argument(*wait_args, **wait_kwargs)
parser_transfer_in.set_defaults(func=transfer_in)
# transfer out args
parser_transfer_out.add_argument(*proc_id_args, **proc_id_kwargs)
parser_transfer_out.set_defaults(func=transfer_out)
# transfer test args
parser_transfer_test.add_argument(*wait_args, **wait_kwargs)
parser_transfer_test.set_defaults(func=transfer_test)
# testrun args
parser_testrun.add_argument(*filter_args, **filter_kwargs)
parser_testrun.add_argument('--num-pages',
help='number pages to reserve and run',
dest='testrun_num_pages',
action='store',
type=int,
default=1)
parser_testrun.add_argument('--no-upload',
help='disable uploading of results',
dest='testrun_no_upload',
action='store_true',
default=False)
parser_testrun.set_defaults(func=testrun)
return parser
[docs]def main():
parser = setup_parser()
args = parser.parse_args()
args.func(args, parser)
if __name__ == '__main__':
main()