Skip to content

get-started.md

Latest commit

 

History

History
154 lines (102 loc) · 4.28 KB

get-started.md

File metadata and controls

154 lines (102 loc) · 4.28 KB

Get Started

This guide provides step-by-step procedure to:

  • Set up the agent using the automated setup script for quick deployment.
  • Run predefined tasks to explore its functionality.
  • Learn how to modify configurations to suit specific requirements.

Prerequisites

Before you begin ensure the following:

  • System Requirements: Verify that the system meets the minimum requirements.
  • Docker Installation Complete: Install Docker, For installation instructions, see Get Docker.
  • MQTT Explorer: Ensure access to MQTT explorer for traffic data streaming and verifying payloads.

Note:

  • Make sure the following ports are available
    • localhost:1880 (for NodeRED)
    • localhost:8086 (for InfluxDB)
    • localhost:3000 (for Grafana)

Setup Guide

1. Deploy Source Code

Clone the repository to your Edge Server:

git clone https://github.com/open-edge-platform/edge-ai-suites.git

Go to the directory:

cd edge-ai-suites/metro-ai-suite/metro-vision-ai-app-recipe/

2. Configure Environment

Ensure the following specialized adapters are present in src/dlstreamer-pipeline-server/user_scripts/:

  • sscape_adapter_lpr.py (Front/Rear LPR)
  • sscape_adapter_side.py (Axle Counting)

Note: Verify variables in .env match your camera RTSP endpoints.

3. Create .yml file

Generate the 'docker-compose.yml' file:

./install.sh smart-tolling

The docker-compose.yml file mentions all the relative paths in the pipeline which is configured in config.json file.

4. Launch Services

Start the application stack using Docker Compose:

docker compose up

OR to hide the logs:

docker compose up -d

To stop the application:

docker compose down

5. Verify Deployment

Check the status of all containers:

docker compose ps

Expected Output: Services dlstreamer-pipeline-server, broker, web, influxdb, node-red and grafana should be Up.

Accessing the Application

  • Web UI (Intel® SceneScape Configuration): https://localhost
  • Grafana (Dashboard): http://localhost:3000 (Default Login: admin/admin)

User Interface

Open a browser and go to the following endpoints to access the application.

Note:

  • For passwords stored in files (e.g., supass or influxdb2-admin-token), refer to the respective secret files in your deployment under ./src/secrets (Docker) or chart/files/secrets (Helm).
  • Since the application uses HTTPS with self-signed certificates, your browser may display a certificate warning. For the best experience, use Google Chrome and accept the certificate.
  • URL: https://localhost
  • Log in with credentials:
    • Username: admin
    • Password: Stored in supass. (Check ./smart-intersection/src/secrets/supass)

Note:

  • After starting the application, wait approximately 1 minute for the MQTT broker to initialize. You can confirm it is ready when green arrows appear for MQTT in the application interface . Since the application uses HTTPS, your browser may display a self-signed certificate warning. For the best experience, use Google Chrome.

MQTT Explorer

Login with the following credentials:

  • Protocol: mqtt://
  • Host: localhost
  • Port: 1883

Note:

  • Make sure to disable "Validate Certificate" and enable "Encryption(tls)".

NodeRED UI

InfluxDB UI

  • URL: http://localhost:8086

  • Log in with credentials:

    • Username: <your_influx_username> (Check ./smart-intersection/src/secrets/influxdb2/influxdb2-admin-username)
    • Password: <your_influx_password> (Check ./smart-intersection/src/secrets/influxdb2/influxdb2-admin-password)

Grafana UI

  • URL: http://localhost:3000
  • Log in with credentials:
    • Username: admin
    • Password: (You will be prompted to change it on first login)