GitBook: [master] 71 pages modified

Author: theo-o

SUMMARY.md

@@ -19,21 +19,11 @@
       * [PR Workflow](services/director/development/pr-workflow.md)
       * [Style Guide](services/director/development/style-guide.md)
       * [Maintainer Workflow](services/director/development/maintainer-workflow.md)
-    * [/web](services/director/web/README.md)
-      * [Administration](services/director/web/administration.md)
-      * [Setup](services/director/web/setup.md)
     * [User Experience](services/director/user-experience/README.md)
       * [User Interface](services/director/user-experience/user-interface.md)
-    * [Production](services/director/production/README.md)
-      * [Setup](services/director/production/setup.md)
-    * [Architecture](services/director/architecture/README.md)
-      * [Architecture](services/director/architecture/architecture.md)
-  * [Workstations](services/workstations/README.md)
-    * [Programs](services/workstations/programs.md)
-    * [Technologies](services/workstations/technologies.md)
-    * [Administration](services/workstations/administration.md)
-    * [Troubleshooting](services/workstations/troubleshooting.md)
-    * [Setup](services/workstations/setup.md)
+    * [Production](services/director/production.md)
+    * [Architecture](services/director/architecture.md)
+  * [Workstations](services/workstations.md)
   * [Mail](services/mail.md)
   * [Signage](services/signage/README.md)
     * [Setup](services/signage/setup.md)
@@ -62,9 +52,11 @@
       * [Web Proxy](services/www/sites/proxy-script.md)
     * [Setup](services/www/setup.md)
     * [Troubleshooting](services/www/troubleshooting.md)
-  * [Othello](services/othello/README.md)
-    * [Setup](services/othello/setup.md)
-    * [Administration](services/othello/administration.md)
+  * [Academic Services](services/academic-services/README.md)
+    * [Tin](services/academic-services/tin.md)
+    * [Othello](services/academic-services/othello/README.md)
+      * [Setup](services/academic-services/othello/setup.md)
+      * [Administration](services/academic-services/othello/administration.md)
 * [Technologies](technologies/README.md)
   * [Web](technologies/web/README.md)
     * [Nginx](technologies/web/nginx.md)
@@ -112,8 +104,7 @@
       * [Setup](technologies/tools/gitlab/setup.md)
       * [Updating](technologies/tools/gitlab/updating.md)
   * [Virtualization](technologies/virtualization-stack/README.md)
-    * [QEMU](technologies/virtualization-stack/qemu.md)
-    * [KVM](technologies/virtualization-stack/kvm.md)
+    * [QEMU/KVM](technologies/virtualization-stack/qemu.md)
     * [Libvirt](technologies/virtualization-stack/libvirt.md)
   * [Advanced Computing](technologies/advanced-computing/README.md)
     * [MPI](technologies/advanced-computing/mpi.md)
@@ -212,6 +203,7 @@
   * [Organization](general/organization.md)
   * [Documentation](general/documentation/README.md)
     * [Security](general/documentation/security.md)
+    * [Runbooks](general/documentation/runbooks.md)
   * [Communication](general/communication/README.md)
     * [Terminology](general/communication/terminology.md)
   * [Understudies](general/understudies.md)
@@ -226,14 +218,13 @@
   * [tjSTAR](procedures/tjstar/README.md)
     * [Tech Support](procedures/tjstar/tech-support.md)
   * [Onboarding](procedures/onboarding/README.md)
-    * [New Understudy Structure](procedures/onboarding/new-understudy-onboarding.md)
     * [New Sysadmin Onboarding](procedures/onboarding/new-sysadmin-onboarding.md)
 * [Guides](guides/README.md)
-  * [Using sshuttle](guides/using-sshuttle.md)
+  * [sshuttle Usage](guides/using-sshuttle.md)
   * [Linux Wifi Setup](guides/linux-wifi-setup.md)
   * [VNC Usage](guides/how-to-use-vnc.md)
-  * [Changing your Password](guides/changing-your-password.md)
-  * [Configuring RAID on a sun server](guides/raid-on-sun-servers.md)
+  * [Password Changes](guides/changing-your-password.md)
+  * [Sun Server RAID Configuration](guides/raid-on-sun-servers.md)
 * [Policies](policies/README.md)
   * [Data Release Policy](policies/data-release-policy.md)
   * [Upgrade Policy](policies/upgrade-policy.md)

general/communication/terminology.md

@@ -15,6 +15,7 @@ Bad:
 * SYSAdmins
 * sysadmins
 * Student Admins
+* SYSADMINS
 
 _When referring to the Computer Systems Lab:_
 

general/documentation/runbooks.md

@@ -0,0 +1,2 @@
+# Runbooks
+

general/organization.md

@@ -42,7 +42,7 @@ The Documentation team is responsible for accurate, comprehensive, and well-writ
 
 ### Academic Services
 
