Open main menu

CDOT Wiki β

OPS705 Lab 2 (2227)

Revision as of 23:23, 10 September 2022 by Chris.johnson (talk | contribs) (Created page with "= LAB PREPARATION = === Purpose / Objectives of Lab 2 === Understanding how to use a command line interface (CLI) is an incredibly useful skillset as application developers....")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

LAB PREPARATION

Purpose / Objectives of Lab 2

Understanding how to use a command line interface (CLI) is an incredibly useful skillset as application developers. It is present in all major operating systems, and is often how you will interact with tools and databases to accomplish tasks a GUI doesn't provide.

In this lab, you will practice working with the Linux command line environment inside your Azure CentOS VM to:

  1. Understand the purpose of directories and directory pathnames.
  2. Use common Linux commands to perform directory management tasks.
  3. Use text editors to create and modify text files.
  4. Use common Linux commands to manage and manipulate text files.

If you encounter technical issues, please contact your professor via e-mail or in your section's Microsoft Teams group.

Minimum Requirements

Before beginning, you must have:

  1. Successfully completed Lab 1
  2. Attended the Week 2 class lecture
  3. Read through the Week 2 slides, and have them handy as a reference for concepts
  4. Your username-lnx CentOS VM in Azure
  5. Your Seneca Azure login credentials
  6. Your linked mobile device for 2FA

KEY CONCEPTS

Linux Directories

 
In Unix / Linux (as opposed to MS Windows), there are no drive letters (such as C:, or D:).

All files and directories appear under a single ancestor directory called "the root directory".

To better organize files (text, images, documents, spreadsheets, programs, etc) within your Linux system, they should be stored in directories. To further organize many files, directories may contain sub-directories.

The Linux file system is hierarchical, like other operating systems such as Windows, macOS, etc. In Linux (as opposed to Windows), there are no drive letters (such as C:, or D:). All files and directories appear under a single ancestor directory called the "root directory".

Learning how to issue Linux commands for navigating and manipulating directory and files within the the Linux filesystem are essential skills for Linux users and Linux system administrators (i.e. sysadmins).

In the Linux OS, the root directory / is the starting directory, and other child directories, grandchild directories, etc. can be created as required. This hierarchical structure resembles an "upside-down tree". There is actually a command called tree that displays a directory tree diagram!

Directory Pathnames

 
A pathname points to a file system location by following the directory tree hierarchy.
A pathname is used to specify a route to a file within the file system. A pathname points to a file system location by following the directory tree hierarchy expressed in a string of characters in which path components, separated by a delimiting character, represent each directory. The delimiting character is most commonly the slash ("/"). (Reference: [[1]])

The following table displays and defines commonly used directories (listed by directory pathname) for for ALL Linux filesystems:

Directory Pathname Purpose
/ Root directory (ancestor to all directories)
 
Common directory pathnames for for ALL Linux Filesystems.
/home Used to store all users’ home directories
/home/username/ A specific user's home directory
/bin Common system binaries (commands)
/usr/bin Common utilities (commands) for users.
"'/usr/sbin Common utilities for system administration
/etc System administration files (eg. passwd)
/var Dynamic files (log and mail files)
/tmp , /var/tmp Temporary files for programs
/dev Device driver files (terminals, printers, etc.)

When you log into your Linux user account, you are automatically directed to your home directory. This directory is where the user can store files and create subdirectories to organize their files.

INVESTIGATION 1: Creating and Managing Directories

In this investigation, you will learn how to create, navigate, list directory contents and remove directories in your user account.

Directory File Naming Rules

Before you learn how to create directories, it is important to understand what represents an appropriate directory filename.

Listed below are some common file naming rules:

  • Linux characters are case-sensitive. It is recommended to be consistent (e.g. use all lowercase letters)
  • Adopt a consistent directory naming scheme (this will help you to navigate within your directory structure)
  • Make your directory names meaningful
  • Avoid non-alphanumeric characters, as they may have a special meaning to the system that will make your work more difficult when changing to directories, etc.
  • Avoid using spaces for directory names (consider periods, hyphens, and underscores instead)

