Link to this document's Jupyter Notebook

In order to successfully complete this assignment you must do the required reading, watch the provided videos and complete all instructions. The embedded survey form must be entirely filled out and submitted on or before 11:59pm on Sunday January 24. Students must come to class the next day prepared to discuss the material covered in this assignment.


Pre-Class Assignment: GetExample

Cartoon image of a toolbox with tools spilling out. We are going to learn about HPC tools in this class.

Image from: https://pixabay.com/

Goals for today's pre-class assignment

  1. Powertools
  2. Tick Trick
  3. GetExample [ref]
  4. Assignment wrap-up

1. Powertools

Read the following post about powertools on the HPCC Documentation and User Manual and then run the following commands and answer provided questions:

DO THIS: If powertools is not installed by default. Set yourself up as a power user.

  1. Log onto the HPCC
  2. Log onto a development node
  3. load the powertools module (i.e. module load powertools)
  4. run the poweruser command

If done correctly the above steps will make it so that the powertools module is installed each time you log onto the HPC. Test it by logging out then back in to the dev node and runni/ng the module list command.


2. Tick Trick

Both the powertools and poweruser command is written in bash. You can inspect the command by using the cat command on the file. However, the following will not work and should give you a "file not found" error:

cat poweruser

The problem is that cat doesn't know to loop through your system PATH to find the file. You need to explicitly tell cat the full path. Lucky for us you can use the which command to find the file location

which poweruser

You could cut and paste the output of the above command after typing cat but cut and paste can be prone to problems on different computers.

cat <<Cut and pasted output from above which command>>

Also, a good programmer is a lazy programmer. Instead we are going to use a special trick using the tick `. Note the tick is NOT the single quote but instead typically is located with the tilde ~ key on the upper left side of your keyboard. When you surround your command with the tick mark, what would normally be printed to the screen is instead passed into your command as if you typed it yourself. For example, if we want the output of the which command to be used as an input parameter for the cat command we would write the following:

cat `which poweruser`

Give it a try.

QUESTION: Who is the author of the poweruser command?

Put your answer to the above question here.

QUESTION: What year was the poweruser command created (hint you can see the modified date by typing ls -la followed by the full path to the file)?

Put your answer to the above question here.

QUESTION: Inspect the poweruser code. Give a guess as to what you think is stored in the tool variable?

Put your answer to the above question here.


3. GetExample [ref]

The powertool we will be using in class is called getexample it is a way for users to download examples for a wide variety of projects and get them running on the HPCC.

First, you can see what examples are available by typing getexample:

getexample

Then, once you see an example that looks interesting, you can type getexample again followed by the example name. For example:

getexample helloMPI

This will create a folder with the same name as the example you picked and populate the folder with files to get the example going. Just change into the example directory and look for either a "README" file or a submission script (file with the "sb" extension):

cd helloMPI
ls

QUESTION: Using the "Tick Trick" from above. What command would you use to print the contents of the getexample command to your screen?

Put your answer to the above question here.

DO THIS: Pick an example from get example, download it, and see if you can run it. Answer the following questions:

QUESTION: Which example(s) did you try to download?

Put your answer to the above question here.

QUESTION: Was the directions in the example sufficient for you to get it working? Explain what happened.

Put your answer to the above question here.

In class we will be going over a number of examples. Please remember what problems you are having and come to class with questions.


4. Assignment wrap-up

Please fill out the form that appears when you run the code below. You must completely fill this out in order to receive credits for the assignment!

Direct Link to Google Form

If you have trouble with the embedded form, please make sure you log on with your MSU google account at googleapps.msu.edu and then click on the direct link above.

Assignment-Specific QUESTION: Using the "Tick Trick" from above. What command would you use to print the contents of the getexample command to your screen?

Put your answer to the above question here

QUESTION: Summarize what you did in this assignment.

Put your answer to the above question here

QUESTION: What questions do you have, if any, about any of the topics discussed in this assignment after working through the jupyter notebook?

Put your answer to the above question here

QUESTION: How well do you feel this assignment helped you to achieve a better understanding of the above mentioned topic(s)?

Put your answer to the above question here

QUESTION: What was the most challenging part of this assignment for you?

Put your answer to the above question here

QUESTION: What was the least challenging part of this assignment for you?

Put your answer to the above question here

QUESTION: What kind of additional questions or support, if any, do you feel you need to have a better understanding of the content in this assignment?

Put your answer to the above question here

QUESTION: Do you have any further questions or comments about this material, or anything else that's going on in class?

Put your answer to the above question here

QUESTION: Approximately how long did this pre-class assignment take?

Put your answer to the above question here


Congratulations, we're done!

To get credit for this assignment you must fill out and submit the above survey from on or before the assignment due date.

Course Resources:

Written by Dr. Dirk Colbry, Michigan State University Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.