schrodinger.utils.installation_check module

schrodinger.utils.installation_check.main()

The main “entry point” for the module, which gets run by the installation_check_run wrapper script.

schrodinger.utils.installation_check.cd(path)
schrodinger.utils.installation_check.get_host_entries(args)

Get all the host entries (jobcontrol.Host objects) from the hosts file. If no -test arguments were given, return them all. If -test arguments were given, return entries whose names are given by those arguments and which are present in the hosts file (warn on absent ones)

schrodinger.utils.installation_check.run_test_jobs(entries, launch_dir='.', timeout=None)

Run testapp jobs using a list of host entries (jobcontrol.Host objects). Return a list of all jobids, succeeded and failed, that were run

schrodinger.utils.installation_check.run_postmortem(jobids)

Run postmortem for a given set of jobids, log the results into the “postmortem.log”

schrodinger.utils.installation_check.test_pyqt()

Determine if we have correct libraries to load PyQt.

If test fails, raises RuntimeError with suggestion on how to fix.

schrodinger.utils.installation_check.run_installation_check(output_dir='.')

Runs diagnostic commands and writes output in the directory specified. Note: licadmin will write the license-info file in the current directory, not in output_dir. We may want to remove the output_dir argument and leave it to the caller to cd to the correct directory

schrodinger.utils.installation_check.queue_inst_file(queue_name, filename)
schrodinger.utils.installation_check.queue_orig_dir(queue_name)
schrodinger.utils.installation_check.queue_orig_file(queue_name, filename)
schrodinger.utils.installation_check.queue_config_diffs()

Return a collection of diffs of config and template queue files (original version from the installation vs what’s in the user’s queues dir)

schrodinger.utils.installation_check.queue_config_file_pairs()

Return a list of pairs of config/template queue files to be compared, and a list of warnings. A pair is one file from the user’s installation and the original version of the same file (from the ‘orig’ subdirectory). A warning is produced whenever the ‘orig’ subdirectory is not found, or when a user’s or original file that should be present, is not.

schrodinger.utils.installation_check.queue_config_files_diff(inst_filepath, orig_filepath)

Return a diff (list of strings) of two config/template queue files

schrodinger.utils.installation_check.log_banner(logger)

Log the basic information.

schrodinger.utils.installation_check.check_running_as_root(logger)

Produce a warning if we are running as root.

schrodinger.utils.installation_check.parse_args(args=None)

Parse cmdline arguments.

class schrodinger.utils.installation_check.TestJobDJ(entries, basedir='/scr/buildbot/savedbuilds/2018-3/NB/build-149/mmshare-v4.3/python/apidocs', *args, **kwargs)

Bases: schrodinger.job.queue.JobDJ

A flavor of JobDJ that takes a list of host entries (jobcontrol.Host objects) and lets the caller schedule exactly one job per entry.

Create an instance of this class, add the jobs, and call run().

basedir()
entryByName(name)
completedJobids()

The jobids of all jobs that have completed (with success or failure)

class schrodinger.utils.installation_check.TestJob(command_dir=None, duration=10, timeout=None)

Bases: schrodinger.job.queue.JobControlJob

A flavor of JobControlJob to be used with TestJobDJ. Its command line will be determined when run() is called on it, by setup(); the job will get named after the host entry that it gets to run on.

doCommand(host, local)

Launch job on specified host using jobcontrol.launch_job(). The -LOCAL flag is added to the job invocation command if local is True.

Parameters:
  • host (str) – Host on which the job will be executed.
  • local (bool) – Should “-LOCAL” be appended to the command?
run(host, local)

Run the job.

The steps taken are as follows:
  1. Execute the preCommand method for things like changing the working directory.
  2. Call the doCommand to do the actual work of computation or job launching.
  3. Call the postCommand method to undo the changes from the preCommand that need to be undone.
formCommand(entry)

Generate a command line appropriate for a given host entry