dcchambers / CHTC-Student-Handbook

A small handbook for new CHTC (Student) Employees. Also contains a list of server locations.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CHTC-Student-Handbook

A small handbook to help complete tasks for CHTC (Student) Employees. Also contains a list of server locations.

The handbook comes in several versions, but the PDF is the recommended way to read the content. The actual handbook is created in a LaTeX file, allowing it to easily be converted to multiple formats including PDF, Markdown, etc.

  • The PDF updates are to be pushed to github on a monthly basis, so they won't necessarily be updated to the bleeding edge, but they are the most readable. Each PDF release is versioned and dated with the release month.

  • Changes to the LaTeX file are pushed to github as soon as they are made, and are versioned and dated as such. The version will be the same as the previous PDF release until ready for a new PDF release version. The date is updated on the day of editing. You can download the LaTeX file and generate your own PDF if you wish!


There is also a node_locations.txt files - This just contains the locations of execute nodes (and a few others) that the CHTC manages. Useful for finding a server that breaks.


TODO

  • Release 1.0 of the CHTC Student Handbook
    • Add EL7 upgrade information.
    • Rewrite node (re)building guide with proper EL7 configuration steps.
    • Write a proper introduction about student work at the CHTC.
    • Add Basic Linux Sysadmin Tools section.
    • Flesh out the Networking section.
    • Add User Mapping information.
    • Add git section
    • Include a diagram of the CHTC infrastucure/network layout.
      • Submit nodes, monitor servers, service servers, storage nodes, exec nodes.
  • Update node location list.
    • Remove decommissioned nodes.

Contributing

Contributing is easy. If you want to make an edit to the guide the easiest way is to fork this repository, make the relevant changes to the LaTeX version of the guide or another file, and submit a pull request. Check out github's guide to contributing.

You can also open any issues that you see in the github issue tracker, and feel free to submit pull requests to fix issues that are listed. Thanks!

When submitting a pull-request, only submit the relevant LaTeX files.

About

A small handbook for new CHTC (Student) Employees. Also contains a list of server locations.


Languages

Language:TeX 100.0%