-The Academic Services team is responsible for maintaining software that is used by TJHSST classes.  This includes [Othello](../services/othello/), the TJHSST AI Grader, and Tin.  Due to the presence of many services, there may be a sub-team for each service.
+The Academic Services team is responsible for maintaining software that is used by TJHSST classes.  This includes [Othello](../services/academic-services/othello/), the TJHSST AI Grader, and Tin.  Due to the presence of many services, there may be a sub-team for each service.
 
 ### Printing
 

general/sysadmins-list.md

@@ -25,17 +25,23 @@
 | ​[Ion](../services/ion/)​ | Theo Ouzhinski |
 | ​[Director](../services/director/)​ | Theo Ouzhinski |
 | ​[Storage](../technologies/storage/)​ | Theo Ouzhinski |
-| ​[Workstations](../services/workstations/)​ | John Beutner |
+| Networking | Keegan Lanzillotta |
+| ​[Workstations](../services/workstations.md)​ | John Beutner |
 | ​[Cluster](../services/cluster/)​ | TBD |
 | ​[Web Content/WWW](../services/www/)​ | Keegan Lanzillotta |
 | ​[Signage](../services/signage/)​ | John Beutner |
-| ​[Documentation](documentation/)​ | Theo Ouzhinski |
+| ​[Documentation](documentation/)​ | TBD |
 | Security | Theo Ouzhinski |
 | Automation | Theo Ouzhinski |
 | Advanced Computing Hardware | Parthiv Chigurupati |
 | ​[Printing](../services/printing/)​ | Alexander Black |
+| Monitoring | TBD |
+| Academic Services | John Beutner |
+| Understudy | TBD |
 
-## Teams  <a id="teams"></a>
+## Team Membership <a id="teams"></a>
+
+All teams and their responsibilities are [available here](organization.md).
 
 | Team Name | Members |
 | :--- | :--- |
@@ -46,15 +52,18 @@
 
 ## Faculty Sponsor  <a id="faculty-sponsor"></a>
 
-The Sysadmin Faculty Sponsor is Mr. White \(pewhite\).
+The Sysadmin Faculty Sponsor is Mr. White \(`pewhite`\).
 
 ## Points of Contact
 
 | Group | POC |
 | :--- | :--- |
-| Eighth Office | Theo Ouzhinski |
-| SGA | Theo Ouzhinski |
+| Eighth Period Office | Theo Ouzhinski |
+| SGA \(Elections\) | Theo Ouzhinski |
+| SGA \(Other Matters\) | Keegan Lanzillotta |
 | Security Office | Keegan Lanzillotta |
+| Web Development Classes | Theo Ouzhinski |
+| CSL Lab Directors | [Mr. White](sysadmins-list.md#faculty-sponsor) |
 
 ## Previous Student Systems Administrators
 

general/understudies.md

@@ -20,3 +20,18 @@ Sometime before Spring Break, interest meetings are scheduled to allow any stude
 
 The structure of the program is fairly flexible to allow for understudies to explore their interested functional areas.  Each understudy is assigned a mentor whose job is to help and guide them through the program.  Most questions and concerns they have about Sysadmin matters should be raised with their mentor.   Each mentor in collaboration with other mentor should assign various tasks to their understudies as they see fit.
 
+## Overview
+
+The understudy program's structure and details can vary from year to year.  It generally contains the following components:
+
+* Some public announcements of the availability of the program to interested students
+* One or more interest meetings summarizing the program
+* A series of understudy sessions structured as the Sysadmins see fit
+* A determination of who should be elevated to Sysadmin made before the end of the school year
+
+Decisions made regarding the structure of the understudy program should \(hopefully\) be made well before understudy sessions begin.  These decisions are generally made by Understudy Coordinator\(s\) \(as selected by the Sysadmins\), or, if none exists, the Sysadmins as a group.
+
+## History
+
+In the past, understudy sessions have been open to either the entire school or to a specific set of people accepted via an application process.  These sessions generally involve training prospective Sysadmins in the art of being a Sysadmin, providing support to these prospective Sysadmins, and involving these prospective Sysadmins in CSL projects \(if possible\).
+

guides/changing-your-password.md

@@ -1,4 +1,4 @@
-# Changing your Password
+# Password Changes
 
 This is a guide on how to change your _**CSL**_ password, and contains some good information for changing other peoples' _**CSL**_ passwords too \(but only if you have access\).
 

guides/raid-on-sun-servers.md

@@ -1,6 +1,6 @@
-# Configuring RAID on a sun server
+# Sun Server RAID Configuration
 
-This is a "tutorial" for setting up RAID arrays on the sun servers.
+This is a "tutorial" for setting up RAID arrays on the Sun servers.
 
 Oracle _has_ [documentation](https://docs.oracle.com/cd/E19902-01/html/835-0796/wm2wosig.gjxrc.html) on this process, but apparently not for the version of the BIOS that our machines run.
 

guides/using-sshuttle.md

@@ -2,7 +2,7 @@
 description: Describes how to access to the CSL network from your laptop via sshuttle
 ---
 
-# Using sshuttle
+# sshuttle Usage
 
 We use sshuttle to access the CSL network on our own computers without having to be connected to a remote access server.
 

machines/hpc-cluster/zoidberg.md

@@ -16,5 +16,5 @@
 
 ## Trivia
 
-Zoidberg currently has a [workstation](../../services/workstations/) IP and is plugged into the workstation [VLAN]() by means of a long ethernet cable because the networking to the HPC cluster is broken \("it's fine if they can't DHCP" no it friggin isn't "well if they don't have static IPs then they're mis-managed" seriously?? also static IPs didn't seem to work anyway\).
+Zoidberg currently has a [workstation](../../services/workstations.md) IP and is plugged into the workstation [VLAN]() by means of a long ethernet cable because the networking to the HPC cluster is broken \("it's fine if they can't DHCP" no it friggin isn't "well if they don't have static IPs then they're mis-managed" seriously?? also static IPs didn't seem to work anyway\).
 

machines/sun-servers/vega.md

@@ -1,6 +1,6 @@
 # Vega
 
-**Vega** is a Sun Server located in the Machine Room that serves [KVM Virtual Machines](../../technologies/virtualization-stack/kvm.md) on local storage.
+**Vega** is a Sun Server located in the Machine Room that serves [KVM Virtual Machines]() on local storage.
 
 ## Virtual Machines on this Host <a id="virtual-machines-on-this-host"></a>
 

machines/vm-servers/altair.md

@@ -1,6 +1,6 @@
 # Altair
 
-**Altair** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines](../../technologies/virtualization-stack/kvm.md).
+**Altair** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines]().
 
 ## Virtual Machines on this Host
 

