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 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)
Note
titleAttention!

Starting with Detector Pack 3.11, a demo license has been added to the Face Recognition Pack (VL) add-on. Demo license is valid for 30 days after installation on one Server or a virtual machine.

To activate a license for the Face detection (VL) (see Installing DetectorPack add-ons, Configuring Face Detection VL), do the following:

    Request EID and ProductID from 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.

     

    Open the license.conf file.

  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:

    Code Block
    languagebash
    mkdir
  6. Code Blocksudo nano
  7.  /opt/AxxonSoft/
  8. DetectorPack/VLSdk/gpu/data/license.conf

     

  9. AxxonOne/gpucache
  10. Change folder permissions:

    Code Block
    languagebash
    chmod -R 777 /opt/AxxonSoft/AxxonOne/gpucache
  11. Go to the /opt/AxxonSoft/AxxonOne folder:

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

    Code Block
    languagebash
    nano instance.conf
  13. 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

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

    Code Block
    sudo /opt/AxxonSoft/DetectorPack/VLSdk/gpu/FingerprintViewer

    Image Removed

  16. Go to the website.
  17. Note
    titleAttention!
  18. If you fail to log in to the website, please contact technical support.

     

  19. Log in using the received EID.
  20. Fill in the user registration data.
    Image Removed
  21. Click the Save button.
  22. Click the Activate button to activate the license.
    Image Removed
  23. In the Activatee Email Address, 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
  24. In the Device FingerPrint field, specify the FingerPrint data.
  25. Click the Activate button.
  26. Place the licenseFile.v2c in the required directory.

    Code Block
    sudo cp /opt/AxxonSoft/DetectorPack/VLSdk/gpu/data/licenses-archive/license.conf /opt/AxxonSoft/DetectorPack/VLSdk/gpu/data/license.conf
  27. Activate the license.

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

     

  28. Make sure the license is successfully activated.
    Image Removed

Face detection (VL) license is activated.

...

titleNote
  1. 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
  2. Add the GPU_CACHE_DIR system variable,wherethevaluewillspecify the pathto the cachelocationfolder. For example:

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

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

    Note
    titleAttention!

    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).

  5. 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"
  6. Go to the /opt/AxxonSoft/DetectorPack/ folder:

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

    Code Block
    languagebash
    ./VlFaceGpuCacheGenerator
  8. Press Enter.

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

  10. Press Enter.

  11. 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 

  12. 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

If the Server is connected to the Internet, the license will be checked automatically on the license server.

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

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

...

.