Scenario Executions

Possible usage steps within this page

To successfully connect your device using Docker on Debian, follow these steps:

1. Download Docker File and License:
   • Click the "Download Docker File (Debian latest)" button. Your browser will download the Docker configuration file.
   • Click the "Download license (Debian latest)" link. Your browser will download the necessary license file.
   • Store both files in a convenient location on your device where you have a Docker environment installed (e.g., Docker Desktop, Docker on Linux).
2. Execute Docker Commands:
   • Open your terminal or command prompt.
   • Navigate to the directory where you saved the Docker file.
   • Copy the Docker Build Command by clicking its copy icon, then paste and execute it in your terminal. This will build the awaBerry Docker image.
   • Once the build is complete, copy the Docker Run Command and execute it. This will start your awaBerry Docker container in the background.
   • Finally, copy the Docker Exec Command and execute it. This will open a shell inside your running container, and the awaBerry installation routine will begin automatically.
3. Installation and Device Registration:
   • The awaBerry installation routine will guide you through the final setup steps within the Docker container.
   • Upon successful completion, new Docker containers will automatically be added to your awaBerry device list, and you will receive a confirmation email for each newly added container.
4. Return to Device List: After completing the setup, click the "Back to device list" button to return to the main device management page.

Possible errors which may occur on this page

While the page itself is designed for smooth interaction, issues can arise from your local environment or network connectivity:

• Download Failure: If you click the "Download Docker File" or "Download license" buttons and nothing happens, or an error message appears in your browser, it might be due to:
  • Network Connectivity Issues: Ensure your internet connection is stable.
  • Browser Restrictions: Your browser's security settings might be preventing the download. Try temporarily adjusting them or using a different browser.
  • Ad Blockers/Security Software: These tools can sometimes interfere with file downloads.
  Resolution: Check your network, try another browser, or temporarily disable browser extensions.
• Command Copy Failure: Although unlikely, if clicking the copy icon for a command does not copy the text to your clipboard, or the notification doesn't appear, it could indicate:
  • Browser/Device Permissions: In rare cases, your browser or operating system might restrict web pages from accessing the clipboard.
  Resolution: Try manually selecting and copying the text, or restart your browser.
• External Docker Environment Issues (after copying commands): While not an error directly on this page, executing the copied commands in your terminal might fail if:
  • Docker is Not Installed or Running: The commands require a functional Docker environment.
  • Incorrect Directory: You must execute the build command from the directory where the Docker file is stored.
  • Permission Issues: Your user account might not have the necessary permissions to run Docker commands.
  Resolution: Ensure Docker is correctly installed and running, verify your current directory in the terminal, and check your user permissions for Docker.