Browse Source

Split up services into tabs. Everything looks better

creds
Cameron Weinfurt 2 years ago
parent
commit
36bc34c8a3
  1. 6
      docs/compute/granddad.md
  2. 61
      docs/compute/hydra.md
  3. 0
      docs/compute/norm.md
  4. 34
      docs/compute/tiamat.md
  5. 5
      docs/network/atlas.md
  6. 5
      docs/network/talos.md
  7. 10
      docs/network/unifi.md
  8. 5
      docs/network/voip.md
  9. 5
      docs/network/ziltoid.md
  10. 0
      docs/services/containers.md
  11. 65
      docs/services/networking.md
  12. 111
      docs/services/vmhosts.md
  13. 5
      docs/storage/bacon.md
  14. 5
      docs/storage/elephant.md
  15. 5
      docs/storage/uncle-deadly.md
  16. 5
      docs/web/docs.md
  17. 5
      docs/web/dubsdot.md
  18. 5
      docs/web/eldoom.md
  19. 5
      docs/web/gitea.md
  20. 208
      docs/web/info.md
  21. 5
      docs/web/library.md

6
docs/compute/granddad.md

@ -0,0 +1,6 @@
# Grand-Dad
## Basic Info
## History
## Installation
## Services

61
docs/compute/hydra.md

@ -0,0 +1,61 @@
# Hydra
Hydra is our primary VM host. It is currently running 18.04.03 LTS
## Basic Info
!!! Danger
The heat sink on CPU0 is not secured completely. This is not from misuse, but still results in the hardware being extra sensitive to a bump leading to the cooler becoming dislodged and rolling around the rack. Servers should always be handled with care regardless of the circumstance, but in this case an effort must be made.
* CPU: 2x 16 Core AMD Opteron 6376
* 2x Noctua CPU Coolers
* RAM: 4x 16GB DDR3-1600 ECC RAM
* HDDs: 5x 2TB Segate Constelation HDD w/ RAID 6
* Motherboard: Super Micro MBD-H8DG6-F-0 Motherboard EATX
* Power supply: Silver Stone 550 Watt 80+ Platinum
* Chassis: Roswell 4u Server Chassis
* NICs:
* 10G Fiber: Mellanox Technologies MT26448 (00:02:c9:51:77:2c)
* Ethernet: Intel Corporation 82576 (0c:c4:7a:c6:e7:88, 0c:c4:7a:c6:e7:89) [Unused]
## History
## Installation:
### Additional packages:
htop iotop iftop lm_sensors vim sudo qemu libvirtd screen rsync tmux p7zip
### Additional configuration:
## Hardware:
## Services:
* anthonyresearch
* atlas
* bouncer
* cjsd
* crow
* docker [Inactive]
* docs [Inactive]
* dubsdot
* eldoom
* gitea
* GMy [Inactive]
* info
* library
* linalg [Inactive]
* mail [Inactive]
* nagios [Inative]
* OpenVPN
* qvm
* ros-pxe [Inactive]
* Scan2 [Inactive]
* sdrserver [Inactive]
* seance-pxe
* tino
* undocs
* undocs [Unused]
* unifycontroller
* voip

0
docs/services/compute.md → docs/compute/norm.md

34
docs/compute/tiamat.md

@ -0,0 +1,34 @@
# Tiamat
Tiamat is the name of our secondary VM host, taking the name of a hydra from DnD to go along with [Hydra](hydra.md). This is a temporary arrangement and will be changed into a compute server once the new VM Host arrives.
## Basic Info
* CPU: 16 Core AMD Opteron 6220
* RAM: 8x8 GB DDR3-1333
* HDDs: Unknown 279.4G HDD
* Motherboard:
* Power supply:
* Chassis:
* NICs:
* 10G Fiber: Mellanox Technologies MT26448 (00:02:c9:57:11:66)
* Ethernet: Intel Corporation 82576
* c:16:2d:a4:6f:8e
* ac:16:2d:a4:6f:8f [Unused]
* ac:16:2d:a4:6f:92 [Unused]
* ac:16:2d:a4:6f:93 [Unused]
## History
## Installation
## Services:
* 146-dhcp
* docs
* dubsdot
* esports
* help-next-door [To be deleted]
* honeypot
* rekt [Inactive]
* trilogy
* victim [Inactive]

