User Manual
Add existing device - select operating system
This page allows you to select the operating system of your existing device to proceed with connecting it to awaberry.
Add existing device - select operating system
Summary
This page is part of the process to connect an existing device to awaberry. Here, you will choose the operating system installed on your device. Your selection helps guide the subsequent connection steps to ensure compatibility and a smooth setup. After selecting, the system will prepare to move to the next stage of the connection, provided you have available device slots on your license.
Add existing device - LINUX
The 'Add existing device - LINUX' page is the starting point for integrating your Linux-based device with the awaBerry system. This multi-step process ensures a secure and functional connection. You will begin by assigning a unique name to your device, followed by on-screen instructions to prepare your Linux machine, including verifying or installing OpenSSH. Crucially, you will copy specific commands from this page to run in your device's terminal, initiating the awaBerry client software installation. The system then waits for your device to report its online status, eventually leading to a successful connection and readiness for remote management.
Add existing device - MAC
This page provides comprehensive instructions for connecting your existing Mac device to the awaBerry system. It guides you through essential prerequisites such as enabling remote SSH access and installing Homebrew, allowing you to then register your device by assigning a unique name. Following successful registration, you will receive a device ID to be used in the terminal, after which the system will monitor for your device to come online and finalize its configuration.
Add existing device - WINDOWS
This comprehensive guide helps you connect your existing Windows device to awaBerry. The process involves several key steps: first, ensuring your Windows Subsystem for Linux (WSL) is properly installed and configured. Next, you will assign a unique name to your device within the awaBerry platform. After successful registration of the device name, the system provides you with a unique device ID and installation commands to be executed on your Windows device (within WSL). Finally, the system will monitor for your device to come online and complete its setup, confirming a successful connection and preparing your device for use with awaBerry.
Page Access
You can access this page by navigating to: /connect_steps_existing
Page Functionalities
On this page, you will see a prompt asking you to select your device's operating system. Below this prompt, there are three distinct selection tiles, each representing a different operating system:
- Mac OS (Apple based) Tile: Select this if your device runs on Apple's Mac OS. A brief description indicates that an installer is available via brew.
- Linux (Ubuntu / Debian / RedHat based) Tile: Choose this option for devices running on Linux distributions such as Ubuntu, Debian, or RedHat. The description confirms support for these systems.
- Windows (10 / 11 / Server) Tile: Select this for devices operating on Windows. The description mentions that the installer is available via Windows Subsystem for Linux (WSL).
Tapping on any of these tiles will not only select the operating system but also immediately trigger the progression to the next step of the device connection process.
Scenario Executions
Possible usage steps within this page
Here are common ways to successfully use this page:
- Selecting Mac OS:
- You arrive at the "Add existing device - select operating system" page.
- You locate and tap on the "Mac OS (Apple based)" tile.
- The system registers your selection and, assuming you have an available device slot, you are automatically advanced to the next step of the connection process.
- Selecting Linux:
- You arrive at the "Add existing device - select operating system" page.
- You locate and tap on the "Linux (Ubuntu / Debian / RedHat based)" tile.
- The system registers your selection and, assuming you have an available device slot, you are automatically advanced to the next step of the connection process.
- Selecting Windows:
- You arrive at the "Add existing device - select operating system" page.
- You locate and tap on the "Windows (10 / 11 / Server)" tile.
- The system registers your selection and, assuming you have an available device slot, you are automatically advanced to the next step of the connection process.
Possible errors which may occur on this page
Sometimes, you might encounter issues. Here's what to expect and why:
- Device Limit Reached:
Error: After selecting an operating system tile, instead of proceeding to the next connection step, you are redirected to a page asking you to upgrade your license.
Why it happens: This occurs because you have reached the maximum number of devices allowed by your current awaberry license. The system prevents you from adding more devices until you upgrade your subscription.
What to do: If you see this, you will need to follow the instructions on the license upgrade page to increase your device limit or remove an existing device to free up a slot.
