Skip to content

how-to-deploy-scenescape-using-prebuilt-containers.md

Latest commit

 

History

History
101 lines (69 loc) · 2.5 KB

how-to-deploy-scenescape-using-prebuilt-containers.md

File metadata and controls

101 lines (69 loc) · 2.5 KB

Intel® SceneScape Deployment Guide (Prebuilt Containers)

This guide explains how to deploy Intel® SceneScape using prebuilt Docker images, primarily from Docker Hub.

1. Set Up Docker Environment

  1. Ensure Docker is installed and running on your system.

2. Generate secrets and download OpenVINO Model Zoo models

make init-secrets install-models

3. Use Prebuilt Images for Intel® SceneScape Deployment

Prebuilt containers can be found here:

3.1 Configure Docker Compose to use prebuilt images

Update sample_data/docker-compose-dl-streamer-example.yml to use the above prebuilt images. Example:

scene:
  image: docker.io/intel/scenescape-controller:latest
  # ... other service configurations ...
web:
  image: docker.io/intel/scenescape-manager:latest
  # ... other service configurations ...
camcalibration:
  image: docker.io/intel/scenescape-camcalibration:latest
  # ... other service configurations ...

3.2 Configure preloaded scenes at deployment

  • Skip preloading: Do not set the EXAMPLEDB environment variable.
  • Preload database: Set the EXAMPLEDB environment variable to the path of your database tar file and ensure the folder is mounted. Example:
web:
  image: docker.io/intel/scenescape-manager:latest
  environment:
    - EXAMPLEDB=/home/scenescape/SceneScape/sample_data/exampledb.tar.bz2
    - SUPASS=<password>
  volumes:
    - vol-sample-data:/home/scenescape/SceneScape/sample_data

4. Start Services

Start the demo services:

SUPASS=<password> make demo

Verify that all containers are running:

docker ps

5. Import Scenes

After the services are up, scenes can be imported either via API (curl) or the Web UI.

5.1 Using curl

  1. Obtain an authentication token:
curl --location --insecure -X POST -d "username=admin&password=<password>" https://<ip_address>/api/v1/auth

Note: <password> is the same as used in SUPASS=<password> make demo.

  1. Upload the scene ZIP:
curl -k -X POST \
  -H "Authorization: Token <token>" \
  -F "zipFile=@<path_to_zip>" \
  https://<ip_address>/api/v1/import-scene/

5.2 Using the Web UI

  1. Log in with admin credentials.
  2. Navigate to Import Scene.
  3. Select and upload the scene ZIP.