Skip to content

Commit

Permalink
Updates anchor links to match returned code string (#1465)
Browse files Browse the repository at this point in the history
updates anchor links to match returned code string
  • Loading branch information
ZPain8464 committed Jun 21, 2024
1 parent fbd819a commit 4f80a99
Showing 1 changed file with 13 additions and 13 deletions.
26 changes: 13 additions & 13 deletions content/docs/troubleshooting/cluster-status.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The [Status](https://console.pomerium.app/app/reports/status) page of the Zero C

We've addressed all the cluster status alerts below. Refer to the relevant alert to learn how to fix it.

## Certificates are expired or invalid {#certificates-current}
## Certificates are expired or invalid {#certificates_current}

This cluster status alert inspects a cluster's certificates to see if they expire within 10 days. It runs daily, and every time the cluster configuration is updated.

Expand All @@ -22,7 +22,7 @@ This cluster status alert inspects a cluster's certificates to see if they expir

**Steps to resolve**: Upload a valid certificate, or allow Pomerium to automate certificate management for you by adding a [Custom Domain](/docs/capabilities/custom-domains).

## Hostnames do not have matching certificates {#certificates-match-hostnames}
## Hostnames do not have matching certificates {#certificates_match_hostnames}

This cluster status alert ensures that all the hostnames available in a cluster's configuration have matching certificates. It runs every time the cluster configuration is updated.

Expand All @@ -39,23 +39,23 @@ For more information on certificates in Pomerium, see the following pages:

:::

## Cluster configuration is not current {#cluster-config-current}
## Cluster configuration is not current {#cluster_config_current}

This cluster status alert makes sure the cluster is running the latest changeset. It runs daily to check for the latest configuration, or every time the cluster configuration is updated.

**What causes this alert**: This cluster status alert may indicate cluster connectivity issues. Specifically, Pomerium Zero can't connect to the cluster to apply the latest changeset to its configuration.

**Steps to resolve**: Restart the cluster. If that doesn't resolve the issue, please [contact support](https://discuss.pomerium.com/).

## Cluster version is not current {#cluster-version-current}
## Cluster version is not current {#cluster_version_current}

This cluster status alert makes sure the cluster replica is running the latest release. It runs daily.

**What causes this alert**: The replica is not running the latest version of Pomerium Zero.

**Steps to resolve**: Update your Pomerium Zero cluster configuration to run the latest version of Pomerium.

## Cluster using an in-memory storage backend {#persistent-backend}
## Cluster using an in-memory storage backend {#persistent_backend}

This cluster status alert throws an error if it detects a cluster isn't connected to a persistent storage backend. It runs every time the cluster configuration is updated.

Expand All @@ -65,29 +65,29 @@ By default, a cluster uses an in-memory storage backend to synchronize replicas.

**Steps to resolve**: See the [**Databroker Storage Connection String**](/docs/reference/databroker#databroker-storage-connection-string) reference page to learn how to connect to a database instance in Pomerium.

## Incompatible configuration {#config-databroker-build}
## Incompatible configuration {#config.databroker.build}

This cluster status alert looks for configuration incompatibilities in a replica. It runs every time the cluster configuration is updated.

**What causes this alert**: This is caused by a version incompatibility in the cluster configuration. For example, you somehow apply a configuration change that isn't compatible with your version of Pomerium Zero.

**Steps to resolve**: If you see this warning, please [contact support](https://discuss.pomerium.com/).

## Cluster can't communicate with the storage backend {#storage-backend}
## Cluster can't communicate with the storage backend {#storage.backend}

This cluster status alert monitors the connection to a PostgreSQL database. It runs every time the cluster configuration is updated.

**What causes this alert**: Pomerium can't connect to your PostgreSQL database.

**Steps to resolve**: Check the parameters of your [**Databroker Storage Connection String**](/docs/reference/databroker#databroker-storage-connection-string).

## There's an issue with cluster configuration {#xds-cluster}
## There's an issue with cluster configuration {#xds.cluster}

This cluster status alert tells you if Envoy accepted the cluster configuration or not after a configuration update.

**What causes this alert**: If you see this warning, please [contact support](https://discuss.pomerium.com/).

## There's an issue with the network listener {#xds-listener}
## There's an issue with the network listener {#xds.listener}

This cluster status alert makes sure the network listener is configured correctly. It runs every time the cluster configuration is updated.

Expand All @@ -98,29 +98,29 @@ This cluster status alert makes sure the network listener is configured correctl
- If this is a port binding error, you may need to kill a process running on that port or specify a port to bind to.
- If this is a permissions issue, you may need to add the `CAP_NET_BIND_SERVICE` capability to the process.

## There's an issue with the route configuration {#xds-route-configuration}
## There's an issue with the route configuration {#xds.route-configuration}

This cluster status alert verifies the route configuration. It runs every time the cluster configuration is updated.

**What causes this alert**: A route misconfiguration in a cluster.

**Steps to resolve**: If you see this warning, it's likely a problem with Pomerium. Please [contact support](https://discuss.pomerium.com/).

## There's an issue with the configuration {#xds-other}
## There's an issue with the configuration {#xds.other}

This cluster status alert monitors [xDS](https://www.envoyproxy.io/docs/envoy/latest/api-docs/xds_protocol) issues in a replica. It runs every time the cluster configuration is updated.

**What causes this alert**: If you see this warning, it's likely a problem with Pomerium. Please [contact support](https://discuss.pomerium.com/).

## Pomerium can't write some of its cache files {#zero-bootstrap-config-save}
## Pomerium can't write some of its cache files {#zero.bootstrap-config.save}

This cluster status alert makes sure Pomerium can persist a replica's bootstrap configuration. It runs when you start a cluster, or every time the cluster configuration is updated.

**What causes this alert**: Pomerium doesn't have sufficient permissions to read from a replica's configuration file.

**Steps to resolve**: Check your file permissions to make sure Pomerium has read access.

## Cluster connectivity issues with the cloud {#zero-connect}
## Cluster connectivity issues with the cloud {#zero.connect}

This cluster status alert monitors the connection between the Pomerium Zero cloud and a cluster. It maintains a consistent streaming connection.

Expand Down

0 comments on commit 4f80a99

Please sign in to comment.