Name

       condor_convert_history Convert - the history file to the new format

Synopsis

       condor_convert_history[-help]

       condor_convert_historyhistory-file1[history-file2...]

Description

       As  of  Condor  version 6.7.19, the Condor history file has a new format to allow fast searches backwards
       through the file. Not all queries can take advantage of the speed increase, but the  ones  that  can  are
       significantly faster.

       Entries  placed in the history file after upgrade to Condor 6.7.19 will automatically be saved in the new
       format. The new format adds information to the string which distinguishes and separates job  entries.  In
       order  to  search  within  this  new  format, no changes are necessary. However, to be able to search the
       entire history, the history file must be converted  to  the  updated  format.  condor_convert_historydoes
       this.

       The  condor_convert_historycommand  can also be used to reconstruct the new format in a history file that
       has been corrupted or concantenated with another history file.

       Turn the condor_schedddaemon off while converting history files. Turn it  back  on  after  conversion  is
       completed.

       Arguments  to condor_convert_historyare the history files to convert. The history file is normally in the
       Condor spool directory; it is named history. Since the history file is rotated,  there  may  be  multiple
       history files, and all of them should be converted. On Unix platform variants, the easiest way to do this
       is:

       cd `condor_config_val SPOOL`
       condor_convert_history  history*

       condor_convert_historymakes a back up of each original history files in case of a problem. The  names  of
       these  back  up  files are listed; names are formed by appending the suffix  .oldver to the original file
       name. Move these back up files to a directory other than the  spool  directory.  If  kept  in  the  spool
       directory, condor_historywill find the back ups, and will appear to have duplicate jobs.

Exit Status

       condor_convert_historywill  exit  with a status value of 0 (zero) upon success, and it will exit with the
       value 1 (one) upon failure.

Author

       Center for High Throughput Computing, University of Wisconsin–Madison

Copyright

       Copyright © 1990-2016 Center for High Throughput Computing, Computer Sciences Department,  University  of
       Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.

                                                  January 2020                         condor_convert_history(1)