57 lines
1.7 KiB
Markdown
57 lines
1.7 KiB
Markdown
# 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
|
|
|
|
|
|
|
|
|
|
For more information, see the [Design](docs/DESIGN.md) document.
|
|
|
|
## Getting Started
|
|
|
|
See also: [Installation](docs/INSTALL.md)
|
|
|
|
```
|
|
$ 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.
|
|
|