# Participant Setup Procedures

## Set up VM

1. Open VMWare Player app
2. Open existing Virtual Machine
3. Navigate to and select `/opt/Thesis-mini.ova`
4a. *14-30{1,2}* Rename directory from `/home/...` to `/tmp/...`
4b. *14-303* Rename directory from `/home/...` to `/vm/...`
5. Hit Retry when prompted
6. Once the program finishes importing, Boot the Thesis-Mini
7. Hit Continue when prompted

## Using VM

*Note: All SSH connections to outside the VM will take up 2 minutes to establish
for unknown reasons.*

### Direct Usage

There is a terminal available as the green icon in the bottom-right corner.
From there you can SSH into another computer as per normal.

### Indirect Usage

Each VM will have an IP with is accessible from the host O.S.  Usually this will be
`172.16.98.128`.
To be sure, from the host O.S. open a terminal and type, `ip addr` and look for
`vmnet1`.  Replace the last octal of that interface's IP with `128` and that is
the address of the VM.

Using this IP address, you can connect to the VM with:
```Shell
ssh volenteer@172.16.98.128
```
And the password, `password123`.  Once connected participants can SSH out to other
machines as normal.

## SSHing from the VM

Each SSH session will start with a prompt asking if this is a guided session.  If
participants are not following the provided guide, they should type `n`.  If they
are, they should type `y`.

Next the shell will warn them not to enter passwords into the session.  The first
password they enter to establish the connection will not be captured.  Importantly,
afterwards we cannot filter out passwords afterwards.  Thus far avoiding entering
any has not been a problem.

Finally, participants must properly close the SSH session in order to complete the
connection __(They should not hit the X to exit)__.  They can do this by typing
`exit` or `C-d`.

Once they have exited the VM will show them the log of their recorded keys.  Once
they review the logs and feel satisfied, they can type `q` to continue.  The VM
will then confirm that they want to submit the logs which they can respond with
either `y` or `n` to continue or withdraw respectively.