diff --git a/content/runbooks/rds/RDSUnappliedParameters.md b/content/runbooks/rds/RDSUnappliedParameters.md index f7f10a4..279d6fa 100644 --- a/content/runbooks/rds/RDSUnappliedParameters.md +++ b/content/runbooks/rds/RDSUnappliedParameters.md @@ -31,7 +31,7 @@ RDS parameter groups have `dynamic` and `static` parameters: 1. Check instance status - If instance is in `creating` status, the parameter group should be applied automatically by AWS in few minutes. + If the instance is in `creating` status, the parameter group should be applied automatically by AWS in a few minutes. 1. Identify the RDS parameter group used by the RDS instance @@ -113,8 +113,44 @@ RDS parameter groups have `dynamic` and `static` parameters: ## Mitigation -- Apply RDS parameter group changes by restarting the RDS instance +You must restart the RDS instance to fix the `pending-reboot` apply status. + +{{< hint warning >}} +**Important** + +The following mitigation measures will restart the RDS instance, resulting in an **interruption of service**. You may consider shutting down the database clients and informing users first. +{{< /hint >}} + +1. Find a suitable time slot to restart the instance + +1. Apply RDS parameter group changes by restarting the RDS instance + + ```bash + aws rds reboot-db-instance --db-instance-identifier ${DB_IDENTIFIER} + ``` + + This operation is performed asynchronously, it could take several minutes. + +1. Check parameter group apply status is now `in-sync`. + + ```bash + aws rds describe-db-instances --db-instance-identifier ${DB_IDENTIFIER} --query 'DBInstances[0].DBParameterGroups[0]' + ``` + +
+ Example + + ```bash + $ aws rds describe-db-instances --db-instance-identifier ${DB_IDENTIFIER} --query 'DBInstances[0].DBParameterGroups[0]' + { + "DBParameterGroupName": "postgres14-primary", + "ParameterApplyStatus": "in-sync" + } + ``` + +
## Additional resources -- +- [Working with parameter groups](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html) +- [Rebooting a DB instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html)