Skip to content

Commit 936a3c5

Browse files
authored
remove unclear blocked status and old TODOs (#1139)
1 parent 358eae8 commit 936a3c5

File tree

1 file changed

+7
-6
lines changed

1 file changed

+7
-6
lines changed

docs/reference/statuses.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,27 @@
11
# Charm statuses
22

33
```{caution}
4-
This reference is a work in progress and not fit for production. [Contact us](/reference/contacts) if you are interested in the topic.
4+
This reference is a work in progress and may not reflect the latest statuses. [Contact us] for status troubleshooting help.
55
```
66

7-
The charm follows [standard Juju applications statuses](https://documentation.ubuntu.com/juju/3.6/reference/status/#application-status). Here you can find the expected end-user reaction on different statuses:
7+
The charm follows [standard Juju applications statuses](https://documentation.ubuntu.com/juju/3.6/reference/status/). Here you can find the expected end-user reaction on different statuses:
88

99
| Juju Status | Message | Expectations | Actions |
1010
|-------|-------|-------|-------|
1111
| **active** | any | Normal charm operations | No actions required |
1212
| **waiting** | any | Charm is waiting for relations to be finished | No actions required |
1313
| **maintenance** | any | Charm is performing the internal maintenance (e.g. cluster re-configuration, upgrade, ...) | No actions required |
1414
| **blocked** | the S3 repository has backups from another cluster | The bucket contains foreign backup. To avoid accident DB corruption, use clean bucket. The cluster identified by Juju app name + DB UUID. | Choose/change the new S3 [bucket](https://charmhub.io/s3-integrator/configuration#bucket)/[path](https://charmhub.io/s3-integrator/configuration#path) OR clean the current one. |
15-
| **blocked** | failed to update cluster members on member | TODO: error/retry? | |
1615
| **blocked** | failed to install snap packages | There are issues with the network connection and/or the Snap Store | Check your internet connection and https://status.snapcraft.io/. Remove the application and when everything is OK, deploy the charm again |
1716
| **blocked** | failed to patch snap {spellexception}`seccomp` profile | The charm failed to patch one issue that happens when pgBackRest restores a backup (this blocked status should be removed when https://github.com/pgbackrest/pgbackrest/releases/tag/release%2F2.46 is added to the snap) | Remove the unit and add it back again |
1817
| **blocked** | failed to set up postgresql_exporter options | The charm failed to set up the metrics exporter | Remove the unit and add it back again |
19-
| **blocked** | failed to start Patroni | TODO: error/retry? | |
18+
| **blocked** | failed to start Patroni | | |
2019
| **blocked** | Failed to create postgres user | The charm couldn't create the default `postgres` database user due to connection problems | Connect to the database using the `operator` user and the password from the `get-password` action, then run `CREATE ROLE postgres WITH LOGIN SUPERUSER;` |
2120
| **blocked** | Failed to restore backup | The database couldn't start after the restore | The charm needs fix in the code to recover from this status and enable a new restore to be requested |
22-
| **blocked** | Please choose one endpoint to use. No need to relate all of them simultaneously! | [The modern / legacy interfaces](https://charmhub.io/postgresql-k8s/docs/e-legacy-charm) should not be used simultaneously. | Remove modern or legacy relation. Choose one to use at a time. |
23-
| **error** | any | An unhanded internal error happened | Read the message hint. Execute `juju resolve <error_unit/0>` after addressing the root of the error state |
21+
| **blocked** | Please choose one endpoint to use. No need to relate all of them simultaneously! | [The modern / legacy interfaces](/explanation/legacy-charm) should not be used simultaneously. | Remove modern or legacy relation. Choose one to use at a time. |
22+
| **error** | any | An unhanded internal error happened | Read the message hint. Execute `juju resolve <error_unit/0>` after addressing the root of the error state. [Contact us] for more help. |
2423
| **terminated** | any | The unit is gone and will be cleaned by Juju soon | No actions possible |
2524
| **unknown** | any | Juju doesn't know the charm app/unit status. Possible reason: K8s charm termination in progress. | Manual investigation required if status is permanent |
2625

26+
<!-- Links -->
27+
[Contact us]: /reference/contacts

0 commit comments

Comments
 (0)