Red Hat Training
A Red Hat training course is available for Red Hat OpenStack Platform
Chapter 7. Database cleaning
The Compute service includes an administrative tool, nova-manage, that you can use to perform deployment, upgrade, clean-up, and maintenance-related tasks, such as applying database schemas, performing online data migrations during an upgrade, and managing and cleaning up the database.
Director automates the following database management tasks on the overcloud by using cron:
- Archives deleted instance records by moving the deleted rows from the production tables to shadow tables.
- Purges deleted rows from the shadow tables after archiving is complete.
7.1. Configuring database management
The cron jobs use default settings to perform database management tasks. By default, the database archiving cron jobs run daily at 00:01, and the database purging cron jobs run daily at 05:00, both with a jitter between 0 and 3600 seconds. You can modify these settings as required by using heat parameters.
Procedure
- Open your Compute environment file.
Add the heat parameter that controls the cron job that you want to add or modify. For example, to purge the shadow tables immediately after they are archived, set the following parameter to "True":
parameter_defaults: … NovaCronArchiveDeleteRowsPurge: True
For a complete list of the heat parameters to manage database cron jobs, see Configuration options for Openstack Compute (nova) automated database management.
- Save the updates to your Compute environment file.
Add your Compute environment file to the stack with your other environment files and deploy the overcloud:
(undercloud)$ openstack overcloud deploy --templates \ -e [your environment files] \ -e /home/stack/templates/<compute_environment_file>.yaml
7.2. Configuration options for OpenStack Compute (nova) automated database management
Use the following heat parameters to enable and modify the automated cron jobs that manage the database.
Table 7.1. OpenStack Compute (nova) cron parameters
| Parameter | Description |
|---|---|
|
| Set this parameter to "True" to archive deleted instance records from all cells.
Default value: |
|
| Use this parameter to archive deleted instance records based on their age in days.
Set to
Default value: |
|
| Use this parameter to configure the file for logging deleted instance records.
Default value: |
|
| Use this parameter to configure the hour at which to run the cron command to move deleted instance records to another table.
Default value: |
|
| Use this parameter to configure the maximum delay, in seconds, before moving deleted instance records to another table.
Default value: |
|
| Use this parameter to configure the maximum number of deleted instance records that can be moved to another table.
Default value: |
|
| Use this parameter to configure the minute past the hour at which to run the cron command to move deleted instance records to another table.
Default value: |
|
| Use this parameter to configure on which day of the month to run the cron command to move deleted instance records to another table.
Default value: |
|
| Use this parameter to configure in which month to run the cron command to move deleted instance records to another table.
Default value: |
|
| Set this parameter to "True" to purge shadow tables immediately after scheduled archiving.
Default value: |
|
| Set this parameter to "True" to continue to move deleted instance records to another table until all records are moved.
Default value: |
|
| Use this parameter to configure the user that owns the crontab that archives deleted instance records and that has access to the log file the crontab uses.
Default value: |
|
| Use this parameter to configure on which day of the week to run the cron command to move deleted instance records to another table.
Default value: |
|
| Use this parameter to purge shadow tables based on their age in days.
Set to
Default value: |
|
| Set this parameter to "True" to purge shadow tables from all cells.
Default value: |
|
| Use this parameter to configure the file for logging purged shadow tables.
Default value: |
|
| Use this parameter to configure the hour at which to run the cron command to purge shadow tables.
Default value: |
|
| Use this parameter to configure the maximum delay, in seconds, before purging shadow tables.
Default value: |
|
| Use this parameter to configure the minute past the hour at which to run the cron command to purge shadow tables.
Default value: |
|
| Use this parameter to configure in which month to run the cron command to purge the shadow tables.
Default value: |
|
| Use this parameter to configure on which day of the month to run the cron command to purge the shadow tables.
Default value: |
|
| Use this parameter to configure the user that owns the crontab that purges the shadow tables and that has access to the log file the crontab uses.
Default value: |
|
| Use this parameter to enable verbose logging in the log file for purged shadow tables.
Default value: |
|
| Use this parameter to configure on which day of the week to run the cron command to purge the shadow tables.
Default value: |
