Load SD Card with Raspberry Pi OS Lite

  1. Download & Install Raspberry Pi Imager to Windows PC if needed
  2. Insert MicroSD Card into Card Adapter and connect to PC
  3. Run Raspberry Pi Imager
  4. [Choose OS] >> Raspberry Pi OS (other) >> Raspberry Pi OS Lite (32-bit)
  5. [Choose Storage] >> Choose MicroSD Card
    *** Do Not accidentally over-write a hard drive ***
  6. [Write] the OS image to the card
  7. Wait for OS to finish writing to the card & be verified
  8. Remove and re-insert the card / adapter to re-mount in Windows

Enable SSH

  1. Open a command prompt to the root of the SD Card
  2. At the command prompt run 
    type nul>ssh

*If Connecting via WiFi *

  1. Create a new text file on the root of the MicroSD card named wpa_supplicant.conf
  2. Edit the text file with the content:
    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=US
network={
	ssid="<Name of your wireless LAN>"
	psk="<Password for your wireless LAN>"
}

Label the RPi

  1. Assign & Label the RPi with an incremental identifier
    RPi-T3D-###

Boot the RPi

  1. Insert the MicroSD card into the RPi unit
  2. Connect the PoE network cable or power supply cable
  3. Wait about 1 minute to boot

Configure IP Address Reservation for RPi

Identify the MAC address of the unit

  1. Log in to PepLink Router
  2. Navigate to Status >> Client List
  3. Locate the device named raspberrypi and note the MAC address and current IP

Assign the IP Reservation

  1. Navigate to Network >> Network Settings
  2. In the "DHCP Reservation" list under "DHCP Server" add an entry
    Name: RPi-T3D-###
    MAC Address: as noted
    Static IP: 192.168.5.###

Configure Device Name and Update IP

  1. Connect to the RPi via SSH 
    ssh pi@current-ip

    default password: raspberry
  2. Configure the device name
    sudo hostnamectl set-hostname RPi-T3D-###
  3. Add the device's name as a loopback IP
    sudo nano /etc/hosts

    add to end of file append:
    127.0.0.1 RPi-T3D-###
  4. Ctrl+S, Ctrl+X
  5. sudo reboot
  6. Wait about 1 minute to boot
  7. Re-connect to the RPi via SSH 
    ssh pi@RPi-T3D-###

Install AMP stack & T3D Site

  1. Download the T3D Install script
    wget http://t3d.mayerfabrics.com/install.sh
  2. Make the T3D Install script executable
    chmod 755 install.sh
  3. Run the T3D Install script and optionally initialize the unit for a T3D Vendor:
    sudo ./install.sh

    or
    sudo ./install.sh T3D-Vendor-ID

Configure External USB Hard Drive for Image Repository

  1. Identify the external drive's device name 
    lsblk
    (i.e. /dev/sda1)
  2. Create a mounting point directory
    sudo mkdir /mnt/exthd
  3. Mount the external drive at the mounting point directory
    sudo mount /dev/sda1 /mnt/exthd
  4. Remove the existing T3D site images directory and content
    sudo rm -f -r /var/www/t3d/images
  5. Create a link for the T3D site images directory to the mounted drive
    sudo ln -s /mnt/exthd /var/www/t3d/images

Manually Run T3D Replicator