CSCWiki - User contributions [en]

Notes for Future Librarians

2023-01-10T19:16:56Z

Joss: Add notes for book writeoffs

= The Library system =

You can access this by typing "librarian" in the command line, or by selecting "Library" inside of [[ceo]]. It is completely independent of ceo, or any of its parts.

Its repository is in /users/git/public/library.git/

It's also hosted at https://git.csclub.uwaterloo.ca/public/library

There's talk about writing a web UI for it, which is still TBD.

I hope that using the library system will be intuitive. If it is not, contact [mailto:fbauckho@uwaterloo.ca fbauckho]. Just try to avoid resizing your terminal while it is running.

==Library Upgrades==
As of the time of writing (Winter 2017) we are set to get donation of $1500 that can be used towards purchasing new books for the next two years. This comes from a man named Doug and it is a good idea to send him a thank you card thanking him for the books. This ensures that we are on good terms with him and can inspire him to continue in helping us upgrade the library. If you have questions about the process, contact [mailto:csfmurph@edu.uwaterloo.ca csfmurph] about the procedures. If you need more specific information about the donation and the procedures for it or you want to send a thank you to Doug, contact [mailto:c2harrington@uwaterloo.ca Candace Harrington] in MC 5228. I find that talking to Candace in person is the best because she is really nice and you get an immediate response.

== FAQ ==

=== Why can't you sign out books from inside the book browser? ===

The signout process works like this:

# You look at the first page of the book that is going to be signed out, figure out the "CSC id", and input it into the sign-out dialogue.
#* While for the purpose of figuring out the CSC id, you could easily bypass the looking-at-the-book part, this doesn't make sense, because in order to sign out a book, you need the book you are planning to sign out.

Similarly, when returning a book, you should have the book in your hands, so you can easily find out the CSC id.

= Things you should do every term =

* Get added to the group <code>libcom</code>, if you're new.
* There's not really any training at the moment, but you should know how to sign out a book for people.
* Hunt down people with signed out books before they disappear forever (an example of this is what happened to one of our modern C books)
** (2022-10-18) joss: This hasn't happened in a while, a fair bit of books are now semi-unrecoverable. Should somehow keep track of history in the database to actually handle writing off the books.
* Send the email reminders through <code>librarian</code> near the end of each term, at maximum of once per term.

= <s>Things that need to be done right now</s> Things we should have done (Winter 2017) =

* The new books need to be stickered
* We should try to think of some rule of thumb about how expensive books have to be in order to get stickered
* We should think about some policy how many books people are allowed to sign out for which amount of time
* Contrary to how the Wishlist page looks, we *don't* need to get new books right now.
* We need to [[Book Pruning|throw away/donate/stash]] books as soon as possible. The proper procedure for this seems to be to announce a list of books that are going to disappear, and then to see if anybody objects, but I (fbauckho) have been too weak-willed to do that yet
* Speaking of books to get rid of, some guy (satalha) wanted one copy of The C Programming Language. He signed one out, so if we decide to donate it to him, we should notify him that he can have it, and otherwise, we should tell him to give it back. NOTE: This person no longer goes to UWaterloo so the chances of seeing this book again is very low
* There are some changes in the repository I made that should make the library system slightly better for the librarian. We should use Debian-Voodoo to install them, and then write how this works.

== Things that we ''really'' should do soon (Fall 2022) ==

* Need to get rid of books that aren't really used / important / wanted / read.
** Pruning is up to the librarian, but just make sure to keep things that are historically important, or popular, or you think would be a neat conversation starter.
* Should really decide about how many books people are allowed to sign out for which amount of time.
* We still don't really need new books, but some newer ones could be nice every so often.
* Librarian needs to be updated to support UTF8 properly, and the database needs to be cleaned up a bit.
* If you're so inclined, contribute to the [https://openlibrary.org/ The Open Library], which is where we get our book data from.
* Update / Write actual documentation on the library stuff, as the average update cycle is about every 5 years.

== Book Writeoffs ==

* TBD: Develop process / way to document reasons why books were written off, should track in database.
* Some books have been gone for quite some time (4+ years), with no real way to contact them and get them back / they are no longer here.
* Because of this, we should figure out if there's penalties of some sort, or other more formalized ways to document why things are written off.
* Should also determine ''when'' something should get written off, and standardize some process around that.

Library Project

2022-11-02T16:33:41Z

Joss: Addded note about to mock a mockingbird

See also: [[Notes for Future Librarians]]

== Objectives ==
Our club library is pretty impressive, for 1980. We should seriously consider changing this to the present. Content decisions seem to generally be made by strongly opinionated individuals whereas we should be focused on providing resources for anyone on campus who is interested in computer science.
* Update and improve library content.
* Set up some method of keeping the library current in the future.
* Re-evaluate the purpose of our library.

== Books Wishlist ==
Split to [[Books Wishlist]]

== Pruning the Library ==
Split to [[Book Pruning]]

== To Mock a Mockingbird ==
In Spring 2022, there was MEF funding for a "To Mock a Mockingbird" reading group. As of 2022-11-02, there's still a fair few of those books in the CSC offices that we don't technically own.

To be clear, *they don't belong to us*, and we are to store them out of sight until TBD.

For any future questions, contact joss (librarian), or thefringthing#7903 (person that organized the reading group) on discord.

== Guidelines for Library Funding ==
In the past, our budgets have failed to focus much attention to the library,
even though our textbooks keeping getting older and less relevant, and courses
and frontiers in Computer Science evolve. It is a shame that we don't have a book
on multi-core programming, or artificial intelligence! The following guideline
provides a detailed strategy for budgeting for books in the future :

'''This guideline is likely high, because most undergrad courses are moving towards printed course notes rather than textbooks.'''