Part 1: Directory Creation

 
Fig. 4: Tree diagram of directory structure to create in your home directory (displayed in blue text).

Creating subdirectories within your home directory makes it more efficient to save and access files on your Linux server.

A comparison would be rooms in a house. If there were no rooms, just one large room in a 3,000 square foot house, it would be "messy" and difficult to locate items. Each room in a house is used to for a specific purpose to be more productive to perform a task such as a kitchen, bedroom, bathroom, etc.

You will be creating the following directory structure within your home directory (refer to diagram on the right side (Fig. 4)).

Creating Directories

We will now create our first level of directories.

IMPORTANT: For the following commands, you will be using your Seneca username to replace the text "your-seneca-id" in a pathname.
For example, if your Seneca user ID was mkhan then you would write the pathname /home/your-seneca-id as: /home/mkhan

Perform the following steps:

  1. SSH into your CentOS Linux account (Refer to Week 2 slides).
  2. Issue a command to confirm that you are located in your home directory (/home/your-seneca-id): pwd
  3. Issue the following Linux command: mkdir /home/your-seneca-id/uli101xx
    • NOTE: You should always confirm that you have created a directory. This can be done by issuing the ls command.
       
      Creating and confirming the creation of a directory.
  4. Issue the following Linux command: ls /home/your-seneca-id/uli101xx
    • There are no contents that are contained in this newly-created directory; therefore, no contents appear. A useful option -d can be used to confirm that the actual directory has been created as opposed to viewing the contents of the directory.
  5. Issue the following Linux command: ls -d /home/your-seneca-id/uli101xx
    • You should now see just the directory listed. You can also combine the -d and -l options to provide more detail regarding the newly-created directory.
  6. Issue the following Linux command: ls -d -l /home/your-seneca-id/uli101xx
    • How can you confirm from the output of this command that the file uli101xx is a directory?
  7. Issue the following Linux command: ls -ld /home/your-seneca-id/uli101xx
    • Is the output from this command the same was the output from the previous command?
    • If so, what does this say about how to use multiple options for Linux commands?
  8. Issue the following Linux command to create the acp100xx and xyz100xx directories: mkdir /home/your-seneca-id/acp100xx /home/your-seneca-id/xyz100xx
    • NOTE: You can create multiple directories by issuing the mkdir command with multiple arguments.
  9. Issue the following Linux command to confirm that those directories have been created: ls -ld /home/your-seneca-id/acp100xx /home/your-seneca-id/xyz100xx
    • Using a FULL pathname starting from the root directory (i.e. /) requires is a LOT of typing!
    • Since we are already located in our home directory, we don't have to start from the root directory. This is called a "relative" pathname. See the next instruction for an example.

Creating Subdirectories

We will now create the subdirectories that are contained in the uli101xx directory:

  1. Move to the uli101xx directory using a relative pathname: cd uli101xx
  2. Confirm that your current location is in the uli101xx directory (/home/your-seneca-id/uli101xx): pwd
  3. Create the directories called notes, tutorials and samples: mkdir notes tutorials samples
  4. Confirm that those directories have been created: ls

There are better ways to create the same directory structure without using the cd command.

Creating Subdirectories Without cd

Issuing the cd command prior to issuing other commands indicates to others that you are a novice or "newbie". You can actually lose marks on quizzes or tests if you issue multiple Linux commands to performed tasks that can be performed using a single Linux command with pathnames.

Here we'll show you how to create directories and subdirectories without having to move inside them.

First, return to your home directory:

  1. Return to your home directory: cd
  2. Confirm that you are now located in your home directory (/home/your-seneca-id): pwd

