Open main menu

CDOT Wiki β

Changes

Tutorial 1 - Using Your Matrix Account

16,932 bytes added, 12:14, 8 June 2023
m
Protected "Tutorial 1 - Using Your Matrix Account": OER transfer ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))
|colspan="2" style="font-size:16px;font-weight:bold;border-bottom: thin solid black;border-spacing:0px;"|Course Notes / Software<br>
|colspan="2" style="font-size:16px;font-weight:bold;border-bottom: thin solid black;border-spacing:0px;padding-left:15px;"|Linux Command/Shortcut Reference<br>
|- valign="top" style="padding-left:15px;"
|colspan="2" |Slides:<ul><li>[https://matrix.senecacollege.ca/~osl640/slides/OSL640-Week1.pdf PDF] | [https://matrix.senecacollege.ca/~osl640/slides/OSL640-Week1.pptx PPTX]</li></ul>Windows SSH client Software:<ul><li>[http://www.sfsu.edu/ftp/win/ssh/SSHSecureShellClient-3.2.9.exe SSH/SFTP]</li><li>[httphttps://thewww.earthchiark.ligreenend.org.uk/%7Esgtatham~sgtatham/putty/latest/x86/putty.exe html Putty]</li><li>[https://www.bitvise.com/ssh-client-download Bitvise SSH Client]</li><li>[https://mobaxterm.mobatek.net/download-home-edition.html MovaXterm]</li></ul>
| style="padding-left:15px;" |Matrix Account Access
[[Image:gp1.png|thumb|right|130px|'''Seneca GlobalProtect Student VPN''' ]]
Seneca College is "rolling-out" additional measures to improve '''network security'''. One of these measures is to implement '''multi-factored authentication'''. As of '''September 2020''', all Seneca College students are required to connect to the '''Seneca GlobalProtect Student VPN''' in order to be able to connect to their '''Matrix''' Linux account.<br><br>''<b>Multi-factor authentication</b> is an electronic authentication method in which a computer user is granted access to a website or application only after successfully presenting two or more pieces of evidence (or factors) to an authentication mechanism: knowledge (something the user and only the user knows).'' Reference: https://en.wikipedia.org/wiki/Multi-factor_authentication<br><br>You should have received an email message (also available in course announcements) regarding how to setup your Smart Phone to connect and valid via the Seneca GlobalProtect Student VPN. '''NOTE:''' If you haven't done this yet, please perform the steps provided in the following link:<br>https://employeesstudents.senecacollege.ca/spaces/77186/it-services/wiki/view/37221025/student-vpn<br><br>
In the next investigation, you will learn how to '''connect''' to and '''login''' to your Matrix server account from a remote computer<br>such as your '''home desktop computer''', '''laptop''' or '''tablet''' computer.<br><br>
= INVESTIGATION 1: ACCESSING YOUR MATRIX LINUX ACCOUNT =
<span style="color:red;">'''ATTENTION''': The due date for successfully completing this tutorial (i.e. tutorial 1) is by Friday, November 5th at midnight by March 10 @ 11:59 PM (Week 8).</span><br><br>
In this investigation, you will learn how to connect and login to your Matrix account by issuing a command from your computer's text-based terminal<br>and/or by downloading, installing a running a graphical Windows SSH graphical application.
'''Perform the Following Steps:'''
# Before proceeding, make certain that your '''Seneca GlobalProtect Student VPN is connected'''.<br><br>If you haven't set this up, refer to the following link for instructions;<br>https://employeesstudents.senecacollege.ca/spaces/77186/it-services/wiki/view/37221025/student-vpn<br><br>'''NOTE:''' You only have to connect to your Seneca GlobalProtect student VPN once during the day,<br>or while you are logged into your computer.<br><br>
# Determine which '''operating system''' that your computer is using.<br><br>
# Try connecting to your Matrix account using the instructions in the '''table''' below based on <u>your</u> '''current operating system'''.<br><br>
# Try moving your mouse pointer to the bottom right-hand corner of the SSH application window,<br>then '''click and drag''' outwards to make the application window larger.<br><br>
# To exit your Matrix session, type the command <span style="color:blue;font-weight:bold">exit</span> followed by '''ENTER'''<br><br>'''NOTE:''' You should notice that the colour of the text changes slightly when disconnected<br>and you are unable to issue Linux commands from that window.<br><br>
# After you have disconnected from your account, '''close''' the SSH Secure Shell Client application window.<br><br>'''NOTE:''' You are '''STRONGLY ADVISED''' to use the '''exit''' command to properly terminate your Matrix session<br>'''<u>PRIOR</u>''' to closing the SSH or terminal application window!<br><br>In the next investigation, you will learn how to '''issue Linux commands''', issue a '''checking program''' to confirm that you logged into your Matrix account, and how to <u>setup</u> and <u>perform</u> the '''first two sections of the online ULI101 assignment #1'''.<br><br>
= INVESTIGATION 2: USING THE LINUX SHELL =
 
<br>
In this investigation, you will learn how to use the Linux Shell. Topics in the section include:
 
:* Learn the basic '''Linux command structure''' (''arguments'' and ''options'')
:* Learn how to get '''help''' for Linux commands via the '''online manual''' (i.e. '''man''' command).
:* Perform '''Basic Shell Editing'''
:* Issue a '''program''' to confirm that you connected to your Matrix account
<br>
 
===Part 1: Using the Linux Shell ===
 
The Bash shell in Matrix allows you to interact with your Matrix account by issuing commands.
 
'''The General Linux Command Structure is as follows:'''<br><span style="font-family:courier;color:blue;font-weight:bold">command argument1 argument2 ... </span>
 
Some Linux commands can be issued by entering the Linux command line without arguments (e.g. '''pwd''', '''date''', '''ls''', '''cal'''),<br>but many Linux commands can be issued with arguments (e.g. '''cal 2002''', '''cd /bin''', '''ls -l -a /bin''' ).<br><br>
'''What Does an Argument Represent?'''
 
An '''argument''' can respresent:
:* a '''file pathname'''
:* a command '''option'''
:* a series of characters (i.e. '''text''') that the command can use
 
An '''argument''' is <u>separated</u> from a command (or from other arguments) by a '''SPACE''', '''MULTIPLE SPACES''' or a '''TAB'''.<br><br>
 
'''Perform the Following Steps:'''
 
# Make certain that you are logged into your Matrix account.<br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">pwd</span><br><br>The output from this Linux command basically shows your '''current location''' in the Matrix server.<br>This represents a '''directory pathname''' to your home directory. We will discuss ''pathnames'' later in this course.<br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">ls</span><br><br>What do you notice?<br><br>If there were any files in your home directory, just their file names would be displayed.<br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">cd /bin</span><br><br>
# Issue the following Linux command to confirm your current location: <span style="font-family:courier;color:blue;font-weight:bold">pwd</span><br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">ls</span><br><br>What do you notice?<br><br>
# Issue the following Linux command using an '''option''': <span style="font-family:courier;color:blue;font-weight:bold">ls -l</span><br><br>What do you notice?<br><br>The '''-l''' option with the '''ls''' command provides a '''detailed''' ("''long''") listing of files providing more information on a separate line for each file.<br><br>
# Issue the following Linux command to return to your home directory: <span style="font-family:courier;color:blue;font-weight:bold">cd</span><br><br>
# Issue the following Linux command to confirm your current location: <span style="font-family:courier;color:blue;font-weight:bold">pwd</span><br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">ls /bin</span><br><br>
# Issue the following Linux command to confirm your current location: <span style="font-family:courier;color:blue;font-weight:bold">pwd</span><br><br>What do you notice?<br><br>What makes this command with that argument useful if you are current located in your home directory?<br><br>
# Issue a Linux command that you have already learned to change to your '''home''' directory<br>and to '''confirm''' that you have returned to your home directory.<br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">clear</span><br><br>What do you notice? How would this command be helpful?<br>'''FYI:''' The short-cut keys to clear the screen for the Bash shell is: <span style="font-family:courier;color:font-weight:bold">ctrl-l</span><br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">who</span><br><br>What information does this command show?<br><br>This command lists users that are logged into the same Matrix server as yourself.<br>'''NOTE:''' Remember that the Matrix Linux cluster contains several servers, so it does not display<br>all users that are logged onto those other machines within that cluster!<br><br>
# Issue the following Linux command: <span style="color:blue;font-weight:bold">whoami</span><br><br>What does this command display? What do you think is the purpose of this command?<br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">cal</span><br><br>What is the purpose of this command?<br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">cal 2021</span><br><br>What is the purpose of this command using this argument?<br><br>
# Issue the following Linux command: <span style="font-family:courier;color:blue;font-weight:bold">cal 2 2021</span><br><br>What is the purpose of this command using those two '''numbers''' as arguments?<br><br>
'''Getting Help with Linux Commands'''
 
With the Linux OS containing over '''2500''' commands and utilities, it is good for a Linux user or <br>Linux system administrator (sysadmin) to learn about how to use commands “on-the-fly”.<br><br>
The '''man''' command can provide information on how to use a command<br>(i.e. '''command usage''', '''acceptable command arguments''', '''command options''', '''examples''').<br><br>
# Issue the following command: <span style="font-family:courier;color:blue;font-weight:bold">man man</span><br><br>You may notice that the online manual categories commands into sections or '''numbered volumes'''.<br><br>
# Type the '''SPACE''' key to move to the next screen.<br><br>How many '''volume numbers''' are contained in the man pages (like '''executable commands''',<br>'''games''', or '''system administrator commands''')?<br><br>'''TIP:''' You can use the following '''short-cut keys''' within the man command to <br>help navigate throughout this utility to get help with the ls command (refer to table below):<br><br><table cellpadding="3"><tr><th style="border-bottom: 1px solid black;">Keyboard Shortcut</th><th style="border-bottom: 1px solid black;">Purpose</th></tr><tr><td>'''ENTER'''</td><td>Move down one line</td></tr><tr><td>'''SPACEBAR'''</td><td>Move one screen down</td></tr><tr><td>'''&lt;ctrl&gt;&lt;b&gt;'''</td><td>Move one screen up</td></tr><tr><td>'''/pattern/'''</td><td>Search for Pattern</td></tr><tr><td>'''q'''</td><td>quit man utility</td></tr></table><br>
# Press the letter <span style="font-family:courier;color:blue;font-weight:bold">q</span> to exit the man command.<br><br>
# Issue the following Linux command to get help with the ls command: <span style="font-family:courier;color:blue;font-weight:bold">man ls</span><br><br>
# Navigate through the man utility for the '''ls''' Linux command and note the '''option letters''' that correspond to the following descriptions:<br><ul><li>"'''use a long lising format'''"</li><li>"'''do not ignore entries starting with .'''" (i.e. hidden files)</li><li>"'''sort by file size'''"</li><li>"'''append indicator (one of */=>&|) to entries'''" (i.e. type of file)</li></ul><br>
# Exit the man utility for the ''ls'' command.<br><br>
# Issue the '''ls''' command for <u>each</u> of those option letters you noted in '''step 4''' to see how this command differs for each option.<br><br>'''NOTE:''' The '''man''' utility can be used with the '''-k''' option to help list Linux commands that match a text pattern<br>that is contained within the help screen for a Linux command.<br><br>
# '''Pipeline commands''' can be used to filter-out unnecessary output. In the next command that you will be issuing,<br>the output from the '''man -k''' command, is sent into the '''grep''' command to ''filter'' (i.e. ''trap'') only output that matches the pattern "8"<br>(The number "8" refers to the category of type of command - in this case, administration commands).<br><br>We will learn more about pipeline commands later in this course.<br><br>
# Issue the following Linux pipeline command: <span style="font-family:courier;color:blue;font-weight:bold">man -k user | grep 8</span><br><br>How does this ''pipeline command'' make it easier to obtain information regarding man command?<br><br>
# If you wish to change your password, you can change it by issuing the command: <span style="font-family:courier;color:blue;font-weight:bold">passwd</span><br>What option for the passwd command can be used to change user info (such as name)?<br>'''Hint:''' use the '''man''' command for '''passwd'''.<br><br>
# Press the letter <span style="font-family:courier;color:blue;font-weight:bold">q</span> to exit the man command.<br><br>'''NOTE:''' Do '''NOT''' run the ''passwd'' command. Unique for this college, your Matrix password<br>is changed automatically when you change your '''myseneca''' password.<br><br>You will now learn how to perform '''command line editing'''<br>to correct syntax errors while typing Linux commands PRIOR to pressing the ENTER key.<br><br>
 
'''Command Line Editing'''
[[Image:command-line-editing.png|thumb|right|520px|Command Line Editing Shortcut Keys. ]]
 
 
Learning '''shortcut keys''' in any OS terminal will allow you to be more productive as a ''Linux user'' or ''Linux System Administrator'' (commonly referred to as: '''Linux sysadmin''').<br><br><br>Let's learn a few common Bash Shell keyboard shortcut keys and find out where you can access online help for additional shortcuts (if required).
 
 
 
'''Perform the Following Steps:'''
[[Image:meta-key.png|thumb|right|370px|To make '''alt-f''' key work, select '''Edit''' -> '''Settings''' -> '''Keyboard''', and select the checkbox '''Use ALT as Meta key (and Escape)'''.]]
# Type the following Linux command, but DON’T press the ''ENTER'' key:<br><span style="font-family:courier;color:blue;font-weight:bold">cd /bin</span><br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">ctrl-a</span> key combination. What happens?<br><br>'''NOTE:''' To make '''alt-f''' key work when use the '''GRAPHICAL Windows SSH Client application''', select '''Edit''' -> '''Settings''' -> '''Keyboard''', and select the checkbox '''Use ALT as Meta key (and Escape)'''.<br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">alt-f</span> key combination '''two times'''<br>(OPTION+right-arrow for Mac OSx).<br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">alt-b</span> key combination '''one time'''.<br>(OPTION+left-arrow for Mac OSx).<br><br><table align="right"><tr valign="top"><td>[[Image:ctrl-b.png|thumb|right|150px|'''alt-b''' moves one word backwards for Windows OS]]</td><td>[[Image:ctrl-w.png|thumb|right|150px|'''ctrl-w''' deletes a word to <u>left</u> of the cursor.]]</td><td>[[Image:new-ls.png|thumb|right|150px|After command is deleted, then type new command and press '''ctrl-e''' to move to end of the command line.]]</td></tr></table>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">ctrl-w</span> shortcut key. What happens?<br><br>
# Type the following command: <span style="font-family:courier;color:blue;font-weight:bold">ls</span><br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">ctrl-e</span> key combination<br><br>What happens?<br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">ENTER</span> key to execute the command.<br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">up arrow</span> key. What happens?<br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">ctrl-u</span> key combination. What happens?<br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">up arrow</span> key combination, and see what happens when you press <span style="font-family:courier;color:blue;font-weight:bold">BACKSPACE</span> , <span style="font-family:courier;color:blue;font-weight:bold">&lt;ctrl&gt;&lt;BACKSPACE&gt;</span> and <span style="font-family:courier;color:blue;font-weight:bold">&lt;ctrl&gt;&lt;h&gt;</span>.<br>Why is it important to know those series of key combinations?<br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">ctrl-u</span> key combination to clear the line.<br><br>
# Press the <span style="font-family:courier;color:blue;font-weight:bold">ctrl-l</span> key combination. What happens? What is the advantage of using '''ctrl-u''' as opposed to '''ctrl-l'''?<br><br>The Bash shortcut keys that you just learned are sufficient to perform Bash Shell editing.<br>Although you are NOT required to learn other short-cut keys, here is a link to a listing in case you are interested:<br>[https:// ostechnix.com/list-useful-bash-keyboard-shortcuts/ Useful Bash Shell Keyboard Shortcuts]<br><br>
'''Running a Shell Script to Check Student Online Tutorial Participation'''
 
Some professors will require students successfully perform these online tutorials for marks (within a deadline). <br>In order to confirm that you successfully performed a tutorial, you will be required to run a program<br>(or in later tutorials, several programs) to prove that you successfully completed tasks in a tutorial.
 
These programs (known as Shell Scripts) will check your work and offer feedback if you made mistakes, so you can make corrections.<br>Making corrections (i.e. troubleshooting) and re-running these checking programs until you are successful will help students<br>gain "hands-on" experience.
 
 
<table align="right"><tr valign="top"><td>[[Image:script-check-1.png|thumb|right|250px|If all all check pass, then user performed can proceed.]]</td><td>[[Image:script-check-2.png|thumb|right|450px|If there is a warning, then feedback is provided to user to correct and re-run checking script.]]</td></table>
If you have correctly completed the required tasks, the user can proceed. If the checking shell script detects an '''error''', then it will provide feedback to allow the student to fix that problem so they can re-run the checking shell scripts until they have successfully completed a task.
 
 
'''Perform the Following Steps:'''
 
# Make certain that your current directory is '''your home directory'''<br>By entering the following Linux command:<br><span style="color:blue;font-weight:bold;font-family:courier;">cd</span><br><br>
#Issue the following command to run a checking script :<br><span style="font-family:courier;color:blue;font-weight:bold">~osl640/week1-check</span><br><br>The beginning character "'''~'''" is called '''tilde'''. You get this character by pressing '''SHIFT''' + '''`'''<br>(which is the key to the left of the number 1 on your keyboard). <br><br>
# Your screen should clear and indicate that you have proved that you have successfully logged in.<br><br>
# An email will be sent to your Seneca email as '''confirmation''' that you have completed this tutorial.<br><br>Keep those confirmation email messages for the duration of this semester as proof that you have completed those checking scripts in case there is a discrepancy in tutorial grades.<br><br>
= LINUX PRACTICE QUESTIONS =
The purpose of this section is to obtain '''extra practice''' to help with '''quizzes''', your '''midterm''', and your '''final exam'''.
 
Here is a link to the [https://matrix.senecacollege.ca/~osl640/questions/osl640_week1_practice.docx MS Word Document of ALL of the questions] displayed below but with extra room to answer on the document to simulate a quiz:
 
Your instructor may take-up these questions during class. It is up to the student to attend classes in order to obtain the answers to the following questions. Your instructor will NOT provide these answers in any other form (eg. e-mail, etc).
 
 
'''Review Questions:'''
 
# What is a “'''Linux Cluster'''”? What is an advantage of using a Linux cluster?
# List '''three unique server names''' at Seneca college and briefly explain the purpose of that server.
# List the steps to connect and login to your Matrix Seneca College account on your '''laptop''' or your '''home computer'''.
# List alternative methods to connect to your Matrix account, including if you have an '''Apple Mac''' computer or are running the '''Linux''' operating system.
# List 3 unique ways to '''log-out''' of your Matrix account (not including closing the SSH window or application).
# What is the difference between a Linux '''command''' and an '''argument'''?
# What is the purpose of a Linux command '''option'''?
# What character(s) are used to '''separate''' commands and arguments?
# Create a '''table''' listing each Linux command, useful options that were mentioned in this tutorial for the following Linux commands:<br>'''pwd''' , '''cd''' , '''ls''' , '''cal''' , '''date''' , '''who''' , '''w''' , '''whoami''' , '''who am I''' , '''clear'''
 
[[Category:OSL640]]