#include "common.markdown.include"
#define title Using Ubuntu in the SCS environment
#define date $Date: 2010/08/18 18:35:40 $

# Using Ubuntu in the SCS environment
 
* based on [Amar Phanishayee's guide](http://www.cs.cmu.edu/~amarp/ubuntu_andrew.html)
* revised for lucid (Ubuntu 10.04) 64-bit
* Other resources
    * [The Usable Mac](http://www.cs.cmu.edu/~dga/usable_mac.html)
    * [Setting up OpenAFS to talk to CMU's network](http://www.cs.cmu.edu/~pgunn/sysadmin/openafs.html)
    * [MIT's Debathena Project](http://debathena.mit.edu/)

## Before setup

### Backup (required)

* Kerberos files: /etc/krb*

### Reversible installation (optional)

* Shrink the Windows NTFS volume using Disk Management
* Make a normal or LVM partition
* Install a boot loader in /dev/sda4 instead of /dev/sda
* Setup chain loading; in OLD/boot/grub/menu.lst, add

        title New Linux
          savedefault
          rootnoverify (hd0,4)
          chainloader +1

## During setup

### UNIX account name

* Use your SCS/andrew account name for making the main UNIX account
* Will be referred to as USERNAME

## After setup

### Kerberos

* $ sudo apt-get install krb5-user krb5-clients
* $ sudo cp -a OLD/etc/krb* /etc/
* In [libdefaults] of /etc/krb5.conf, add/modify

        ticket_lifetime = 1d
        renew_lifetime = 30d
        allow_weak_crypto = true

* $ kinit; klist

### AFS

* $ sudo apt-get install openafs-client openafs-krb5 openafs-module-dkms dkms build-essential
* $ sudo dpkg-reconfigure openafs-client
    * AFS cell = cs.cmu.edu
* $ In /etc/openafs/cacheinfo, increase the cache size (unit is KB)

        /afs:/var/cache/openafs:2000000

* $ aklog; tokens
* $ ls /afs/cs.cmu.edu/user/USERNAME/
* $ aklog andrew.cmu.edu; tokens
* $ klog.afs -c andrew.cmu.edu; tokens
* $ ls /afs/andrew.cmu.edu/usr*/USERNAME/

### Automatic Kerberos/AFS authentication/renewal

* $ sudo apt-get install libpam-krb5 kstart
* $ krenew -b -p /home/USERNAME/.krenew.pid -K 60 -t
* Convenient when added in System - Preferences - Startup Applications
* Manually execute kinit when the renewal duration terminates

### SCS printers

* [Find printer name, location, and model](http://www.cs.cmu.edu/~help/printing/printers_by_features.html#PUBLIC)
* System - Administration - Printing - New - Other - lpd://(cyan|magenta|yellow).srv.cs.cmu.edu/PRINTERNAME
* Check "Duplex Unit"
* TODO: automatic or more convenient way to register printers

### NTP

* $ sudo apt-get install ntp
* In /etc/ntp.conf, comment out existing servers and add

        server PARSLEY.SRV.CS.CMU.EDU
        server SAGE.SRV.CS.CMU.EDU
        server ROSEMARY.SRV.CS.CMU.EDU

### SCS backup

* Obtain the backup client from /afs/cs.cmu.edu/project/operations/Backup-Client/TiBs-Install/tibs2501.x86_64.Linux.tar.gz
* $ sudo apt-get install xinetd
* Extract tarball
* $ cd tibs2501
* $ ./install.sh
* Client hostname: gsXXXX.sp.cs.cmu.edu
* Server hostname: tibs4.srv.cs.cmu.edu (may vary)
* Request client.auth and client.dat file (TODO: not sure how to get these for the latest client distribution)
* Contact the Help Desk for the backup.  See [details](http://www.cs.cmu.edu/~help/backups_restores/unix_backups.html).

### Terminal server script

* TODO
* Source: /afs/cs.cmu.edu/local/rdesktop/common/scripts/006/bin/ts

## Misc

### ATI GPU driver

* $ sudo apt-get install fglrx
* $ sudo aticonfig --initial

### Audio

* No special action needed
* But if you can't hear anything, check Volume Control - Playback and Volume Control - Switches

### Compiz

* $ sudo apt-get install compiz compizconfig-settings-manager
* System - Preferences - Appearance - Visual Effects - anything other than None
* $ ccsm

### Adobe Flash Player

* $ sudo apt-get install flashplugin-installer

### Korean language support

* $ sudo apt-get remove ttf-wqy-zenhei
* $ sudo apt-get install ibus-hangul ttf-alee ttf-unfonts
* $ im-switch -s ibus