Guides

Operations and Troubleshooting

Connect to the Application

Once the system is running, connect to the application using your browser:

  • HTTP: http://<server name>:2080
  • HTTPS: https://<server name>:2443

Start the System

./srart.sh

Stop the System

./stop.sh

Creating Datasets

./run_profiler.sh -n "<desired dataset name>" -p "<dataset source dir>"
  • This process can take several hours, depending on data size.
  • If the dataset name includes spaces, use quotation marks (e.g., "My Dataset").

Troubleshooting

Resolving Common Errors

Problem: Image Not Found

docker: Error response from daemon: pull access denied for visuallayer/onprem-installer, repository does not exist or may require 'docker login'.

Solution: Ensure you are logged into Docker.

Problem: Docker Daemon Not Running

docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock.

Solution: Start the Docker daemon.

Problem: Image Pulling Fails

manifest for visuallayer/onprem-cd:2.25.6-rc6 not found: manifest unknown

Solution: Verify the software version and that you are logged into Docker with the correct user.

Problem: Platform Mismatch Warning

WARNING: The requested image's platform (linux/arm64) does not match the detected host platform (linux/amd64/v3).

Solution: This is a warning onlyβ€”can be ignored.

Problem: docker compose Not Found

./run_profiler.sh: line 159: docker compose: command not found

Solution: Install or reinstall Docker following the official installation instructions.

Problem: PostgreSQL Operational Error

sqlalchemy.exc.OperationalError: (psycopg.OperationalError) [Errno -3] Temporary failure in name resolution

Solution: Ensure the system was brought up using the docker up command.


Accessing Logs & Support

Debugging Run

Use the following environment variables to enable debugging:

LOG_LEVEL=10  # Set log level to debug
REPORTING_LOG_PATH="/path/to/log.txt"  # Write pipeline log to file