1CONDOR_CONVERT_HISTORY(1)       HTCondor Manual      CONDOR_CONVERT_HISTORY(1)
2
3
4

NAME

6       condor_convert_history - HTCondor Manual
7
8       Convert the history file to the new format
9

SYNOPSIS

11       condor_convert_history [-help ]
12
13       condor_convert_history history-file1 [history-file2... ]
14
15
16

DESCRIPTION

18       As  of  Condor version 6.7.19, the Condor history file has a new format
19       to allow fast searches backwards through the file. Not all queries  can
20       take advantage of the speed increase, but the ones that can are signif‐
21       icantly faster.
22
23       Entries placed in the history file after upgrade to Condor 6.7.19  will
24       automatically  be saved in the new format. The new format adds informa‐
25       tion to the string which distinguishes and separates job  entries.   In
26       order to search within this new format, no changes are necessary.  How‐
27       ever, to be able to search the entire history, the history file must be
28       converted to the updated format. condor_convert_history does this.
29
30       The  condor_convert_history command can also be used to reconstruct the
31       new format in a history file that has been corrupted  or  concantenated
32       with another history file.
33
34       Turn the condor_schedd daemon off while converting history files.  Turn
35       it back on after conversion is completed.
36
37       Arguments to condor_convert_history are the history files  to  convert.
38       The history file is normally in the Condor spool directory; it is named
39       history. Since the history file is rotated, there may be multiple  his‐
40       tory files, and all of them should be converted. On Unix platform vari‐
41       ants, the easiest way to do this is:
42
43          cd `condor_config_val SPOOL`
44          condor_convert_history history*
45
46       condor_convert_history makes a back up of each original  history  files
47       in  case  of  a  problem.  The names of these back up files are listed;
48       names are formed by appending the suffix .oldver to the  original  file
49       name.  Move these back up files to a directory other than the spool di‐
50       rectory. If kept in the spool directory, condor_history will  find  the
51       back ups, and will appear to have duplicate jobs.
52

EXIT STATUS

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

AUTHOR

58       HTCondor Team
59

61       1990-2021, Center for High Throughput Computing, Computer Sciences  De‐
62       partment,  University  of  Wisconsin-Madison, Madison, WI, US. Licensed
63       under the Apache License, Version 2.0.
64
65
66
67
688.8                              Aug 23, 2021        CONDOR_CONVERT_HISTORY(1)
Impressum