Although we will teach you how to remove directories and their contents in another investigation, let's remove the created directory structure and recreate the same directory structure using just one command using pathnames:

  1. Remove all of the directories that you have created: rm -r uli101xx acp100xx xyz100xx
  2. Confirm that the uli101xx, acp100xx and xyz100xx have been removed: ls
  3. Issue the following single Linux command to create the entire directory structure: mkdir -p uli101xx/notes uli101xx/tutorials uli101xx/samples acp100xx xyz100xx
    • NOTE: The -p option allows "parent" directories to be automatically created first to then create their subdirectories.
  4. Confirm that all of the directories have been created: ls -ld uli101xx/ uli101xx/notes uli101xx/tutorials uli101xx/samples acp100xx xyz100xx

Running a Shell Script to Check Your Work

Although you are being asked to create the directory structure, you might have made some mistakes.

For example:

  • Forgetting to create a directory.
  • Making syntax errors (eg. spelling or mixing up character case)
  • Not creating subdirectories within specified directories.

To check for mistakes, a shell script has been created to check your work. If the checking shell script detects an error, then it will provide feedback and offer constructive feedback on how to fix that problem so you can re-run the checking shell scripts until your work is correct.

Perform the following steps:

 
If all check pass, then user performed task correctly and can continue.
 
If there is a warning, then feedback is provided to user to correct and re-run checking script.
  1. Make certain that your current directory is your home directory.
  2. Create a new directory called bin: mkdir bin
  3. Download the Part 1 checking script: wget urlhere -P /home/your-seneca-id/bin/
  4. Move back to your home directory.
  5. Run the checking script for Part 1: check_lab2-part1
    • If you encounter errors, then view the feedback to make corrections, and then re-run the checking script.
    • If you receive a congratulations message that there are no errors, then proceed to the next part.

Part 2: Viewing Directory Contents / Copying & Moving Directories

Now that you have learned how to efficiently create your directory structure, you will now learn how to issue Linux commands to view directory contents as well as copy and move directories.

Perform the following steps:

 
Output of the tree command to display directory structure.
 
Output of the ls -R command to display directory structure.
 
Output of the tree command to confirm copy of uli101xx directory (and contents) to the xyz100xx directory.
 
Output of the tree command to confirm movement of acp100 directory directory (and contents) to the xyz100xx diredtory.
  1. Issue the following Linux command: tree
    • NOTE: You should see the directory structure that you created in the previous investigation. You can also issue the tree command combined with a directory pathname to display the directory structure for a specific scope.
    • You can also use the -R option for the ls command to display all directories and subdirectories for a specified directory path (referred to as a recursive directory listing).
  2. Issue the following Linux command: ls -lR
    • What directories do you see?
  3. Issue the following Linux command: ls -lR uli101xx
    • Note the differences between both of these commands (i.e. using and not using a pathname).
  4. You can copy and move entire directories (and their contents) to other directories. Issue the following Linux command: cp -R uli101xx xyz100xx
  5. Display the directory structure of your home directory to confirm you copied the uli101xx directory: tree
  6. Issue the following Linux command: mv acp100xx xyz100xx/uli101xx/tutorials
  7. Display the directory structure of your home directory to confirm you moved the acp100xx directory: </code>tree</code>

Let's run a checking script to see if you moved and copied the directories correctly:

  1. Make certain that your current directory is your home directory.
  2. Download the Part 2 checking script: wget urlhere -P /home/your-seneca-id/bin/
  3. Run the checking script for Part 2: check_lab2-part2

If you encounter errors, make corrections and re-run the checking script until you receive a congratulations message.

Proceed to Part 3.

Part 3: Removing Directories

You will now learn how to safely remove directories and their contents.

Perform the following steps:

  1. Confirm that you are located in your home directory.
  2. The rmdir command is used to remove empty directories. Remove the empty directory called tutorials: rmdir uli101xx/tutorials
  3. Confirm that you removed the tutorials directory.
  4. Remove the empty directory called uli101xx: rmdir uli101xx
    • NOTE: You should get an error message, since the uli101xx directory is NOT empty.
  5. To remove non-empty directories, you can use the rm -r option, which can travel down the directory paths and their contents: rm -r uli101xx
  6. Confirm that the uli101xx directory (contained in your home directory) and its contents have been removed.
    • NOTE: To safely remove non-empty directories, you can add the -i option, which will prompt the user if they wish to remove contents as it your travel recursively down a directory to remove directories and their contents.
  7. Issue the following Linux command (entering "y" when prompted): rm -ri xyz100xx
    • NOTE: You should have removed all directories that you have created.