5
docs/network/atlas.md

@ -0,0 +1,5 @@
# Atlas
## Basic Info
## History
## Installation

5
docs/network/talos.md

@ -0,0 +1,5 @@
# Talos
## Basic Info
## History
## Installation

10
docs/services/storage.md → docs/network/unifi.md

@ -1,16 +1,10 @@
# Bacon
# Unifi
## Basic Info
## History
## Installation
# Elephant
## Basic Info
## History
## Installation
# Uncle-Deadly
# Unifi Controller
## Basic Info
## History

5
docs/network/voip.md

@ -0,0 +1,5 @@
# VOIP
## Basic Info
## History
## Installation

5
docs/network/ziltoid.md

@ -0,0 +1,5 @@
# Ziltoid
## Basic Info
## History
## Installation

0
docs/services/containers.md

65
docs/services/networking.md

@ -1,65 +0,0 @@
# Ziltoid
## Basic Info
## History
## Installation
# Talos
## Basic Info
## History
## Installation
# Atlas
## Basic Info
## History
## Installation
# SWF1
## Basic Info
## History
## Installation
# SWF2
## Basic Info
## History
## Installation
# SWM1
## Basic Info
## History
## Installation
# SWM2
## Basic Info
## History
## Installation
# SWM3
## Basic Info
## History
## Installation
# SWM4
## Basic Info
## History
## Installation
# Unifi
## Basic Info
## History
## Installation
# VOIP
## Basic Info
## History
## Installation

111
docs/services/vmhosts.md

