Breadcrumbs

OR Service Installation

For Object Recognition (OR), you need to install the ORService and ODSService packages. OR carries out the object recognition, and ODS stores the object recognition events in PostgreSQL.

Requirements

  • Administrator rights

  • Object Recognition license on the VMS Management Server

  • RTSP license feature on the VMS Management Server and the VMS Server

  • Required NVIDIA libraries (CUDA, cuDNN, TensorRT) are installed

The Object Data Store Service has a similarity search cache to speed up Similarity Search, which can be switched on or off.

Note: Using the cache will increase the memory consumption.

You can enable or disable the similarity search cache when installing the service.

NVIDIA libraries (CUDA cuDNN, TensorRT) are not included in the OR installer. The installer will detect the presence of the NVIDIA library installers from the ‘NVIDIA’ subfolder and install the libraries automatically if they are found.

NVIDIA libraries

Required NVIDIA libraries should be installed before installing the OR service if they have not yet been installed. Installation of the OR service requires the installation of the following NVIDIA libraries for Windows:

Installing NVIDIA libraries

  1. Download the Mirasys OR service installer and place it in a folder on your machine

  2. Create a subfolder 'NVIDIA'

  3. Download the NVIDIA libraries mentioned above

  4. Save the downloaded NVIDIA libraries to the 'NVIDIA' subfolder

  5. Run the Mirasys OR service installer

    1. Mirasys OR service installer automatically installs the NVIDIA libraries that it detects from the 'NVIDIA' subfolder before the service is installed

  6. Follow the installation instructions to finalize the installation

OR Installation

  1. Download the latest version from Extranet.

  2. Unzip the files e.g. to the C:\temp folder.

  3. Start the installation by double-clicking the installation file.

  4. Click Install to continue.

  5. Click Next to continue.

  6. Check I accept the terms in the License Agreement and click Next.

  7. Change the installation location if needed; if not, click Next to continue.

  8. Change the service HTTP port, main server address and port, the event queue address and port if needed.

The HTTP port where the OR service is hosted is by default 8092. Change the port in case the default port is reserved for some other use.

The main server uses port 8082 by default. Set the main server address and port to allow the OR service to connect to the correct main server.

Event queue uses port 5672 by default. The event queue is installed with the ODS service installation, where the used event queue port is set. Set the event queue address to the machine where the ODS service is installed.

  1. Click Next to continue.

  2. Select at least one of the devices that will be used for OR:

    • CPU

    • Intel GPU

    • NVIDIA GPU

  3. Click Install to continue and wait.

Installation will take some time until it is finished.

Model creation can take up to 30 minutes. This depends on how powerful the graphics card in use is.

  1. Click Finish to continue.

  2. Click Close to close the installation.

ODS Installation

  1. Download the latest version from Extranet.

  2. Unzip the files e.g. to the C:\temp folder.

  3. Start the installation by double-clicking the installation file.

  4. Set the PostgreSQL database password

    1. The default password is postgres

PostgreSQL will be installed with the ODS service if it hasn’t already been installed earlier.

Currently, there is no support for a separate PostgreSQL server, with the exception of an existing installation of PostgreSQL version 15 or 16.

  1. Click Install to continue.

  2. Click Next to continue.

  3. Change the installation location if needed, and click Next to continue.

  4. Change the service HTTP port, main server address and port, the event queue address and port if needed.

The HTTP port where the ODS service is hosted is by default 8093. Change the port in case the default port is reserved for some other use.

The main server uses port 8082 by default. Set the main server address and port to allow the ODS service to connect to the correct main server.

Event queue uses port 5672 by default. The event queue is installed with the ODS service. Change the event queue port in case the default port is reserved for some other use.

  1. Click Next to continue.

  2. Click Install to continue and wait.

  3. Click Finish to continue.

  4. Click Close to close the installation.