Nexus' software components have new names:

Nexus PRIME -> Smart ID Identity Manager
Nexus Certificate Manager -> Smart ID Certificate Manager
Nexus Hybrid Access Gateway -> Smart ID Digital Access component
Nexus Personal -> Smart ID clients

Go to Nexus homepage for overviews of Nexus' solutions, customer cases, 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

This article is valid for Smart ID 21.04 and later.

Related information