Let's run a checking script to confirm that you have correctly removed all of those directories:

  1. Make certain that your current directory is your home directory.
  2. Issue the tree command to confirm that all of those recently created directories have been removed.
  3. Download the Part 3 checking script: wget urlhere -P /home/your-seneca-id/bin/
  4. Run the checking script for Part 3: check_lab2-part3

If you encounter errors, make corrections and re-run the checking script until you receive a congratulations message.

Proceed to the next investigation.

INVESTIGATION 2: Managing Text Files

As you will be working in the Linux command line environment, it is useful to learn a least one common command-line text editors.

Although programmers and developers usually use graphical IDE's to code and compile programs (Visual Studio, Sublime, Eclipse, etc), they can create source code using a text editor and compile their code directly on the server to generate executable programs (without having to transfer them for compilation or execution).

Developers very often use a text editor to modify configuration files. In this course, you will become familiar with the process of installing, configuring, and running network services. Text editors are an important tool to help this setup, but are also used to "tweak" or make periodic changes in service configurations.

The two most readily-available command line text editors in Linux are nano and vi.

The nano text editor would seem like an easier-to-use text editor, but vi (although taking longer to learn) has outstanding features and allow the user to be more productive with editing text files.

Part 1: Creating Text Files Using The vi Text Editor

 
The online vi-tutorial provides users "hands-on" experience of using the vi text editor.

You will now learn basic editing skills using the vi (vim) text editor including creating, editing, and saving text files. As mentioned, the vim text editor (although taking longer to learn) has outstanding features to increase coding productivity.

(Vim is a newer version of vi with expanded features. We will be using vim in this course. In most cases, vi and vim can be used interchangeably here.)

The big thing to remember with vim is that it starts in COMMAND mode. You need to issue letter commands to change modes (including to enter plain text into the document). Also, you can press colon “: ” in COMMAND mode to enter more complex commands.

Resource: vi Cheat Sheet (PDF)

An online tutorial has been created to give you "hands-on" experience on how to use vi text editor. It is recommended that you run this interactive tutorial in your Linux account to learn how to create and edit text files with the vi text editor.

  1. Make certain that your current directory is your home directory.
  2. Download the interactive vi tutorial: wget vi-tutorial -P /home/your-seneca-id/bin/
  3. Run the interactive tutorial: vi-tutorial
  4. In the tutorial menu, select the first menu item labelled "USING THE VI TEXT EDITOR"
  5. Read and follow the instructions in the tutorial. Eventually, it will display a simulated vi environment and will provide you with "hands-on" practice using the vi text editor.
  6. When you have completed that section, you will be returned to the main menu.
  7. If you want to get extra practice, you can select the menu item labelled "REVIEW EXERCISE".
  8. When you want to exit the tutorial, select the menu option to exit the tutorial.
 
Fig. 10: Contents of othertext.txt

After you have completed the tutorial:

  1. Using vim, create a new text file called othertext.txt in your home directory.
  2. Write the text shown in Fig. 10 to your new othertext.txt file, save, and quit.

Part 2: Manage and Manipulate Text File Content

We conclude this tutorial by learning to manage, view or manipulate the display of text files.

This is HIGHLY ADVISED in case you only want to view contents and NOT edit text file contents which can cause accidental erasure of data.

Refer to the following table of Text File Management Commands:

