condor_convert_history(1)				      General Commands Manual					 condor_convert_history(1)

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 infor-
       mation  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.

       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 plat-
       form 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
       Condor Team, University of Wisconsin-Madison

Copyright
       Copyright  (C)  1990-2012  Condor  Team,  Computer  Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
       Licensed under the Apache License, Version 2.0.

       See the Condor Version 7.8.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu

								  September 2012					 condor_convert_history(1)