Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Minor


Note

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".

Expandall

Prerequisites 

Expand
titlePrerequisites

The following prerequisites apply:

Upgrade from Smart ID on Docker

Expand
titlePrepare 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:

    Code Block
    cd /home/nexus/smartid/
    cp -rf smartid smartid.backup



Expand
titleStop applications

To stop applications: 

  1. Go to each application folder, for example: 

    Code Block
    titleExample: Navigate to Identity Manager folder
    cd /home/nexus/smartid/docker/compose/identitymanager


  2. Stop the services by running this command: 

    Code Block
    titleStop services
    docker-compose stop



Expand
titleUpdate Smart ID version in environment file

To update the Smart ID version in the environment file:

  1. Read release notes to see if there anything changed in the configurations files that will break 
  2. Open the environment file /home/nexus/smartid/docker/compose/smartid.env for editing. 
  3. Change to the new Smart ID version: 

    Code Block
    titleExample: Change Smart ID Version
    ### Smart ID Version
    SMARTID_VERSION=21.10



Expand
titleUpdate database

To update the database:

  1. Change directory:

    Code Block
    cd <SMARTIDHOME>/compose/identitymanager/updatedb


  2. Start the container:

    Code Block
    docker-compose up


  3. Wait until the container has run until completion.


Expand
titleStart applications

To start applications:

  1. Go to each application folder, for example: 

    Code Block
    titleExample: Navigate to Identity Manager folder
    cd /home/nexus/smartid/docker/compose/identitymanager


  2. Start the services by running this command: 

    Code Block
    titleStart application
    docker-compose up -d


Additional steps for a specific version

Expand
titleAdditional steps for Identity Manager

Children Display

Delete previously deployed images

Expand
titleDelete previously deployed images

After a complete upgrade process, you can delete images that were previously deployed to free space.

  1. List all images:

    Code Block
    titleList images
    docker images


  2. Remove old images, add the image id for the image that shall be removed:

    Code Block
    titleRemove old images
    docker image rm ID_IMAGE



This article is valid includes updates for Smart ID 2122.04 and later10.

Related information