Tiago Pedrosa @[IPB.PT](http://www.ipb.pt)
---

# Labtainers Install and Update

> Labtainers provide controlled and consistent execution environments in which students perform labs entirely within the confines of their computer, regardless of the Linux distribution and packages installed on the student's computer or VM. The only requirement is that the Linux system supports Docker.[1]

## Installation steps
Follow the following steps to install:

1. It can be installed on an existent Linux machine or virtual machine. The easy way will be to use a template (appliance) of virtual machine for VirtualBox or Vmware. Available at [2].

2. After downloading the appliance import it to the virtualization solution that you are using (VirtualBox or Vmware)

3. Start the virtual machine
4. Login using the user *student* and the password *password123*
5. Change date&time to the timezone Lisbon/Portugal, check keyboard layout
6. Update and upgrade the virtual machine and reboot
<!-- 7. Login again then configure the module of IPB on labtainers and update using the following steps:

cd ~/labtainers/labtainers-student
imodule cloud.ipb.pt/f/dba32eb57f6247a6ab0e/?dl=1
cd ..
./update-labtainer.sh

If you have problems running the imodule command, you can use a workaround. Just start a lab, stop a lab. And then repeat step 7.

cd ~/labtainers/labtainers-student
labtainer telnetlab

When requested for your email at the beginning of the labs, use your [e-mail] email
After started the lab, can close the terminals opened.
Then on the terminal that started the lab write:

stoplab telnetlab

-->
7. After this reboot and read the student guide[3]
8. Also check the toturials page, with some videos about the installation and use of labtainers[4].

## Workflow

Resuming the workflow to do the labs, student should be inside directory *~/labtainers/labtainers-student*.

For starting a lab use de command: ```labtainer <labname>```

When requested for your email in the beginning of the labs, use your **[e-mail]** email.

For automatic graded labs, studends can check their grade by executing the command ```checkwork``` on the directory *~/labtainers/labtainers-student*.

After finishing the lab, execute the command: ```stoplab <labname>```

The results will be stored in *~/labtainer_xfer/* directory with subdirectory per lab with *.lab* file that needs to be submitted for evaluation.

## Bibliography
1. [https://nps.edu/web/c3o/labtainers](https://nps.edu/web/c3o/labtainers)
2. [https://nps.edu/web/c3o/virtual-machine-images](https://nps.edu/web/c3o/virtual-machine-images)
3. [Student Guide](https://github.com/mfthomps/Labtainers/raw/master/docs/student/labtainer-student.pdf)
4. [More Labtainers Tutorials](https://nps.edu/web/c3o/labtainers-tutorials)

---
Tiago Pedrosa