Add Device - how to connect -> Connect a new device from scratch

Connect a new device from scratch

Summary

This page helps you set up a new AwaBerry device by choosing how you will install the necessary software. You can either opt to create a personalized installer tailored to your needs or select an option for an installer you've already obtained. The page provides important information about different device types and connection methods, ensuring a smooth start for your new device.

Create a bespoke installer

This page is the first step in creating a custom installer for your new device. It allows you to specify whether your new device is a traditional computer like a server, desktop PC, or laptop, or a more specialized 'System on a chip' device such as a Raspberry Pi. Your choice here will guide you to the appropriate next steps for your specific device type.

Page Access

You can access this page by navigating to: /connect_steps_newdevice

Page Functionalities

On this page, you will find information and options to guide you through the initial setup of your new AwaBerry device:

  • Informational Text:
    • "Select source of installer": Guides you to choose between creating a custom installer or using a downloaded one.
    • "Installer are available for Desktop PC / Server, System on an a chip (Orange, Banana, Raspberry PI, ..) and Virtual Machines (VM Ware, Cloud based, ..)": Informs you about the various types of devices compatible with AwaBerry installers.
    • "Headless connection: For system on a chip devices (Orange, Banana, Raspberry PI, ..) we provide a headless wifi connect routine. This allows to connect your device to awaBerry with a wifi access point without any monitor or keyboard.": Explains how to connect devices without a screen or keyboard using a special Wi-Fi setup.
  • "Create a bespoke installer for my new device" Tile:
    • This option allows you to generate a custom installer for your device.
    • Description: "All bespoke installers contain automated connection routines for newly installed devices to your awaBerry account. You can also order a SD-Card containing the installer to start your device out of the box."
    • Availability: This tile might be temporarily unavailable if you have too many pending custom installer requests.
    • Inactive Message: If unavailable, a message will appear: "Note: there may be only one uncompleted bespoke build ticket at a time and max three in total."
  • "Installer downloaded from awaBerry.com" Tile:
    • Select this option if you have already downloaded or purchased an AwaBerry installer.
    • Description: "The installer was downloaded or bought via awaBerry.com."
  • Download Link:
    • "Download ISO/IMG installer from awaBerry.com": Clicking this link will open your web browser to the official AwaBerry website, where you can download the necessary installer files.

Scenario Executions

Possible usage steps within this page

Here are common ways you can use this page to connect your new AwaBerry device:

  1. Creating a Custom Installer (Bespoke):

    If you prefer a personalized installer that automatically connects to your AwaBerry account:

    1. Ensure the "Create a bespoke installer for my new device" tile is active (not grayed out).
    2. Click on the "Create a bespoke installer for my new device" tile.
    3. You will be redirected to the next step to configure and generate your bespoke installer.
  2. Using a Pre-Downloaded Installer:

    If you have already obtained an AwaBerry installer (e.g., downloaded from the website or received an SD card):

    1. Click on the "Installer downloaded from awaBerry.com" tile.
    2. You will be redirected to the next steps for connecting a device with a pre-existing installer.
  3. Downloading the Installer:

    If you need to download the installer files first:

    1. Click on the "Download ISO/IMG installer from awaBerry.com" link located at the bottom of the options.
    2. Your web browser will open, taking you to the AwaBerry website to begin the download.

Possible errors which may occur on this page

Understanding potential issues can help you troubleshoot if something doesn't go as expected:

  1. Bespoke Installer Option is Inactive:

    Error: You want to create a custom installer, but the "Create a bespoke installer for my new device" tile is grayed out and cannot be clicked.

    Reason: This occurs because there are limits on how many custom installer requests you can have at one time. The message "Note: there may be only one uncompleted bespoke build ticket at a time and max three in total." will appear, explaining the restriction.

    Solution: You will need to wait until existing custom installer requests are completed or canceled before you can create a new one. In the meantime, you can still proceed with the "Installer downloaded from awaBerry.com" option if you have already downloaded an installer, or download one via the provided link.

Up to User Manual Main Page