Migration Guide: to 1.7.23

There are some configurations not compatible between after 1.7.23 and before version.

Instructions

In this guide, the places of war file and properties file are written assuming that you configured Personium using ansible script.

Log into AP server

From bastion, connect to AP server.

Replacing war file

sudo -i
systemctl stop tomcat
cd /opt/tomcat/webapp
mkdir -p ~/bk
mv personium-core ~/bk     # backup if you need
mv personium-core.war ~/bk # backup if you need
wget https://github.com/personium/personium-core/releases/download/v1.7.23/personium-core-1.7.23.war

Editing properties file

cd /personium/personium-core/conf/18888
cp personium-unit-config.properties{,bk}   # backup if you need
vim personium-unit-config.properties

Edit opened file referring to below example.

1. Comment out lines start with io.personium.core.oidc.google.trustedClientIds=
2. Decide an unique identifier (ex. google) to distinguish with other settings. (hereinafter referred to as <SID> )
3. Append lines referring to below table. (with key=value format)

key	value
io.personium.plugin.oidc.<SID>.enabled	true
io.personium.plugin.oidc.<SID>.pluginName	OpenID Connect Auth Setting(Change as you like)
io.personium.plugin.oidc.<SID>.configURL	https://accounts.google.com/.well-known/openid-configuration
io.personium.plugin.oidc.<SID>.trustedClientIds	Paste here from previous io.personium.core.oidc.google.truestedClientIds value
io.personium.plugin.oidc.<SID>.accountType	oidc:google
io.personium.plugin.oidc.<SID>.accountNameKey	email
io.personium.plugin.oidc.<SID>.grantType	urn:x-personium:oidc:google

Start Tomcat

systemctl start tomcat