From e6ea18787534336fb79c70644a5fd95826cb7a80 Mon Sep 17 00:00:00 2001 From: Amber Lim Date: Mon, 26 Oct 2026 14:38:57 -0500 Subject: [PATCH] Formatting updates; remove deprecated issues --- .../docs/htc-known-issues.mdx | 87 +++++-------------- 1 file changed, 23 insertions(+), 64 deletions(-) diff --git a/content/uw-research-computing/docs/htc-known-issues.mdx b/content/uw-research-computing/docs/htc-known-issues.mdx index 77c0d7553..1c9e9511e 100644 --- a/content/uw-research-computing/docs/htc-known-issues.mdx +++ b/content/uw-research-computing/docs/htc-known-issues.mdx @@ -8,30 +8,32 @@ category: Troubleshooting This page documents some common and known issues encountered on the HTC system. While this page can be beneficial in troubleshooting, it does not contain a comprehensive list of errors. -Visit our [Get Help](/uw-research-computing/get-help/) page to find more resources for troubleshooting. + + + -{/* Removing since this seems to be fixed -
+## General -

[General] When submitting a job, it doesn't run / goes on hold and shows the error "Job credentials are not available".

+ +### When submitting a job, it doesn't run / goes on hold and shows the error "Job credentials are not available". + #### Cause: This is a complicated bug that can strike randomly. We're working on a fix. #### Solution: To work around this issue, run the following command on the access point before resubmitting the job. -
+ ``` echo | condor_store_cred add-oauth -s scitokens -i - ``` -
- -*/} -
+ -

[General] My job exits with an "Illegal instructions" error.

+ +### My job exits with an "Illegal instructions" error. + #### Cause: The instructions for communicating with the processor does not match between software and hardware. @@ -46,23 +48,11 @@ Then resubmit and check if this resolves the issue.
-

[General] I used generative AI to create my submit file and the job is stuck on "Idle".

- -#### Cause: -Generative AI (such as Copilot, ChatGPT, etc.) may be inaccurate. -In our experience, generative AI almost always gets something wrong when it comes to an HTCondor submit file. -This is because HTCondor has significantly changed since its creation over 40 years ago, and is highly configurable. -This means that while there is a lot of information online in forums and site-specific documentation, the information is not always relevant to our local HTC system. -As such, submit files created by generative AI are usually not applicable to our HTC system. -#### Solution: -The CHTC website provides documentation - including example submit files - for how to submit jobs on the HTC system. - -* Learn the basics of job submission here: [chtc.cs.wisc.edu/uw-research-computing/htcondor-job-submission](https://chtc.cs.wisc.edu/uw-research-computing/htcondor-job-submission). -* For submitting jobs requesting GPUs, see our dedicated GPU guide here: [chtc.cs.wisc.edu/uw-research-computing/gpu-jobs](https://chtc.cs.wisc.edu/uw-research-computing/gpu-jobs). - -
+## Containers -

[Container] When building an Apptainer, "apt" commands in the %post block fail to run.

+ +### When building an Apptainer, "apt" commands in the %post block fail to run. + #### Example error message: @@ -88,10 +78,9 @@ From: ubuntu:22.04 ``` We also recommend using the `-y` option to prevent installation from hanging due to interactive prompts. - -
- -

[Container] After submitting a job with a Docker container, it goes on hold with a message like, "Cannot pull image user/repo:tag".

+ +### After submitting a job with a Docker container, it goes on hold with a message like, "Cannot pull image user/repo:tag". + #### Cause: The Docker container is likely built on an Apple computer using an ARM processor, which is incompatible with Linux machines. @@ -107,9 +96,9 @@ docker build --platform linux/amd64 . -
- -

[Container] My interactive Apptainer job is failing with the error message, "Can't open master pty Bad file descriptor".

+ +### My interactive Apptainer job is failing with the error message, "Can't open master pty Bad file descriptor". + #### Cause: Interactive Apptainer jobs are incompatible with CentOS7 machines. @@ -121,36 +110,6 @@ requirements = (OpSysMajorVer > 7)
-

[GPU] My GPU job has been in the queue for a long period of time and is not starting.

- -#### Cause: -To use our shared use GPU machines, you must opt into the GPU Lab. -#### Solution: -To your submit file, add the following line and resubmit: -``` -+WantGPULab = true -``` - -
-
- -

[General, Python] My job has an error that mentions /home/netid/ or the root directory /.

- -#### Cause: -Sometimes programs assume that they can write into the `/home` or root `/` directory. However, these directories are not writeable on the Execution Points. - -#### Solution: -To your executable (`.sh` script), add the following line and resubmit: -``` -export HOME=$PWD -``` -This will change the `HOME` environment variable to the working directory on the Execution Point. - -For any items referencing the root directory `/`, try the solution suggested above. If that does not fix the issue, you will need to find where your code or program is referencing the root directory and change it to the current working directory. Please [email us or drop by office hours](/uw-research-computing/get-help/) if you need assistance with this. - -
-
- - ## Can't find your issue? + Visit our [Get Help](/uw-research-computing/get-help/) page.