Version: Mosquitto 3.0

Updating Pro Mosquitto

Updating Pro Mosquitto is usually a straightforward process. When a new version is available, download the latest version from our Cedalo platform. Depending on the update and the platform you are using, your existing setup may continue to function correctly, and you can simply adapt to certain changes. Please refer to the migration information for each version for more details. Be aware, that new features may need activation in the configuration file of Pro Mosquitto. See the release notes for more details.

If there are no changes that require reconfiguration of your current setup, the following steps should be taken for the update:

Docker:
1. Update the version number in the docker-compose.yml file to the latest version.
2. Run the following commands to update the images:
```
docker-compose down
docker-compose up
```
OpenShift:
1. Uncompress the helm package:
```
tar -xzvf <helm-package-name>
```
2. Open and edit the values.yaml file present inside the package and update the mosquitto.image.tag field in the values.yaml file to latest version number.
3. Go one level back to the parent directory and package the folder back to its compressed form using:
```
helm package  <helm-package-folder-name>
```
4. Redeploy your updated setup using the same credentials which you used while installing the setup using helm install command the first time. Below command is just a template:
```
helm upgrade <helm-package-name>   --set repoPath=<path-to-your-folder>  --set runAsUser=<user-id> -n <namespace> --set namespace=<namespace> --set nfs=<nfs-ip-if-required> --set imageCredentials.registry=registry.cedalo.com --set imageCredentials.username=<username> --set imageCredentials.password=<password> --set imageCredentials.email=<email>
```
Kubernetes:
1. Uncompress the helm package:
```
tar -xzvf <helm-package-name>
```
2. Open and edit the values.yaml file present inside the package and update the mosquitto.image.tag field in the values.yaml file to latest version number.
3. Go one level back to the parent directory and package the folder back to its compressed form using:
```
helm package  <helm-package-folder-name>
```
4. Redeploy your updated setup using the same credentials which you used while installing the setup using helm install command the first time. Below command is just a template:
```
helm upgrade <helm-package-name>   --set repoPath=<path-to-your-folder>   -n <namespace> --set namespace=<namespace> --set nfs=<nfs-ip-if-required> --set imageCredentials.registry=registry.cedalo.com --set imageCredentials.username=<username> --set imageCredentials.password=<password> --set imageCredentials.email=<email>
```
Portainer:
1. Update the version number in the docker-compose.yml file to the latest version.
2. Run the following commands to update the images:
```
docker-compose down
docker-compose up
```
Native Linux on RHEL (Red Hat Enterprise Linux):
- Follow the appropriate update procedures for your Linux distribution.
Native Windows:
1. Download the new .exe file.
2. Stop the Mosquitto service.
3. Install the new version over the current installation.

Make sure to verify your configurations after the update to ensure everything is functioning as expected.

Cluster Updates

In a cluster update one broker after the other starting with the two follower nodes. This way the cluster stays intact while updating.