diff --git a/appendices/Glossary.tex b/appendices/Glossary.tex new file mode 100644 index 0000000000000000000000000000000000000000..da02a39b09b6309ba3dee8400595ec3a026d8e32 --- /dev/null +++ b/appendices/Glossary.tex @@ -0,0 +1,93 @@ +\chapter*{Glossary} + +Words and phrases that are (or were) useful around the club. + +\begin{tabular}{ll} + {\bf Term} & {\bf Meaning} \\ +Dr ACC Murphy & +A Computer Called Murphy. Dr ACC Murphy is infamous around the UCC. He even receives mail! \\ +BSD & +Berkeley Systems Distribution – a UNIX developed at Berkeley, now better known through the FreeBSD, NetBSD and OpenBSD UNIXes. musdea runs FreeBSD. \\ +blog & +aka. weblog – sort of like a journal on the Internet (you don't have one?). Think of it as a tumblr for grown-ups. Syndicated by a Planet. \\ +Coke credit & +If you gotta ask, you ain't got it! Coke credit is how people usually refer to money in your dispense account. \\ +Coke Group & +The people who can put money (Coke credit) in your dispense account. \\ +Debian & +a Linux distribution popular in the UCC due to its community nature. \\ +DEC Terminal & +A dumb serial terminal, useful for plugging into the serial console on servers (possibly via a terminal server). Has a model number like vt100, vt200 or vt420. There's one in the corridor you can log into mussel and dispense drinks from. \\ +dispense & +dispense started off as a way to dispense Cokes from the online Coke machine, and has since grown into the way UCCans think the world should do business. \\ +Door Group & +the group of people charged with keep the room open, tidy and safe. \\ +Firefox & +A web browser by the Mozilla Foundation, arguably the second-worst Internet browser – the worst is every other browser. \\ +Flame & +Flame is the UCC's MUD (Multi-User Dungeon) and may or may not be haunted. \\ +Fresher & +A new university student, usually also a first time UCC member. \\ +Fresher Rep & +Fresher Committee member, usually chosen because they look like they'll make a good worker drone in the future. Represents the freshers at committee meetings, if they attend. \\ +GNOME & +GNU Networked Object Model Environment – an open source desktop environment aimed primarily at UNIX computers. Quite popular in the past, before it removed all of the features people liked. \\ +GNU & +GNU is Not Unix – a layer of libraries and utilities to implement a UNIX like operating system, commonly used on top of Linux. \\ +Internet Explorer & +Just use Firefox. No, really. \\ +IRC & +The lifeblood of UCCan communication. Internet Relay Chat lets you share news, stories and terrible puns with other members worldwide. \\ +KDE & +The K Desktop Environment. A rival of GNOME which some members prefer. Contains a frankly scary number of features, and a memory footprint to match. \\ +kernel & +The core of an operating system. All operating systems have a kernel, some popular ones include the Linux kernel and the Mach kernel. \\ +LDAP & +Lightweight Directory Access Protocol: the black magic used for authentication at the UCC. \\ +Linux & +the kernel (basis) of an open source UNIX operating system that has developed quite a following among computer scientists and engineers. \\ +loft & +the area above the UCC that looks down into the UCC clubroom. LAN gaming and other activities take place up there. \\ +machine room & +The UCC data centre. This is the small room with the glass doors that is located within the clubroom. All of our servers are kept in this room. It is locked when there is no one from Wheel around. \\ +mailing list & +a way of communicating with a very large number of people via email. The UCC has several mailing lists of varying popularity. \\ +Mozilla & +develop several open source web related products, such as Firefox and Thunderbird. \\ +OCM & +Ordinary Committee Member – the worker drones of the UCC Committee, they do lots of work, for little reward. \\ +Oligoboot & +boots more then one operating system (selectable when you boot). \\ +OpenSolaris & +A UNIX developed by Sun Microsystems, and abandoned by Oracle. \\ +NeXTStep & +An operating system developed by NeXT before they were bought out by Apple. Lots of NeXTStep is incorporated into Mac OS X. \\ +open source & +A software ideology, where the source code to software (what is compiled into the program you run) is freely available. Also known as Free Software, exactly what makes a program open source is a good way to get into an argument. \\ +Planet & +A web page that syndicates blogs. UCC has one at \url{http://planet.ucc.asn.au/} \\ +Secret Wheel Song & +The song that is supposedly sung at the beginning of each Wheel meeting. \\ % Elitism alert... +SLA & +A Service Level Agreement. A document describing how reliable services are. UCC does not have one, and you should not ask Wheel members about it. \\ +terminal server & +Sort of a router for serial ports, allows you to connect to one serial port from another. Usually connected to DEC Terminals, servers and dispense. (It can also refer to other sorts of servers which provide login sessions over the network). \\ +theft book & +this is where you write down that you borrowed tools from UCC. It is not for borrowing books; you mail books@ucc.asn.au to do that. \\ +TLA & +Three Letter Acronym – a way to refer to UCC members, often used in the minutes of meetings. Use the tla program or visit the UCC website to decode them. \\ +Ubuntu & +A Linux distribution derived from Debian. Funded with space money. \\ +UCCan & +someone who spends a lot of time in the UCC. Some UCCans pass their units. \\ +Unifi & +The University wireless network. Available around campus where UCC's wireless is not. You need to be a student to access it though. \\ +UniSFA & +the University Science Fiction Association, the ones down the hall. \\ +VM & +A VM or Virtual Machine is a computer emulated on top of another computer. Many of the UCC's servers run inside VMs. The claim is that UCC's VMs are not a ``single point of failure.`` That's the machine they are all running on (medico). \\ +WAIX & +WA Internet eXchange – a group of ISPs and interested bodies who peer resources on the Internet for mutual benefit. \\ +Wheel Group & +the group responsible for maintaining computers, accounts and services in UCC. \\ +\end{tabular} diff --git a/chapters/Clubroom.tex b/chapters/Clubroom.tex new file mode 100644 index 0000000000000000000000000000000000000000..1877494a1dae94a95d97d85c330a504c35847205 --- /dev/null +++ b/chapters/Clubroom.tex @@ -0,0 +1,7 @@ +\chapter{Clubroom} + +The clubroom is usually open from about 9am (after the first door group member arrives from 8am lectures) until 11pm (when UWA security kick us out). It is also sometimes open on weekends, and most days during university holidays. There is a map to the clubroom in Chapter \ref{FindClubroom}. If you want to check the clubroom is open and who is there, check out \url{http://webcam.ucc.asn.au} + +The clubroom has a heap of desktop computers, a server room, a projects area with tool cupboard, and assorted storage areas for parts, books and components. These things are all there for members to use – the locks on everything are to keep thieves out, so please don't be put off, and just ask if you need to get into something. + +We don't have cleaners, so look after the clubroom! There is always a door group member in the room, \rant{and you will do what they damn well tell you to do as they are the ones who have to come to cleanups in their free time. Of course, if you see something that needs doing such as cleaning up, feel free to do it!} diff --git a/chapters/Communications.tex b/chapters/Communications.tex new file mode 100644 index 0000000000000000000000000000000000000000..c0275876a4af7399bc60b13e0d28f233c4a56522 --- /dev/null +++ b/chapters/Communications.tex @@ -0,0 +1,42 @@ +\chapter{Communication Technologies} + +% Add Social Media? + +\section{Mailing Lists} + +UCC has a series of mailing lists that its members use to communicate. +These include: + +UCC-Announce - An announcement list through which we let +members know about Events and the like. You are automatically +subscribed to this list when becoming a member. + +UCC - Having a party that you want to invite UCCans to? This is the +list for you! Most UCCans subscribe to this list so it's a great +source of information and discussion on both the club and general +technical things. + +Committee - The list where committee matters are dealt with and circular +discussions occur. If you are interested in the running of the club then +you should subscribe to this list. + +Tech - Technical question? Suggestions or discussion around UCCs setup? +The list used to discuss UCC's hardware and machines. + +If you want to subscribe to any of these lists, you can do so at +\url{http://lists.ucc.gu.uwa.edu.au} + +\section{IRC} + +Without a doubt, the easiest way to waste time in or out of UCC +is chatting on our Internet Relay Chat (IRC) server. + +You'll get to chat with some of the older members of the club who +may not even be in Perth. Some of these old guard may seem a +little grumpy or intimidating at first, but give them a chance, they +are gold mines for information about the club and all things tech! +We also have members from CASSA and ComSSA, clubs at other WA unis. + +You can connect with an IRC client to \texttt{irc://irc.ucc.asn.au:6667} +and join the channel \texttt{\#ucc}, or with a web browser go to +\url{http://irc.ucc.asn.au} diff --git a/chapters/Dispense101.tex b/chapters/Dispense101.tex new file mode 100644 index 0000000000000000000000000000000000000000..20321fbfba92b9e19aaa9454cd1416c8377af23b --- /dev/null +++ b/chapters/Dispense101.tex @@ -0,0 +1,16 @@ +\chapter{Dispense 101} + +% How to use Dispense. + +At the same time as you set up your account, you will also have your dispense account set up. Dispense is the program that allows users to store credit and purchase items from the coke/snack machines (which are almost always cheaper than what you would find elsewhere on campus). + + +This will involve a 5 digit User ID and a 4 digit PIN. This allows you to physically log into the snack machine and dispense both drinks and snacks. +Coke members can help you add credit to your dispense account. Call out for one in the clubroom if need be, there's always one around. + + +You can also use your Student Card/SmartRider as a log in device on the snack machine. To do so, log in to the Snack Machine and hold whichever card you want to use up to the card scanner (it's the thing with the blinking green light) and the card should auto- enroll. To log in using the card, simply hold the enrolled card up to the card scanner. + + +You can also access Dispense online via shell login and using the \shell{dispense} command. Dispense isn't installed on clubroom machines so you will have to use \shell{ssh} to access one of UCC's servers. You can get someone to show you how to do this, or alternatively, go to: \url{http://wiki.ucc.asn.au/SSH} + diff --git a/chapters/FindClubroom.tex b/chapters/FindClubroom.tex new file mode 100644 index 0000000000000000000000000000000000000000..558a7a8d0c9a8e2a4a9273b77e2f05c81064b53d --- /dev/null +++ b/chapters/FindClubroom.tex @@ -0,0 +1,13 @@ +\chapter{Finding the Clubroom}\label{FindClubroom} + +% Directions to the clubroom, ideally with non terrible maps. Most people don't ever find it :-( + +To find the clubroom, follow the maps: + +\begin{enumerate} + \item Starting from the carpark outside The Tav, follow the arrow on the aerial picture to get to the Cameron Hall door, then go up the stairs to the second floor and follow the bottom map. + \item If you see a coke machine and a snack machine, you are in the right place. The UCC clubroom has lots of computers and a couple of couches. + \item If you accidentally find yourself surrounded by books and a fridge, you're in UniSFA --- try the other door in that corridor. +\end{enumerate} + +You can see if the clubroom is open online using the webcams (\url{http://webcams.ucc.asn.au/}) diff --git a/chapters/Groups.tex b/chapters/Groups.tex new file mode 100644 index 0000000000000000000000000000000000000000..617f6b08441146c822eecee43342bf5a7f507ed3 --- /dev/null +++ b/chapters/Groups.tex @@ -0,0 +1,54 @@ +\chapter{UCC Groups} + +% Explanation of the groups. + +% Is this section a little elitist sounding, or is that just the entire group system? [SZM] + +The UCC committee delegates specific duties and responsibilities to other people in the club. These groups, traditionally modelled after UNIX groups, are referred to often. It pays to be aware of what the responsibilities of each group are. + + +You can see who's in each group online (photos are included). Alternatively, if you're looking for a member of a certain group, shouting out 'is there anyone here in group?' will usually get you an answer. + + +Unlike committee, obtaining membership to one of the UCC groups does not involve being elected. Membership of these groups entails a certain amount of trust, so you may not be allowed to join them straight away. + +The exact entry requirements are often vague and it is generally accepted that you will nominate yourself once you feel you meet those requirements. Members join Wheel by invite only, and will be asked to attend a Wheel Meeting, where they too will be taught the Secret Wheel Song. +Do not despair if you're not made a Wheel member immediately. Sticking around and showing an interest through contribution is more important than just having the skills. + + + +\section{Wheel} +wheel@ucc.asn.au +Wheel is in charge of maintaining the club's machines. They are the best people to see if you're having problems with the computers. Wheel maintains its own membership, but works hand in hand with Committee on issues relating to account policy. If you abuse your account, it will be locked by a Wheel member. The unlocking of accounts is at the discretion of Committee. Wheel have infrequent meetings, where they sing the secret wheel song. + +\section{Committee} +committee@ucc.asn.au +Fresher Rep: fresher@ucc.asn.au +The Committee is appointed each year by the members (that's you) at the AGM. They handle the day-to-day running of the club, managing money, events and holding grumpy meetings each week, which members like yourself are welcome to attend. +The Fresher Rep is your voice on the Committee. Get to know them and let them know how incredibly happy you are! If you have problems, they'll always be ready to listen. + +\section{Coke} +coke@ucc.asn.au +(appointed by committee) +The Coke group are the people to talk to if you want to add money to your dispense account (see the section on dispense). They can also credit your account for bad dispenses and other tasks related to dispense. + +\section{Door} +door@ucc.asn.au +(appointed by committeee) +The Door group is responsible for the clubroom itself. Only a member of door group can unlock the clubroom and keep it open for members during the day. This means that if the only Door group member in the room has to leave, then everyone will have to leave until another Door group member arrives. + +\section{Webmasters} +webmasters@ucc.asn.au +The Webmasters are charged with maintaining the UCC web presence. Becoming a Webmaster usually involves showing some interest in the UCC website, as well as approval from an existing Webmaster or member of Wheel. + +\section{Winadmins / Sprocket} +winadmins@ucc.asn.au + +In response to the decreasing availability of Wheel members during the day, the Winadmins group was created to give trusted members administrator access to the Windows desktop machines in the clubroom. Sprocket is the equivelant group for Linux desktop machines. + + + + + + + diff --git a/chapters/SetupAccount.tex b/chapters/SetupAccount.tex new file mode 100644 index 0000000000000000000000000000000000000000..eb70c74dbec7667e4d4f0157fc8f5c3c077be47f --- /dev/null +++ b/chapters/SetupAccount.tex @@ -0,0 +1,15 @@ +\chapter{Setting Up Your Account} + +% How to actually make an account. Most Freshers never do this :-( + +Your UCC account is one of the most important things you can have as a member. It lets you log into any of our clubroom machines, as well as granting you access to our user servers, wireless network and online drink and snack machines. + + +You'll need to come into the clubroom to set up your account. Once you're here, ask around for a Wheel or Committee member and have your membership sticker (we normally put it on your student card on O-Day) to set up your account. You'll need a user name and a password to memorise, but it's a pretty simple procedure once you've found the right person! + + +Now that you have an account, you can use it to log into any of our clubroom machines. If you want to log onto one of our servers, you'll need to use the SSH program. If you're having trouble, just ask someone in the clubroom --- we don't \pun{byte}! + + +Changing your UCC password can either be done by Ctrl-Alt-Del on a windows machine or using the command \shell{passwd} on a Linux/Unix machine. +Accessing the UCC WiFi network can be a bit tricky (particularly on Windows machines). Ask someone if you need help, or refer to \url{http://wiki.ucc.asn.au/Wifi} diff --git a/fresher_guide.pdf b/fresher_guide.pdf index bb90b6f56573434fc71e533cd315e2d139b95f75..e49b4583833e2bad7244ac4b6271eae497a464d3 100644 Binary files a/fresher_guide.pdf and b/fresher_guide.pdf differ diff --git a/fresher_guide.tex b/fresher_guide.tex index bad7ebdb049e40f011238b9207b2c8338037bd11..ad3fe0a3fe9cce1fd41c090a3fe0dd1ea642aa0b 100644 --- a/fresher_guide.tex +++ b/fresher_guide.tex @@ -80,6 +80,12 @@ \newcommand{\gitref}[2]{\href{https://github.com/UniversityComputerClub/FresherGuide/master/#1/#2}{ \textcolor{blue}{\emph{#2}}}} % Refer to API commands \newcommand{\api}[1]{ ``\textcolor{black}{\texttt{/api/#1}}''} +% Pun alert +\newcommand{\pun}[1]{\emph{#1}} +% Shell command +\newcommand{\shell}[1]{\texttt{#1}} +% Rants +\newcommand{\rant}[1]{\textsc{#1}} % To make underscores printable without escaping them \usepackage[T1]{fontenc} @@ -143,7 +149,12 @@ %--------------------------------------------------------- %Include the chapters! -\include{chapters/Introduction} % Chapter 1 +\include{chapters/FindClubroom} % Chapter 1 +\include{chapters/SetupAccount} +\include{chapters/Dispense101} +\include{chapters/Groups} +\include{chapters/Clubroom} +\include{chapters/Communications} % ETC %\newpage @@ -156,7 +167,7 @@ % Appendices \appendix -%\include{appendices/glossary} +\include{appendices/Glossary} %\include{appendices/figures} %--------------------------------------------------------- diff --git a/references/refs.bib b/references/refs.bib index 52dfc99fbec6e4b663d869f3edc24b09afa016e9..653212be6df45398708dcf09fe775a41a177fb4e 100644 --- a/references/refs.bib +++ b/references/refs.bib @@ -1 +1,9 @@ -% References go here. If we actually use them +% References go here. If we actually use them. + +% Note that we need at least one reference or the existence of this will make bibtex angry and break other random parts of the pdf. + +@misc {committee, + title = "Committee", + author = "ACC Murphy", + howpublished = "\url{http://www.ucc.asn.au/infobase/committee}" +} diff --git a/titlepage/Titlepage.tex b/titlepage/Titlepage.tex index 3270dff5bb11161d76cff0ef3ecd98eba42d2a2e..01bfaf5a5e6c3855d009ec825314a2d721623e85 100644 --- a/titlepage/Titlepage.tex +++ b/titlepage/Titlepage.tex @@ -1,6 +1,9 @@ \begin{titlepage} + +% Suitably pretty title page is required. + \title{UCC::FresherGuide} -\author{The Ghosts of Committee Past \\ <\href{mailto:committee@ucc.asn.au}{committee@ucc.asn.au}>} +\author{The Ghosts of Committee Past\cite{committee} \\ <\href{mailto:committee@ucc.asn.au}{committee@ucc.asn.au}>} \date{January 2014}