Upgrade
This guide shows how to upgrade a Janssen VM deployment.
Note
VM deployments don't provide automatic upgrade/update support. Uninstalling and re-installing with newer binaries is the only option that requires re-configuration of auth-server. Though this is made easy using Terraform. We recommend using Kubernetes installations over VM, to avail smooth upgrades and better HA support.
Let's assume we are upgrading Jans VM installation from current version
to v1.1.2
-
Keep the old VM installation running.
-
Install on a separate VM the target new Jans installation, i.e.
v1.1.2
.You can install with a test client. For example:
sudo python3 /opt/jans/jans-setup/setup.py -test-client-id 6382c9da-f25d-435f-ac63-6acde36f4859 -test-client-pw secret1172023
This
client-id
andclient-pw
will then be used to import Terraform configurations -
Use our Terraform docs on the new installation, i.e.
v1.1.2
to:- import all the global configurations from the new installation using
terraform import
- define all the custom IDP configurations and apply them using
terraform apply
- import all the global configurations from the new installation using
-
At this point there should be two versions up,
old version
andv1.1.2
. -
Traffic should be switched gradually from the old setup to the new setup. Once confidence is gained, drain the old VM.
Created: 2023-07-24