Nexus Documentation

Space shortcuts

Page tree

Nexus information on: Azure Key Leakage - Storm-0558
Nexus awareness advisory on Microsoft’s update KB5014754

Visit Nexus to get an overview of Nexus' solutions, read customer cases, access the latest news, and more.

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

Expand/Collapse All

Prerequisites 

The following prerequisites apply:

Upgrade from Smart ID on Docker

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:

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

To stop applications: 

  1. Go to each application folder, for example: 

    Example: Navigate to Identity Manager folder
    cd /home/nexus/smartid/docker/compose/identitymanager

  2. Stop the services by running this command: 

    Stop services
    docker-compose stop

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: 

    Example: Change Smart ID Version
    ### Smart ID Version
SMARTID_VERSION=21.10

To update the database:

  1. Change directory:

    cd <SMARTIDHOME>/compose/identitymanager/updatedb

  2. Start the container:

    docker-compose up
  3. Wait until the container has run until completion.

To start applications:

  1. Go to each application folder, for example: 

    Example: Navigate to Identity Manager folder
    cd /home/nexus/smartid/docker/compose/identitymanager

  2. Start the services by running this command: 

    Start application
    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.

  1. List all images:

    List images
    docker images

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

    Remove old images
    docker image rm ID_IMAGE

Related information

© 2023 Technology Nexus Secured Business Solutions AB. All rights reserved.
Contact Nexus | https://www.nexusgroup.com | Disclaimer | Terms & Conditions