Upgrade Smart ID
Smart ID Certificate Manager and OCSP Responder are not included in this instruction.
This article describes how to upgrade Smart ID to a new version.
You can always update directly to the latest version, no intermediate steps are necessary if you are coming from an older version. But you always have to go through all manual update steps (if there are some) between the current version and the target version. See section "Additional steps for a specific version".
Prerequisites
Smart ID is deployed on Docker. See Deploy Smart ID.
Upgrade from Smart ID on Docker
Prepare upgrade
Before upgrade, do these steps:
Check release notes for additional upgrade steps.
Take backup of Smart ID databases that are used: Identity Manager, Physical Access, Digital Access, Hermod.
Take backup of Smart ID configuration files:
CODEcd /home/nexus/smartid/ cp -rf smartid smartid.backup
Stop applications
To stop applications:
Go to each application folder, for example:
cd /home/nexus/smartid/docker/compose/identitymanager
Stop the services by running this command:
docker-compose stop
Update Smart ID version in environment file
To update the Smart ID version in the environment file:
Read release notes to see if there anything changed in the configurations files that will break
Open the environment file /home/nexus/smartid/docker/compose/smartid.env for editing.
Change to the new Smart ID version:
### Smart ID Version
SMARTID_VERSION=21.10
Update database
To update the database:
Change directory:
cd <SMARTIDHOME>/compose/identitymanager/updatedb
Start the container:
docker-compose up
Wait until the container has run until completion.
Start applications
To start applications:
Go to each application folder, for example:
cd /home/nexus/smartid/docker/compose/identitymanager
Start the services by running this command:
docker-compose up -d
Additional steps for a specific version
Delete previously deployed images
After a complete upgrade process, you can delete images that were previously deployed to free space.
List all images:
docker images
Remove old images, add the image id for the image that shall be removed:
docker image rm ID_IMAGE