|
1 | 1 | # Charm statuses |
2 | 2 |
|
3 | 3 | ```{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. |
5 | 5 | ``` |
6 | 6 |
|
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: |
8 | 8 |
|
9 | 9 | | Juju Status | Message | Expectations | Actions | |
10 | 10 | |-------|-------|-------|-------| |
11 | 11 | | **active** | any | Normal charm operations | No actions required | |
12 | 12 | | **waiting** | any | Charm is waiting for relations to be finished | No actions required | |
13 | 13 | | **maintenance** | any | Charm is performing the internal maintenance (e.g. cluster re-configuration, upgrade, ...) | No actions required | |
14 | 14 | | **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? | | |
16 | 15 | | **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 | |
17 | 16 | | **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 | |
18 | 17 | | **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 | | | |
20 | 19 | | **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;` | |
21 | 20 | | **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. | |
24 | 23 | | **terminated** | any | The unit is gone and will be cleaned by Juju soon | No actions possible | |
25 | 24 | | **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 | |
26 | 25 |
|
| 26 | +<!-- Links --> |
| 27 | +[Contact us]: /reference/contacts |
0 commit comments