@ -1,111 +0,0 @@
# Virtual Machine Hosts
There are many reasons to use virtual machines or containers as a place for services to exist on. Unless there is a specific reason why a service needs to run on bare metal, then it should probably be virtualized. To facilitate these services, a number of machines are delegating to hosting them; the VM Hosts. As of right now, these are [Hydra](vmhosts.md#hydra), [Tiamat](vmhosts.md#tiamat) and [Grand-Dad](vmhosts.md#grand-dad).
If you want to create a VM or container, ask a sysadmin to set on up for you and they will prepare it for you and help you log into it. You should also name your VMs and containers descriptively to help other lab member understand what they are. Better yet, document what they are on this wiki.
Even though our VM Hosts are powerful, they are still limited. During the Fall of 2019, Hydra was experiencing packet loss and was running with all of memory and swap almost full. This lead to the creation of the Tiamat VM Host to offload some of the work. In addition, VMs and containers that aren't actively being used or maintained will probably be shut down. Undocumented VMs and containers will be deleted without warning.
# Hydra
Hydra is our primary VM host. It is currently running 18.04.03 LTS
## Basic Info
!!! Danger
The heat sink on CPU0 is not secured completely. This is not from misuse, but still results in the hardware being extra sensitive to a bump leading to the cooler becoming dislodged and rolling around the rack. Servers should always be handled with care regardless of the circumstance, but in this case an effort must be made.
* CPU: 2x 16 Core AMD Opteron 6376
* 2x Noctua CPU Coolers
* RAM: 4x 16GB DDR3-1600 ECC RAM
* HDDs: 5x 2TB Segate Constelation HDD w/ RAID 6
* Motherboard: Super Micro MBD-H8DG6-F-0 Motherboard EATX
* Power supply: Silver Stone 550 Watt 80+ Platinum
* Chassis: Roswell 4u Server Chassis
* NICs:
* 10G Fiber: Mellanox Technologies MT26448 (00:02:c9:51:77:2c)
* Ethernet: Intel Corporation 82576 (0c:c4:7a:c6:e7:88, 0c:c4:7a:c6:e7:89) [Unused]
## History
## Installation:
### Additional packages:
htop iotop iftop lm_sensors vim sudo qemu libvirtd screen rsync tmux p7zip
### Additional configuration:
## Hardware:
## Services:
* anthonyresearch
* atlas
* bouncer
* cjsd
* crow
* docker [Inactive]
* docs [Inactive]
* dubsdot
* eldoom
* gitea
* GMy [Inactive]
* info
* library
* linalg [Inactive]
* mail [Inactive]
* nagios [Inative]
* OpenVPN
* qvm
* ros-pxe [Inactive]
* Scan2 [Inactive]
* sdrserver [Inactive]
* seance-pxe
* tino
* undocs
* undocs [Unused]
* unifycontroller
* voip
# Tiamat
Tiamat is the name of our secondary VM host, taking the name of a hydra from DnD to go along with [Hydra](vmhosts.md#hydra). This is a temporary arrangement and will be changed into a compute server once the new VM Host arrives.
## Basic Info
* CPU: 16 Core AMD Opteron 6220
* RAM: 8x8 GB DDR3-1333
* HDDs: Unknown 279.4G HDD
* Motherboard:
* Power supply:
* Chassis:
* NICs:
* 10G Fiber: Mellanox Technologies MT26448 (00:02:c9:57:11:66)
* Ethernet: Intel Corporation 82576
* ac:16:2d:a4:6f:8e
* ac:16:2d:a4:6f:8f [Unused]
* ac:16:2d:a4:6f:92 [Unused]
* ac:16:2d:a4:6f:93 [Unused]
## History
## Installation
## Services:
* 146-dhcp
* docs
* dubsdot
* esports
* help-next-door [To be deleted]
* honeypot
* rekt [Inactive]
* trilogy
* victim [Inactive]
# Grand-Dad
## Basic Info
## History
## Installation
## Services

5
docs/storage/bacon.md

@ -0,0 +1,5 @@
# Bacon
## Basic Info
## History
## Installation

5
docs/storage/elephant.md

@ -0,0 +1,5 @@
# Elephant
## Basic Info
## History
## Installation

5
docs/storage/uncle-deadly.md

@ -0,0 +1,5 @@
# Uncle-Deadly
## Basic Info
## History
## Installation

5
docs/web/docs.md

@ -0,0 +1,5 @@
# Docs
## Basic Info
## History
## Installation

5
docs/web/dubsdot.md

@ -0,0 +1,5 @@
# Dubsdot
## Basic Info
## History
## Installation

5
docs/web/eldoom.md

@ -0,0 +1,5 @@
# Eldoom
## Basic Info
## History
## Installation

5
docs/web/gitea.md

@ -0,0 +1,5 @@
# Gitea
## Basic Info
## History
## Installation

208
docs/services/vms.md → docs/web/info.md

@ -1,67 +1,3 @@
# Anthonyresearch
## Basic Info
## History
## Installation
# Atlas
See [*Atlas*](networking.md#atlas)
# Bouncer
## Basic Info
## History
## Installation
# CJSD
## Basic Info
## History
## Installation
# Crow
## Basic Info
## History
## Installation
# Docker [Inactive]
## Basic Info
## History
## Installation
# Docs
## Basic Info
## History
## Installation
# Dubsdot
## Basic Info
## History
## Installation
# Eldoom
## Basic Info
## History
## Installation
# Gitea
## Basic Info
## History
## Installation
# GMy [Inactive]
## Basic Info
## History
## Installation
# Info
The VM that is hosting this site!
@ -82,23 +18,23 @@ Currently, info/ is using the Cinder theme.
## History
The [previous documentation webservice](vms.md#docs) used to be the place to record documentation and other info about the labs. However, due to the MediaWiki instance becoming unstable and problematic to maintain, a [Gitea](vms.md#gitea) instance was created to replace it. Rather than being a wiki, it was a Git server being used as a way to version control documentation and configuration. [info/](https://info.cosi.clarkson.edu) was created to act as a prettier front-end to the lab's record keeping.
The [previous documentation webservice](docs.md) used to be the place to record documentation and other info about the labs. However, due to the MediaWiki instance becoming unstable and problematic to maintain, a [Gitea](gitea.md) instance was created to replace it. Rather than being a wiki, it was a Git server being used as a way to version control documentation and configuration. [info/](https://info.cosi.clarkson.edu) was created to act as a prettier front-end to the lab's record keeping.
## Installation
Create a lightweight VM on a capable [VM Host](vmhosts.md) and provide it enough resources to run a web server. A single core and 20 GB of disk should suffice. Perform a basic Arch Linux install and install the following additional packages
Create a lightweight VM on a capable VM Host and provide it enough resources to run a web server. A single core and 20 GB of disk should suffice. Perform a basic Arch Linux install and install the following additional packages
nginx certbot certbot-nginx python3 python-pip
nginx certbot certbot-nginx python3 python-pip
MkDocs isn't strictly required to be installed on the VM in order for it to work, but it is handy to have it installed. Install the following packages via `pip3`:
mkdocs mkdocs-cinder
mkdocs mkdocs-cinder
### Nginx and Certbot
To make info/ an HTTPS server, we need a SSL certificate. Grab one by running:
sudo certbot certonly --nginx -d info.cosi.clarkson.edu -d info.cslabs.clarkson.edu
sudo certbot certonly --nginx -d info.cosi.clarkson.edu -d info.cslabs.clarkson.edu
You may need to run it a few times until all the keys are obtained. Ensure the `fullchain.pem` and `privkey.pem` files are installed at `/etc/letsencrypt/live/info.cosi.clarkson.edu/` and `/etc/letsencrypt/live/info.cslabs.clarkson.edu/`.
@ -116,10 +52,10 @@ http {
ssl_protocols TLSv1.2 TLSv1.3;
server {
listen 80 default_server;
listen [::]:80 default_server;
listen 443 ssl http2 default_server;
listen [::]:443 ssl http2 default_server;
listen 80 default_server;
listen [::]:80 default_server;
listen 443 ssl http2 default_server;
listen [::]:443 ssl http2 default_server;
server_name _;
ssl_certificate /etc/letsencrypt/live/info.cosi.clarkson.edu/fullchain.pem;
@ -144,120 +80,30 @@ Change the `root` field under `location` to just `/usr/share/nginx/html` since w
### Syncing with Gitea with Systemd
Our Gitea instance houses and version controls both the source and the web content. In the `/usr/share/nginx/html` directory, run `git clone https://gitea.cslabs.clarkson.edu/COSI_Sysadmins/info-slash.git -b gh-pages`. Restart the nginx service and info/ should be available.
Finally, a systemd service and timer needs to be created to handle updating the website periodically. Create the `mkdocs-pull.service` file in `/etc/systemd/system/` directory and copy the following into it:
```
[Unit]
```
[Unit]
Description=Pulls down most recent changes from Gitea for the MkDocs instance
[Service]
Type=simple
[Service]
Type=simple
WorkingDirectory=/usr/share/nginx/html/info-slash/
ExecStart=/usr/bin/git pull
```
ExecStart=/usr/bin/git pull
```
Create the `mkdocs-pull.timer` service next to it and copy the following into it:
```
```
Description=Pull down changes for MkDocs periodically
[Timer]
[Timer]
OnActiveSec=1s
OnUnitActiveSec=5m
OnUnitActiveSec=5m
[Install]
WantedBy=timers.target
```
```
Finally, enable and start the timer and verify that the service is running periodically. Run `systemctl list-timers` to help debug the timer and `journalctl -xe` for debug logs.
# Library
## Basic Info
## History
## Installation
# Linalg [Inactive]
## Basic Info
## History
## Installation
# Mail [Inactive]
## Basic Info
## History
## Installation
# Nagios [Inactive]
## Basic Info
## History
## Installation
# OpenVPN
## Basic Info
## History
## Installation
# QVM
## Basic Info
## History
## Installation
# ROS-PXE [Inactive]
## Basic Info
## History
## Installation
# Scan2 [Inactive]
## Basic Info
## History
## Installation
# SDR Server [Inactive]
## Basic Info
## History
## Installation
# Seance-PXE
## Basic Info
## History
## Installation
# Tino
## Basic Info
## History
## Installation
# Undocs
## Basic Info
## History
## Installation
# Undocs2 [Inactive]
## Basic Info
## History
## Installation
# Unify Controller
## Basic Info
## History
## Installation
# VOIP
See [*VOIP*](networking.md#voip)

5
docs/web/library.md

@ -0,0 +1,5 @@
# Library
## Basic Info
## History
## Installation
Loading…
Cancel
Save