Add basic sysadmin stuff
authorJames Morrison <ja2morri@csclub.uwaterloo.ca>
Wed, 13 Aug 2003 17:12:01 +0000 (17:12 +0000)
committerJames Morrison <ja2morri@csclub.uwaterloo.ca>
Wed, 13 Aug 2003 17:12:01 +0000 (17:12 +0000)
docs/execmanual/book.xml
docs/execmanual/sysadmin.xml [new file with mode: 0755]

index dfde0e7..273a3bf 100755 (executable)
@@ -4,10 +4,12 @@
 [
 <!ENTITY prez SYSTEM "president.xml">
 <!ENTITY veep SYSTEM "vice-president.xml">
+<!ENTITY sysadmin SYSTEM "sysadmin.xml">
 ]>
 
 <book><title>Computer Science Club Exec Manual</title>
 &prez;
 &veep;
+&sysadmin;
 </book>
 
diff --git a/docs/execmanual/sysadmin.xml b/docs/execmanual/sysadmin.xml
new file mode 100755 (executable)
index 0000000..4b56129
--- /dev/null
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter>
+  <title>System Administrator</title>
+
+  <para>This chapter covers various useful notes for the CSC sysadmin, ranging
+  from how to get appointed to expiring users.</para>
+
+  <sect1>
+    <title>What to do</title>
+
+    <para>The SysAdmin position was added to the exec when the CSC acquired a
+    computer system of their own. The SysAdmins duties are:</para>
+
+    <itemizedlist>
+      <listitem>
+        <para>to operate any and all equipment in the possession of the Club;</para>
+      </listitem>
+
+      <listitem>
+        <para> to maintain and upgrade the software on equipment that is
+        operated by the Club;</para>
+      </listitem>
+
+      <listitem>
+        <para>to facilitate the use of equipment that is operated by the Club.</para>
+      </listitem>
+    </itemizedlist>
+
+    <para>It has become quite regular for the CSC to get new equipment each
+    term. The sysadmin is responsible for ensuring this gear gets installed
+    and works as intended.</para>
+  </sect1>
+
+  <sect1>
+    <title>Useful contacts</title>
+
+    <itemizedlist>
+      <listitem>
+        <para>You can try getting access to the machine room from MFCF/CSCF.
+        You probably want to talk to Dave Gawley, <email>dlgawley@cs.uwaterloo.ca</email>.
+        He&#39;s been really friendly to the CSC in the past and is a cool guy
+        in general.</para>
+      </listitem>
+    </itemizedlist>
+  </sect1>
+
+  <sect1>
+    <title>Expiring Users</title>
+
+    <para>This procedure is for users that were expired at the end of spring
+    2003.</para>
+
+    <orderedlist>
+      <listitem>
+        <para>login as root on peri (you probably can&#39;t do this, but might
+        have access to someone who can..)</para>
+      </listitem>
+
+      <listitem>
+        <para>Unexpire the account in the ldap database</para>
+
+        <para><prompt>peri# </prompt><userinput>echo username
+        |/root/dead-accounts/unexpire.pl</userinput> If this worked, it should
+        spit back the username.</para>
+      </listitem>
+
+      <listitem>
+        <para>Extract home directory onto peri</para>
+
+        <para>extract home directory onto peri mount &#34;Expired /u&#34; on
+        sugar (or wherever) copy /$mntpoint/username.tar to somewhere
+        accessible to root@peri</para>
+
+        <para>Note: the home directories are not compressed on the CD,
+        remember this when &#39;cp&#39; is telling you &#39;username.tgz: no
+        such file or directory&#39;. tar (below) doesn&#39;t need &#39;z&#39;
+        either. <prompt>peri# </prompt><userinput>tar xf /path/to/username.tar
+        -C /u</userinput></para>
+      </listitem>
+
+      <listitem>
+        <para>Restore mail onto peri </para>
+
+        <para><prompt>peri$ </prompt><userinput>grep username
+        /root/dead-accounts/unreadable-accounts</userinput> if the username is
+        there, the mbox is on &#34;Expired mail 2&#34; otherwise, the mbox is
+        on &#34;Expired mail&#34; mount appropriate CD cd to a temporary
+        directory (*not* /var/mail) extract mbox from archive -- on the
+        &#34;Expired mail&#34;, this will take a while -- just hit ^C after
+        you see the username printed and you&#39;re happy tar has moved on to
+        other files.</para>
+
+        <para>(I say &#39;sugar&#39;, but really any machine with a CD
+        drive...) <prompt>sugar$ </prompt><userinput>tar jxvf
+        /$mntpoint/mail_tar.bz2 username </userinput> (hmm.. I don&#39;t
+        remember what the tarball is called on Expired2, maybe the same thing,
+        maybe different, but I&#39;m pretty sure this is the filename for
+        Expired1. Besides, there&#39;s only one file on the CD, so just
+        tab-complete the damn thing :) (probably scp username root@peri: or
+        something here) restore mail, appending any mail received since backup
+        was made, and preserving permissions on the file. (Note: this
+        doesn&#39;t take into account locks -- i.e., stuff might get screwed
+        if the account receives mail while one of the below cats is running. A
+        message received between the cats simply gets lost.)</para>
+
+        <para> The following commands should also work from another machine if
+        the account was on &#34;Expired mail&#34; (i.e., was not in
+        ``unreadable-accounts&#39;&#39;). But doing it on peri will always</para>
+
+        <para><prompt>peri#</prompt><userinput>cat /var/mail/username
+        &#62;&#62;username</userinput></para>
+
+        <para><prompt>peri#</prompt><userinput>cat username
+        &#62;/var/mail/username</userinput></para>
+      </listitem>
+    </orderedlist>
+  </sect1>
+</chapter>
\ No newline at end of file