--> Skip to main content

Getting help on the HPC clusters

  1. Overview of getting help on HPC clusters
  2. Information to include/tips for submitting tickets
    1. Using the script command to record actions
  3. Opening a help ticket
  4. Discussion list
  5. Workshops

Overview of getting help on the HPC clusters

We are constantly trying to improve our documentation on the clusters, and we ask that for basic questions on usage and how to do things that you look at that first. We are developing a FAQ and we have general usage documentation. Kindly read this before asking questions via help tickets.

While the HPC systems staff will try to assist you on just about any question, we are generally not very familiar with the various applications used in your research, and therefore cannot always provide much useful assistance. Often such questions are best directed at your colleagues. The Division of Information Technology is trying to find ways to facilitate such collaboration (suggestions are welcome), but one mechanism currently in place is the hpcc-discuss mailing list.

Of course, not all questions are covered (or covered clearly) in the documentation, and in these cases you should open a help ticket.

And unfortunately, sometimes there are real hardware, software, or other problems with the system. While we are sometimes aware of these issues from our own monitoring, HPCCs are by their nature complicated beasts, and some issues are not easily detected from monitoring. So if you encounter an issue that you believe to be of a system nature, please open a help ticket.

Information to include/tips for submitting tickets

To help us serve you better, when you submit a help ticket, please:

Using the script command to record actions

Sometimes when diagnosing an issue, we will ask you to show us exactly what commands you issued and what they returned. Or, you need to show us a long complicated error message. An useful tool in these cases is the script command; once you issue it, it will start a new shell and log all of your input to and all the output from the new shell. This is not that useful for programs that run in a graphical environment, but provides a fairly good log for command line processes.

For example, in the following, we log the session to the file help.script in my home directory:


login-1:~: script help.script
Script started, file is help.script
login-1:~: date
Tue Oct 21 10:41:07 EDT 2014
login-1:~:  module list
Currently Loaded Modulefiles:
  1) dept/Glue
login-1:~:  ncap2
ncap2: Command not found.
login-1:~: exit
exit
Script done, file is help.script
login-1:~:
login-1:~:
login-1:~: cat help.script
Script started, file is help.script
login-1:~: date
Tue Oct 21 10:41:07 EDT 2014
login-1:~:  module list
Currently Loaded Modulefiles:
  1) dept/Glue
login-1:~:  ncap2
ncap2: Command not found.
login-1:~: exit
exit

Script done on Tue Oct 21 10:42:51 2014
login-1:~:

NOTE: Always remember to exit the shell started by the script command. And, as in the above example, it can be useful to print the contents of the file (e.g. with the cat command) to verify things were properly recorded.

Submitting a help ticket

There are several ways to actually submit the ticket to the UMD Division of Information Technology:

NOTE: The Division of Information Technology at the University of Maryland does NOT maintain the MARCC/Bluecrab HPC cluster. While you are welcome to submit a ticket to the Division of Information Technology for support with issues on the Bluecrab cluster, and we will try to assist you, many matters will require or be more readily solved by contacting the MARCC support staff. Again, please provide a reasonable subject line. If you decide to contact both support staffs on the same issue, kindly:

Discussion list

Although systems staff will try to assist you with just about any problem on the HPC clusters you request assistance with, our expertise does not extend very far into the various codes that run on the cluster, and certainly not into the science, etc. behind them. Questions of such natures are best directed at your peers and colleagues.

Because some codes are run by users in different groups across campus, the Division of Information Technology is trying to come up with ways to facilitate these collaborative discussions (suggestions are welcome). One mechanism that currently is in place is an open discussion list, hpcc-discuss. This discussion list is an open forum wherein you can ask questions of other members of the list. It is also hoped that you will take the time to assist other, newer members of the Deepthought/Deepthought2 community when they ask questions which you know the answers to.

The discussion is currently unmoderated, but the intent is to provide a place to ask technical questions regarding the use of the HPC in your research. Questions about basic Unix commands are probably not appropriate, and are better directed towards systems staff, as would be issues logging into the systems, etc. But if you have questions regarding the use of specific application software packages, especially questions more tightly coupled with specifics about your research, this is probably a good forum for that.

To join the list, either:

  1. Go to https://listserv.umd.edu, click on Subscriber's Corner, show All Lists, and select and subscribe to hpcc-discuss and hit submit.
  2. Send email to listserv@listserv.umd.edu with the contents subscribe hpcc-discuss anonymous.

After doing the above, you will get a confirmation email which contains instruction on how to complete the subscription (either reply with the line "Ok", or visit the provided URL).

You will then receive email sent to the list, and you can reply to such email or send email to hpcc-discuss@umd.edu to post a new message.

Remember, although the Division of Information Technology is making the list available, the usefulness of the list depends on users of the HPC clusters like you subscribing to the list and contributing to it.






Back to Top