User Manual
Connect a new device from scratch
This page guides you through the initial steps of connecting a new AwaBerry device to your account, allowing you to choose how you want to install the necessary software.
Connect a new device from scratch
Summary
This page guides you through the initial setup process for a new AwaBerry device. You will select the installer source, specifically focusing on creating a custom, 'bespoke' installer. The system manages the display of any error messages and leads you to the next steps for connecting your device.
Create a bespoke installer
This page is the starting point for setting up a new device using a bespoke installation method. It allows you to choose between installing on a 'Server / PC' or a 'System on a chip' device. Your selection determines the specific installation steps that follow. The system checks your license device limit before proceeding.
Page Access
You can access this page by navigating to: /connect_steps_newdevice
Page Functionalities
This page serves as the starting point for connecting a new AwaBerry device. It provides important information and a clear option for how to proceed with the installation process:
- Informational Text:
- A general statement indicating you need to "Select source of installer".
- Details about "Available installers" for various device types such as Desktop PCs, Servers, Systems on a chip (like Orange Pi, Banana Pi, Raspberry Pi), and Virtual Machines (VMware, cloud-based).
- Information about "Headless connection" for system-on-a-chip devices, explaining how to connect your device to awaBerry via Wi-Fi without a monitor or keyboard.
- "Create a bespoke installer for my new device" Tile:
- This is the primary interactive element on the page.
- Title: "Create a bespoke installer for my new device".
- Subtitle: "All bespoke installers contain automated connection routines for newly installed devices to your awaBerry account. You can also order an SD-Card containing the installer to start your device out of the box."
- Functionality: Tapping this tile will initiate the process of creating a custom installer tailored for your device and will lead you to the next setup steps.
- Availability: This tile may be temporarily inactive if you have pending bespoke installer build requests. A message will inform you if this is the case, stating: "Note: there may be only one uncompleted bespoke build ticket at a time and max three in total."
- Promotional Banner: You may see a banner indicating that bespoke installations are "Currently for free".
Scenario Executions
Possible usage steps within this page
Here's how you can successfully use this page to start connecting your new AwaBerry device:
- You arrive at the "Connect a new device from scratch" page.
- Read the introductory information about available installers and headless connections.
- Locate the "Create a bespoke installer for my new device" tile.
- Verify that the tile is active, meaning it is not grayed out and you don't see a message restricting new build tickets.
- Tap on the "Create a bespoke installer for my new device" tile.
- The system will then navigate you to the next step in the bespoke device setup process.
Possible errors which may occur on this page
While interacting with this page, you might encounter situations that prevent immediate progression:
Bespoke Installer Tile is Inactive
This error occurs when the "Create a bespoke installer for my new device" tile is grayed out and cannot be tapped. This happens because:
- Reason: You currently have pending bespoke installer build requests. The system allows only a limited number of simultaneous or total pending requests.
- Indication: A message will appear near the inactive tile stating: "Note: there may be only one uncompleted bespoke build ticket at a time and max three in total."
- Resolution: You will need to wait for your existing bespoke build tickets to be completed or cancelled before you can request a new one.