*Did you know that every year approximately 20% of the courses in [http://www.cs.uwaterloo.ca/ SCS] change their books & edition?
This equates to something like $1000 of new material per year. As a result :
**We need to raise at least $1,000 annually to keep up with the material used to cover courses in SCS
**We will need to raise most of it during the Fall & Winter terms since :
***First offerings of courses occur in the Fall/Winter term each year and that is when the new textbooks arrive
***Historically we get higher memberships and people on campus so more funding
*Did you know that CS is a constantly changing field?
**New fields within CS are discovered every year
**New technologies and paradigms (e.g. multi-core programming) occur every 5 to 10 years?
**New knowledge is discovered in the field that replaces our older (less accurate) knowledge?
We therefore need to allocate roughly $1,500 per year to have a library that accurately reflects the current
and state of the art of computer science. To say that our library is not state of the art in CS is an extreme
under-statement. This funding could be equally spread out to $500 per term from mathsoc.

Currently our library is very much outdated and does not have textbooks that reflect the courses that CS students are
currently taking. From my estimate we need approximately $5,000 to have an up to date CS library. Therefore for the immediate strategy we need to get at least $1,500 per term from Mathsoc/MEF to allow our library a chance at staying current with the department's offerings. Therefore we should try to budget in $2,000 for Fall,Winter and Spring to get our library updated to the CS courses as well as to cover some of the frontiers and state of the art in computing that will serve our library into the future.

A great deal of discussion has been spent talking about our library equipment and possible hardware (barcode upgrades for instance). However I don't think it would be responsible for us to look at these areas and especially to budget these improvements in if we don't have a vastly updated library.

== Fixing the Library ==
A statement :
The only way to get the library fixed is through terms of growing and pruning.
As mentioned above, we need to grow our library to reflect the courses offered in SCS,
as well as to cover the current and state of the art in CS.

At the same time it is important that we prune down our library to contain relevant and
updated material. There is no point in having a cluttered library that makes it hard to
find reference material because we must hold on to books that are 20/30+ years old. We
don't need to have books on APL/360 programming, and having these old unnecessarry books
will pollute our library with irrelevance and outdatedness.

The only way the library can be fixed is to find the solutions to the direct problems in our
library. That is rather than worrying about the irrelevant technical details of the library system,
we need to take a look at our inventory (that is our books) and see what needs growing and pruning.
We can build the technical layers once we have built the paper layers (that is the physical books have
been purchased or have been planned to be purchased). It will take courage and will to follow
this procedure since we will have to let go of things that need letting go.
== Proposed Library Update Plan ==
One of the problems in keeping any library relevant is to ensure that reference material
is up to date and current with the area of study in question. This is especially true in
the area of computer science and technology where ideas change fast. The following are some
suggested considerations which could aid in keeping our library up to date now and into the
future.
* Safari Bookshelf Subscription
Safari Bookshelf is a online web service that allows you to read any O'Reilly book for a
subscription fee (usually around $40/month). This service will give the CSC an excellent
online library resource, where members can login and view all of the latest O'Reilly books
including those yet to be published. Access control would be a concern which would need
to be addressed in using such a system, however the concept of having an electronic resource
of continually up to date reference material is tempting.
* What are the new technologies and ideas in computer science?
This is the question that we should be asking ourselves at least at the beginning of the term
to determine what new books need to be purchased to fill the reference gap that builds going from
term to term. We should have a firm commitment of purchasing at least 10 reference books per term
to ensure that we are getting the breadth and depth requirements of having a successful CS library,
especially when it is common for dozens of new CS books to be released every term.
* What are the official CS course textbooks?
The CSC should have an up to date library of all of the required textbooks for all of the CS courses
offered at the University. This will allow our members to quickly access their course reference materials
should they ever leave their books at home, or need to look at the book desperately for an assignment that
is coming due soon. The CSC be a source of reference for CS students who need the references that drive
many of their CS courses.
* What books are getting old?
** How relevant is the book's content today?
** Has the book gone to a new edition?
** Have their been fundamental changes in the topic which are not reflected in the current book?
** How popular is the book? (This can be determined by how many times it has been checked out from the library system)
** Does the material fill a large gap in our reference material?
== Library Accessories ==
There has also been some talk for suggested accessories or tools for our library system. The
following is the current list of such accessories and reasons behind getting such accessories.
* Magstripe Member Cards
Each CSC member could have a magstripe member card which would allow them to check-in and checkout
books by swiping their card at a swiper and then scanning the book in question. This could speed
up the check-in/check-out times since they do not need to enter information into the system, but
rather scan their cards. The magstripe cards could later be extended with CEO to allow term renewal
via card swipe, as well as other value added features.
* Wireless barcode scanner.
The wireless barcode scanner will allow us to go up to the books and scan them in, rather than
having to move the books over to the barcode scanner to have them scanned. This will allow for
a degree of more freedom when scanning in books (especially when we receive the stack of new
books)
* RFID tags
When we receive new books, RFID tags encoded with book information is attached to each book.
Whenever, someone checks-in/checks out books, all you need to do is wave the book in front of a scanner
without having to locate the barcode, which could speed up the process of checking in and out books

[[Category:Library]]
[[Category:Projects]]

Books Wishlist

2022-10-26T17:32:57Z

Joss: Adds TODO to see what we bought

This page consists of books we'd like to get to stock the [[library]]. It is divided into 3 sections. The first is books going on this term's MEF proposal, this should be done by whoever is writing the proposal. The second is a list of actual books with ISBN. The third is vague ideas of what kind of books we need. The goal is for this page to be emptied by way of moving things from section three up to section one and then off.

A bunch of these were bought. That needs to be updated.

Programming Windows by Charles Petzold used to be the definitive guide to Win32
http://www.amazon.ca/Programming-Windows%C2%AE-Charles-Petzold/dp/157231995X/ref=sr_1_1?ie=UTF8&s=books&qid=1269631483&sr=8-1

TCP/IP illustrated (All three volumes $180)
http://www.amazon.com/TCP-IP-Illustrated-Vol-Protocols/dp/0201633469

= Books we may have bought with $1500 by csfmurph =
'''TODO(2022-10-26): I think that $1500 is gone, but we have a fair bit of these books on the shelf now, and thus probably bought a fair bit of them.'''
* Regular Polytopes By Coxeter: $22 (Hardcover: $64)
**http://www.amazon.ca/Regular-Polytopes-H-S-Coxeter/dp/0486614808/ref=sr_1_1?s=books&ie=UTF8&qid=1456780992&sr=1-1&keywords=Regular+Polytopes+By+Coxeter
**ISBN 978-0486614809
*Advanced Topics in Types and Programming Languages: $113
**https://www.amazon.ca/Advanced-Topics-Types-Programming-Languages/dp/0262162288
**ISBN 978-0262162289
* Thinking as Computation: $62
**https://www.amazon.ca/Thinking-as-Computation-First-Course/dp/0262016990/ref=sr_1_1?s=books&ie=UTF8&qid=1456782446&sr=1-1&keywords=thinking+as+computation
**ISBN 978-0262016995
* Shellcoders Handbook: $41
**https://www.amazon.ca/Shellcoders-Handbook-Discovering-Exploiting-Security/dp/047008023X/ref=sr_1_1?s=books&ie=UTF8&qid=1456782575&sr=1-1&keywords=The+Shellcoder%27s+Handbook%3A+Discovering+and+Exploiting+Security+Holes
**ISBN 978-0470080238
* Let over Lambda: $54
**https://www.amazon.ca/Let-Over-Lambda-Doug-Hoyte/dp/1435712757/ref=sr_1_1?s=books&ie=UTF8&qid=1486482168&sr=1-1&keywords=let+over+lambda
**ISBN 978-1435712751
* Learning Spark: $36
**https://www.amazon.ca/Learning-Spark-Lightning-Fast-Data-Analysis/dp/1449358624/ref=sr_1_1?s=books&ie=UTF8&qid=1486482236&sr=1-1&keywords=learning+spark
**ISBN 978-1449358624
* Graph Theory 4th ed (note available for free at http://diestel-graph-theory.com/): $105
**https://www.amazon.com/Graduate-Mathematics-Reinhard-19-Jul-2010-Paperback/dp/B013IM0IGC/ref=mt_paperback?_encoding=UTF8&me=
* Computers and Intractability: $79
**https://www.amazon.ca/Computers-Intractability-Guide-Theory-NP-Completeness/dp/0716710455/ref=sr_1_1?s=books&ie=UTF8&qid=1486482553&sr=1-1&keywords=Computers+and+Intractability
**ISBN 978-0716710455
* A discipline of programming: $99
**https://www.amazon.ca/Discipline-Programming-Edsger-W-Dijkstra/dp/013215871X/ref=sr_1_1?ie=UTF8&qid=1457033480&sr=8-1
**ISBN 978-0132158718
* Algorithms + Data Structures: $120
**https://www.amazon.ca/gp/offer-listing/0130224189/ref=dp_olp_new?ie=UTF8&condition=new
**ISBN 978-8120305694
* Eloquent Javascript 2nd Ed.: $52
**https://www.nostarch.com/ejs2
**ISBN 978-1593275846
* Effective Python: $30
**https://www.amazon.ca/Effective-Python-Specific-Write-Better/dp/0134034287/?s=books&ie=UTF8&qid=1486958231&sr=1-1&keywords=effective+python
**ISBN 978-0134034287
* OpenGL Superbible: $57
**https://www.amazon.ca/OpenGL-Superbible-Comprehensive-Tutorial-Reference/dp/0672337479/?s=books&ie=UTF8&qid=1486958291&sr=1-1&keywords=opengl+superbible
**ISBN 978-0672337475
* Operating Systems: Three Easy Pieces: $53
**http://www.lulu.com/shop/http://www.lulu.com/shop/remzi-arpaci-dusseau-and-andrea-arpaci-dusseau/operating-systems-three-easy-pieces-hardcover-version-091/hardcover/product-22819939.html
* Theoretical Introduction to Programming: $94
**https://www.amazon.ca/Theoretical-Introduction-Programming-Bruce-Mills/dp/1846280214
**ISBN 978-1846280214
* Lectures on the Curry-Howard Isomorphism: $190
**https://www.amazon.ca/Lectures-Curry-Howard-Isomorphism-Morten-S%C3%B8rensen/dp/0444520775
**ISBN 978-0444520777

The sum: $1123

'''With TAX''' (sum * 1.13): 1269

Meaning there is about $90 for shipping and any surprise fees

= MEF Proposal =
MEF Proposal books should include a quote and a sentence or two of justification.

= W18 Whiteboard Books =
* Digital Typograph, Donald Knuth
** ISBN: 978-1575860107
* Programming Language Concepts, Peter Sestoft
** ISBN: 978-1447141556
* Cracking the Coding Interview, Gayle Laakmann McDowell
** ISBN: 978-0984782857
** https://www.amazon.ca/Cracking-Coding-Interview-Programming-Questions/dp/0984782850
* The Moscow Puzzles: 359 Mathematical Recreations
** ISBN: 978-0486270784
** https://www.amazon.ca/Moscow-Puzzles-359-Mathematical-Recreations/dp/0486270785/
* Programming Rust: Fast, Safe Systems Development
** ISBN: 978-1491927281
** https://www.amazon.ca/Programming-Rust-Fast-Systems-Development/dp/1491927283/
* Stable marriage and its relation to other combinatorial problems, Donald Knuth
** ISBN: 978-0821806036
* Automating Inequality: How High-Tech Tools Profile, Police, and Punish the Poor
** ISBN: 978-1250074317
** https://www.amazon.ca/Automating-Inequality-High-Tech-Profile-Police/dp/1250074312
* Quantum Computation and Quantum Information: 10th Anniversary Edition
** ISBN: 978-1107002173
** https://www.amazon.ca/Quantum-Computation-Information-10th-Anniversary/dp/1107002176
* Algorithms of Oppression: How Search Engines Reinforce Racism
** ISBN: 978-1479837243
** https://www.amazon.ca/gp/product/1479837245

= W17 Whiteboard Books =
* Advanced Topics in Types and Programming Languages
** ISBN 978-0262162289
* OS in 3 easy steps (maybe they meant to write Operating Systems: Three Easy Pieces?)
* Realm of Racket
** ISBN 978-1593274917
* Let over Lambda
** ISBN 978-1435712751
* Learning Spark
** ISBN 978-1449358624
* A tour of C++
** ISBN 978-0321958310
* Graph Theory 4th Ed. (http://diestel-graph-theory.com/)
** ISBN 978-3662536216
* Computers and Intractability
** ISBN 978-0716710455
* Quantum Computing Since Democritus
** ISBN 978-0521199568

= W16 Whiteboard books in progress =
This is a list of books that people have put on the whiteboard so far. May still change.
*Cracking the Code Inteview (++++++)(maybe two copies of this)
*Analytic Number Theory (? There are several such books)
*To Mock a Mockingbird(++)
*Regular Polytopes By Coxeter
*Matroid Theory
*Model Theory 2nd edition (?)
*Polyhedral and Semidefinite Programming Methods in Combinatorial Optimization, by Levent Tuncel
*Quantum Computing Since Democritus
*Theory of Linear and Integer Programming
*Sedra and Smith's microelectronic circuits
*Analytic cominatorics
*Haskell Programming from first principles (Allen & Moronuki)
*Analytic Combinatorics
*Naive Set Theory
*Starlight [unreadable] student handbook

= Actual Books =
Actual books should have a precise title and ISBN for edition desired.

*Thinking as Computation
** http://mitpress.mit.edu/books/thinking-computation
* The Shellcoder's Handbook: Discovering and Exploiting Security Holes
** ISBN-10: 047008023X
** ISBN-13: 978-0470080238

== j2simpso's suggestions should be sorted ==

[note: do we want this section, with books about "Startup's early Days"?

*Dreaming in Code
** ISBN 978-1400082469
*Founter's at Work: Stories of Startup's early Days
** ISBN 978-1590597149
*Metaprogramminging GPUs with SH
** ISBN 978-1568812298
*High Performance Computing
** ISBN 978-1566923126
*Critical Testing Processes: Plan, Prepare, Perform, Perfect
** ISBN 978-0201748680
* GREP pocket reference
** ISBN 978-0596153601
* Programming Embedded Systems
** ISBN 978-0596009830
* High Availability and Disaster Recovery
** ISBN 978-3540244608
* An Introduction to Mathematical Cryptography
** ISBN 978-0387779930
* Real Time Systems Design and Analysis
** ISBN 978-0471228554
* The Black Swan: The Impact of the Highly Improbable
** ISBN 978-1400063512

== Non-technical ==
* How to Win Friends and Influence People
** ISBN 978-0671027032
* A Field Guide to Earthlings: An Autistic/Asperger View of Neurotypical Behavior
** ISBN 978-0615426198
* Natural Harvest - A Collection of Semen-Based Recipes
** ISBN 1-4743-1461-5
* Logicomix: An Epic Search for Truth
** ISBN 978-0747597209

== UI & HCI ==
*Sketching User Experiences
** ISBN 978-0-12-374037-3
*The Design of Everyday Things
** ISBN 978-0465067107
*The Laws of Simplicty
** ISBN 978-0262134729

== Course Textbooks ==
* CSfoo: '''rebind''' CLRS
* CS116: Downey, Python for Software Design: How to Think Like a Computer Scientist
** ISBN 978-0521725965
* CS136: King, C programming
** ISBN 978-0393979503
* CS240: GOODRICH & TAMASSIA:ALGORITHM DESIGN
** ISBN 978-0471383659
* CS246: SAVITCH:ABSOLUTE C++ 4TH ED
** ISBN 978-0136083818
* CS246: MEYERS:EFFECTIVE C++
** ISBN 978-0321334879
* CS365: Sipser, ''Introduction to the Theory of Computation'' SECOND EDITION
** ISBN 0-534-95097-3
* CS462 SHALLIT:SECOND COURSE IN FORMAL LANGUAGES & AUTOMATA THEOR
** ISBN 9780521865722

== Foundations/Field Surveys ==
* Knuth, The Art of Computer Programming (Copies that aren't signed)
** Volume 1, Fascicle 1: MMIX -- A RISC Computer for the New Millennium
*** ISBN 978-0201853926
** Volume 4, Fascicle 0: Introduction to Combinatorial Algorithms and Boolean Functions
*** ISBN 978-0321534965
** Volume 4, Fascicle 1: Bitwise Tricks & Techniques; Binary Decision Diagrams
*** ISBN 978-0321580504
** Volume 4, Fascicle 2: Generating All Tuples and Permutations
*** ISBN 978-0201853933
** Volume 4, Fascicle 3: Generating All Combinations and Partitions
*** ISBN 978-0201853940
** Volume 4, Fascicle 4: Generating All Trees--History of Combinatorial Generation
*** ISBN 978-0321335708
* Wirth, Algorithms + Data Structures = Programs
** ISBN 978-0130224187
* Dijkstra, A Discipline of Programming
** ISBN 978-0132158718
* Abelson, Structure and Interpretation of Computer Programs
** ISBN 978-0070004849
* Basic Category Theory for Computer Scientists
** ISBN 978-0262660716

== Strict Theory ==
* Recommended by John Watrous: http://www.amazon.com/Computational-Complexity-Approach-Sanjeev-Arora/dp/0521424267/ref=sr_1_1?ie=UTF8&s=books&qid=1276314046&sr=1-1
* [http://www.lulu.com/shop/univalent-foundations-project/homotopy-type-theory-hardcover/hardcover/product-21679084.html#productDetails Homotopy Type Theory]
* [http://www.amazon.com/Computational-Complexity-Christos-H-Papadimitriou/dp/0201530821/ Papadimitriou, ''Computational Complexity''] or newer equivalent
** ISBN 0201530821
* [http://www.amazon.com/Computability-Theory-Chapman-Hall-Mathematics/dp/1584882379 Cooper, ''Computability Theory''] or similar (Cooper is buggy)
** ISBN 1-58-488237-9
* [http://www.amazon.com/Introduction-Kolmogorov-Complexity-Applications-Computer/dp/0387339981/ Li and Vitanyi ''Kolmogorov Complexity and its Applications]
** ISBN 978-0387339986
* [http://www.amazon.com/Cambridge-Tracts-Theoretical-Computer-Science/dp/0521802008 Blackburn, de Rijke, Venema, ''Modal Logic'']
** ISBN 978-0521802000
* Kozen, ''Theory of Computation''
** ISBN 978-1846282973

== Programming Languages ==

* Theory of
** Pierce, Types and Programming Languages
*** ISBN 978-0262162098
* C++
** Bjarne Stroustrup, A Tour of C++
*** ISBN 978-0321958310
** Andrei Alexandrescu, Modern C++ Design: Generic Programming and Design Patterns Applied
*** ISBN 978-0201704310
* Scheme
** Friedman, The Little Schemer - 4th Edition
*** ISBN 978-0262560993
** Dybvig, The Scheme Programming Language, 3rd Edition
*** ISBN 978-0262541480
* Haskell
** Hudak, The Haskell School of Expression
*** ISBN 978-0521644082

= Vague Ideas =
These can be anything from a title missing an edition choice to a topic name to a binding style/colour.

== Theory ==
* Approximation Algorithms
* Randomized Algorithms
* Computer and Intractability (Grey & Johnson)
* Human Computer Interaction (HCI)
* Project Management
** Software Requirements
** Software Design & Architecture
** Software Testing
* Concurrency/Multithreading
* Security (Firewalls)
* Introduction to the Theory of Computation
* Numerical Analysis
* Numerical Methods? (Stoer & Bulirsch)
** This is probably not the actual title. We want a book on numerical methods by Stoer & Bulirsch
* Computer Systems: A Programmer's Perspective (Bryant & O'Hallaron)
* Quantum Computing book (from QIP)
** We have the course text, do we need more on the topic? IQC Recommendation?

== Programming Languages ==
* Python
* Haskell .NET
* Ruby
* C#
* Visual Basic .NET
* OCaml
* F#
* Basic
* Groovy
* Javascript
* C/C++
* Assembly .NET
* Databases [SQL]
* Coq .NET

== Technology Books ==
* Ubuntu
* Unix/Linux Beginner Books
* OpenGL/DirectX
* GTK
* Unix Network Programming

[[Category:Library]]

Machine List

2022-10-26T16:57:29Z

Joss: Adds the PS3 :)

Most of our machines are in the E7, F7, G7 and H7 racks (as of Jan. 2022) in the MC 3015 server room. There is an additional rack in the DC 3558 machine room on the third floor. Our office terminals are in the CSC office, in MC 3036/3037.

= Web Server =
You are highly encouraged to avoid running anything that's not directly related to your CSC webspace on our web server. We have plenty of general-use machines; please use those instead. You can even edit web pages from any other machine--usually the only reason you'd *need* to be on caffeine is for database access.

== ''caffeine'' ==

Caffeine is the Computer Science Club's web server. It serves websites, databases for websites, and a large amount of other services.

==== Specs ====

* currently a virtual machine hosted on phosphoric-acid
** 12 vCPUs
** 32GB of RAM

==== Services ====

* Club and member web sites with [[Apache]]
* [[MySQL]] databases
* [[PostgreSQL]] databases
* [[ceo]] daemon
* mail was migrated to [[#mail|mail]]

= General-Use Servers =

These machines can be used for (nearly) anything you like (though be polite and remember that these are shared machines). Recall that when you signed the Machine Usage Agreement, you promised not to use these machines to generate profit (so no cryptocurrency mining).

For computationally-intensive jobs (CPU/memory bound) we recommend running on high-fructose-corn-syrup, carbonated-water, sorbitol, mannitol, or corn-syrup, listed in roughly decreasing order of available resources. For low-intensity interactive jobs, such as IRC clients, we recommend running on neotame. If you have a long-running computationally intensive job, it's good to nice[https://en.wikipedia.org/wiki/Nice_(Unix)] your process, and possibly let syscom know too.

== ''corn-syrup'' ==

PowerEdge 2950

==== Specs ====

* 2 × Intel Xeon E5405 (2.00 GHz, 4 cores each)
* 32 GB RAM
* eth0 ("Gb0") mac addr 00:24:e8:52:41:27
* eth1 ("Gb1") mac addr 00:24:e8:52:41:29
* IPMI mac addr 00:24:e8:52:41:2b
* 3 × Western-Digital 160GB SATA hard drive (445 GB software RAID0 array)

==== Notes ====

* Use eth0/Gb0 for the mathstudentorgsnet connection
* has ipmi on corn-syrup-ipmi.csclub.uwaterloo.ca.

==== Services ====

* Hosts 1 TB <tt>[[scratch|/scratch]]</tt> and exports via NFS (sec=krb5)

== ''high-fructose-corn-syrup'' ==

High-fructose-corn-syrup (or hfcs) is a large SuperMicro server. It's been in CSC service since April 2012.

==== Specs ====

* 4x AMD Opteron 6272 (2.4 GHz, 16 cores each)
* 192 GB RAM
* Supermicro H8QGi+-F Motherboard Quad 1944-pin Socket [http://csclub.uwaterloo.ca/misc/manuals/motherboard-H8QGI+-F.pdf (Manual)]
* 500 GB Seagate Barracuda
* Supermicro Case Rackmount CSE-748TQ-R1400B 4U [http://csclub.uwaterloo.ca/misc/manuals/SC748.pdf (Manual)]

== ''carbonated-water'' ==

carbonated-water is a Dell R815 provided by CSCF.

==== Specs ====

* 4x AMD Opteron 6176 processors (2.3 GHz, 12 cores each)
* 128GB RAM

== ''neotame'' ==

neotame is a SuperMicro server funded by MEF. It is the successor to taurine.

We discourage running computationally-intensive jobs on neotame as many users run interactive applications such as IRC clients on it and any significant service degradation will be more likely to affect other users (who will probably notice right away).

==== Specs ====

* 2x Intel Xeon E5-2630 processors (2.2 GHz, 10 cores/20 threads each)
* 64GB RAM
* SSH server also listens on ports 21, 22, 53, 80, 81, 443, 8000, 8080 for your convenience.

== ''sorbitol'' ==

sorbitol is a SuperMicro server funded by MEF.

==== Specs ====

* 2x Intel Xeon E5-2630 processors (2.2 GHz, 10 cores/20 threads each)
* 64GB RAM

== ''mannitol'' ==

mannitol is a SuperMicro server funded by MEF.

==== Specs ====

* 2x Intel Xeon E5-2630 processors (2.2 GHz, 10 cores/20 threads each)
* 64GB RAM

= Office Terminals =

It's possible to SSH into these machines, but we discourage you from trying to use these machines when you're not sitting in front of them. They are bounced at least every time our login manager, lightdm, throws a tantrum (which is several times a day). These are for use inside our physical office.

== ''bit-shifter'' ==

bit-shifter is an office terminal.

==== Specs ====

* Intel(R) Core(TM)2 Quad CPU Q8300
* 4GB RAM
* Nvidia GeForce GT 440
* [http://csclub.uwaterloo.ca/misc/manuals/motherboard_manual_ga-ep45-ud3l.pdf Gigabyte GA-EP45-UD3L] Motherboard
* 1x 64GB SanDisk SDSSDP064G SSD
* Jacob Parker's Firewire Card

==== Services ====

* [http://csclub.uwaterloo.ca/office/webcam Office webcam]

== ''gwem'' ==

gwem is an office terminal that was created because AMD donated a graphics card. It entered CSC service in February 2012.

=== Specs ===

* AMD FX-8150 3.6GHz 8-Core CPU
* 16 GB RAM
* AMD Radeon 6870 HD 1GB GPU
* [http://csclub.uwaterloo.ca/misc/manuals/ga-990fxa-ud7_e.pdf Gigabyte GA-990FXA-UD7] Motherboard
* 1x 64GB SanDisk SDSSDP064G SSD

== ''maltodextrin'' ==
* [http://csclub.uwaterloo.ca/misc/manuals/motherboard_manual_ga-ep45-ud3l.pdf Gigabyte GA-EP45-UD3L] Motherboard
Maltodextrin is an office terminal. It was upgraded in Spring 2014 after an unidentified failure.
Not operational (no video output) as of July 2022.

==== Specs ====

* Intel Core i3-4130 @ 3.40 GHz
* 8GB RAM
* 1x 64GB SanDisk SDSSDP064G SSD
* [http://csclub.uwaterloo.ca/misc/manuals/E8425_H81I_PLUS.pdf ASUS H81-PLUS] Motherboard

==== Services ====

* [http://csclub.uwaterloo.ca/office/webcam Office webcam]

== ''natural-flavours'' ==

Natural-flavours is an office terminal; it used to be our mirror.

In Fall 2016, it received a major upgrade thanks the MathSoc's Capital Improvement Fund.

==== Specs ====

* Intel Core i7-6700k
* 2x8GB RAM
* 1x 64GB SanDisk SDSSDP064G SSD
* Cup Holder (DVD drive has power, but not connected to mother board)

== ''strombola''==
It is named after Gordon Strombola.

==== Specs ====
* Intel Pentium G4600 2 cores @ 3.6Ghz
* 8 GB RAM
* 1x 64GB SanDisk SDSSDP064G SSD

==== Speakers ====
Strombola used to have integrated 5.1 channel sound before we got new speakers and moved audio stuff to nullsleep.

== ''nullsleep'' ==

nullsleep is an [http://csclub.uwaterloo.ca/misc/manuals/ASRock_ION_330.pdf ASRock ION 330] machine given to us by CSCF and funded by MEF.

==== Specs ====

* Intel® Dual Core Atom™ 330
* 2GB RAM
* NVIDIA® ION™ graphics
* 1x 64GB SanDisk SDSSDP064G SSD
* DVD Burner

==== Speakers ====
Nullsleep has the office speakers (a pair of nice studio monitors) currently connected to it.

==== Services ====
Nullsleep runs MPD for playing music. Control of MPD is available only to users in the "audio" group.
Music is located in /music on the office terminals

= Progcom Only =
The Programme Committee has access to a VM on corn-syrup called 'progcom'. They have sudo rights in this VM so they may install and run their own software inside it. This VM should only be accessible by members of progcom or syscom.

= Syscom Only =

The following systems may only be accessible to members of the [[Systems Committee]] for a variety of reasons; the most common of which being that some of these machines host [[Kerberos]] authentication services for the CSC.

== ''xylitol'' ==

xylitol is a Dell PowerEdge R815 donated by CSCF. It is primarily a container host for services previously hosted on aspartame and dextrose, including munin, rt, mathnews, auth1, and dns1. It was provisioned with the intent to replace both of those hosts.

==== Specs ====

* Dual AMD Opteron 6176 (2.3 GHz, 48 cores total)
* 128GB RAM
* 500GB volume group on RAID1 SSD (xylitol-mirrored)
* 500ish-GB volume group on RAID10 HDD (xylitol-raidten)

== ''auth1'' ==

Container on [[#xylitol|xylitol]].

==== Services ====

* [[LDAP]] primary
* [[Kerberos]] primary

== ''chat'' ==

Container on [[#xylitol|xylitol]].

==== Services ====

* The Lounge web IRC client (https://chat.csclub.uwaterloo.ca)

== ''phosphoric-acid'' ==

phosphoric-acid is a Dell PowerEdge R815 donated by CSCF and is a clone of xylitol. It may be used to provide redundant cloud services in the future.

==== Specs ====
==== Services ====

* [[#caffeine|caffeine]]
* [[#coffee|coffee]]

== ''coffee'' ==

Virtual machine running on phosphoric-acid.

==== Services ====

* [[Database#MySQL|MySQL]]
* [[Database#Postgres|Postgres]]

== ''cobalamin'' ==

Dell PowerEdge 2950 donated to us by FEDS. Located in the Science machine room on the first floor of Physics. Will act as a backup server for many things.

==== Specs ====

* 1 × Intel Xeon E5420 (2.50 GHz, 4 cores)
* 16GB RAM
* Broadcom NetworkXtreme II
* 2x73GB Hard Drives, hardware RAID1
** Soon to be 2x1TB in MegaRAID1
* http://www.dell.com/support/home/ca/en/cabsdt1/product-support/servicetag/51TYRG1/configuration

==== Services ====

* Containers: [[#auth2|auth2]]

==== Notes ====

* The network card requires non-free drivers. Be sure to use an installation disc with non-free.

* We have separate IP ranges for cobalamin and its containers because the machine is located in a different building. They are:

** VLAN ID 506 (csc-data1): 129.97.18.16/29; gateway 129.97.18.17; mask 255.255.255.240
** VLAN ID 504 (csc-ipmi): 172.19.5.24/29; gateway 172.19.5.25; mask 255.255.255.248

* For some reason, the keyboard is shit. Try to avoid having to use it. It's doable, but painful. IPMI works now, and then we don't need to bug about physical access so it's better anyway.

== ''auth2'' ==

Container on [[#cobalamin|cobalamin]].

==== Services ====

* [[LDAP]] secondary
* [[Kerberos]] secondary

MAC Address: c2:c0:00:00:00:a2

== ''mail'' ==

mail is the CSC's mail server. It hosts mail delivery, imap(s), smtp(s), and mailman. It is also syscom-only. It is a [[Virtualization#Linux_Containers|Linux container]] at present.

==== Specs ====

* currently hosted on [[#biloba|biloba]]

==== Services ====

* [[Mail]] services
* mailman (web interface at [http://mailman.csclub.uwaterloo.ca/])
* [[Webmail]]
* [[ceo]] daemon

== ''sodium-benzoate'' ==

Sodium-benzoate is our previous mirror server, funded by MEF.

It is currently sitting in the office pending repurposing. Will likely become a machine for backups in DC.

==== Specs ====

* Intel Xeon Quad Core E5405 @ 2.00 GHz
* 16GB RAM
* vg0: 228 GB block device behind DELL PERC 6/i (contains root partition)

Space disks are currently in the office underneath maltodextrin.

== ''potassium-benzoate'' ==

potassium-benzoate is our mirror server, funded by MEF.

==== Specs ====

* 36 drive Supermicro chassis (SSG-6048R-E1CR36L)
* 1 x Intel Xeon E5-2630 (8 cores, 2.40 GHz)
* 64 GB (4 x 16GB) of DDR4 (2133Mhz) ECC RAM
* 2 x 1 TB Samsung Evo 850 SSD drives
* 17 x 4 TB Western Digital Gold drives (separate funding from MEF)
* 10 Gbps SFP+ card (loaned from CSCF)
* 50 Gbps Mellanox QSFP card (from ginkgo; currently unconnected)

==== Network Connections ====

potassium-benzoate has two connections to our network:

* 1 Gbps to our switch (used for management)
* 2 x 10 Gbps (LACP bond) to mc-rt-3015-mso-a (for mirror)

Mirror's bandwidth is limited to 1 Gbps on each of the 4 campus internet links. Mirror's bandwidth is not limited on campus.

==== Services ====

* [[Mirror]]
* [[Talks]] mirror
* [[Debian_Repository|CSClub packages repository]]

== ''munin'' ==

munin is a syscom-only monitoring and accounting machine. It is a [[Virtualization#Linux_Containers|Linux container]] at present.

==== Specs ====

* currently hosted on [[#xylitol|xylitol]]

==== Services ====

* [http://munin.csclub.uwaterloo.ca munin] systems monitoring daemon

== ''yerba-mate'' ==

A Dell PowerEdge 2950 donated by a CSC member.

==== Specs ====

* 2x 3.00 Hz quad core Intel Xeon 5160
* 32GB RAM
* 2x75GB 15k drives (RAID 1)

==== Services ====

* test-ipv6 (test-ipv6.csclub.uwaterloo.ca; a test-ipv6.com mirror)
* mattermost (under development)
* shibboleth (under development)

Also used for experimenting new CSC services.

= Cloud =

These machines are used by [https://cloud.csclub.uwaterloo.ca cloud.csclub.uwaterloo.ca]. The machines themselves are restricted to Syscom only access.

== ''chamomile'' ==

A Dell PowerEdge R815 provided by CSCF.

==== Specs ====

* 4x 2.20GHz 12-core processors
* 128GB RAM
* 10GbE connection to core router

==== Services ====

* OpenStack primary controller services for csclub.cloud

== ''riboflavin'' ==

A Dell PowerEdge R515 provided by CSCF.

==== Specs ====

* 2x 2.6 GHz 8-core processors
* 64GB RAM
* 10GbE connection to core router
* 2x 500GB internal SSD
* 12x Seagate 4TB SSHD

==== Services ====

* OpenStack block and object storage for csclub.cloud

== ''guayusa'' ==

A Dell PowerEdge 2950 donated by a CSC member.

==== Specs ====

* 2x 3.00 GHz quad core Intel Xeon 5160
* 32GB RAM
* 2TB PCI-Express Flash SSD
* 2x75GB 15k drives (RAID 1)

==== Services ====

Currently being used to set up NextCloud.

Was used to experiment the following then-new CSC services:

* logstash (testing of logstash)
* load-balancer-01
* cifs (for booting ginkgo from CD)
* caffeine-01 (testing of multi-node caffeine)
* block1.cloud
* object1.cloud

== ''ginkgo'' ==

Supermicro server funded by MEF for CSC web hosting. Locate in MC 3015.

==== Specs ====

* 2x Intel Xeon E5-2697 v4 @ 2.30GHz [18 cores each]
* 256GB RAM
* 2 x 1.2 TB SSD (400GB of each for RAID 1)
* 10GbE onboard, 25GbE SFP+ card (also included 50GbE SFP+ card which will probably go in mirror)

==== Services ====

* OpenStack Compute machine

No longer in use:

* controller1.cloud
* db1.cloud
* router1.cloud (NAT for cloud tenant network)
* network1.cloud

== ''biloba'' ==

Supermicro server funded by SLEF for CSC web hosting. Located in DC 3558.

==== Specs ====

* 2x Intel Xeon Gold 6140 @ 2.30GHz [18 cores each]
* 384GB RAM
* 12 3.5" Hot Swap Drive Bays
** 2 x 480 GB SSD
* 10GbE onboard, 10GbE SFP+ card (on loan from CSCF)

==== Services ====

* OpenStack Compute machine

No longer in use:

* caffeine
* mail
* mattermost

= Storage =

== ''fs00'' ==

fs00 is a NetApp FAS3040 series fileserver donated by CSCF.

It is currently being used for testing of a HA NetApp nodes and serving home directories directly from the NetApp filer.

==== Specs ====

== ''fs01'' ==

fs01 is a NetApp FAS3040 series fileserver donated by CSCF.

It is currently being used for testing of a HA NetApp nodes and serving home directories directly from the NetApp filer.

==== Specs ====

= Other =

== ps3 ==
This is just a very wide PS3, the model that supported running Linux natively before it was removed. Firmware was updated to remove this feature, however it can still be done via. homebrew.

'''Specs'''

* It's a PS3.

'''2022-10-24''' - Thermal paste replaced + firmware updated to latest supported version, also modded.

==''binaerpilot''==

This is a Gumstix Overo Tide CPU on a Tobi expansion board. It is currently attached to corn-syrup in the machine room and even more currently turned off until someone can figure out what is wrong with it.

==== Specs ====

* TI OMAP 3530 750Mhz (ARM Cortex-A8)
* 512MB RAM

== ''anamanaguchi'' ==

This is a Gumstix Overo Tide CPU on a Chestnut43 expansion board. It is currently in the hardware drawer in the CSC.

==== Specs ====

* TI OMAP 3530 750Mhz (ARM Cortex-A8)
* 512MB RAM

== ''digital cutter'' ==

See [[Digital Cutter|here]].

== ''mathnews'' ==

[[#xylitol|xylitol]] hosts a systemd-nspawn container which serves as the mathNEWS webserver. It is administered by mathNEWS, as a pilot for providing containers to select groups who have more specialized demands than the general-use infrastructure can meet.

= Decommissioned =

== ''aspartame'' ==

aspartame was a taurine clone donated by CSCF. It was once our primary file server, serving as the gateway interface to space on phlogiston. It also used to host the [[#auth1|auth1]] container, which has been temporarily moved to [[#dextrose|dextrose]]. Decomissioned in March 2021 after refusing to boot following a power outage.

== ''psilodump'' ==

psilodump is a NetApp FAS3000 series fileserver donated by CSCF. It, along with its sibling phlogiston, hosted disk shelves exported as iSCSI block devices.

psilodump was plugged into aspartame. It's still installed but inaccessible.

== ''phlogiston'' ==

phlogiston is a NetApp FAS3000 series fileserver donated by CSCF. It, along with its sibling psilodump, hosted disk shelves exported as iSCSI block devices.

phlogiston is turned off and should remain that way. It is misconfigured to have its drives overlap with those owned by psilodump, and if it is turned on, it will likely cause irreparable data loss.

==== Specs ====

* 2 AMD Opteron 2218 CPUs
* 10GB RAM

==== Notes from before decommissioning ====

* The lxc files are still present and should not be started up, or else the two copies of auth1 will collide.
* It currently cannot route the 10.0.0.0/8 block to a misconfiguration on the NetApp. This should be fixed at some point.

== ''glomag'' ==

Glomag hosted [[#caffeine|caffeine]]. Decommissioned April 6, 2018.

==== Specs ====

* Intel Xeon X3450 @ 2.67 GHz
* 6 GB RAM
* vg0: 465 GB software RAID1 (contains root partition):
** 750 GB Seagate Barracuda SATA hard drive
** 500 GB Western-Digital Caviar Blue SATA hard drive
* vg1: 596 GB software RAID1 (contains caffeine):
** 2 × 640 GB Western-Digital Caviar Blue SATA hard drive

==== Services ====

* Before its decommissioning, glomag hosted [[#caffeine|caffeine]], [[#mail|mail]], and [[#munin|munin]] as [[Virtualization#Linux_Container|Linux containers]]

== ''Lisp machine'' ==

A Symbolics XL1200 Lisp machine. Donated to a new home when we couldn't get it working.

http://www.globalnerdy.com/2008/12/03/symbolics-xl1200-lisp-machine-free-to-a-good-home/ for some history on this hardware.

==== Specs ====

Currently inoperable due to (at least) a missing console cable.

== ''ginseng'' ==

Ginseng used to be our fileserver, before aspartame and the netapp took over.

==== Specs ====

* Intel Pentium Dual Core E2180
* 8GB RAM
* [http://csclub.uwaterloo.ca/misc/manuals/s3000ah_tps_1_1.pdf Intel S3000AHV Motherboard]
* 4 × 640 GB Western-Digital Caviar Blue in [http://en.wikipedia.org/wiki/Nested_RAID_levels#RAID_10_.28RAID_1.2B0.29 RAID 10] behind a [http://www.3ware.com/products/serial_ata2-9650.asp 3ware 9650SE RAID card].
[[Category:Hardware]]

== ''calum'' ==

Calum used to be our main server and was named after Calum T Dalek. Purchased new by the club in 1994.

==== Specs ====

* SPARCserver 10 (headless SPARCstation 10)

== ''paza'' ==

An iMac G3 that was used as a dumb terminal.

==== Specs ====

* 233Mhz PowerPC 740/750
* 96 MB RAM

== ''romana'' ==

Romana was a BeBox that has been in the CSC's possession since long before BeOS became defunct.

Confirmed on March 19th, 2016 to be fully functional. An SSHv1 compatible client was installed from http://www.abstrakt.ch/be/ and a compatible firewalled daemon was started on Sucrose (living in /root, prefix is /root/ssh-romana). The insecure daemon is to be used a bastion host to jump to hosts only supporting >=SSHv2. The mail daemon on the BeBox has also been configured to send mail through mail.csclub.uwaterloo.ca.

==== Specs ====

* 2 PowerPC based processors
* Stylish Blinken processor-load lights

== ''sodium-citrate'' ==

Sodium-citrate was an SGI O2 machine.

In order to net boot you need to set /proc/sys/net/ipv4/ip_no_pmtu_disc to 1. When the O2 boots, hit F5 at the boot menu and type bootp():.

==== Specs ====
* SGI O2 MIPS processor
* 423 MB (?) RAM
* 2 × 2 GB hard drive

== ''acesulfame-potassium'' ==

An old office terminal.

==== Specs ====
* Intel Pentium 4 2.67GHz
* 1GB RAM
* [http://csclub.uwaterloo.ca/misc/manuals/ABIT_VT7.pdf ABIT VT7] Motherboard
* ATI Radeon 7000

== ''skynet'' ==

skynet was a Sun E6500 machine donated by Sanjay Singh. It was never fully set up.

==== Specs ====

* 15 full CPU/memory boards
** 2x UltraSPARC II 464MHz / 8MB Cache Processors
** ??? RAM?
* 1 I/O board (type=???)
** ???x disks?
* 1 CD-ROM drive

* [http://mirror.csclub.uwaterloo.ca/csclub/sun_e6500/ent6k.srvr/ e6500 documentation (hosted on mirror, currently dead link)]
* [http://docs.oracle.com/cd/E19095-01/ent6k.srvr/ e6500 documentation (backup link)]
* [http://www.e6500.com/ e6500]

== ''freebsd'' ==

FreeBSD was a virtual machine with FreeBSD installed.

==== Services ====

* Newer software

== ''rainbowdragoneyes'' ==

Rainbowdragoneyes was our Lemote Fuloong MIPS machine. This machine is aliased to rde.csclub.uwaterloo.ca.

==== Specs ====

* 800MHz MIPS Loongson 2f CPU

== ''denardo'' ==

Due to some instability, general uselessness, and the acquisition of a more powerful SPARC machine from MFCF, denardo was decommissioned in February 2015.

==== Specs ====

* Sun Fire V210
* TI UltraSparc IIIi (Jalapeño)
* 2 GB RAM
* 160 GB RAID array
* ALOM on denardo-alom.csclub can be used to power machine on/off

== ''artificial-flavours'' ==

Artificial-flavours was our secondary (backup services) server. It used to be an office terminal. It was decommissioned in February 2015 and transferred to the ownership of Women in Computer Science (WiCS).

==== Specs ====

* Intel Celeron 3.2GHz
* 2GB RAM
* [http://csclub.uwaterloo.ca/misc/manuals/Biostar_P4M80-M4.pdf Biostar P4M80-M4] Motherboard
* Western-Digital 80 GB ATA hard drive

== ''potassium-citrate'' ==

Potassium-citrate is a dual-processor Alpha machine. It is on extended loan from pbarfuss.

It is temporarily decommissioned pending the reinstallation of a supported operating system (such as OpenBSD).

==== Specs ====
* Alphaserver CS20 (2 833MHz EV68al CPUs)
* 512MB RAM
* 36 GB Seagate SCSI hard drive

== ''potassium-nitrate'' ==

This was a Sun Fire E2900 from a decommissioned MFCF compute cluster. It had a SPARC architecture and ran OpenBSD, unlike many of our other systems which are x86/x86-64 and Linux/Debian. After multiple unsuccessful attempts to boot a modern Linux kernel and possible hardware instability, it was determined to be non-cost-effective and non-effort-effective to put more work into running this machine. The system was reclaimed by MFCF where someone from CS had better luck running a suitable operating system (probably Solaris).

The name is from saltpetre, because sparks.

==== Specs ====

* 24 CPUs
* 90GB main memory
* 400GB scratch disk local storage in /scratch-potassium-nitrate

There is a [[Sun 2900 Strategy Guide|setup guide]] available for this machine.

See also [[Sun 2900]].

== ''taurine'' ==

'''Note: On August 21, 2019, just before 2:30PM EDT, we were informed that taurine caught fire'''. As a result, taurine has been decommissioned as of Fall 2019.

==== Specs ====

* 2 AMD Opteron 2218 CPUs
* 8GB RAM
* 136 GB LVM volume group

==== Services ====

* Virtual machines
* BitlBee IRC instant messaging gateway (localhost only)
* [[ident]] server to maintain high connection cap to freenode
* Runs ssh on ports 21,22,53,80,81,443,8000,8080 for user's convenience.

== ''dextrose'' ==

dextrose was a [[#taurine|taurine]] clone donated by CSCF and was decommissioned in Fall 2019 after being replaced with a more powerful server.

== ''sucrose'' ==

sucrose was a [[#taurine|taurine]] clone donated by CSCF. It was decommissioned in Fall 2019 following multiple hardware failures.

== ''goto80'' ==
'''Note (2022-10-25): This seems to have gone missing or otherwise left our hands.'''

This was small ARM machine we picked up in order to have similar hardware to the Real Time Operating Systems (CS 452) course. It has a [[TS-7800_JTAG|JTAG]] interface. Located was the office on the top shelf above strombola.

==== Specs ====

* 500 MHz Feroceon (ARM926ej-s compatible) processor
* ARMv5TEJ architecture

Use -march=armv5te -mtune=arm926ej-s options to GCC.

For information on the TS-7800's hardware see here:
http://www.embeddedarm.com/products/board-detail.php?product=ts-7800

= UPS =

All of the machines in the MC 3015 machine room are connected to one of our UPSs.

All of our UPSs can be monitored via CSCF:

* MC3015-UPS-B2
* mc-3015-e7-ups-1.cs.uwaterloo.ca (rbc55, batteries replaced July 2014) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-e7-ups-1&var-Interval=30m)
* mc-3015-f7-ups-1.cs.uwaterloo.ca (rbc55, batteries replaced Feb 2017) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-f7-ups-1&var-Interval=30m)
* mc-3015-g7-ups-1.cs.uwaterloo.ca (su5000t, batteries replaced 2010) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-g7-ups-1&var-Interval=30m)
* mc-3015-g7-ups-2.cs.uwaterloo.ca (unknown) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-g7-ups-2&var-Interval=30m)
* mc-3015-h7-ups-1.cs.uwaterloo.ca (su5000t, batteries replaced 2004) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-h7-ups-1&var-Interval=30m)
* mc-3015-h7-ups-2.cs.uwaterloo.ca (unknown) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-h7-ups-2&var-Interval=30m)

We will receive email alerts for any issues with the UPS. Their status can be monitored via [[SNMP]].

TODO: Fix labels & verify info is correct & figure out why we can't talk to cacti.

Machine List

2022-10-26T00:57:00Z

Joss: Update specs for strombola and decomission the trains machine

Most of our machines are in the E7, F7, G7 and H7 racks (as of Jan. 2022) in the MC 3015 server room. There is an additional rack in the DC 3558 machine room on the third floor. Our office terminals are in the CSC office, in MC 3036/3037.

= Web Server =
You are highly encouraged to avoid running anything that's not directly related to your CSC webspace on our web server. We have plenty of general-use machines; please use those instead. You can even edit web pages from any other machine--usually the only reason you'd *need* to be on caffeine is for database access.

== ''caffeine'' ==

Caffeine is the Computer Science Club's web server. It serves websites, databases for websites, and a large amount of other services.

==== Specs ====

* currently a virtual machine hosted on phosphoric-acid
** 12 vCPUs
** 32GB of RAM

==== Services ====

* Club and member web sites with [[Apache]]
* [[MySQL]] databases
* [[PostgreSQL]] databases
* [[ceo]] daemon
* mail was migrated to [[#mail|mail]]

= General-Use Servers =

These machines can be used for (nearly) anything you like (though be polite and remember that these are shared machines). Recall that when you signed the Machine Usage Agreement, you promised not to use these machines to generate profit (so no cryptocurrency mining).

For computationally-intensive jobs (CPU/memory bound) we recommend running on high-fructose-corn-syrup, carbonated-water, sorbitol, mannitol, or corn-syrup, listed in roughly decreasing order of available resources. For low-intensity interactive jobs, such as IRC clients, we recommend running on neotame. If you have a long-running computationally intensive job, it's good to nice[https://en.wikipedia.org/wiki/Nice_(Unix)] your process, and possibly let syscom know too.

== ''corn-syrup'' ==

PowerEdge 2950

==== Specs ====

* 2 × Intel Xeon E5405 (2.00 GHz, 4 cores each)
* 32 GB RAM
* eth0 ("Gb0") mac addr 00:24:e8:52:41:27
* eth1 ("Gb1") mac addr 00:24:e8:52:41:29
* IPMI mac addr 00:24:e8:52:41:2b
* 3 × Western-Digital 160GB SATA hard drive (445 GB software RAID0 array)

==== Notes ====

* Use eth0/Gb0 for the mathstudentorgsnet connection
* has ipmi on corn-syrup-ipmi.csclub.uwaterloo.ca.

==== Services ====

* Hosts 1 TB <tt>[[scratch|/scratch]]</tt> and exports via NFS (sec=krb5)

== ''high-fructose-corn-syrup'' ==

High-fructose-corn-syrup (or hfcs) is a large SuperMicro server. It's been in CSC service since April 2012.

==== Specs ====

* 4x AMD Opteron 6272 (2.4 GHz, 16 cores each)
* 192 GB RAM
* Supermicro H8QGi+-F Motherboard Quad 1944-pin Socket [http://csclub.uwaterloo.ca/misc/manuals/motherboard-H8QGI+-F.pdf (Manual)]
* 500 GB Seagate Barracuda
* Supermicro Case Rackmount CSE-748TQ-R1400B 4U [http://csclub.uwaterloo.ca/misc/manuals/SC748.pdf (Manual)]

== ''carbonated-water'' ==

carbonated-water is a Dell R815 provided by CSCF.

==== Specs ====

* 4x AMD Opteron 6176 processors (2.3 GHz, 12 cores each)
* 128GB RAM

== ''neotame'' ==

neotame is a SuperMicro server funded by MEF. It is the successor to taurine.

We discourage running computationally-intensive jobs on neotame as many users run interactive applications such as IRC clients on it and any significant service degradation will be more likely to affect other users (who will probably notice right away).

==== Specs ====

* 2x Intel Xeon E5-2630 processors (2.2 GHz, 10 cores/20 threads each)
* 64GB RAM
* SSH server also listens on ports 21, 22, 53, 80, 81, 443, 8000, 8080 for your convenience.

== ''sorbitol'' ==

sorbitol is a SuperMicro server funded by MEF.

==== Specs ====

* 2x Intel Xeon E5-2630 processors (2.2 GHz, 10 cores/20 threads each)
* 64GB RAM

== ''mannitol'' ==

mannitol is a SuperMicro server funded by MEF.

==== Specs ====

* 2x Intel Xeon E5-2630 processors (2.2 GHz, 10 cores/20 threads each)
* 64GB RAM

= Office Terminals =

It's possible to SSH into these machines, but we discourage you from trying to use these machines when you're not sitting in front of them. They are bounced at least every time our login manager, lightdm, throws a tantrum (which is several times a day). These are for use inside our physical office.

== ''bit-shifter'' ==

bit-shifter is an office terminal.

==== Specs ====

* Intel(R) Core(TM)2 Quad CPU Q8300
* 4GB RAM
* Nvidia GeForce GT 440
* [http://csclub.uwaterloo.ca/misc/manuals/motherboard_manual_ga-ep45-ud3l.pdf Gigabyte GA-EP45-UD3L] Motherboard
* 1x 64GB SanDisk SDSSDP064G SSD
* Jacob Parker's Firewire Card

==== Services ====

* [http://csclub.uwaterloo.ca/office/webcam Office webcam]

== ''gwem'' ==

gwem is an office terminal that was created because AMD donated a graphics card. It entered CSC service in February 2012.

=== Specs ===

* AMD FX-8150 3.6GHz 8-Core CPU
* 16 GB RAM
* AMD Radeon 6870 HD 1GB GPU
* [http://csclub.uwaterloo.ca/misc/manuals/ga-990fxa-ud7_e.pdf Gigabyte GA-990FXA-UD7] Motherboard
* 1x 64GB SanDisk SDSSDP064G SSD

== ''maltodextrin'' ==
* [http://csclub.uwaterloo.ca/misc/manuals/motherboard_manual_ga-ep45-ud3l.pdf Gigabyte GA-EP45-UD3L] Motherboard
Maltodextrin is an office terminal. It was upgraded in Spring 2014 after an unidentified failure.
Not operational (no video output) as of July 2022.

==== Specs ====

* Intel Core i3-4130 @ 3.40 GHz
* 8GB RAM
* 1x 64GB SanDisk SDSSDP064G SSD
* [http://csclub.uwaterloo.ca/misc/manuals/E8425_H81I_PLUS.pdf ASUS H81-PLUS] Motherboard

==== Services ====

* [http://csclub.uwaterloo.ca/office/webcam Office webcam]

== ''natural-flavours'' ==

Natural-flavours is an office terminal; it used to be our mirror.

In Fall 2016, it received a major upgrade thanks the MathSoc's Capital Improvement Fund.

==== Specs ====

* Intel Core i7-6700k
* 2x8GB RAM
* 1x 64GB SanDisk SDSSDP064G SSD
* Cup Holder (DVD drive has power, but not connected to mother board)

== ''strombola''==
It is named after Gordon Strombola.

==== Specs ====
* Intel Pentium G4600 2 cores @ 3.6Ghz
* 8 GB RAM
* 1x 64GB SanDisk SDSSDP064G SSD

==== Speakers ====
Strombola used to have integrated 5.1 channel sound before we got new speakers and moved audio stuff to nullsleep.

== ''nullsleep'' ==

nullsleep is an [http://csclub.uwaterloo.ca/misc/manuals/ASRock_ION_330.pdf ASRock ION 330] machine given to us by CSCF and funded by MEF.

==== Specs ====

* Intel® Dual Core Atom™ 330
* 2GB RAM
* NVIDIA® ION™ graphics
* 1x 64GB SanDisk SDSSDP064G SSD
* DVD Burner

==== Speakers ====
Nullsleep has the office speakers (a pair of nice studio monitors) currently connected to it.

==== Services ====
Nullsleep runs MPD for playing music. Control of MPD is available only to users in the "audio" group.
Music is located in /music on the office terminals

= Progcom Only =
The Programme Committee has access to a VM on corn-syrup called 'progcom'. They have sudo rights in this VM so they may install and run their own software inside it. This VM should only be accessible by members of progcom or syscom.

= Syscom Only =

The following systems may only be accessible to members of the [[Systems Committee]] for a variety of reasons; the most common of which being that some of these machines host [[Kerberos]] authentication services for the CSC.

== ''xylitol'' ==

xylitol is a Dell PowerEdge R815 donated by CSCF. It is primarily a container host for services previously hosted on aspartame and dextrose, including munin, rt, mathnews, auth1, and dns1. It was provisioned with the intent to replace both of those hosts.

==== Specs ====

* Dual AMD Opteron 6176 (2.3 GHz, 48 cores total)
* 128GB RAM
* 500GB volume group on RAID1 SSD (xylitol-mirrored)
* 500ish-GB volume group on RAID10 HDD (xylitol-raidten)

== ''auth1'' ==

Container on [[#xylitol|xylitol]].

==== Services ====

* [[LDAP]] primary
* [[Kerberos]] primary

== ''chat'' ==

Container on [[#xylitol|xylitol]].

==== Services ====

* The Lounge web IRC client (https://chat.csclub.uwaterloo.ca)

== ''phosphoric-acid'' ==

phosphoric-acid is a Dell PowerEdge R815 donated by CSCF and is a clone of xylitol. It may be used to provide redundant cloud services in the future.

==== Specs ====
==== Services ====

* [[#caffeine|caffeine]]
* [[#coffee|coffee]]

== ''coffee'' ==

Virtual machine running on phosphoric-acid.

==== Services ====

* [[Database#MySQL|MySQL]]
* [[Database#Postgres|Postgres]]

== ''cobalamin'' ==

Dell PowerEdge 2950 donated to us by FEDS. Located in the Science machine room on the first floor of Physics. Will act as a backup server for many things.

==== Specs ====

* 1 × Intel Xeon E5420 (2.50 GHz, 4 cores)
* 16GB RAM
* Broadcom NetworkXtreme II
* 2x73GB Hard Drives, hardware RAID1
** Soon to be 2x1TB in MegaRAID1
* http://www.dell.com/support/home/ca/en/cabsdt1/product-support/servicetag/51TYRG1/configuration

==== Services ====

* Containers: [[#auth2|auth2]]

==== Notes ====

* The network card requires non-free drivers. Be sure to use an installation disc with non-free.

* We have separate IP ranges for cobalamin and its containers because the machine is located in a different building. They are:

** VLAN ID 506 (csc-data1): 129.97.18.16/29; gateway 129.97.18.17; mask 255.255.255.240
** VLAN ID 504 (csc-ipmi): 172.19.5.24/29; gateway 172.19.5.25; mask 255.255.255.248

* For some reason, the keyboard is shit. Try to avoid having to use it. It's doable, but painful. IPMI works now, and then we don't need to bug about physical access so it's better anyway.

== ''auth2'' ==

Container on [[#cobalamin|cobalamin]].

==== Services ====

* [[LDAP]] secondary
* [[Kerberos]] secondary

MAC Address: c2:c0:00:00:00:a2

== ''mail'' ==

mail is the CSC's mail server. It hosts mail delivery, imap(s), smtp(s), and mailman. It is also syscom-only. It is a [[Virtualization#Linux_Containers|Linux container]] at present.

==== Specs ====

* currently hosted on [[#biloba|biloba]]

==== Services ====

* [[Mail]] services
* mailman (web interface at [http://mailman.csclub.uwaterloo.ca/])
* [[Webmail]]
* [[ceo]] daemon

== ''sodium-benzoate'' ==

Sodium-benzoate is our previous mirror server, funded by MEF.

It is currently sitting in the office pending repurposing. Will likely become a machine for backups in DC.

==== Specs ====

* Intel Xeon Quad Core E5405 @ 2.00 GHz
* 16GB RAM
* vg0: 228 GB block device behind DELL PERC 6/i (contains root partition)

Space disks are currently in the office underneath maltodextrin.

== ''potassium-benzoate'' ==

potassium-benzoate is our mirror server, funded by MEF.

==== Specs ====

* 36 drive Supermicro chassis (SSG-6048R-E1CR36L)
* 1 x Intel Xeon E5-2630 (8 cores, 2.40 GHz)
* 64 GB (4 x 16GB) of DDR4 (2133Mhz) ECC RAM
* 2 x 1 TB Samsung Evo 850 SSD drives
* 17 x 4 TB Western Digital Gold drives (separate funding from MEF)
* 10 Gbps SFP+ card (loaned from CSCF)
* 50 Gbps Mellanox QSFP card (from ginkgo; currently unconnected)

==== Network Connections ====

potassium-benzoate has two connections to our network:

* 1 Gbps to our switch (used for management)
* 2 x 10 Gbps (LACP bond) to mc-rt-3015-mso-a (for mirror)

Mirror's bandwidth is limited to 1 Gbps on each of the 4 campus internet links. Mirror's bandwidth is not limited on campus.

==== Services ====

* [[Mirror]]
* [[Talks]] mirror
* [[Debian_Repository|CSClub packages repository]]

== ''munin'' ==

munin is a syscom-only monitoring and accounting machine. It is a [[Virtualization#Linux_Containers|Linux container]] at present.

==== Specs ====

* currently hosted on [[#xylitol|xylitol]]

==== Services ====

* [http://munin.csclub.uwaterloo.ca munin] systems monitoring daemon

== ''yerba-mate'' ==

A Dell PowerEdge 2950 donated by a CSC member.

==== Specs ====

* 2x 3.00 Hz quad core Intel Xeon 5160
* 32GB RAM
* 2x75GB 15k drives (RAID 1)

==== Services ====

* test-ipv6 (test-ipv6.csclub.uwaterloo.ca; a test-ipv6.com mirror)
* mattermost (under development)
* shibboleth (under development)

Also used for experimenting new CSC services.

= Cloud =

These machines are used by [https://cloud.csclub.uwaterloo.ca cloud.csclub.uwaterloo.ca]. The machines themselves are restricted to Syscom only access.

== ''chamomile'' ==

A Dell PowerEdge R815 provided by CSCF.

==== Specs ====

* 4x 2.20GHz 12-core processors
* 128GB RAM
* 10GbE connection to core router

==== Services ====

* OpenStack primary controller services for csclub.cloud

== ''riboflavin'' ==

A Dell PowerEdge R515 provided by CSCF.

==== Specs ====

* 2x 2.6 GHz 8-core processors
* 64GB RAM
* 10GbE connection to core router
* 2x 500GB internal SSD
* 12x Seagate 4TB SSHD

==== Services ====

* OpenStack block and object storage for csclub.cloud

== ''guayusa'' ==

A Dell PowerEdge 2950 donated by a CSC member.

==== Specs ====

* 2x 3.00 GHz quad core Intel Xeon 5160
* 32GB RAM
* 2TB PCI-Express Flash SSD
* 2x75GB 15k drives (RAID 1)

==== Services ====

Currently being used to set up NextCloud.

Was used to experiment the following then-new CSC services:

* logstash (testing of logstash)
* load-balancer-01
* cifs (for booting ginkgo from CD)
* caffeine-01 (testing of multi-node caffeine)
* block1.cloud
* object1.cloud

== ''ginkgo'' ==

Supermicro server funded by MEF for CSC web hosting. Locate in MC 3015.

==== Specs ====

* 2x Intel Xeon E5-2697 v4 @ 2.30GHz [18 cores each]
* 256GB RAM
* 2 x 1.2 TB SSD (400GB of each for RAID 1)
* 10GbE onboard, 25GbE SFP+ card (also included 50GbE SFP+ card which will probably go in mirror)

==== Services ====

* OpenStack Compute machine

No longer in use:

* controller1.cloud
* db1.cloud
* router1.cloud (NAT for cloud tenant network)
* network1.cloud

== ''biloba'' ==

Supermicro server funded by SLEF for CSC web hosting. Located in DC 3558.

==== Specs ====

* 2x Intel Xeon Gold 6140 @ 2.30GHz [18 cores each]
* 384GB RAM
* 12 3.5" Hot Swap Drive Bays
** 2 x 480 GB SSD
* 10GbE onboard, 10GbE SFP+ card (on loan from CSCF)

==== Services ====

* OpenStack Compute machine

No longer in use:

* caffeine
* mail
* mattermost

= Storage =

== ''fs00'' ==

fs00 is a NetApp FAS3040 series fileserver donated by CSCF.

It is currently being used for testing of a HA NetApp nodes and serving home directories directly from the NetApp filer.

==== Specs ====

== ''fs01'' ==

fs01 is a NetApp FAS3040 series fileserver donated by CSCF.

It is currently being used for testing of a HA NetApp nodes and serving home directories directly from the NetApp filer.

==== Specs ====

= Other =

==''binaerpilot''==

This is a Gumstix Overo Tide CPU on a Tobi expansion board. It is currently attached to corn-syrup in the machine room and even more currently turned off until someone can figure out what is wrong with it.

==== Specs ====

* TI OMAP 3530 750Mhz (ARM Cortex-A8)
* 512MB RAM

== ''anamanaguchi'' ==

This is a Gumstix Overo Tide CPU on a Chestnut43 expansion board. It is currently in the hardware drawer in the CSC.

==== Specs ====

* TI OMAP 3530 750Mhz (ARM Cortex-A8)
* 512MB RAM

== ''digital cutter'' ==

See [[Digital Cutter|here]].

== ''mathnews'' ==

[[#xylitol|xylitol]] hosts a systemd-nspawn container which serves as the mathNEWS webserver. It is administered by mathNEWS, as a pilot for providing containers to select groups who have more specialized demands than the general-use infrastructure can meet.

= Decommissioned =

== ''aspartame'' ==

aspartame was a taurine clone donated by CSCF. It was once our primary file server, serving as the gateway interface to space on phlogiston. It also used to host the [[#auth1|auth1]] container, which has been temporarily moved to [[#dextrose|dextrose]]. Decomissioned in March 2021 after refusing to boot following a power outage.

== ''psilodump'' ==

psilodump is a NetApp FAS3000 series fileserver donated by CSCF. It, along with its sibling phlogiston, hosted disk shelves exported as iSCSI block devices.

psilodump was plugged into aspartame. It's still installed but inaccessible.

== ''phlogiston'' ==

phlogiston is a NetApp FAS3000 series fileserver donated by CSCF. It, along with its sibling psilodump, hosted disk shelves exported as iSCSI block devices.

phlogiston is turned off and should remain that way. It is misconfigured to have its drives overlap with those owned by psilodump, and if it is turned on, it will likely cause irreparable data loss.

==== Specs ====

* 2 AMD Opteron 2218 CPUs
* 10GB RAM

==== Notes from before decommissioning ====

* The lxc files are still present and should not be started up, or else the two copies of auth1 will collide.
* It currently cannot route the 10.0.0.0/8 block to a misconfiguration on the NetApp. This should be fixed at some point.

== ''glomag'' ==

Glomag hosted [[#caffeine|caffeine]]. Decommissioned April 6, 2018.

==== Specs ====

* Intel Xeon X3450 @ 2.67 GHz
* 6 GB RAM
* vg0: 465 GB software RAID1 (contains root partition):
** 750 GB Seagate Barracuda SATA hard drive
** 500 GB Western-Digital Caviar Blue SATA hard drive
* vg1: 596 GB software RAID1 (contains caffeine):
** 2 × 640 GB Western-Digital Caviar Blue SATA hard drive

==== Services ====

* Before its decommissioning, glomag hosted [[#caffeine|caffeine]], [[#mail|mail]], and [[#munin|munin]] as [[Virtualization#Linux_Container|Linux containers]]

== ''Lisp machine'' ==

A Symbolics XL1200 Lisp machine. Donated to a new home when we couldn't get it working.

http://www.globalnerdy.com/2008/12/03/symbolics-xl1200-lisp-machine-free-to-a-good-home/ for some history on this hardware.

==== Specs ====

Currently inoperable due to (at least) a missing console cable.

== ''ginseng'' ==

Ginseng used to be our fileserver, before aspartame and the netapp took over.

==== Specs ====

* Intel Pentium Dual Core E2180
* 8GB RAM
* [http://csclub.uwaterloo.ca/misc/manuals/s3000ah_tps_1_1.pdf Intel S3000AHV Motherboard]
* 4 × 640 GB Western-Digital Caviar Blue in [http://en.wikipedia.org/wiki/Nested_RAID_levels#RAID_10_.28RAID_1.2B0.29 RAID 10] behind a [http://www.3ware.com/products/serial_ata2-9650.asp 3ware 9650SE RAID card].
[[Category:Hardware]]

== ''calum'' ==

Calum used to be our main server and was named after Calum T Dalek. Purchased new by the club in 1994.

==== Specs ====

* SPARCserver 10 (headless SPARCstation 10)

== ''paza'' ==

An iMac G3 that was used as a dumb terminal.

==== Specs ====

* 233Mhz PowerPC 740/750
* 96 MB RAM

== ''romana'' ==

Romana was a BeBox that has been in the CSC's possession since long before BeOS became defunct.

Confirmed on March 19th, 2016 to be fully functional. An SSHv1 compatible client was installed from http://www.abstrakt.ch/be/ and a compatible firewalled daemon was started on Sucrose (living in /root, prefix is /root/ssh-romana). The insecure daemon is to be used a bastion host to jump to hosts only supporting >=SSHv2. The mail daemon on the BeBox has also been configured to send mail through mail.csclub.uwaterloo.ca.

==== Specs ====

* 2 PowerPC based processors
* Stylish Blinken processor-load lights

== ''sodium-citrate'' ==

Sodium-citrate was an SGI O2 machine.

In order to net boot you need to set /proc/sys/net/ipv4/ip_no_pmtu_disc to 1. When the O2 boots, hit F5 at the boot menu and type bootp():.

==== Specs ====
* SGI O2 MIPS processor
* 423 MB (?) RAM
* 2 × 2 GB hard drive

== ''acesulfame-potassium'' ==

An old office terminal.

==== Specs ====
* Intel Pentium 4 2.67GHz
* 1GB RAM
* [http://csclub.uwaterloo.ca/misc/manuals/ABIT_VT7.pdf ABIT VT7] Motherboard
* ATI Radeon 7000

== ''skynet'' ==

skynet was a Sun E6500 machine donated by Sanjay Singh. It was never fully set up.

==== Specs ====

* 15 full CPU/memory boards
** 2x UltraSPARC II 464MHz / 8MB Cache Processors
** ??? RAM?
* 1 I/O board (type=???)
** ???x disks?
* 1 CD-ROM drive

* [http://mirror.csclub.uwaterloo.ca/csclub/sun_e6500/ent6k.srvr/ e6500 documentation (hosted on mirror, currently dead link)]
* [http://docs.oracle.com/cd/E19095-01/ent6k.srvr/ e6500 documentation (backup link)]
* [http://www.e6500.com/ e6500]

== ''freebsd'' ==

FreeBSD was a virtual machine with FreeBSD installed.

==== Services ====

* Newer software

== ''rainbowdragoneyes'' ==

Rainbowdragoneyes was our Lemote Fuloong MIPS machine. This machine is aliased to rde.csclub.uwaterloo.ca.

==== Specs ====

* 800MHz MIPS Loongson 2f CPU

== ''denardo'' ==

Due to some instability, general uselessness, and the acquisition of a more powerful SPARC machine from MFCF, denardo was decommissioned in February 2015.

==== Specs ====

* Sun Fire V210
* TI UltraSparc IIIi (Jalapeño)
* 2 GB RAM
* 160 GB RAID array
* ALOM on denardo-alom.csclub can be used to power machine on/off

== ''artificial-flavours'' ==

Artificial-flavours was our secondary (backup services) server. It used to be an office terminal. It was decommissioned in February 2015 and transferred to the ownership of Women in Computer Science (WiCS).

==== Specs ====

* Intel Celeron 3.2GHz
* 2GB RAM
* [http://csclub.uwaterloo.ca/misc/manuals/Biostar_P4M80-M4.pdf Biostar P4M80-M4] Motherboard
* Western-Digital 80 GB ATA hard drive

== ''potassium-citrate'' ==

Potassium-citrate is a dual-processor Alpha machine. It is on extended loan from pbarfuss.

It is temporarily decommissioned pending the reinstallation of a supported operating system (such as OpenBSD).

==== Specs ====
* Alphaserver CS20 (2 833MHz EV68al CPUs)
* 512MB RAM
* 36 GB Seagate SCSI hard drive

== ''potassium-nitrate'' ==

This was a Sun Fire E2900 from a decommissioned MFCF compute cluster. It had a SPARC architecture and ran OpenBSD, unlike many of our other systems which are x86/x86-64 and Linux/Debian. After multiple unsuccessful attempts to boot a modern Linux kernel and possible hardware instability, it was determined to be non-cost-effective and non-effort-effective to put more work into running this machine. The system was reclaimed by MFCF where someone from CS had better luck running a suitable operating system (probably Solaris).

The name is from saltpetre, because sparks.

==== Specs ====

* 24 CPUs
* 90GB main memory
* 400GB scratch disk local storage in /scratch-potassium-nitrate

There is a [[Sun 2900 Strategy Guide|setup guide]] available for this machine.

See also [[Sun 2900]].

== ''taurine'' ==

'''Note: On August 21, 2019, just before 2:30PM EDT, we were informed that taurine caught fire'''. As a result, taurine has been decommissioned as of Fall 2019.

==== Specs ====

* 2 AMD Opteron 2218 CPUs
* 8GB RAM
* 136 GB LVM volume group

==== Services ====

* Virtual machines
* BitlBee IRC instant messaging gateway (localhost only)
* [[ident]] server to maintain high connection cap to freenode
* Runs ssh on ports 21,22,53,80,81,443,8000,8080 for user's convenience.

== ''dextrose'' ==

dextrose was a [[#taurine|taurine]] clone donated by CSCF and was decommissioned in Fall 2019 after being replaced with a more powerful server.

== ''sucrose'' ==

sucrose was a [[#taurine|taurine]] clone donated by CSCF. It was decommissioned in Fall 2019 following multiple hardware failures.

== ''goto80'' ==
'''Note (2022-10-25): This seems to have gone missing or otherwise left our hands.'''

This was small ARM machine we picked up in order to have similar hardware to the Real Time Operating Systems (CS 452) course. It has a [[TS-7800_JTAG|JTAG]] interface. Located was the office on the top shelf above strombola.

==== Specs ====

* 500 MHz Feroceon (ARM926ej-s compatible) processor
* ARMv5TEJ architecture

Use -march=armv5te -mtune=arm926ej-s options to GCC.

For information on the TS-7800's hardware see here:
http://www.embeddedarm.com/products/board-detail.php?product=ts-7800

= UPS =

All of the machines in the MC 3015 machine room are connected to one of our UPSs.

All of our UPSs can be monitored via CSCF:

* MC3015-UPS-B2
* mc-3015-e7-ups-1.cs.uwaterloo.ca (rbc55, batteries replaced July 2014) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-e7-ups-1&var-Interval=30m)
* mc-3015-f7-ups-1.cs.uwaterloo.ca (rbc55, batteries replaced Feb 2017) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-f7-ups-1&var-Interval=30m)
* mc-3015-g7-ups-1.cs.uwaterloo.ca (su5000t, batteries replaced 2010) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-g7-ups-1&var-Interval=30m)
* mc-3015-g7-ups-2.cs.uwaterloo.ca (unknown) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-g7-ups-2&var-Interval=30m)
* mc-3015-h7-ups-1.cs.uwaterloo.ca (su5000t, batteries replaced 2004) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-h7-ups-1&var-Interval=30m)
* mc-3015-h7-ups-2.cs.uwaterloo.ca (unknown) (https://metrics.cscf.uwaterloo.ca/grafana/dashboard/db/ups-statistics?orgId=1&var-UPS=mc-3015-h7-ups-2&var-Interval=30m)

We will receive email alerts for any issues with the UPS. Their status can be monitored via [[SNMP]].

TODO: Fix labels & verify info is correct & figure out why we can't talk to cacti.

Music

2022-10-25T22:36:18Z

Joss: Added syscom info :)

Music is run off <code>nullsleep</code>, since that's the computer with the speakers attached.

All music files are in <code>/music</code>. You may or may not be required to be a member of the audio group to actually play tracks

View recently listened tracks: http://www.last.fm/user/csclub

== How to play music ==

# Run <code>ssh nullsleep</code> from an office terminal.
# Run <code>ncmpcpp</code>
# That's it!

== Controls ==
To view the keybindings of ncmpcpp, press F1 while it's running.
The number keys switch between tabs in it.

* 1 is current playlist
* 2 is browsing files
* 3 is search
* 4 is browsing the media library
* 5 is browsing saved playlists, etc.

== Syscom Info ==

* We require https://github.com/hrkfdn/mpdas to get scrobbling working as it "official" last.fm integration was removed from mpd in 2013.
** n.b. https://github.com/hrkfdn/mpdas/issues/58
* To control the mixer on other terminals, use <code>PULSE_SERVER=nullsleep pavucontrol</code>
* The official last.fm account credentials are stored in the exec password spot :)

Main Page

2022-10-19T19:59:24Z

Joss: Adds CSS

This is the Wiki of the [[Computer Science Club]]. Feel free to start adding pages and information.

[[Special:AllPages]]

== Guides ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[ New Member Guide]]
* [[Budget Guide]]
* [[Club Hosting]]
* [[Web Hosting]]
* [[Git Hosting]]
* [[Exec Manual]]
* [[Sysadmin Guide]]
* [[Imapd Guide]]
* [[MEF Guide]]
* [[Office Policies]]
* [[Office Staff]]
* [[How to IRC]]
* [[How to SSH]]
* [[Talks Guide]]
* [[SCS Guide]]
* [[Kerberos | Password Reset ]]
* [[Disk Drive RMA Process]]
* [[ IPMI101 ]]
* [[Keys and Fobs]]
* [[ZNC]]
* [[BigBlueButton]]
* [https://docs.cloud.csclub.uwaterloo.ca/ CSC Cloud Documentation]
</div>

== News and Events ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[Meetings]]
* [[Talks]]
* [[Projects]]
* [[Industry Opportunities]]
</div>

== Machine/System Documentation ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[ADFS]]
* [[Application List]]
* [[Authentication]]
* [[Backups]]
* [[ceo]]
* [[Ceph]]
* [[Cloud Networking]]
* [[CloudStack]]
* [[CloudStack Templates]]
* [[DNS]]
* [[Debian Repository]]
* [[Digital Cutter]]
* [[Directory Services]]
* [[Electronics]]
* [[Firewall]]
* [[Hardware]]
* [[Kerberos]]
* [[Keycloak]]
* [[Kubernetes]]
* [[KVM]]
* [[LDAP]]
* [[Machine List]]
* [[Mail]]
* [[Mailing Lists]]
* [[Mirror]]
* [[Music]]
* [[MySQL]]
* [[NetApp]]
* [[New NetApp]]
* [[Network]]
* [[New CSC Machine]]
* [[Nextcloud]]
* [[NFS/Kerberos]]
* [[Observability]]
* [[OID Assignment]]
* [[Podman]]
* [[Printing]]
* [[Pulseaudio]]
* [[Scratch]]
* [[SNMP]]
* [[Serial Connections]]
* [[SSL]]
* [[Switches]]
* [[Syscom Todo]]
* [[Systemd-nspawn]]
* [[Systems Committee]]
* [[Two-Factor Authentication]]
* [[UID/GID Assignment]]
* [[Webmail]]
* [[Virtualization (LXC Containers)]]
</div>

== Miscellaneous ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[Budget]]
* [[Executive]]
* [[Past Executive]]
* [[Frosh]]
* [[History]]
* [[Library]]
* [[MEF Proposals]]
* [[Term Notes]]
* [[Proposed Constitution Changes]]
</div>

== Historical or Obsolete Pages ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[Robot Arm]]
* [[Webcams]]
* [[Website]]
__NOTOC__

Main Page

2022-10-19T19:58:59Z

Joss:

This is the Wiki of the [[Computer Science Club]]. Feel free to start adding pages and information.

[[Special:AllPages]]

== Guides ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[ New Member Guide]]
* [[Budget Guide]]
* [[Club Hosting]]
* [[Web Hosting]]
* [[Git Hosting]]
* [[Exec Manual]]
* [[Sysadmin Guide]]
* [[Imapd Guide]]
* [[MEF Guide]]
* [[Office Policies]]
* [[Office Staff]]
* [[How to IRC]]
* [[How to SSH]]
* [[Talks Guide]]
* [[SCS Guide]]
* [[Kerberos | Password Reset ]]
* [[Disk Drive RMA Process]]
* [[ IPMI101 ]]
* [[Keys and Fobs]]
* [[ZNC]]
* [[BigBlueButton]]
* [https://docs.cloud.csclub.uwaterloo.ca/ CSC Cloud Documentation]
</div>

== News and Events ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[Meetings]]
* [[Talks]]
* [[Projects]]
* [[Industry Opportunities]]
</div>

== Machine/System Documentation ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[ADFS]]
* [[Application List]]
* [[Authentication]]
* [[Backups]]
* [[ceo]]
* [[Ceph]]
* [[Cloud Networking]]
* [[CloudStack]]
* [[CloudStack Templates]]
* [[DNS]]
* [[Debian Repository]]
* [[Digital Cutter]]
* [[Directory Services]]
* [[Electronics]]
* [[Firewall]]
* [[Hardware]]
* [[Kerberos]]
* [[Keycloak]]
* [[Kubernetes]]
* [[KVM]]
* [[LDAP]]
* [[Machine List]]
* [[Mail]]
* [[Mailing Lists]]
* [[Mirror]]
* [[Music]]
* [[MySQL]]
* [[NetApp]]
* [[New NetApp]]
* [[Network]]
* [[New CSC Machine]]
* [[Nextcloud]]
* [[NFS/Kerberos]]
* [[Observability]]
* [[OID Assignment]]
* [[Podman]]
* [[Printing]]
* [[Pulseaudio]]
* [[Scratch]]
* [[SNMP]]
* [[Serial Connections]]
* [[SSL]]
* [[Switches]]
* [[Syscom Todo]]
* [[Systemd-nspawn]]
* [[Systems Committee]]
* [[Two-Factor Authentication]]
* [[UID/GID Assignment]]
* [[Webmail]]
* [[Virtualization (LXC Containers)]]
</div>

== Miscellaneous ==
<div style="-webkit-column-count:3; -moz-column-count:3; column-count:3;">
* [[Budget]]
* [[Executive]]
* [[Past Executive]]
* [[Frosh]]
* [[History]]
* [[Library]]
* [[MEF Proposals]]
* [[Term Notes]]
* [[Proposed Constitution Changes]]
</div>

== Historical or Obsolete Pages ==

* [[Robot Arm]]
* [[Webcams]]
* [[Website]]
__NOTOC__

Website

2022-10-19T19:54:26Z

Joss:

'''''<big>NOTE: THIS IS FOR THE OLD WEBSITE, THE NEW ONE IS HOSTED AT https://git.csclub.uwaterloo.ca/www/www-new</big>'''''

== Dependencies ==

You'll need to install a few dependencies to build the website; the following command will install all dependencies if you're using a Debian-based system:

sudo aptitude install python python-libxslt1 python-libxml2 python-tz git-core python-ldap

== Checking out the website ==

The website is managed in a [http://git.csclub.uwaterloo.ca/?p=www/www.git git repository].

Any member can checkout the website using git clone:
git clone /users/www/www

This creates a directory called "www" that contains the entire website and its history. If you want to make changes to the website, you'll need to ask someone on the [[Systems Committee]] to add you to the "www" group. You should also subscribe to our [http://csclub.uwaterloo.ca/mailman/listinfo/git git mailing list].

== Testing your changes ==

You should test any changes you make before pushing them out for all the world to see. The easiest way to see your changes without committing them is to create a symlink into your public "www/build" directory. For example, say your local copy of the website lives in "/users/$USER/csc/www". You could symlink "/users/$USER/csc/www/build" to "/users/$USER/www/csc". Do this by typing:

ln -s /users/$USER/csc/www/build /users/$USER/www/csc

Type make in the directory. Now you can see your copy of the website at this URL:

http://csclub.uwaterloo.ca/~USERNAME/csc/

= Committing changes to the website =

If you add a new file to the website, you can add it to git:
git add file

To delete a file type:
git rm file

And to rename or move a file type:
git mv old-file new-file

Once you're done modifying the website you can commit your changes:
git commit -a

The above command only commits the change to your local repository; you need to push the changes out to the master repository:
git push

The above command will also automatically rebuild the website and send out an email to the git mailing list with the details of your change, as long as you are on caffeine when you push.

= Building the website =

Once you've checked out the website, you can build the website by running:
make

This will build the website into the build directory. When git-pushing, the website will be built into /srv/www-csc.

You can remove the generated files by running:
make clean

= Modifying the website =

== XML ==

The website's data is contained in a series of XML files. A series of XSLT files are used to transform the XML data into HTML files. If you want to add new information to the website you'll want to modify the XML files.

Some notable XML files:
* events.xml - past and upcoming events
* news.xml - past and upcoming items
* media/index.xml - media items (e.g. talks)

XML should be fairly easy to work with. Some important things to remember:
* All opening tags must be closed.
* All tags should be in lowercase.
* Tag and attribute names are case-sensitive.

If you want more information on XML, the following are good resources:
* The XML specification: http://www.w3.org/TR/2006/REC-xml-20060816/
* XML tutorials and general reference: http://www.w3schools.com/xml/default.asp

== XSLT ==

If you want to change the HTML layout you'll want to modify the XSLT files. Almost all XSLT files are located in the 'xsl' directory. We are using XSLT 1.0 and a python front-end (xmlproc.py) to libxslt.

== CSS ==

If you want to change the style of the HTML you'll want to modify default.css. We primarily target Firefox 2.0 but every effort should be made to use CSS that renders correctly in Internet Explorer 6.0 and other browsers. You can test various Internet Explorer versions from Linux by installing [http://www.tatanka.com.br/ ies4linux]. There's also [http://browsershots.org/ browsershots.org], which will take screenshots of a page in various browsers.

== Data files ==

Data files, such as PDF's, should be copied to /srv/www-csc-misc. These files are accessible via http://csclub.uwaterloo.ca/misc/.

== Media ==

To change media files, you need to update the /media/index.xml file. The format of new entries should be fairly self evident based on the pre-existing entries.

Once you have a bunch of MTS data from a talk, you need to run it through the scripts in ~git/public/csc-media to compress it and generate thumbnails (check them out, and read the readme). The scripts generate a fairly large amount of output. If you happen to be near the member quota you will want to create symlinks for encodes and timings into /scratch.

The scripts should get run on a beefy machine (ie, high-fructose-corn-syrup).

Once the video files have been encoded, the encoded files need to get uploaded to mirror. The website automagically links the <*file /> tags to "mirror.csclub.../csclub/TALK_FILE". Contact syscom to do this.

= Website vs Wiki =

In order to keep things organized, the following guidelines should be followed.

Website:
* Information not likely to change frequently (e.g. services, general information)
* Information that should only be modifiable by the exec
* Official documents (e.g. constitution, policies)
* Current and past executive
* User and club lists
* News, events, and media items
* Anything we want non-members to see when they first encounter our site

Wiki:
* Information that changes frequently
* Information that any club member should be able to add to or modify
* Exec and office staff guides/manuals
* System and hardware documentation
* Past funding opportunities and advice (assuming this can be publicly posted)
* Contacts (e.g. CSCF, SCS) (assuming this can be publicly posted)

Also note that we can protect various pages if they shouldn't be edited in general.

= Conventions =

== Email Addresses ==

'''Note''': this convention is not currently used and is not recommended for now.

Email addresses should be wrapped in <email> tags. For example, if you want to include the email example@csclub.uwaterloo.ca you should include the following xml snippet:
<email>example@csclub.uwaterloo.ca</email>
Leading and trailing whitespace will be stripped so it is safe to do this:
<email>
example@csclub.uwaterloo.ca
</email>
Currently this just generates an standard mailto link. In order to prevent spammers from harvesting address, I want to generate an image that contains the address.

My current plan is to generate the email images while running make. This would be accomplished by creating a csc:email function that generates and saves the image to http://csclub.uwaterloo.ca/images/. The image name would be generated from HMAC(email, key), where key is some secret key/phrase.

= Feature Requests and Ideas =

* Possibly move club list onto wiki.
* Convert cellspacing and cellpadding to CSS equivalents.
* Make RSS and ICS feeds more prominent.
* Replace or compliment /events with a web-based calendar?
* Replace all email addresses with generated graphics or javascript obfuscation?
* Replace <br>'s with <p>'s wherever it makes sense.
* Replace <strong>, <b>, <i>, etc... tags with CSS.
* Highlight (e.g. make left bar green) current page in directory header

[[Category:Software]]
[[Category:Guides]]
[[Category:Policy]]
[[Category:Projects]]

Website

2022-10-19T19:53:58Z

Joss:

= '''''<big>NOTE: THIS IS FOR THE OLD WEBSITE, THE NEW ONE IS HOSTED AT <nowiki>https://git.csclub.uwaterloo.ca/www/www-new</nowiki></big>''''' =

== Dependencies ==

You'll need to install a few dependencies to build the website; the following command will install all dependencies if you're using a Debian-based system:

sudo aptitude install python python-libxslt1 python-libxml2 python-tz git-core python-ldap

== Checking out the website ==

The website is managed in a [http://git.csclub.uwaterloo.ca/?p=www/www.git git repository].

Any member can checkout the website using git clone:
git clone /users/www/www

This creates a directory called "www" that contains the entire website and its history. If you want to make changes to the website, you'll need to ask someone on the [[Systems Committee]] to add you to the "www" group. You should also subscribe to our [http://csclub.uwaterloo.ca/mailman/listinfo/git git mailing list].

== Testing your changes ==

You should test any changes you make before pushing them out for all the world to see. The easiest way to see your changes without committing them is to create a symlink into your public "www/build" directory. For example, say your local copy of the website lives in "/users/$USER/csc/www". You could symlink "/users/$USER/csc/www/build" to "/users/$USER/www/csc". Do this by typing:

ln -s /users/$USER/csc/www/build /users/$USER/www/csc

Type make in the directory. Now you can see your copy of the website at this URL:

http://csclub.uwaterloo.ca/~USERNAME/csc/

= Committing changes to the website =

If you add a new file to the website, you can add it to git:
git add file

To delete a file type:
git rm file

And to rename or move a file type:
git mv old-file new-file

Once you're done modifying the website you can commit your changes:
git commit -a

The above command only commits the change to your local repository; you need to push the changes out to the master repository:
git push

The above command will also automatically rebuild the website and send out an email to the git mailing list with the details of your change, as long as you are on caffeine when you push.

= Building the website =

Once you've checked out the website, you can build the website by running:
make

This will build the website into the build directory. When git-pushing, the website will be built into /srv/www-csc.

You can remove the generated files by running:
make clean

= Modifying the website =

== XML ==

The website's data is contained in a series of XML files. A series of XSLT files are used to transform the XML data into HTML files. If you want to add new information to the website you'll want to modify the XML files.

Some notable XML files:
* events.xml - past and upcoming events
* news.xml - past and upcoming items
* media/index.xml - media items (e.g. talks)

XML should be fairly easy to work with. Some important things to remember:
* All opening tags must be closed.
* All tags should be in lowercase.
* Tag and attribute names are case-sensitive.

If you want more information on XML, the following are good resources:
* The XML specification: http://www.w3.org/TR/2006/REC-xml-20060816/
* XML tutorials and general reference: http://www.w3schools.com/xml/default.asp

== XSLT ==

If you want to change the HTML layout you'll want to modify the XSLT files. Almost all XSLT files are located in the 'xsl' directory. We are using XSLT 1.0 and a python front-end (xmlproc.py) to libxslt.

== CSS ==

If you want to change the style of the HTML you'll want to modify default.css. We primarily target Firefox 2.0 but every effort should be made to use CSS that renders correctly in Internet Explorer 6.0 and other browsers. You can test various Internet Explorer versions from Linux by installing [http://www.tatanka.com.br/ ies4linux]. There's also [http://browsershots.org/ browsershots.org], which will take screenshots of a page in various browsers.

== Data files ==

Data files, such as PDF's, should be copied to /srv/www-csc-misc. These files are accessible via http://csclub.uwaterloo.ca/misc/.

== Media ==

To change media files, you need to update the /media/index.xml file. The format of new entries should be fairly self evident based on the pre-existing entries.

Once you have a bunch of MTS data from a talk, you need to run it through the scripts in ~git/public/csc-media to compress it and generate thumbnails (check them out, and read the readme). The scripts generate a fairly large amount of output. If you happen to be near the member quota you will want to create symlinks for encodes and timings into /scratch.

The scripts should get run on a beefy machine (ie, high-fructose-corn-syrup).

Once the video files have been encoded, the encoded files need to get uploaded to mirror. The website automagically links the <*file /> tags to "mirror.csclub.../csclub/TALK_FILE". Contact syscom to do this.

= Website vs Wiki =

In order to keep things organized, the following guidelines should be followed.

Website:
* Information not likely to change frequently (e.g. services, general information)
* Information that should only be modifiable by the exec
* Official documents (e.g. constitution, policies)
* Current and past executive
* User and club lists
* News, events, and media items
* Anything we want non-members to see when they first encounter our site

Wiki:
* Information that changes frequently
* Information that any club member should be able to add to or modify
* Exec and office staff guides/manuals
* System and hardware documentation
* Past funding opportunities and advice (assuming this can be publicly posted)
* Contacts (e.g. CSCF, SCS) (assuming this can be publicly posted)

Also note that we can protect various pages if they shouldn't be edited in general.

= Conventions =

== Email Addresses ==

'''Note''': this convention is not currently used and is not recommended for now.

Email addresses should be wrapped in <email> tags. For example, if you want to include the email example@csclub.uwaterloo.ca you should include the following xml snippet:
<email>example@csclub.uwaterloo.ca</email>
Leading and trailing whitespace will be stripped so it is safe to do this:
<email>
example@csclub.uwaterloo.ca
</email>
Currently this just generates an standard mailto link. In order to prevent spammers from harvesting address, I want to generate an image that contains the address.

My current plan is to generate the email images while running make. This would be accomplished by creating a csc:email function that generates and saves the image to http://csclub.uwaterloo.ca/images/. The image name would be generated from HMAC(email, key), where key is some secret key/phrase.

= Feature Requests and Ideas =

* Possibly move club list onto wiki.
* Convert cellspacing and cellpadding to CSS equivalents.
* Make RSS and ICS feeds more prominent.
* Replace or compliment /events with a web-based calendar?
* Replace all email addresses with generated graphics or javascript obfuscation?
* Replace <br>'s with <p>'s wherever it makes sense.
* Replace <strong>, <b>, <i>, etc... tags with CSS.
* Highlight (e.g. make left bar green) current page in directory header

[[Category:Software]]
[[Category:Guides]]
[[Category:Policy]]
[[Category:Projects]]

User:Joss

2022-10-19T17:13:18Z

Joss: added me :)

I am John, watid joss

F22: Librarian

Robot Arm

2022-10-19T17:12:15Z

Joss: Note that the arm is long gone

=== (2022-10-17): This arm is long gone ===

= Software =

The robot arm was purchased with the intent of being used to create a mechanical turk.
The code going towards this goal lives in ~ssalbiz/arm, use "git clone ~ssalbiz/arm" to make a copy.

= Hardware =
The arm is a [http://www.lynxmotion.com/c-130-al5d.aspx Lynxmotion AL5D].

= Operation =
Currently the arm is controlled by interfacing directly with /dev/ttySx or /dev/ttyUSBx . The syntax for controlling this is by sending the following string to the board:
<pre>
#<servo id> P<position> S<speed> T<time>
</pre>

You can control multiple servos with one command
<pre>
#<servo id> P<position> S<speed> #<servo id> P<position> S<speed> T<time>
</pre>

S and T are optional parameters

Key:
* <servo id> - id of the servo being controlled (includes jaw)
* <position> - servo rotation position, generally between (500,2500)
* <speed> - speed of rotation; 100 means 10s to rorate 90°; leaving this off generates fast movement, 400 seems like a "safe" value?
* <time> - time it takes to complete the motion in ms; specified once for the entire motion

if both speed(s) and time are specified, time is a "minimum" and speed is a "maximum", i.e. the motion will take at minimum T milliseconds, but servoA will move no faster than speed SA

== Servo key and degree of motion ==
* 0 - Base
* 1 - Shoulder
* 2 - Elbow
* 3 - Wrist
* 4 - Grip
* 5 - Wrist Rotate

= Purpose =
The current purpose of the robot arm is to make an entity that can play chess against a human.

==Status==
Not being worked on. Need to complete the following:

* Complete physical modifications to robot arm to allow it to reach all pieces on the board
* Calibrate arm base mount against chess board squares
* Make the robot arm code talk to a chess program
* Make the chess program talk to the chess vision code
* Make the arm not have terrible things happen when the servos heat up

= External Links =
* a manual [http://www.lynxmotion.com/images/data/rios106h.pdf]
* j3parker's [http://csclub.uwaterloo.ca/~j3parker/arm.png 3D model of the arm]

Music

2022-10-19T17:04:44Z

Joss: Re-format and add newer command

Music is run off nullsleep, since that's the computer with the speakers attached.

All music files are in <code>/music</code>. You may or may not be required to be a member of the audio group to actually play tracks

<s>View recently listened tracks: http://www.last.fm/user/csclub</s> (2022-10-19): this hasn't been set back up since nullsleep went on hiatus, should eventually re-add.

== How to play music ==

# Run <code>ssh nullsleep</code> from an office terminal.
# Run <code>ncmpcpp</code>
# That's it!

== Controls ==
To view the keybindings of ncmpcpp, press F1 while it's running.
The number keys switch between tabs in it.

* 1 is current playlist
* 2 is browsing files
* 3 is search
* 4 is browsing the media library
* 5 is browsing saved playlists, etc.

New Member Guide

2022-10-19T16:13:40Z

Joss: Mentions how to take out a book.

Hello, and welcome to the Computer Science Club! Thanks for joining. The office staff who signed you up should have told you about this stuff, but just as a refresher, here it is again.

== Office ==

<b>Note: The CSC office is temporarily closed for the pandemic. We are looking into opening it next term (W22).</b>

* Our office is MC 3036/3037 (we occupy both rooms) and we're across the hall (but distinct from) the Mathsoc office.

* Our club doesn't have weekly meetings or anything like that. If the door is open, we are open (even if it's 3 in the morning on Sunday). Feel free to drop in and say hi!

* The office closes when the last office staff leaves the room, and the office opens when somebody with a key comes by. If you're interested in becoming office staff, look out for the termly office staff training event or ask around the office.

* We have staplers by the door farthest from Mathsoc. Even if you're not a member, you're allowed to use them. You don't even have to ask (and in fact, we'd prefer if you didn't. Office regulars spend a good amount of time telling people that yes, they can use the staplers).

* We sell pop, chips, chocolate bars and other snacks. Prices are on the fridge door. Pay the red cup in the fridge.

== Events ==
We hold a different set of events every term, but the same types of events come up again and again. Watch out for emails about:
* Industry tech talks. In the past, we've gotten folks from various tech companies to talk about algorithms, database design decisions and other things.

* UNIX 10X tutorials. Don't know how to use the commandline? Come out and learn with us. Know how to use the commandline? Come out and help us answer questions.

* Member talks. Do you have a burning desire to talk about AVL trees? No? Well, if you want to talk about a computer sciencey topic that's close to your heart, send an email to exec at csclub.uwaterloo.ca with a talk abstract (a paragraph we can put on a poster to describe your talk) and we'll see if we can make something happen.

* Code parties. We eat food, talk and write code. Code parties happen several times a term.

== Machines ==
As a member of the club, you have access to our machines, both [[Machine_List#Servers|servers in the machine room down the hall]] and [[Machine_List#Office Terminals|desktops in our physical office]]. Keep in mind that your username is your quest userid (e.g. ctdalek) and your password starts out as the one you set when you joined the club for the first time. If you registered your account virtually, your password will have been emailed to you when you signed up. If this is the case, you will be prompted to change your password when you first login to any machine. You can also email syscom at any time to reset your password, if you've forgotten it or don't have the password email.

* As a member you must abide by the [https://csclub.uwaterloo.ca/services/machine_usage machine usage policy].

* Your files are accessible on all of our machines

* Keep in mind that the machines are shared among all of our members. Play nice. For example, <nowiki>caffeine</nowiki> is our web server. You are strongly advised not to run long, intensive jobs on it. Something like that is a better fit for <nowiki>hfcs</nowiki>, <nowiki>corn-syrup</nowiki>.

* use SSH for access to the machines in the server room.
** If you don't know how to use the commandline, you can wait for our approximately termly UNIX 101 event, google for "how to use the command line", or ask around the office.
** On all major operating systems except iOS (find Termius on the App Store) and Android (find Termux on FDroid), you already have the <nowiki>ssh</nowiki> command installed. If your userid is <nowiki>ctdalek</nowiki> and you want to use <nowiki>HFCS</nowiki>, just open up a terminal window (CMD on Windows) and type the following:

ssh ctdalek@hfcs.csclub.uwaterloo.ca

You will be asked for your CSC password and be prompted to go through DUO 2FA. If it is your first time logging in, you will be prompted to change your password. To avoid having to go through DUO, you can add an SSH key instead.

* Our office terminals are turned off, rebooted and otherwise reset somewhat frequently.

* If you forget your password, come by the office with your Watcard and some other form of ID. Regular office staff can't reset your password for you, but if there's someone on our Systems Committee hanging around, they can do this for you.

* If you would like to change your password, log on to any of our machines and type <nowiki>kpasswd</nowiki> in a terminal. You will be prompted for your old password and be asked to type in your new password twice (just to make sure you didn't make a typo).

* We have a MySQL daemon running, but only on our web server <nowiki>caffeine</nowiki>. Check out [[MySQL|this page]] if you would like a database.

* for technical questions (including package installation requests), send an email to our systems committee, syscom at csclub.uwaterloo.ca.

== Web Hosting ==
You get web space with your CSC membership. Your website is visible at [http://csclub.uwaterloo.ca/~ctdalek] (where ctdalek is replaced with your own userid, of course).

See [[Web Hosting]] for more information.

== IRC ==
We have an IRC (internet relay chat) channel. Come hang out with us in #csc on libera.chat. If you are unfamiliar with IRC, you may want to read [[How to IRC|this guide]].

== Mail ==
* see the [[Mail]] page.
* The CSC gets a lot of requests to distribute [[Industry Opportunities]] to our members. We have a special opt-in mailing list for the people that want to hear about such things.
* We have a low-volume general mailing list which we use to send out information about upcoming events.

== Library ==
There are books on the shelves lining the office. Feel free to drop by and read them.

You can borrow ones that don't have a sticker on them. There's no hard limit for how long at the moment, just make sure to give them back.

Only someone on <code>libcom</code> can check out books for people, so ask around the office if one of them is around.

Notes for Future Librarians

2022-10-18T23:48:00Z

Joss: Updated for F22.