Skip to content
This repository has been archived by the owner on Sep 2, 2021. It is now read-only.

Latest commit

 

History

History
59 lines (43 loc) · 3.06 KB

assembly.md

File metadata and controls

59 lines (43 loc) · 3.06 KB

Assembly: Edge Lab Bring Up - RPi Version

Return to Edge Lab Overview or Bill of Materials.

This page explains how to build and install the Edge Lab. Before starting, please acquire all the required items from the Edge Lab Bill of Materials.

Prerequisites

The Edge Lab uses Wifi for the cluster internet gateway. Make sure you know your SSID and password.

You must have access to Wifi for the Edge Lab to function correctly.

You need a SD Card download utility to create two different type images. We recommend Balena.io Etcher which has as simple UX and works on multiple platforms.

You'll need at four two 32 (or larger) Gb SD Cards. Since SD Cards look alike, consider marking each with a unique letter or number for reference.

This step takes some time, you can proceed with Assembly while you burn the cards.

  1. Download the two images:
  2. Client: https://s3-us-west-2.amazonaws.com/get.rebar.digital/edge-lab/rpi-client-v1.4.0.img.xz
  3. Server: https://s3-us-west-2.amazonaws.com/get.rebar.digital/edge-lab/rpi-server-v1.4.0.img.xz
  4. Burn one copy of the server image (rpi-server) to an SD Card.
  5. Burn copies of the client image (rpi-client) on your remaining SD Cards.

While all machines need an SD card in the end, it is OK if you only burn one client card, you'll just need to boot the client RPi machines sequentially instead of in parallel.

NOTE: If you are planning on do a k3s install, you will need to leave SD cards in all machinesbecause they are used as container storage.

Assembly

Like pictures? Use the visual assembly instructions.

NOTE: DO NOT POWER THE SYSTEMS UNTIL INSTRUCTED!

  1. Assemble the mechanical environment, if needed
    1. For Cloudlet case, attach the fans and attach RPi boards to the riser cards. Do not install the risers.
    2. For PoE HAT. attach the PoE boards and risers to the RPi
  2. Identify all the RPi numbers 0 to 3. It is helpful to mark them for future reference.
    1. The server is RPi #0 for reference.
  3. Wire the USB power lines to all the servers. Skip this step is using PoE.
    1. Recommended: label the end of the cables to reflect which RPi is plugged into each one
  4. Insert the SD Cards into the systems,
    1. Make sure to note which one has the server image.
  5. Wire the Network cables to the Network Switch
    1. Order does not matter
    2. If you are using PoE, make sure the RPi systems are plugged into the PoE ports.
  6. For Keyboard+Video Install
    1. Attach the mini-HDMI adapter to the server (RPi #0) card using HDMI port 0 (the one near the USBC connector. Connect the HDMI port to a monitor.
    2. Attach the USB Keyboard to the server (RPi #0) card using any of the four USB ports.
  7. For Wired Network Install
    1. Connect an ethernet from an open switch port to your PC or Laptop NIC.
    2. Configure a static IP address in the 10.3.14.[2-10] range

Time to Power On!

See Bootstrapping for next steps!