Skip to content

Upgrade process from 4.1 to 4.2

Jose edited this page May 30, 2020 · 4 revisions

Move config files to DB

  • Move /etc/gluu/conf/casa.json contents to database (as in https://github.com/GluuFederation/casa/issues/96)

  • If /opt/gluu/jetty/casa/casa-cors-domains exists, create a new key in the json configuration whose value is an array of strings. Every element of the array must contain every line found in the file

Example:

If casa-cors-domains contains

http://acme.com
https://some.gluu.foo

we should add to oxConfApplication the following:

allowed_cors_domains: ["http://acme.com", "https://some.gluu.foo"]

Update plugins

Examine the *.jar files in /opt/gluu/jetty/casa/plugins

Temporary extract the contents and see META-INF/MANIFES.MF and collect the values of Plugin-Id property

Remove the jar files and download the new corresponding versions using the table below:

Plugin-Id Jar (temporal links until we have final 4.2 version)
strong-authn-settings https://ox.gluu.org/maven/org/gluu/casa/plugins/strong-authn-settings/4.2.0-SNAPSHOT/strong-authn-settings-4.2.0-SNAPSHOT-jar-with-dependencies.jar
account-linking https://ox.gluu.org/maven/org/gluu/casa/plugins/account-linking/4.2.0-SNAPSHOT/account-linking-4.2.0-SNAPSHOT-jar-with-dependencies.jar
authorized-clients https://ox.gluu.org/maven/org/gluu/casa/plugins/authorized-clients/4.2.0-SNAPSHOT/authorized-clients-4.2.0-SNAPSHOT-jar-with-dependencies.jar
custom-branding https://ox.gluu.org/maven/org/gluu/casa/plugins/custom-branding/4.2.0-SNAPSHOT/custom-branding-4.2.0-SNAPSHOT-jar-with-dependencies.jar

If strong-authn-settings is found, additionally do the following:

In oxConfApplication json content add:

"basic_2fa_settings": {
	"autoEnable": false,
	"allowSelfEnableDisable": true,
	"min_creds": the same value of property min_creds_2FA of casa.json
},
"plugins_settings": {
	"strong-authn-settings": {
		"policy_2fa" : Copy the value of property policy_2fa found in original casa.json (if any)
		"trusted_dev_settings": Copy the value of property trusted_dev_settings found in original casa.json (if any)
		"basic_2fa_settings": the same contents used in outer basic_2fa_settings above
	}
}

If account-linking is found, additionally do the following:

  • Copy to /opt/gluu/jetty/oxauth/custom/pages the new casa.xhtml file

  • In the database, update attribute oxScript of the custom script with displayName=casa

For this purpose use the files found in this github folder: https://github.com/GluuFederation/casa/tree/master/plugins/account-linking/extras (temporal until the proper git branch is created)