Skip to main content

295 Machines

Executable Environment. For this C homework, the executables needs to run on a course machine. In particular, you will need to compile your source by either using the VM provided or CSIL machine. CSIL machines can be accessed either using RDP or ssh.

WARNING: Pre-requistes and 127/135 should have taught you how to pull up a terminal in linux If not, read tutorials below and self-learn

WARNING: As SFU has migrated to VPN, the instructions may be updated. THE CMPT 295 STAFF DO NOT CONTROL RDPing or SSHing to CSIL ALL CMPT 295 ASSIGNMENTS/LABS CAN BE COMPLETED USING THE VM BELOW IF YOU HAVE ANY QUESTIONS ABOUT CONNECTING TO CSIL PLEASE CONTACT THE DEPARTMENT TECH STAFF helpdesk@cs.sfu.ca The instructions for CSIL/RDP may be updated constantly as SFU provides more information. Please keep track of this section

RDP Access

Follow in order.

  • COVID 19 Working Remotely.
  • Follow for Undergraduate Students. Option Linux GUI WE DO NOT SUPPORT WINDOWS
  • RDP to a linux station WARNING: Known defects include copy-pasting from host to RDP machine
  • List of CSIL machines
    • Make sure windows and OS X is disabled and only linux is highlighted
    • DO NOT USE CONNECT on this page. Follow RDP to linux guacamole instructions

After you have remote desktop. Open Applications>Utilities>Terminal You can SSH or complete assignment tasks from terminal

SSH

WARNING: You have to first ssh using instructions below to connect to a gateway server If unable to connect to gateway that means SFU has blocked access. Please contact helpdesk@cs.sfu.ca.

The SSH command will be like this:

$ ssh -p 24 [CSIL ID]@gateway.csil.sfu.ca
# This will prompt for password and OTP (one time password)
# For password use your csil/sfu password
# For OTP use MFA set up above
# On gateway
$ ssh -p 24 [CSIL ID]@asb9700u-b01.csil.sfu.ca
# If the machines have not been booted to linux, this command will timeout.
# To check which machines in CSIL have booted into linux see below.
  • Available Servers
  • Unselect MAC and Windows. Only have linux selected. WARNING: DO NOT USE Connect Link
# To directly access asb machine from your desktop/laptop. Add the following to your ~/.ssh/config file on your desktop/laptop. 
# If you do not have it, create one. 

# PASTE THIS INTO YOUR MAC/linux/WSL desktop laptop

Host csil-bounce
HostName gateway.csil.sfu.ca
User [CSIL ID]
ServerAliveInterval 120
Port 24

Host a*.csil.sfu.ca
User [CSIL ID]
ProxyCommand ssh csil-bounce nc %h 24

Host cs-srye*.cs.surrey.sfu.ca
User [CSIL ID]
ProxyCommand ssh csil-bounce nc %h 24

# Now you can ssh directly to csil machine
# with the gateway implicitly forwarding connections.
$ ssh asb9700u-a02.csil.sfu.ca

Finding linux machines

To work remotely with CSIL you need to find linux machines.

  • Option 1 Typically these are listed [here]- List of CSIL machines If that page is down or is not working for you. Then you can use the option below

  • Option 2 First follow steps in SSH to ensure you can ssh to gateway SSH.

$ ssh -p 24 [CSIL ID]@gateway.csil.sfu.ca
# On gateway 
cs-accessed$ wget "https://www.cs.sfu.ca/~ashriram/Courses/CS295/assets/distrib/csil-linux.py"
cs-accessed$ python3 csil-linux.py
# e.g., You will get a dump of machine names.
# The names below will vary each time you run it.
asb10928-d06.csil.sfu.ca
asb10928-e02.csil.sfu.ca
asb10928-e03.csil.sfu.ca
asb10928-e04.csil.sfu.ca
asb10928-e05.csil.sfu.ca
asb10928-e06.csil.sfu.ca
asb10928-e07.csil.sfu.ca
cs-srye4013ua02.cs.surrey.sfu.ca
cs-srye4013ua04.cs.surrey.sfu.ca
cs-srye4013ua08.cs.surrey.sfu.ca
cs-srye4013ua10.cs.surrey.sfu.ca
cs-srye4013ub01.cs.surrey.sfu.ca
cs-srye4013ub02.cs.surrey.sfu.ca
cs-srye4013ub03.cs.surrey.sfu.ca

Now go back to SSH and complete the steps.

WARNING 1: If you are accessing remotely someone sitting physically at the linux machine could reboot it i.e., save early and often WARNING 2: The machines can be sshed into does not mean that they support RDP. This depends on sfu. If you encounter trouble for RDPing mail helpdesk@cs.sfu.ca

Once you have done that; establish vscode access below.

Working remotely with CSIL

Warning: Instructions in this section are for self learning They are provided here without any additional support We will not respond to any questions on piazza

Warning: We do not recommend working without VM OR sshing into CSIL

Overview. We will be tunnelling our edits to files and commands over ssh in particular over remote ssh extension under vscode. Figure below provides an overview. This permits us to locally run the vscode editor (on your laptop) while editing files on remote csil machines and running commands remotely on linux.

VM

