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:
Download latest SmartFace Platform Prerequisites installer and SmartFace Platform installer from our CRM portal (for the old CRM portal please visit the old CRM).
Run SmartFace Platform Prerequisites installer.
Run SmartFace Platform installer.
Migrate NoSQL database from LevelDB to Mino DB.
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:
In case you have incompatible NoSQL DB or face templates, installer will notify you.
Click OK on mentioned notifications and continue with the installation.
Installer will upgrade your SmartFace Platform.
SmartFace services won’t run due to the incompatibility of your database and your face templates.
Migrate NoSQL database from LevelDB to MinioDB
To migrate LevelDB to MinioDB follow these steps:
Download
LevelDbMinioMigration (2022-12-06).exe
migration tool from our CRM portal (for the old CRM portal please visit the old CRM).Open Command Line.
Open directory where
LevelDbMinioMigration (2022-12-06).exe
is copied.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
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:
Download sfadmin.exe migration tool from our CRM portal (for the old CRM portal please visit the old CRM).
Open Command Line.
Open directory where
sfadmin (2022-12-06).exe
is downloaded.Execute command:
migrate-faces
withsfadmin (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.