Deployment#

Customize Location#

The default configurations and sample streams are designed for a specific location. To deploy the blueprint for your own location, you must complete the following steps:

  1. Create calibration files: Generate calibration files for your cameras. Refer to Calibration for detailed instructions.

  2. Update configuration files: Modify the relevant configuration files to reflect your environment settings, see details below for each deployment method.

  3. Configure your video streams: Obtain and configure the video streams for your deployment location.

The sections below describe the configuration changes required for each deployment method.

Docker Compose#

  1. Update location information for the city in the deployments/smartcities/smc-app/vss-behavior-analytics/configs/vss-behavior-analytics-kafka-config.json file

    • In this file, update the osmQueryPlace parameter to the name of your city. The value here is based on the OSM naming scheme. If this is incorrectly set, you will see errors in the vss-behavior-analytics-smc container logs and will not see any behavior output in Kibana.

  2. Replace the calibration.json and road-network.json files in deployments/smartcities/smc-app/calibration/sample-data with the files generated by the Calibration process.

    • Alternatively, you can upload these via the UI or API once the deployment is up. To use the UI, go to the http://<HOST_IP>:3002 endpoint and upload the files. For the API, make a POST request to http://<HOST_IP>:8081/config/upload-file/calibration with the json as a payload for calibration and http://<HOST_IP>:8081/config/upload-file/road-network with the json as a payload for road-network.

  3. Delete (or move) all video files in the $(MDX_DATA_DIR)/videos/smc-app directory so that they are not auto loaded on deployment. You can then either replace the videos here with your own or keep this directory empty. Make sure that the file name matches exactly what you have in the calibration file otherwise the videos will not be mapped correctly by Analytics.

  4. Redeploy the blueprint.

  5. Navigate to VST at http://<HOST_IP>:30888/vst/#/dashboard and add your RTSP streams.

    • If you copied streams to the folder mentioned above, those streams should automatically show up here. If you have video files instead and did not copy them to the above folder, you can upload them to NVStreamer via the UI at http://<HOST_IP>:31000 then use the RTSP stream link provided and add to VST.

    • Make sure that if you are manually adding streams to VST that the sensor name set matches exactly what you have in the calibration file otherwise the videos will not be mapped correctly by Analytics.

    • For additional details on how to use VST, check the VST docs page and for additional details on how to use NVStreamer, check the NVStreamer docs page.