operations/cosi-build.md

# cosi build

Installation instructions for the COSI lab build.

## Install Ubuntu 18.10 server edition

Install the Ubuntu 18.10 server edition. No special MAAS or any other stuff, English language, etc.

### Networking

Set DHCP on all interfaces. The DHCP server will automaticall hand out very specific IP addresses to the lab machines, based on their MAC address.

### Disks

When configuring the disks, be sure to use the common smallest denomination so that you don't need to shrink the operating system image when you are cloning the operating system later.

A good size is somewhere between 32GiB and 64GiB. Generally, we do MBR installs since they are relatively easy to maintain.

### Computer Naming Scheme

Machines are named using the following convention (as required by Kerberos later):

`cosi-xx`

where `xx` is 01-08.

For example, `cosi-01`.

### Usernames

Use the default `csguest` username with the well-known password.

## Install Base Packages

Ubuntu tends to puke a bunch of stuff at you when you are booting up, so you're going to want to wait for it to generate SSH keys and all that jazz.

### Update system

Update the system once it boots up.

```bash
sudo apt update && sudo apt upgrade
```

### Install Graphical User Interface and tools

Install required packages

```bash
sudo apt install htop vim git
sudo apt install gnome-session gdm3 gnome-terminal
sudo apt install firefox
```

Configure GDM to start on bootup.

```bash
#sudo systemctl enable gdm3
sudo systemctl disable NetworkManager
sudo systemctl disable systemd-resolved
sudo systemctl disable swap.img.swap
```

Other software

```bash
sudo apt install pavucontrol nautilus
```

Write out new configs

```bash
# important, removes symlink to /run
rm /etc/resolv.conf
vim /etc/resolv.conf
```

```
nameserver 128.153.145.3
nameserver 8.8.8.8
search cslabs.clarkson.edu
```