---
name: "heat-manage"
section: "1"
platform: "linux"
package: "heat-common"
version: "1:7.0.0-4"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/heat-manage"
---

# heat-manage(1)

Script which helps manage specific database operations

## NAME

heat-manage - Script which helps manage specific database operations

## SYNOPSIS

**heat-manage \<action\> \[options\]**

## DESCRIPTION

heat-manage helps manage heat specific database operations.

## OPTIONS

The standard pattern for executing a heat-manage command is: **heat-manage \<command\> \[\<args\>\]**

Run with -h to see a list of available commands: **heat-manage -h**

Commands are **db\_version**, **db\_sync**, **purge\_deleted** and **service**. Detailed descriptions are below.

### Heat Db version

**heat-manage db\_version**

Print out the db schema version.

**heat-manage db\_sync**

Sync the database up to the most recent version.

**heat-manage purge\_deleted \[-g {days,hours,minutes,seconds}\] \[-p project\_id\] \[age\]**

Purge db entries marked as deleted and older than \[age\]. When project\_id argument is provided, only entries belonging to this project will be purged.

**heat-manage service list**

Shows details for all currently running heat-engines.

**heat-manage service clean**

Clean dead engine records.

**heat-manage --version**

Shows program's version number and exit. The output could be empty if the distribution didn't specify any version information.

## FILES

The /etc/heat/heat.conf file contains global options which can be used to configure some aspects of heat-manage, for example the DB connection and logging.

## BUGS

- •

  Heat issues are tracked in Launchpad so you can view or report bugs here *OpenStack Heat Bugs*

## AUTHOR

Heat Developers

## COPYRIGHT

2017,2013 Heat Developers