Use the following information to upgrade the Identity Service from version 1.2 to version 1.3.
Important: Upgrading the Identity Service requires downtime and should be performed in a test environment before being attempted in a production environment.
Upgrade a Kubernetes deployment
Use the following steps as a reference to upgrade a Kubernetes deployment:
Normally the infrastructure chart that contains the Identity Service will be deployed as part of another product chart such as Alfresco Content Services or Alfresco Process Services.
As an example, the following upgrade steps reference the infrastructure chart on its own:
- Manage any open sessions in the Identity Service by signing in as an administrator and using the Manage > Sessions option.
- Delete the data/tx-object-store/ directory.
- Create a back up of any customizations such as themes or configurations.
- Back up the database used by the Identity Service.
-
Locate the previously deployed infrastructure chart in Kubernetes and set it as a variable:
export RELEASENAME=knobby-wolf
-
Use the
helm upgrade
command to upgrade the infrastructure chart to a release that contains version 1.3 of the Identity Service:helm upgrade $RELEASENAME alfresco-stable/alfresco-infrastructure --version 5.2.0
- Wait for the new pods to start up before accessing the new version of the Identity Service.
-
(Optional) Use the following command to rollback to the previous version if required:
helm rollback --force --recreate-pods --cleanup-on-fail $RELEASENAME 1
Upgrade a ZIP distribution installation
Use the following steps to upgrade a manual ZIP installation:
-
Back up the database used by the Identity Service.
For example, for a PostgreSQL database backup:
pg_dump --clean --no-owner --no-acl -h ${POSTGRES_HOST} -p ${POSTGRES_PORT} -U ${POSTGRES_USER} ${POSTGRES_DATABASE} | grep -v -E '(DROP\ SCHEMA\ public|CREATE\ SCHEMA\ public|COMMENT\ ON\ SCHEMA\ public|DROP\ EXTENSION\ plpgsql|CREATE\ EXTENSION\ IF\ NOT\ EXISTS\ plpgsql|COMMENT\ ON\ EXTENSION\ plpgsql)' > /backup/backup.sql
- Remove the existing data from the database and stop the database service.
- Stop the Identity Service service.
- Open the zip file for version 1.3 of the Identity Service and configure its connection to the database.
-
Restart the database service and restore the database backup to it.
For example, for a PostgreSQL database:
psql -h ${POSTGRES_HOST} -p ${POSTGRES_PORT} -d ${POSTGRES_DATABASE} -U ${POSTGRES_USER} -f /backup/backup.sql
-
Run the standalone start script for the new version of the Identity Service:
Note: To bind to all public interfaces use
0.0.0.0
as the value ofIP_ADDRESS
otherwise use the address of a specific interface.For a Linux or Unix environment:
$ cd alfresco-identity-service-1.3.0/bin $ ./standalone.sh -b <IP_ADDRESS>
For a Windows environment using a bat script:
> ...\alfresco-identity-service-1.3.0\bin\standalone.bat -b <IP_ADDRESS>
For a Windows environment using a Powershell script:
> ...\alfresco-identity-service-1.3.0\bin\standalone.ps1 -b <IP_ADDRESS>