machines/vm-servers/antipodes.md

@@ -1,6 +1,6 @@
 # Antipodes
 
-**Antipodes** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines](../../technologies/virtualization-stack/kvm.md).
+**Antipodes** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines]().
 
 ## Virtual Machines on this Host
 

machines/vm-servers/chatham.md

@@ -1,6 +1,6 @@
 # Chatham
 
-**Chatham** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines](../../technologies/virtualization-stack/kvm.md).
+**Chatham** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines]().
 
 ## Virtual Machines on this Host
 

machines/vm-servers/cocos.md

@@ -1,6 +1,6 @@
 # Cocos
 
-**Cocos** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines](../../technologies/virtualization-stack/kvm.md).
+**Cocos** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines]().
 
 ## Virtual Machines on this Host
 

machines/vm-servers/galapagos.md

@@ -1,6 +1,6 @@
 # Galapagos
 
-**Galapagos** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines](../../technologies/virtualization-stack/kvm.md).
+**Galapagos** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines]().
 
 ## Virtual Machines on this Host
 

machines/vm-servers/gorgona.md

@@ -1,6 +1,6 @@
 # Gorgona
 
-**Gorgona** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines](../../technologies/virtualization-stack/kvm.md).
+**Gorgona** is a physical server residing in the CSL Machine Room that currently serves [KVM Virtual machines]().
 
 ## Virtual Machines on this Host
 

machines/vm-servers/overlord.md

@@ -1,6 +1,6 @@
 # Overlord
 
-**Overlord** is a physical server residing in the CSL Machine Room that will serve [KVM Virtual machines](../../technologies/virtualization-stack/kvm.md).
+**Overlord** is a physical server residing in the CSL Machine Room that will serve [KVM Virtual machines]().
 
 ## Virtual Machines on this Host
 

machines/vm-servers/waverider.md

@@ -1,6 +1,6 @@
 # Waverider
 
-**Waverider** is a physical server residing in the CSL Machine Room that will serve [KVM Virtual machines](../../technologies/virtualization-stack/kvm.md).
+**Waverider** is a physical server residing in the CSL Machine Room that will serve [KVM Virtual machines]().
 
 ## Virtual Machines on this Host
 

policies/account-policy.md

@@ -1,3 +1,7 @@
+---
+description: Policy for managing CSL accounts
+---
+
 # Account Policy
 
 ## Introduction

policies/data-release-policy.md

@@ -1,5 +1,5 @@
 ---
-description: This page describes the CSL policy for releasing data to the public
+description: Policy for releasing data
 ---
 
 # Data Release Policy

policies/student-leadership-election-policy.md

@@ -1,3 +1,7 @@
+---
+description: Policy for managing student leadership elections via Intranet
+---
+
 # Election Policy
 
 ## Introduction

policies/upgrade-policy.md

