logo logo

Upgrade to 4.8

This article explains how to update an existing SmartFace Platform from any older versions to 4.8.

In SmartFace Platform 4.8 or above LevelDB is no longer supported as a NoSQL database and is replaced by MinioDB. When upgrading from SmartFace Platform 4.7 it is required to migrate your LevelDB database to MinioDB.

SmartFace Platform 4.8 and above provides improved detection and extraction algorithms, therefore existing extracted face templates won’t be compatible with the new ones. When upgrading from previous versions of SmartFace Platform migration of your data is required.

To upgrade from SmartFace Platform 4.7 to SmartFace Platform 4.8 or above follow these steps:

  1. Download latest SmartFace Platform Prerequisites installer and SmartFace Platform installer from our CRM portal (for the old CRM portal please visit the old CRM).

  2. Run SmartFace Platform Prerequisites installer.

  3. Run SmartFace Platform installer.

  4. Migrate NoSQL database from LevelDB to Mino DB.

  5. Migrate your face templates.

Install SmartFace Platform Prerequisites

Run SmartFace Platform Prerequisites installer. This installer will install all missing prerequisites:

  • Erlang
  • RabbitMQ
  • SQL database
  • MS Visual C++ Redistributable
  • OpenVINO
  • MinioDB

Install SmartFace Platform

Run SmartFace Platform installer:

  1. In case you have incompatible NoSQL DB or face templates, installer will notify you.

  2. Click OK on mentioned notifications and continue with the installation.

  3. Installer will upgrade your SmartFace Platform.

  4. SmartFace services won’t run due to the incompatibility of your database and your face templates.

Migrate NoSQL database from LevelDB to MinioDB

⚠️ When upgrading from SmartFace Platform 4.7, migration to MinioDB must be executed before any face template migration, because face template migration works with MinIO database.

To migrate LevelDB to MinioDB follow these steps:

  1. Download LevelDbMinioMigration (2022-12-06).exe migration tool from our CRM portal (for the old CRM portal please visit the old CRM).

  2. Open Command Line.

  3. Open directory where LevelDbMinioMigration (2022-12-06).exe is copied.

  4. Execute migrate command with LevelDbMinioMigration (2022-12-06).exe and defined LevelDB storage path:
    Migration command: .\LevelDbMinioMigration (2022-12-06).exe migrate --level-db-path "C:\ProgramData\Innovatrics\SmartFace\Data

⚠️ Migration tool does not delete or modify data in LevelDB database. It is required you have at least as much free disk space as your current LevelDB size is.

Once the migration is successfully done, migration tool will finish with the message and you can continue with the migration of your face templates.

In case you would like to perform a custom migration with a configuration of the database or the configuration of the migration itself, please follow the Custom migration configuration chapter.

Face templates migration

To migrate your face templates follow these steps:

  1. Download sfadmin.exe migration tool from our CRM portal (for the old CRM portal please visit the old CRM).

  2. Open Command Line.

  3. Open directory where sfadmin (2022-12-06).exe is downloaded.

  4. Execute command: migrate-faces with sfadmin (2022-12-06).exe tool.
    Migration command: .\sfadmin (2022-12-06).exe migrate-faces

In case the migration is stopped or not all faces templates are migrated, the migration can be re-run to migrate the remaining face templates (already migrated face templates will not be migrated again).

After the All faces migrated successfully. message is displayed, the migration is fully completed and SmartFace services can be started.

In case you would like to perform a custom migration with a configuration of the database or the configuration of the migration itself, please follow the Custom migration configuration chapter.

Troubleshooting

In case of an issue when some of the faces cannot be migrated to newer version, error message Value cannot be null" will be displayed. To solve this problem use command: .\sfadmin (2022-12-06).exe set-state-error-non-migrated-faces, which will change the state of these faces to Error.