BuildForge Help

Deletion Properties of Classes

Most of the properties for classes control what kinds of project data are deleted and under what conditions they are deleted.

The system checks for jobs to delete at an interval defined by the Purge Check Time system setting, which defaults to 15 minutes.

Note: You can also use schedules to denote when purges should be performed, so that the system does not try to run purges when the system is otherwise occupied. You can use this feature to have purges occur only at night, or once a week, for example. See Scheduling Purges.

Delete Files: Determines what kinds of data are deleted. It has the following options:

Everything
Deletes all information about the job from the database and deletes the job directory from the server(s) that ran it.
Console Data
Deletes all information about the job from the database, but leaves the job directory on the server intact.
Logs And Files
Deletes the job directory and the logs, but retains step pass/failure information on the Jobs > Archived page.
Logs Only
Deletes only the job logs.
Files Only
Deletes the job directory on the server(s) that ran the job. Logs and some other information (such as step pass/fail status) remain within the database; the job record moves to the Jobs > Archived page.

Days: The number of days old a job must be before it is deleted.

Count: The maximum number of jobs allowed. When the number of jobs exceeds the Count value, the system schedules purge jobs to delete the extra builds. The default value, Unlimited, prevents the system from deleting jobs because of the number of jobs that exist.

Note:The system deletes jobs when either the Days or Count values are exceeded. For example, if you have Count set to 10 and Days set to 2, and there are 8 jobs, but 3 are more than 2 days old, those three jobs would be deleted. Similarly, if you had 12 jobs, all less than 2 days old, the two oldest jobs would be deleted.

Which: The Which property sets additional conditions that must be met before a job can be deleted. It has the following options:

Any Build
When this option is selected, the Which property has no effect on job deletion.
Only Failed
The system deletes only failed jobs.
Only Passed
The system deletes only passed jobs.
Keep 1 Pass
The system always retains the most recent passed job, even if it meets other deletion criteria.