Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip

Configuring the Face detector VL

Creating system variables for the Axxon One server in Linux OS

Creating system variables for the Axxon One server in the failover mode in Linux OS

The

...

titleAttention!

...

VL Face Recognition Pack add-on (

...

see Installing DetectorPack add-ons)

...

 includes a utility that allows you to create GPU neural network caches without using Axxon One. The presence of the cache speeds up the initialization, optimizes video memory consumption, and ensures the start and correct operation of the Face detector VL on the GPU.

Note
titleAttention!

You must recreate the cache when:

  • updating the VL face recognition pack add-on (see Installing DetectorPack add-ons),
  • changing the resolution of the video stream for which the cache is created,
  • changing the Nvidia GPU model,
  • updating Nvidia GPU drivers.

To optimize the operation of the Face detector VL on GPU, do the following:

  1. Stop the server (see Starting and stopping the Axxon One Server in Linux OS)

To activate a license for the Face detector VL (see Configuring the Face detector VL), do the following:

    Request EID and ProductID from the technical support
  1. .
    Note
    titleAttention!
  2. EID and ProductID are linked with the MAC address of the Server. If the MAC address changes, you need to request EID and ProductID again.

  3. If the system uses the software that is running on the GPU, you must stop its operation. 

  4. Login as ngp superuser:

    1. In the command prompt, run the command:

      Code Block
      languagebash
      sudo su ngp
    2. Enter the password for the superuser.

  5. Create a folder with a custom name to store the cache. For example:

  6. Open the license.conf file.
  7. Code Block
    languagebash
  8. sudo nano
  9. mkdir /opt/AxxonSoft/AxxonOne/gpucache
  10. Change folder permissions:

    Code Block
    languagebash
    chmod -R 777 /opt/AxxonSoft
  11. /DetectorPack/VLSdk/gpu/data/license.conf
  12. Enter the received EID and ProductID.

    Code Block
    <param name="EID" type="Value::String" text="received EID"/>
    <param name="ProductID" type="Value::String" text="received ProductID"/>

    Image Removed

  13. Save the file.
  14. Run the FingerprintViewer file. You will receive the FingerPrint data.

    Code Block
    languagebash
    sudo /opt/AxxonSoft/DetectorPack/VLSdk/gpu/FingerprintViewer /opt/AxxonSoft/DetectorPack/VLSdk/gpu/data/license.conf

    Image Removed

  15. /AxxonOne/gpucache
  16. Go to the /opt/AxxonSoft/AxxonOne folder:

    Code Block
    languagebash
    cd /opt/AxxonSoft/AxxonOne
  17. Open the server configuration file for editing:

    Code Block
    languagebash
    nano instance.conf
    Note
    titleAttention!

    When you use the server in the failover mode, you must:

    1. Open the /etc/AxxonSoft folder:
      Code Block
      cd /etc/AxxonSoft
    2. Open the server configuration file for editing:
      Code Block
      nano axxon-one.conf
      Info
      titleNote

      Before you make changes to the axxon-one.conf file, we recommend reading the instructions on the page Creating system variables for the Axxon One server in the failover mode in Linux OS.

    3. Add the GPU_CACHE_DIR system variable in the configuration file, wherethevaluewillspecify the pathto the cachelocationfolder. For example:
      Code Block
      export GPU_CACHE_DIR="/opt/AxxonSoft/AxxonOne/gpucache"
    4. Save the changes in the file.
    5. Add the GPU_CACHE_DIR system variable in the /etc/profile file.
      Code Block
      export GPU_CACHE_DIR="/opt/AxxonSoft/AxxonOne/gpucache"
    6. Run the command:
      Code Block
      source /etc/profile
  18. Add the GPU_CACHE_DIR system variable,wherethevaluewillspecify the pathto the cachelocationfolder. For example:

    Code Block
    export GPU_CACHE_DIR="/opt/AxxonSoft/AxxonOne/gpucache"
  19. Save the server configuration file using the Ctrl+O keyboard shortcut.

  20. Exit the file editing mode using the Ctrl+X keyboard shortcut

  21. Go to the website
  22. .

    Note
    titleAttention!
  23. If you fail to log in to the website, contact the technical support.

    Tip

    Guide to the Sentinel EMS Customer Portal

  24. Log in using the received EID.
    Image Removed
  25. Fill in the user registration data.
    Image Removed
  26. Click the Save button.
  27. Click the Activate button to activate the license.
    Image Removed
  28. In the Activatee Email field, specify the email address to confirm the license activation. The licenseFile.v2c file with license data will be sent to the specified email address.
    Image Removed
  29. In the Device FingerPrint field, specify the FingerPrint data.
  30. Click the Complete Activation button.
  31. Place the licenseFile.v2c file in the required directory: /opt/AxxonSoft/DetectorPack/VLSdk/. 

  32. Make sure the license is successfully activated. If the Server is connected to the internet, the license will be checked automatically.
Info
titleNote

If the Server doesn't have an internet connection, do the following:

  1. Do steps 2–5, 14 on the Server where the license will be used.
  2. Do steps 1, 6–13, 15 on any computer connected to the internet.
  3. Click the View License Certificate button.
  4. Download the license file by clicking the Save License button.
    Image Removed

The license is activated on the Server with no internet connection.

  1. When you change the server configuration (see Changing the configuration of the Axxon One Server in Linux OS) or update to the new Axxon One version, the system variables previously added to the instance.conf configuration file will be deleted (see Creating system variables for the Axxon One server in Linux OS).

  2. In the terminal, run the command that was usedtoadd the systemvariablewiththepathto the cache location folder. For example:
    Code Block
    export GPU_CACHE_DIR="/opt/AxxonSoft/AxxonOne/gpucache"
  3. Go to the /opt/AxxonSoft/DetectorPack/ folder:

    Code Block
    cd /opt/AxxonSoft/DetectorPack
  4. Run the following command:

    Code Block
    languagebash
    ./VlFaceGpuCacheGenerator
  5. Press Enter.

  6. Specify the ID of the required GPU (see Selecting Nvidia GPU when configuring detectors).

  7. Press Enter.

  8. If you want to change the resolution of the video stream:

    1. Enter y. If you don't want to change the resolution of the video stream, enter n

    2. Specify the required resolution. For example, 3840x2160 2688x1520. The GPU uses the default 1920x1080 video stream resolution. If you change the resolution of the video stream from 1920x1080 and higher, it increases the percentage of face detection 

  9. Press Enter. As a result, the process of creating the cache starts. If you get the 0 value, it means that the cache is created successfully.

Optimizing the operation of the Face detector VL on the GPU is complete

...

.