Skip to content

Commit

Permalink
Updated upgrade doc headers
Browse files Browse the repository at this point in the history
  • Loading branch information
keyvaann committed Nov 5, 2024
1 parent 39eb0bc commit 1df8708
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions docs/upgrade.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,36 @@
## Upgrade instructions
# Upgrade instructions

Run the following instructions to upgrade an existing RADAR-Kubernetes cluster.

| :exclamation: Note |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Upgrading the major version of a PostgreSQL image is not supported. If necessary, we propose to use a `pg_dump` to dump the current data and a `pg_restore` to restore that data on a newer version. Please find instructions for this elsewhere. |

### Upgrade to RADAR-Kubernetes version 1.2
## Upgrade to RADAR-Kubernetes version 1.2

#### KSQL S erver and JDBC Connector service configuration
### KSQL S erver and JDBC Connector service configuration
In `production.yaml` rename sections:

| Old Name | New Name |
|--------------------------|------------------------------------|
| radar_jdbc_connector | radar_jdbc_connector_grafana |
| radar_jdbc_connector_agg | radar_jdbc_connector_realtime_dashboard |

#### Data dashboard backend secret
### Data dashboard backend secret
You need to manually create this field in your secrets file: `management_portal.oauth_clients.radar_data_dashboard_backend.client_secret`.
If you're not using data dashboard backend you can put `null` in the value, otherwise make sure to generate a random secret and put it in that field.

#### MongoDB
### MongoDB
MongoDB has been updated to a new version and it's not compatible with the current version that has been installed in the cluster. There are two pathes forward:
- Deleting the MongoDB and its volumes and then installing it and configuring Graylog again. This is the recommeneded approach since usually there is no important data is stored in MongoDB and the Graylog stack will be replaced in the next release.
- Upgrading MongoDB cluster. If you have configured Graylog significantly, then it might be better to upgrade the MongoDB instead of reinstalling it. Options are:
- Manually exporting the databases and doing a clean reinstall as stated in the last step and the importing the data again.
- Following official MongoDB upgrade instructions for version [5.0](https://www.mongodb.com/docs/manual/release-notes/5.0-upgrade-replica-set/), [6.0](https://www.mongodb.com/docs/manual/release-notes/6.0-upgrade-replica-set/) and [7.0](https://www.mongodb.com/docs/manual/release-notes/7.0-upgrade-replica-set/).

### Upgrade to RADAR-Kubernetes version 1.1.x
## Upgrade to RADAR-Kubernetes version 1.1.x
Before running the upgrade make sure to copy `environments.yaml.tmpl` to `environments.yaml` and if you've previously changed `environments.yaml` apply the changes again. This is necessary due to addition of `helmDefaults` and `repositories` configurations to this file.

### Upgrade to RADAR-Kubernetes version 1.0.0
## Upgrade to RADAR-Kubernetes version 1.0.0

Before running the upgrade, compare `etc/base.yaml` and `etc/base.yaml.gotmpl` with their `production.yaml` counterparts. Please ensure that all properties in `etc/base.yaml` are overridden in your `production.yaml` or that the `base.yaml` default value is fine, in which case no value needs to be provided in `production.yaml`.

Expand Down

0 comments on commit 1df8708

Please sign in to comment.