Using Fedora SoC - nus-cs2030/2021-s1 GitHub Wiki

This page will explain how to start up the PE on Fedora SoC.

Important PE Instructions:

  1. Logging in
  2. Connecting to the Internet and VPN
  3. Beginning the PE
  4. Viewing Java Docs
  5. Ending the PE

Miscellaneous Instructions:

  1. Changing Keyboard Layout
  2. Splitting screens

Logging in

First, you will be prompted to log in. Log in with CS2030.

fedora_login

Your Fedora SoC version will be shown. Ensure that the version you are using is the latest one found in the Downloads page before proceeding to the next step. Problems with previous versions will not be entertained.

fedora_version

Next, you need to choose a font size. Test out any integer from 0 - 8 and enter q when you are done.

fedora_font_size

If you are using a Mac, you will be asked to adjust your resolution.

PC users may skip to entering your NUSNET id.

First, adjust the number of columns such that the + is at the right edge of your screen.

fedora_col_adjust

Then, adjust the number of rows such that the line Adjust rows resolution (this should be the last line) or 'c' to continue: is at the bottom edge of your screen.

fedora_row_adjust

PC users resume here.

Then, you will be asked to enter your NUSNET id E0XXXXXX (the 'E' has to be in uppercase).

After entering, you will be asked to double check your NUSNET id, enter y if it is correct, and N if it is wrong.

fedora_nusnet

If you have any issues and you are using a Mac, please report them here

Connecting to the Internet and VPN

If you are already connected to the Internet:

You will asked to enter your password to connect to the VPN. Enter your NUSNET password and press Enter.

fedora_vpn

DISCLAIMER: Your password will not be recorded, it will be directly uploaded to the authentication server.

If you are not connected to the Internet:

You will be asked to connect to the Internet. Press "enter".

Use arrow keys to select Activate a connection and press Enter.

nmtui_activate

You will see a list of available Wi-Fi networks. Select the correct one and press Enter.

nmtui_select

Once connected, there will be an asterisk (*) beside the Wi-Fi network to show that you are connected.

nmtui_activated

Then, scroll down the list until you see the section labelled VPN.

Select NUSSTU-SoC and press Enter.

nmtui_activate_vpn

You will be prompted for a password. Enter your NUSNET password and press Enter.

DISCLAIMER: Your password will not be recorded, it will be directly uploaded to the authentication server.

nmtui_vpn_pw

Once connected, there will be an asterisk (*) beside NUSSTU-SoC to show that you are connected.

nmtui_vpn_done

If successful, you are now connected to internet and NUS SoC VPN! Press Esc twice to exit nmtui.

Beginning the PE

You will be asked if you would like to connect to the PE, enter y to connect, and N otherwise.

fedora_connect

You will then be asked to enter your plab account and server plabXXXX@peYYY.

Then, you will be asked to enter your plab password.

fedora_plab

After entering your password, the PE will automatically begin.

DISCLAIMER: Your screen will be recorded during the PE for invigilation purposes.

Upon successful login, you will see this screen and the PE will have started.

fedora_pe_start

You can view these commands by entering start-pe.

Viewing Java Docs

To open Java Docs, use see-browser.

You will be asked if you want to continue to the browser. Enter y to continue, or N if you change your mind.

fedora_see_javadocs

To go back to the command line interface, press Esc or `.

You can return to the Java Docs by pressing Ctrl+ Alt + F2.

Ending the PE

When you are done with the PE, enter end-pe to stop the PE.

You will be asked to confirm if you want to exit. Enter y to confirm, enter N if you don't want to end yet.

Your files will then be automatically uploaded for you.

You will receive the message below when the upload is complete.

fedora_upload

Type and enter check-submission to get a QR code for your submission.

Take a picture of the QR code and keep it.

Enter exit to exit the ssh. Then you may power off your machine.

Congratulations! You have completed the PE.

Changing Keyboard Layout

The default keyboard layout may not be correct for your machine. View all available keyboard layouts using the command localectl list-keymaps | less

Set your desired keyboard layout using loadkeys, referencing the layout from the previous command. For example, to set the US keyboard:

loadkeys us

Splitting screens

If you want to split your screen (e.g. to use elinks on one side and vim on the other), first enter tmux.

You should now see a green bar at the bottom of your screen.

tmux-begin

To split your screen vertically, press Ctrl + B (Control + B on Mac). Then press the % key.

tmux-vertical

To split your screen horizontally, press Ctrl + B (Control + B on Mac). Then press the " key.

tmux-horizontal

To move between screens, press Ctrl + B (Control + B on Mac), then press the Up, Down, Left or Right key to navigate.

To close a screen, press Ctrl + B (Control + B on Mac), then press the 'X' key. The bar at the bottom will turn orange and ask if you would like to kill-pane X?. Then enter y to close or n if you change your mind.

tmux-delete