Docs: Difference between revisions
(initial commit (very rough draft)) |
m (→OPNsense) |
||
| (42 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
This page is |
This page is the hub for LUG's documentation. |
||
All of our documentation is intentionally public so that other |
All of our documentation is intentionally public so that other orgs (or students) can replicate aspects of our infrastructure if they want. Everything sensitive (private keys, break-glass passwords, etc) should go in the LUG Bitwarden. |
||
Topics should generally be broken out into individual articles and linked on this page, unless there's a very small amount of content. |
|||
== [[Docs/Infrastructure|Infrastructure]] == |
|||
If a section requires a significant amount of content, you may want to break it out into a new article and link it to this page. |
|||
General infrastructure notes |
|||
== |
=== [[Docs/Plans|Plans]] === |
||
Pending upgrades/maintenance to our infrastructure |
|||
Our main website runs here, and other stuff |
|||
== |
=== Network === |
||
Mirrors is a standalone [https://www.dell.com/en-us/shop/povw/poweredge-r730xd/1000 Dell R730xd] server (3.5" drive bay variant) running FreeBSD, and all services are managed by salt. |
|||
==== [[Docs/Cables|Cables]] ==== |
|||
We're in the process of rebuilding it, but in the meantime this is what we've been doing to manage it thus far: |
|||
Physical cabling and "layer 1" network config. |
|||
==== [[Docs/Switches|Switches]] ==== |
|||
Switch and layer 2 network configs (VLANs). |
|||
=== Servers === |
|||
Certificate maintenance: |
|||
==== [[Docs/Leskinen|Leskinen]] ==== |
|||
put it in /usr/share/salt/<somewhere> where salt will copy it to /etc/nginx/<somewhere> |
|||
The primary storage server. |
|||
Currently has Shell home directory backups and media for maho. |
|||
| ⚫ | |||
== |
==== [[Docs/Maho|Maho]] ==== |
||
The GPU compute server. |
|||
Currently hosts a [https://studio.blender.org/films/ Blender Open Studio Films] mirror via Jellyfin and Local LLM host for members to experiment with. |
|||
== Fileserver == |
|||
Coming Soon, currently unprovisioned (waiting on new PSU and drives to arrive) |
|||
==== [[Docs/Mirrors|Mirrors]] ==== |
|||
The Linux mirror server at mirrors.lug.mtu.edu |
|||
==== [[Docs/OPNsense|OPNsense]] (Lasanga/Ravioli) ==== |
|||
Router/Firewall and layer 3+ network configs. |
|||
==== [[Docs/Proxmox Cluster|Proxmox Cluster]] ==== |
|||
Our Proxmox cluster running the majority of our services |
|||
==== [[Docs/Shell|Shell]] ==== |
|||
The shared multi-tenant server for LUG members/alums at shell.lug.mtu.edu |
|||
=== Services === |
|||
==== BlueSky ==== |
|||
==== [[Docs/IRC|IRC]] ==== |
|||
==== Website ==== |
|||
==== Wiki ==== |
|||
== Org Management == |
|||
| ⚫ | |||
==== Docs ==== |
|||
How to create/manage pages in this category ("Docs"). |
|||
==== Meeting Minutes ==== |
|||
<insert process/methodology for making/formatting meeting minutes (e.g. wiki page guidelines)> |
|||
=== Time-sensitive === |
|||
* Email IT for new certs (example template to use, make sure to keep SubjectAltName, etc) |
|||
* Install-a-thons |
|||
* Shirt printing / stickers |
|||
=== Budget === |
|||
* USG meetings |
|||
* Making presentable diagrams and representations of data |
|||
=== MTU Policies and Procedures === |
|||
https://www.mtu.edu/umc/services/websites/requirements/ |
|||
All (sub)domains need to be approved by UMC (University Marketing & Communication) |
|||
IT handles IP addressing and SSL certificates |
|||
USG handles funding and reimbursements |
|||
Latest revision as of 08:09, 4 November 2025
This page is the hub for LUG's documentation.
All of our documentation is intentionally public so that other orgs (or students) can replicate aspects of our infrastructure if they want. Everything sensitive (private keys, break-glass passwords, etc) should go in the LUG Bitwarden.
Topics should generally be broken out into individual articles and linked on this page, unless there's a very small amount of content.
Infrastructure
General infrastructure notes
Plans
Pending upgrades/maintenance to our infrastructure
Network
Cables
Physical cabling and "layer 1" network config.
Switches
Switch and layer 2 network configs (VLANs).
Servers
Leskinen
The primary storage server.
Currently has Shell home directory backups and media for maho.
Maho
The GPU compute server.
Currently hosts a Blender Open Studio Films mirror via Jellyfin and Local LLM host for members to experiment with.
Mirrors
The Linux mirror server at mirrors.lug.mtu.edu
OPNsense (Lasanga/Ravioli)
Router/Firewall and layer 3+ network configs.
Proxmox Cluster
Our Proxmox cluster running the majority of our services
Shell
The shared multi-tenant server for LUG members/alums at shell.lug.mtu.edu
Services
BlueSky
IRC
Website
Wiki
Org Management
Wiki
Docs
How to create/manage pages in this category ("Docs").
Meeting Minutes
<insert process/methodology for making/formatting meeting minutes (e.g. wiki page guidelines)>
Time-sensitive
- Email IT for new certs (example template to use, make sure to keep SubjectAltName, etc)
- Install-a-thons
- Shirt printing / stickers
Budget
- USG meetings
- Making presentable diagrams and representations of data
MTU Policies and Procedures
https://www.mtu.edu/umc/services/websites/requirements/
All (sub)domains need to be approved by UMC (University Marketing & Communication)
IT handles IP addressing and SSL certificates
USG handles funding and reimbursements