Changes

Jump to: navigation, search

Tutorial 1: Using Your Matrix Server Account

1,150 bytes added, 21:43, 28 May 2021
no edit summary
:* Become efficient with '''Linux command line editing''' by using '''short-cut keys'''.
 
:* Issue a '''checking program''' (i.e. ''Shell Script'') to '''confirm''' that you accessed your Matrix account.
:* Perform '''the first section and half of the second section of online assignment #1'''.
|- valign="top" style="padding-left:15px;"
|colspan="2" |Slides:<ul><li>[https://ict.senecacollege.ca/~murray.saul/uli101/ULI101-Week1.pdf PDF] | [https://ict.senecacollege.ca/~murray.saul/uli101/ULI101-Week1.pptx PPTX]</li></ul>Tutorials:<ul><li>[[https://wiki.cdot.senecacollege.ca/wiki/Tutorial_1:_Using_Your_Matrix_Server_Account#INVESTIGATION_1:_ACCESSING_YOUR_MATRIX_LINUX_ACCOUNT HOWTO: Access Your Matrix Account]]</li><li>[http://czegel.com/seneca/uli101/lectures/Lecture1.html Les Czegel's Week 1 Notes (HTML)]</li></ul>Windows SSH client Software:<ul><li>[http://www.sfsu.edu/ftp/win/ssh/SSHSecureShellClient-3.2.9.exe SSH/SFTP]</li><li>[http://the.earth.li/%7Esgtatham/putty/latest/x86/putty.exe 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
:* Performing '''Online Linux Assignments''' ('''3''')
===Connecting to the Seneca Global PortalGlobalProtect Student VPN===[[Image:gp1.png|thumb|right|130px|'''Seneca Global PortalGlobalProtect Student VPN''' ]]
Seneca College is "rolling-out" additional measures to improve '''network security'''. One of these measures<br>is to implement '''multi-factored authentication'''. As of '''September 2020''', all Seneca College students are required<br>to connect to the '''Seneca Global PortalGlobalProtect 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 Global PortalGlobalProtect Student VPN. '''NOTE:''' If you haven't done this yet, please perform the steps provided in the following link:<br>https://employees.senecacollege.ca/spaces/77/it-services/wiki/view/3722/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>
===Connecting to Your Matrix Account===
[[Image:cli-prompt.png|right|80px|]]
After connecting to the Seneca Global PortalGlobalProtect Student VPN, you can open a '''command terminal'''<br>in your '''Newer Windows 10''', '''Mac''' or '''Linux''' computer and issue the following command:<br><br><span style="color:blue;font-weight:bold;">ssh senecauserid@matrix.senecacollege.ca</span><br><br>
[[Image:ssh-application-icon.png|right|80px|]]
You can also click on the following link to '''download''' and '''install''' a graphical SSH application for your Windows machine:<br>http://www.sfsu.edu/ftp/win/ssh/SSHSecureShellClient-3.2.9.exe<br><br>
===CONNECTING TO YOUR MATRIX ACCOUNT FROM A COMMAND LINE TERMINAL===
[[Image:gp1.png|thumb|right|130px|The '''Global PortalGlobalProtect Student VPN''' service must be connected.]]
You will now learn a quick and simple method of connecting to your Matrix account by opening<br>a text-based '''terminal''' (in any OS) and issuing the '''ssh command'''.<br><br>
'''Perform the Following Steps:'''
# Before proceeding, make certain that your '''Seneca Global Portal GlobalProtect Student VPN is connected'''.<br><br>If you haven't set this up, refer to the following link for instructions;<br>https://employees.senecacollege.ca/spaces/77/it-services/wiki/view/3722/student-vpn<br><br>'''NOTE:''' You only have to connect to your Seneca Global Portal 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>
# Click the '''Quick Connect''' button.<br><br>'''NOTE:''' The ''Connect dialog box'' allows the user to specify the '''server name''' and your '''account name''' to allow you to connect to the server.<br><br>[[Image:quick-connect-window.png|thumb|right|150px|Quick Connect Dialog Box ]]
# Click on the textbox labelled '''Hostname''' and type the text: <span style="color:blue;font-weight:bold">matrix.senecacollege.ca</span><br><br>'''NOTE:''' You can use the hostname '''matrix''' if you are at Seneca college.<br>If you where located <u>outside</u> Seneca's network, then you would need to enter<br>the <u>full</u> domain name: '''matrix.senecacollege.ca'''<br><br>You will be using the latter hostname since you will be connecting to your Matrix account remotely<br>and not within the college.<br><br>[[Image:share-public-key.png|thumb|right|150px|Dialog Box to Share Public Key on Remote Server ]]
# Click on the textbox labelled '''User Name''' and type your Seneca username (i.e. same as your Seneca userid).<br><br>
# Click the '''Connect''' button.<br><br>
# When connecting securely for the '''first time''', a '''dialog box''' will appear to share a "public key" with your Matrix account in order to make your interaction between your workstation and the remote Linux server secure within the network (i.e. encrypted to prevent unauthorized access by other users).<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<br><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 / ONLINE EVALUATION =
An '''argument''' can respresent:
:* a '''file pathname'''
:* a command '''option'''
:* a series of characters (i.e. '''text''') that the command can use
# 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>
'''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>
# 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'''
# 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 the 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 that will help them complete the online assignments.
Students whose professors do NOT assign marks for these online tutorials are encouraged to perform them for "hands-on" practice. The checking program for this tutorial is just showing proof that you were able to connect to your Matrix account from your home computer.
<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 and offer constructive feedback to allow the student on how to fix that problem so you they can re-run the checking shell scripts until you they have successfully completed a task.
# 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 (there is a '''space''' separating '''bash''' and the '''script pathname'''):<br><span style="font-family:courier;color:blue;font-weight:bold">bash /home/murray.saul/myscripts~uli101/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''' in case your ULI101 professor is assigning marks to these tutorials.<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>
===Part 2: Performing Online Assignments ===
You are required to perform '''3 online assignments''' throughout this course. This online assignment is used to teach and reinforce<br>Linux commands to gain experience for '''quizzes''', '''test 1''' (midterm ) and '''test 2''' (final exams).
In this part of the investigation, you will learn to:
* '''Select the correct section''' for assignment submission
* Perform the '''first section''' and '''3 parts of the second section''' of assignment #1
'''Perform the following steps:'''
[[Image:Assn-initial-window3.png|thumb|right|250px|Initial Assignment Window to Allow Student to Select Correct Course Section. ]]
# In your Matrix account, issue the following command:<br><span style="color:blue;font-weight:bold;font-family:courier">~uli101/a1assign1</span><br><br>
# Press '''ENTER''' at the "Notes" screen.<br><br>
# A screen similar to the one displayed on the right will appear.<br><br><span style="color:red;">'''WARNING''': You need to select the <u>'''CORRECT'''</u> section for the course which you belong to.<br>If you do <u>NOT</u> select your correct section, your assignment may not be recorded for marks!</span><br><br># Determine your '''ULI101 three-letter course section code''' from your timetable.<br><br>
# Select the '''3 letter code''' corresponding to the <u>correct</u> '''ULI101 <u>section</u>''' and '''professor''' and press <span style="color:blue;font-weight:bold">ENTER</span><br><br>
# After you have selected your course section, There will be a screen that provides several important notes before proceeding.<br>Please take a few moments to read those notes and press <span style="color:blue;font-weight:bold">ENTER</span> to proceed.<br><br>[[Image:assn-section-completion.png|thumb|right|250px|Main Assignment Window to View Which Sections Need to be Completed. ]]
# The assignment main menu will then be displayed.<br><br>'''NOTES:'''<ul><li>Near the bottom of the window, you will see '''"You are currently registered to"''' followed by the '''section letter''' and '''instructor name'''. Double-check your course timetable to confirm that this the correct section letter. If you have selected the WRONG section, type <span style="color:blue;font-weight:bold">C</span> in the menu selection area and press <span style="color:blue;font-weight:bold">ENTER</span>. You will return back to the original window to select your correct course section.<br><br></li><li>Near the top of the window displays the sections to complete in the assignment. You are NOT required to complete all sections at the same time. You can check the assignment #1 link on the ULI101 main WIKI page to note the due date for assignment #1. Sections that are NOT completed will be displayed in '''reverse text with a blue background'''. On the other hand, when you compete a section, then the section will appear as regular text<br>(i.e not in reverse text).<br><br>[[Image:assn-completed-window.png|thumb|right|250px|Main Assignment Window to Confirm Which Sections Have or Have Not Been Completed. ]]</li><li>If you want to verify that you have completed sections for the assignment, look for the text '''"Marks earned so far for ULI101 Assignment:"''' and it will show how many sections have been completed. When it shows all sections completed, then your assignment is finished and you should receive full marks provided that you have selected your correct course section.<br><br></li></ul># At the '''Selections Available''' menu assignment #1 window, enter <span style="color:blue;font-weight:bold">1</span> in the menu selection area to begin the first section called '''"Introduction to Unix Commands"'''.<br><br>
# When you have completed this section, you will be returned to the main window.<br>View the contents of this window to confirm that you completed this section.<br><br>
# When you have time this week, enter <span style="color:blue;font-weight:bold">2</span> in the menu selection area and perform the first 3 parts only<br>('''Unix Command Structure''', '''Entering and Editing Commands''', '''Using the Online Manual''').<br><br>
# When you have completed this section, you will be returned to the main window.<br>View the contents of this window to confirm that you completed this section.<br><br>'''NOTE:''' Although you are NOT allowed to use reference sheets for course evaluations, it is recommended to create one for your personal use, and write down Linux commands, their arguments and options, so your can successfully perform quizzes, midterm exam, and final exam.<br><br>
# In order to exit the assignment #1 screen, enter <span style="color:blue;font-weight:bold">q</span><br><br>
# Run Re-run the command to restart your assignment that you did in step #1 and go to the '''main menu'''.<br>What do you notice?<br><br>If you successfully completed the first two sections, they no longer appear in reverse video.<br>This indicates that you have completed the first two sections of this assignment(i.e. you do NOT have to save your work!).<br><br>
# Exit your Assignment 1, and exit your Matrix session.<br><br>
# Proceed to the next section to perform additional practice. Linux is about "doing"! The more practice questions you perform,<br>the better mark you will achieve for this course and have a better foundation of issuing Linux commands to be more productive in your future courses.<br><br>
13,420
edits

Navigation menu