Redbrick System Documentation
The idea of Redbrick documention is to keep an up to date information about the technical infrastructure of Redbrick. This is mostly intended for admins, future admins, webmasters, and everybody else who is grumpy and has no life.
The search box actually works (I was amazed at this. Search isn't meant to work. Ever. For anything).
You will regret this decision. But if you are sure make sure you are familiar with the following:
Day to day running of things.
- IRC Operator Guide
- News Server (the boards)
- Clubs and Socs Day
- Changing a local Password
- Committee changeover procedure
- Installing new machines
- Responding to tickets
- .15 Address Space
- Network setup (internal LAN, external LAN, switches, cable colours etc)
- Switch Setup
- Gratuitous ARP (or, how to force update an IP address's associated MAC on the router and other machines)
- JunOS Configuration
After each emergency remember to write a postmortem!
Daedalus + Icarus - LDAP + Distributed storage
- NFS, (a.k.a /storage) from Icarus
Paphos - Primary Services
Zeus - Secondary Services and New web
Hardcase - Web Applications
halfpint - Admin Bastion
Azazel - Primary User Login
Pygmalion - User Development
Software written by RedBrick, or with RedBrick customisations etc.
- RedBrick Apt Repo (work in progress)
- Backported Packages
- Hey (and huh)
- Chfn & Chsh for ldap
- Small scripts
- RedBrick MOTD setup
- Icecast Streaming Service for DCUFM
System Documentation Redundancy
This is a self hosted version running on halfpint. Its a cron job that pull from github once an hour and if it finds an update it rebuilds the site.
Github is where docs are stored. They are plain markdown but they are easily accessed and read from anywhere.
Docs are auto deployed to readthedocs on commit to the
master branch. They should always be up to date.