AWS AmazonRDS documentation change
Summary
Added documentation for rdsadmin.backup_database errors including insufficient disk space warnings and internal error handling
Security assessment
The changes address backup failure scenarios and storage requirements but do not indicate a security vulnerability being patched. While backups are security-adjacent, this documentation update focuses on operational troubleshooting rather than introducing or fixing security controls.
Diff
diff --git a/AmazonRDS/latest/UserGuide/db2-troubleshooting.md b/AmazonRDS/latest/UserGuide/db2-troubleshooting.md index bb55b6f80..c3f075e5b 100644 --- a//AmazonRDS/latest/UserGuide/db2-troubleshooting.md +++ b//AmazonRDS/latest/UserGuide/db2-troubleshooting.md @@ -177,0 +178 @@ Databases | rdsadmin.activate_database errors +Databases | rdsadmin.backup_database errors @@ -268,0 +270,40 @@ The following error message indicates that you tried to alter a tablespace. +### rdsadmin.backup_database errors + +The following errors can occur when you call the [rdsadmin.backup_database](./db2-sp-managing-databases.html#db2-sp-backup-database) stored procedure. + +Error | Error message +---|--- +Insufficient disk space | `Aborting task. Reason Backing up your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.backup_database stored procedure.` +Internal error | `Caught exception during executing task id 104, Aborting task. Reason Internal Error` + +**Insufficient disk space** + +The following error message indicates that your DB instance has insufficient disk space to back up your database: + + + Aborting task. Reason Backing up your database failed because of insufficient disk space. Increase the storage for your DB instance and rerun the rdsadmin.backup_database stored procedure. + +When backing up a database to remote storage, make sure that you have sufficient free disk space for the backup session and the working files. Each backup session processes up to 5 GB of data, but additional space is needed for transaction logs, temporary files, and ongoing database operations. + +We recommend that you have the following free disk space for backups based on the database size: + + * For databases under 5 GB – The database size + 3 GB buffer + + * For databases 5 GB and larger – At least 10 GB of free space + + + + +This amount of free disk space accounts for backup session processing, transaction log accumulation during backup, temporary working files, and parallel backup streams if configured. For more information, see [Increasing DB instance storage capacity](./USER_PIOPS.ModifyingExisting.html). + +Increase your disk space and then call the [rdsadmin.backup_database](./db2-sp-managing-databases.html#db2-sp-backup-database) stored procedure again. To confirm that the database was backed up correctly, check the task status by using [rdsadmin.get_task_status](./db2-user-defined-functions.html#db2-udf-get-task-status). You can also verify that the backup files exist in your Amazon S3 bucket under `s3_prefix/dbi_resource_id/db_name`. + +**Internal error** + +The following error message indicates that the stored procedure encountered an internal error: + + + Caught exception during executing task id 104, Aborting task. Reason Internal Error + +Contact [AWS Support](https://aws.amazon.com/premiumsupport/). +