Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

About SAFR object storage structure for events and persons

This article explains how to  event or person images files within SAFR's object storage repository.  These files are encrypted on disk so if a decrypted images file is required, use SAFR REST APIs.

Since SAFR Platform 3.20, SAFR object store server (CVOS) stores objects in a hierarchical directory structure to improve the CVOS and OS tools performance with very large number of objects.  

Before 3.20 main\ZDdkZmZkNTItOWZmZS00YTM2LTllMGItZTI0ZmYyZGU1NWFj\face
After 3.20 main\NW\Fj\ZDdkZmZkNTItOWZmZS00YTM2LTllMGItZTI0ZmYyZGU1NWFj\face

The long string is the event id (e.g. d7dffd52-9ffe-4a36-9e0b-e24ff2de55ac) encoded as Base64.

The following procedure explains how to find the event face or scene image on disk.

  1. Get the event id.  E.g.:  d7dffd52-9ffe-4a36-9e0b-e24ff2de55ac
  2. Convert that to a Base64 string.   This will be the folder name. E.g.:  ZDdkZmZkNTItOWZmZS00YTM2LTllMGItZTI0ZmYyZGU1NWFj
  3. Go to SAFR's Storage directory.  By default C:\Program Files\RealNetworks\SAFR\cv-storage\customer1\main where 'customer1' is the superadmin account on SAFR server.
  4. Get the last 4 characters from the Base64 of the  Event Id.  E.g. NWFj.
  5. Go to directory name with 1st 2 characters.  E.g. NW
  6. Go to directory name with 2nd 2 characters.  E.g. Fj
  7. Inside this folder, there will be a folder with the full base64 string as the name
  8. In that folder you will find two files:  'face' and 'sceneThumb'.

Note: These files are encrypted. To decrypt, use SAFR Applications or SAFR REST API

If you upgrade SAFR Platform older than 3.20 to 3.20, your cv-storage will have the mixed object layout. New objects will be stored using the hierarchical layout but the old objects remains in legacy layout. This condition will shift to 100% new structure after your event retention period.