WARNING: WE ONLY PROVIDE THE VM. SETTING IT UP ON YOUR LAPTOP/DESKTOP IS YOUR RESPONSIBILITY STAFF WILL NOT PROVIDE INDIVIDUAL TECH SUPPORT PLEASE REFER TO OUR LINKS/VIDEO BELOW FOR GUIDANCE If you have trouble with VM, use the CSIL instructions

We have created a CMPT 295 VM that comes preinstalled with Ubuntu 18.04 Bionic Beaver and many of the tools preinstalled. Download and install latest virtual Box. Last checked on version 6.1.22 Download and install latest extension pack

You can ssh into the VM from your machine. Port 2222 on the host machine maps to port 22 on VM.

 ssh -p 2222 vagrant@localhost (username: vagrant password: vagrant)

Modules

CMPT 295 relies on a set of customized compilers and software. We uses modules to manage the user environment for different third-party software versions. The advantage of the modules approach is that the user is no longer required to explicitly specify paths for different executable versions. ON VMs

These come preinstalled.

On CSIL. If RDPed. Open Applications>Utilities>Terminal

$ module avail
# Step 1: If it says module command not found. If found, goto Step 2.
$ export LD_LIBRARY_PATH=/usr/shared/CMPT/courses/cmpt295/tcl/lib:$LD_LIBRARY_PATH
$ source /usr/shared/CMPT/courses/cmpt295/modules/Modules/3.2.10/init/bash
$ module avail
# If you see some Tclerror etc. Then you have not set the LD_LIBRARY_PATH
# Step 2
$ module load cmpt295/cgdb  
$ module load valgrind
$ module load cmpt295/riscv
# If shell does not say (base).. you also need to load conda
$  . "/usr/shared/CMPT/courses/cmpt295/miniconda3/etc/profile.d/conda.sh"
$ conda activate

Alternative if your are not able to get above steps working

# Add this to your .bashrc if you want to automatically have cgdb loaded each time.
export PATH=/usr/shared/CMPT/courses/cmpt295/cgdb/bin:$PATH
export PATH=/usr/shared/CMPT/courses/cmpt295/valgrind/bin:$PATH

On CSIL. If in SSH Terminal If you see errors such as cgdb not found If logged into CSIL. You need to do this everytime you log in to CSIL. If you do not want to. Add the following commands below to your .bashrc or .zshrc found in your home directory ~/ .

# Step 1: If it says module command not found. If found, goto Step 2.
$ export LD_LIBRARY_PATH=/usr/shared/CMPT/courses/cmpt295/tcl/lib:$LD_LIBRARY_PATH
$ source /usr/shared/CMPT/courses/cmpt295/modules/Modules/3.2.10/init/bash
$ module avail
# If you see some Tclerror etc. Then you have not set the LD_LIBRARY_PATH
# Step 2
# Load compilers
$ module load cmpt295/cgdb
$ module load cmpt295/valgrind
$ module load cmpt295/riscv
# Load the appropriate python3 version. This important for Assignment 4 and 6.
# The . below is important. It IS NOT A TYPO
$  . "/usr/shared/CMPT/courses/cmpt295/miniconda3/etc/profile.d/conda.sh"

# Load the grading scripts
$ conda activate
# Following this your shell should change to (base)....
# If not, then you do not have access to the grading scripts

# Do not add above line to your .bashrc. Simply type conda activate
# If it says conda not found then re-run the last step
#  . "/usr/shared/CMPT/courses/cmpt295/miniconda3/etc/profile.d/conda.sh"

If on VM. We preload the software.

$ module avail
# If on VM you do not need to do anything.
## VM
# Your shell should say (base).....
# If module avail says command not found
# then you are most likely in the wrong shell/terminal

Linux Cheats

Your home directory is shared between the CPU servers, so you can copy files to or from there by connecting to one of the CPU servers. The files will be available on the workstations. Copying files to CSIL will be something like:

scp -P24 filename USERNAME@csil-cpu1.csil.sfu.ca:

And back from CSIL:

scp -P24 USERNAME@csil-cpu1.csil.sfu.ca:filename .

Linux interaction

These assignments may need you to navigate through multiple source files. If you do not have a favorite editor then I would highly recommend the following.

  • vscode, installed in your VM. You need an RDP session or VM. It will not work within a terminal. You can pull up vscode by typing code in your terminal (VM or RDP-only)
  • [emacs] is already installed in CSIL and VM.
  • Cheats emacs

C tools

  • Essential C
  • Cheats C
  • C Tutor. A tool to visualize the memory layout and objects in C programs.
  • Repl.it. To try programs without installing compiler etc on your local machine.
  • Valgrind You should use valgrind to check your code for memory leaks.
  • gdb
  • valgrind
$ valgrind -q --leak-check=full ./main

When validating memory leaks, make sure you’re using valgrind to verify that there are no leaks. However, if you’re struggling to figure out the output from valgrind or other errors in your code. We may include another tool on the VM called scan-build (Clang static analyzer). To run this, call (scan-build -k -V ./main). It will generate an HTML page that will show existing issues in the code if it can detect some. This tool will not detect all the same issues though that valgrind will, so you cannot rely on it as proof of no leaks in your code.

RISC V tools

Venus

Venus Online RISC V Simulator **Thanks To Stephan Kaminsky