HPC/Support: Difference between revisions
Line 18: | Line 18: | ||
* The '''job number'''. | * The '''job number'''. | ||
* The '''working directory''' of the job. | * The '''working directory''' of the job. | ||
=== Test directory === | |||
We may ask you to prepare a ''test directory'' which has to contain ''only'' files required by your application for a standalone run or a single PBS job. | |||
This will help to diagnose your problem and confirm resolution, especially to diagnose subtle errors that are difficult to reproduce, such as where your application runs but does not fail outright. | |||
Prepare the test directory at the same directory level as your troubled runs, and include: | |||
* the PBS job file, | |||
* input files, | |||
* any local data files, | |||
* if available, a file with the ''expected'' (correct) output, with a name different from the one generated by the job, e.g. a file with an added extension <code>.ref</code>. | |||
=== Additions required for remote access issues === | === Additions required for remote access issues === |
Revision as of 19:12, November 20, 2014
Request Suppport
For questions regarding the Carbon HPC system, first consult Frequently Asked Questions to find most answers.
Compose a support request
If your question is not answered in the FAQ, Compose an email to our help desk, as follows:
Required information
- Choose an appropriate subject line.
- Do not merely hit "Reply" on a previous unrelated message - doing so might cause your request to get overlooked in a previous thread.
- Be as specific as possible in the body of your message. Include the following:
- The command you were trying to run or the menu item you chose.
- The exact error message you get. Copy & Paste the message text, or take a screenshot and attach it to your mail.
- The path and file name of files you were working on, if applicable.
- It is generally not necessary to include in your message copies of files that already reside on Carbon.
Additions required for PBS jobs
For questions about PBS jobs:
- The job number.
- The working directory of the job.
Test directory
We may ask you to prepare a test directory which has to contain only files required by your application for a standalone run or a single PBS job. This will help to diagnose your problem and confirm resolution, especially to diagnose subtle errors that are difficult to reproduce, such as where your application runs but does not fail outright.
Prepare the test directory at the same directory level as your troubled runs, and include:
- the PBS job file,
- input files,
- any local data files,
- if available, a file with the expected (correct) output, with a name different from the one generated by the job, e.g. a file with an added extension
.ref
.
Additions required for remote access issues
When you cannot log in to mega or a Carbon login node, provide the following:
- The hostname you ran the command on (generally shown in the command prompt).
- The hostname you're trying to reach.
- The username you use to connect.
- The software name and version you use to connect (e.g. SSH, VNC, or a browser).
- Your operating system and version.
Submit
Review your subject line before you submit the message.
Send your request to:
Receiving support
When you get our support response:
- Carefully read it.
- Follow all instructions and answer all questions.
- For account- and password-related issues: it may take several hours for changes to take effect. If your initial attempt fails, wait at least that long before retrying.
Additional considerations
To help us diagnose a problem:
- Read How to Report Bugs Effectively, by Simon Tatham, programmer.
- For deeper reading, consider How To Ask Questions The Smart Way, by Eric S. Raymond, open source pioneer.