@@ -1,3 +1,7 @@
+---
+description: Policy for upgrading CSL systems
+---
+
 # Upgrade Policy
 
 ## General

procedures/account-provisioning.md

@@ -86,24 +86,3 @@ fs sa <username> <username> rlidwka
 vos release students.20XX
 ```
 
-## Historical Provisioning
-
-{% hint style="danger" %}
-This method is completely obsolete.
-{% endhint %}
-
-The update\_nssldap.sh script \(authored by William Yang; see [NSS LDAP](https://github.com/tjcsl/gitbook/tree/0ed8086a38339b7cf231d8d987eae570d21ccd8f/technologies/authentication/nss-ldap/README.md)\) handled user provisioning in [AFS](../technologies/storage/afs/) and [NSS LDAP](https://github.com/tjcsl/gitbook/tree/0ed8086a38339b7cf231d8d987eae570d21ccd8f/technologies/authentication/nss-ldap/README.md) It depends on Identity Synchronization for Windows \(ISW\) to be working properly. Because of the way AD accounts are recreated every year, it was recommended to follow this procedure when it was time to create accounts every fall. The idsync command below was part of ISW and was located in `/opt/SUNWisw/bin` on the ISW server \(usually the primary NSS LDAP server\). All idsync commands are required to have options `-D -w -q`. For our purposes, we used `-D 'cn=Directory Manager' -w - -q -`
-
-**Requirements**
-
-* Have an /admin credential
-* Be added as a user on the AFS servers \(`bos adduser <server> <username>.admin`\)
-* Know/have ready the NSS Manager password
-
-**Account Creation**
-
-* Stop ISW synchronization \(`idsync stopsync -D 'cn=Directory Manager' -w - -q -`\)
-* Reassociate accounts \(`idsync resync -D 'cn=Directory Manager' -w - -q -`\)
-* Restart ISW synchronization \(`idsync startsync -D 'cn=Directory Manager' -w - -q -`\)
-* Run the `update_nssldap.sh` script \(make sure you've read the section on this script in [NSS LDAP](https://github.com/tjcsl/gitbook/tree/0ed8086a38339b7cf231d8d987eae570d21ccd8f/technologies/authentication/nss-ldap/README.md)!\). Make a backup \(`backup.sh`\) before and after running this script, just in case.
-

procedures/onboarding/new-understudy-onboarding.md

@@ -1,5 +1,9 @@
 # tjSTAR
 
+{% hint style="info" %}
+The status of our involvement in tjSTAR is up in the air \(as of the 2018-2019 school year\)
+{% endhint %}
+
 The CSL is responsible for running signups and tech support for the annual tjSTAR, which usually happens in late May or early June.
 
 > The name of the conference should be tjSTAR, not tjStar \(that just doesn't make sense -- STAR is short for _Symposium to Advance Research_.

procedures/tjstar/README.md

@@ -3,7 +3,7 @@
 Use this page as a checklist for updating usernames \(such as in the case of a legal name change\)
 
 {% hint style="warning" %}
-Only use this page as a cheklist for updating usernames such as in the case of a legal name change
+Only use this page as a checklist for updating usernames such as in the case of a legal name change
 {% endhint %}
 
 The following items need to be updated when a username change is requested:

procedures/username-changes.md

@@ -0,0 +1,6 @@
+---
+description: The CSL's public-facing services supporting academic endeavours
+---
+
+# Academic Services
+

services/academic-services/README.md

@@ -0,0 +1,2 @@
+# Tin
+

services/othello/README.md services/academic-services/othello/README.md

@@ -1,5 +1,5 @@
 ---
-description: Describe the CSL's clusters
+description: The CSL's clusters
 ---
 
 # Cluster

services/othello/administration.md services/academic-services/othello/administration.md

@@ -83,7 +83,7 @@ These are problems with the cluster present at the time of documentation \(March
 * Some borg nodes now aren't getting DHCP either.
 * Graphics card compatability on Borg nodes is super spotty. Moving around cards until they work in a node.
 * Dylan said to look at DHCP forwarding on [Imply](../../machines/switches/imply.md) to attempt to fix HPC issue.
-* `zoidberg` is currently being routed through the [Workstation](../workstations/) VLAN in order to get networking due to the below problem.
+* `zoidberg` is currently being routed through the [Workstation](../workstations.md) VLAN in order to get networking due to the below problem.
 * The HPC rack can't get DHCP addresses, ~~and most attempts at static IPs fail as well.~~ but it looks like setting a static ip through `/etc/sysconfig/network/ifcfg-bond0` works. The nodes currently up are fine as long as they don't get rebooted.
 * `hpc7` and `hpc11` are super offline \(have been for a while now\), `hpc9`is offline due to the above issue \(was rebooted\).
 * X11 forwarding doesn't work, problem with slurm. See [this bug report](https://bugs.schedmd.com/show_bug.cgi?id=5692).