---
name: "condor_convert_history"
section: "1"
platform: "linux"
package: "htcondor"
version: "8.6.8~dfsg.1-2+deb10u1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/condor_convert_history"
---

# condor\_convert\_history(1)

the history file to the new format

## 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 (C) 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.