merge and move support pages
this are now under the /support path, meaning that this is unified for all clusters.
This commit is contained in:
42
docs/support/troubleshooting.md
Normal file
42
docs/support/troubleshooting.md
Normal file
@@ -0,0 +1,42 @@
|
||||
# Troubleshooting
|
||||
|
||||
For troubleshooting, please contact us through the official channels. See
|
||||
[here](index.md) for more information.
|
||||
|
||||
## Known Problems
|
||||
|
||||
Before contacting us for support, please check the [Known
|
||||
Problems](known-problems.md) page to see if there is an existing workaround for
|
||||
your specific problem.
|
||||
|
||||
## Troubleshooting Slurm Jobs
|
||||
|
||||
If you want to report a problem or request for help when running jobs, please
|
||||
**always provide** the following information:
|
||||
|
||||
1. Provide your batch script or, alternatively, the path to your batch script.
|
||||
2. Add **always** the following commands to your batch script
|
||||
|
||||
```bash
|
||||
echo "User information:"; who am i
|
||||
echo "Running hostname:"; hostname
|
||||
echo "Current location:"; pwd
|
||||
echo "User environment:"; env
|
||||
echo "List of PModules:"; module list
|
||||
```
|
||||
|
||||
3. Whenever possible, provide the Slurm JobID.
|
||||
|
||||
Providing this information is **extremely important** in order to ease
|
||||
debugging, otherwise only with the description of the issue or just the error
|
||||
message is completely insufficient in most cases.
|
||||
|
||||
## Troubleshooting SSH
|
||||
|
||||
Use the ssh command with the "-vvv" option and copy and paste the text
|
||||
(**please don't send us screenshots**) the output to your request in
|
||||
Service-Now. Example:
|
||||
|
||||
```bash
|
||||
ssh -Y -vvv $username@<hostname>
|
||||
```
|
||||
Reference in New Issue
Block a user