Register for Single Sign-On (SSO) by following instructions on CC website /How To's?/Two Factor Authentication (2FA) for SSO. Once 2FA has been enabled, you can login into MS Teams using your IITB LDAP credentials and an OTP generated by the authenticator app.
Virtual Software Lab Setup (Full document)
Instructions given by lab instructors will over-ride any of the instructions given here.
Welcome to the virtual software lab of the Computer Science Department, IIT Bombay. Living with the COVID-19 pandemic may be hard due to various reasons for each and everyone of us, but the Software lab at CSE department will not be one such reason. We have written these user guides to help students step into the virtual lab* of the department without a hassle, i.e. to set up the software required for labs in their own personal computers and start working on their labs in no time!
Before you start please ensure you have checked the minimum system and network requirements and equipped yourself with those. Now see the sections below to get set up.
The instructions about Docker installations are relevant only if the instructor has specifically mentioned so. Otherwise, please ignore ALL Docker related instructions.
Students who want to use sl2 machines for running their programs, they can use the following steps:
$ ssh cseldap@login.iitb.ac.in -p 5022
Enter your cse ldap password and you will reach login.cse server. From there you can connect to sl2 machines
$ ssh cseldap@sl2-{1-132}.cse.iitb.ac.in
First things first, an Operating system(Ubuntu is a must):
If you have Ubuntu(at least 18.04) running as a full-fledged Operating system, then you are good to go, else install Ubuntu:
If you don’t have any OS installed, then install via this link
If you have Windows already installed:
3.1 Dual boot with Ubuntu 18.04 from this link (recommended)
3.2 If due to some reasons, cannot dual boot and cannot work on Ubuntu, then one can proceed to work on Windows 10(not recommended) following this link(this option is only available for Windows 10)
If you have a MAC, check this guide
Set up the private IITB VPN to access the laboratory, follow this link (use you institute LDAP credentials when you login with above link)
Do this only if at least one of your lab course instructors is planning to use a virtual lab environment, otherwise you can skip the docker installation steps. In general, for labs instructions from your faculty instructor supersede these instructions
Update the package list first, fire up the terminal use the keys alt+ctrl+t on your keyboard and use the following command:
$sudo apt-get update
(enter the OS login password here, on prompt)
Install a product named as docker with the following set of commands:
1)
$sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
2)
$curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
3)
$sudo apt-key fingerprint 0EBFCD88
4) For x86_64 / amd64 architecture:
$sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
For armhf architecture:
$sudo add-apt-repository "deb [arch=armhf] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
For arm64 architecture:
$sudo add-apt-repository "deb [arch=arm64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
5)
$sudo apt-get install docker-ce docker-ce-cli containerd.io
Enter the password when asked, this is your login Ubuntu password
Enable IITB VPN on your personal computer, if you don’t know how, read through the link in step 2(in Ubuntu & VPN Installation)
Keep your cool, you are just a few more steps away from the setup. Login to the virtual laboratory of Software Lab with this command:
$sudo docker login docker.cse.iitb.ac.in
When prompted with a username and password, use the credentials below to enter them:
Username: cse_user
Password: user_auth_pass
All done, now pull the software you require with the following command:
$sudo docker pull docker.cse.iitb.ac.in/[name]
Here, the place holder [name], is the course code or the name of the software required to be installed, all such names are listed at the end of this document.
Follow step 6, for each course you require the laboratory.
To start a course, just use the command below:
$sudo docker run -v "$HOME:/host" --name "[name_work]" -it docker.cse.iitb.ac.in/[name]
[name_work] : You can give the any name of the laboratory in the placeholder
[name] : Mandatory to use [name] used in step 6
[$HOME:/host] : You can access your home directory in /host dir in docker image
Now, you are inside the laboratory, you can start your lab now.
Once, done you can exit with the following command :
root@fdccb3348927:/home#exit
Hope you are in Ubuntu already
Fire up the terminal, with alt+ctrl+t
Run the following command to open the old lab session with all your files intact as you had left them last time:
$sudo docker start [name_work]
Then,
$sudo docker exec -it [name_work] /bin/bash
[name_work] : use the same [name_work] used in step 9 of Setting-up the Virtual Lab
Caution : The files are stored locally on your computer, so if your Hard Disk fails, it would be impossible to recover the same.
Voila!, you are inside, start from where you last left!
Hope, you are inside the laboratory and followed through the above steps until now
To access files of your personal computer being in the virtual laboratory:
root@fdccb3348927:~# cd /host
Now you can access all the files and folders from your local HOME directory inside the laboratory in /host directory