Software Defined Laboratory
Go to file
John Haverlack d4d15effd5 WIP Install / Start / Stop 2026-02-04 20:32:49 -09:00
docs WIP: start stop scripts 2026-02-03 20:09:56 -09:00
sdl-mgr Systemd Detectiion in Start/Stop/Status 2026-02-04 19:52:45 -09:00
sdl-wkr WIP Install / Start / Stop 2026-02-04 20:32:49 -09:00
tools Start v0.3.0 2026-01-31 13:45:39 -09:00
.gitignore Updating Task List 2026-02-03 19:09:16 -09:00
LICENSE.md Start v0.3.0 2026-01-31 13:45:39 -09:00
README.md Adding Screeshot to README 2026-02-01 21:31:08 -09:00
changelog.json Adding Screeshot to README 2026-02-01 21:31:08 -09:00
config.json WIP: Start / Stop Scripts 2026-02-03 21:07:46 -09:00
install-sdl.sh WIP Install / Start /Stop 2026-02-04 20:30:27 -09:00
metadata.json Start v0.3.8 2026-02-01 21:21:39 -09:00

README.md

Software Defined Laboratory (SDL)

Attribute Value
Author John Haverlack
Copyright 2026 John Haverlack
License MIT
Version 0.3.8
Date 2026-02-01

Overview

The Software Defined Laboratory (SDL) project provides a generalized distributed computing platform for managing parallel computational workflows across a cluster of distributed nodes. SDL is a minimalistic High Performance Compute (HPC) platform focused on minimizaton of technical debt associated configuration, deployability, and maintenance of the cluster.

Design

SDL Dashboard SDL About

For more information, see the Design document.

Getting Started

See also: Installation

$ git clone https://github.com/jehaverlack/sdl.git
$ cd sdl
$ ./install-sdl.sh

Point you browser to http://IP-ADDR:8081

Firewall Rules

NOTE: Firewall rules are required to allow SDL Worker to connect to your SDL Manager.

sudo ufw allow in proto tcp from <NETWORK CIDR> to any port 8081
sudo ufw allow in proto tcp from <NETWORK CIDR> to any port 1883
sudo ufw allow in proto tcp from <NETWORK CIDR> to any port 9001
sudo ufw allow in proto udp from <NETWORK CIDR> to any port 10101

SDL Worker Installation

Listen to UDP 10101 for beacon messages broadcast by your SDL Manager.

nc -u -l -k 10101 |jq

NOTE: CTRL-C to exit nc. You cannot run nc on port 10101 in parallel with the sdl-wkr. So run it once to get the install command. Tnen install sdl-wkr.

Run the curl or wget command provided by SDL Manager UDP beacon to install SDL Worker locally.