Linux Command Purpose Example
touch Create empty file(s) / Updates Existing File's Date/Time Stamp touch otherfile.txt
cat Display text file's contents without editing (small files) cat otherfile.txt
more , less Display / Navigate within large text files without editing less otherfile.txt
cp Copy text file(s) cp otherfile.txt uli101xx/otherfile.txt
mv Move / Rename text files mv otherfile.txt uli101xx/otherfile.txt
rm Remove text file(s) rm otherfile.txt
sort Sorts (rearranges) order of file contents when displayed. Content is sorted alphabetically by default. The -nItalic text option sorts numerically, -r performs a reverse sort sort otherfile.txt
head Displays the first 10 lines of a text file by default. An option using a number value will display that number of lines (e.g. head -5 filename will display first 5 lines). head -2 otherfile.txt
tail Displays the last 10 lines of a text file by default. An option using a number value will display that number of lines (e.g. tail -5 filename will display last 5 lines). tail -2 otherfile.txt
grep Displays file contents that match a pattern grep "third" otherfile.txt
uniq Displays identical consecutive lines only once uniq otherfile.txt
diff file1 file2 Displays differences between 2 files diff otherfile.txt otherfile2.txt
file Gives info about the contents of the file (e.g. file with no extension). file othertext.txt

Perform the following steps:

  1. Make certain that you are located in your home directory.
  2. Create three empty text files in your current directory: touch a.txt b.txt c.txt
  3. Issue the following Linux command: ls -l a.txt b.txt c.txt
    • Check the size in the detailed listing to confirm that these newly-created files are empty.
       
      Nano text editor containing numbers 1 to 40
      on separate lines.
  4. Use the vim text editor to edit the empty file called a.txt.
  5. Type the number "1" and press ENTER. On the second line, type the number "2" and press ENTER.
  6. Continue entering increasing number values until you reach the number 40 on line 40. (refer to the diagram on the right).
  7. Save and exit your editing session.
  8. Issue the following Linux command: cat a.txt
    • Can you see all of the contents?
  9. Issue the following Linux command: more a.txt
    • NOTE: The more command uses the same navigation keys as with the man command. Try using keys that you used to navigate the manual pages.
    • What is the advantage of using the more command?
  10. Type the letter q to exit the more command.
  11. Issue the following Linux command: less a.txt
    • Is there any difference between the more and less commands?
  12. Type the letter q to exit the less command.
  13. Issue the following Linux command: sort a.txt
    • Why does the output not look what you expected? Why?
  14. Issue the following Linux command: sort -n a.txt
  15. Try the same command using both the -n and -r options to see what happens.
  16. Issue the following Linux command: head a.txt
    • What is the output from this command display?
  17. Issue the following Linux command: head -7 a.txt
    • What is the output from this command display?
  18. Issue the following Linux command: tail a.txt
    • What is the output from this command display?
    • How would you issue this command to display only the last line contained in that file?
  19. Issue the following Linux command: grep 2 a.txt
     
    Edit the a.txt file and add to the bottom 5 new lines each consisting of the same text: "end of line".
    • What type of output appear? Why did these lines appear (what do they all have in common)?
  20. Edit the a.txt file and add to the bottom 5 new lines each consisting of the same text: "end of line" (refer to diagram on right).
  21. Save your editing session and exit your text editor.
  22. Issue the following Linux command: uniq a.txt
    • What do you notice happened to those newly created lines?
  23. Issue the following Linux command: cp a.txt a.txt.bk
  24. Issue the following Linux command: cp a.txt b.txt
  25. Issue the following Linux command: mv a.txt aa.txt
  26. Issue a Linux command to view the directory contents.
    • What happened to the file called a.txt? Why?
  27. Issue the following Linux command: file b.txt
    • What sort of information did it provide?
  28. Issue the following Linux command: diff aa.txt b.txt
    • Was there any output? If not, why?
  29. Issue the following Linux command: diff aa.txt c.txt
    • What do you think is the purpose of this output?
  30. Issue the following Linux command: find -P .
    • What is the output of this command?
  31. Issue the following Linux command: rm aa.txt b.txt a.txt.bk c.txt
  32. Issue the ls command to verify that these files have been removed.

Lab Submission

When complete, show your instructor the following in-class:

  1. A successful run of check_lab2-part1
  2. A successful run of check_lab2-part2
  3. A successful run of check_lab2-part3
  4. In vim, the completed version of othertext.txt

Make sure to fully stop your VMs when you're done!