wiki.chpc.ac.za

User Tools

Site Tools

You are here: start » quick » help
Trace:
quick:help

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
quick:help [2017/08/22 19:22]
ccrosby [Information to include in your support query] 		quick:help [2025/06/30 14:39] (current)
ccrosby [The Help Desk]
Line 2: Line 2:
  
 ===== The Help Desk ===== ===== The Help Desk =====
-If you need assistance, please go to [[http://users.chpc.ac.za/helpdesk|the support query page]].  However, before you do that, please ensure that you have crucial information available, and include it in your submission.+If you need assistance, please go to [[http://users.chpc.ac.za/helpdesk|the support query page]].  However, before you do that, please ensure that you have crucial information available, and include it in your submission.  It is helpful to ask yourself the following question: "What information do I need to provide to the support agent in order for that person to fully understand my difficulty?"  You can also send emails directly to [[helpdesk@chpc.ac.za]].  Using either method, **please** identify yourself with the same email address as the one used when you registered on the CHPC user portal.  This immediately links your query to your information on our user portal, which makes it easier and faster to provide assistance.
  
 ===== Please RTFM (Read The Fine Manual) ===== ===== Please RTFM (Read The Fine Manual) =====
 Before submitting the support request, please take a moment to read whatever relevant documentation is available on [[http://wiki.chpc.ac.za|the CHPC Wiki]].  The Wiki is updated as things change and we become aware of existing difficulties, solutions and workarounds.  Please check back often. Before submitting the support request, please take a moment to read whatever relevant documentation is available on [[http://wiki.chpc.ac.za|the CHPC Wiki]].  The Wiki is updated as things change and we become aware of existing difficulties, solutions and workarounds.  Please check back often.
 +
 +===== Asking for help with login problems =====
 +CHPC users log into the cluster using the secure shell protocol, or ssh.  However, there are many different software clients that can be used for this purpose, such as command line ssh from Linux, Windows or macOS, or applications such as PuTTY, MobaXterm or WinSSH.  Not all of these provide helpful information when things go wrong.  The command line tools can typically be used with additional parameters to provide helpful information.  For example:
 +<code>
 +ssh -v jblogs@lengau.chpc.ac.za
 +</code>
 +will provide some additional information and 
 +<code>
 +ssh -vv jblogs@lengau.chpc.ac.za
 +</code>
 +even more.  Simply saying "I cannot log in" does not enable us to help you.  It could be for one of many reasons, such as:
 +  - Network problems at the user's end
 +  - Network problems at the CHPC's end
 +  - Blocked login due to too many failed attempts
 +  - Forgotten or mis-typed password
 +  - A problem with the CHPC's login and authentication system
 +  - A problem with the user's ssh client software
 +
 +Here are some things that the user can try:
 +  - Use a different client
 +  - Get verbose output, as described above, to try and diagnose the problem
 +  - Check network connectivity
 +  - Check ssh login to a totally different site, if possible
 +  - Try the alternative login node, such as ''scp.chpc.ac.za'', or the CHPC's data transfer node ''dtn.chpc.ac.za''
 +
 +
  
 ===== Some hints on resolving your difficulty ===== ===== Some hints on resolving your difficulty =====
Line 15: Line 41:
   * The environment variables $PBS_O_WORKDIR, $PBS_WORKDIR nor $PBS_JOBDIR may not automatically know what your working directory is.  If you do not set these explicitly, they may have no values.  When in doubt, check.   * The environment variables $PBS_O_WORKDIR, $PBS_WORKDIR nor $PBS_JOBDIR may not automatically know what your working directory is.  If you do not set these explicitly, they may have no values.  When in doubt, check.
   * Please put some effort into estimating and requesting a realistic Walltime.  If you ask for much more than you really need, the scheduler will have to wait longer in order to find a large enough gap.   * Please put some effort into estimating and requesting a realistic Walltime.  If you ask for much more than you really need, the scheduler will have to wait longer in order to find a large enough gap.
 +  * Please try repeat a previous calculation which actually worked - please make sure to keep a backup of this previous calculation (please do not overwrite your old results).
 +  * Please confirm you are submitting to the appropriate queue. Possible queues: http://wiki.chpc.ac.za/quick:start?s[]=smp#queues
 +  * The error messages in your code's output and the standard error file are very helpful. The first instance of the error or warning is often the most significant one.
  
 ===== Information to include in your support query ===== ===== Information to include in your support query =====
 Please include the following information where relevant: Please include the following information where relevant:
-  * Your CHPC login name+  * **Your CHPC login name**
   * Your affiliation (company, university, institute, etc.)   * Your affiliation (company, university, institute, etc.)
   * A one-line summary of the project that you are working on   * A one-line summary of the project that you are working on
-  * The software that you are using +  * **The software that you are using** 
-  * The PBS job number of the failed job +  * **The PBS job number of the failed job** 
-  * The directory in which your troublesome project is located +  * **The directory in which your troublesome project is located** 
-  * As much relevant error output as you can find+  * **The name of your submit script** 
 +  * **As much relevant error output as you can find**
   * The language in which the code was written   * The language in which the code was written
   * The compiler used   * The compiler used
/app/dokuwiki/data/attic/quick/help.1503422526.txt.gz · Last modified: 2021/12/09 16:42 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 3.0 Unported
CC Attribution-Noncommercial-Share Alike 3.0 Unported Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki