Skip to content

Commit 2b15991

Browse files
committed
Added VSCode warning to Good Conduct guide
1 parent 8f10251 commit 2b15991

File tree

2 files changed

+19
-18
lines changed

2 files changed

+19
-18
lines changed

docs/basics/accounts.md

Lines changed: 0 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -20,22 +20,6 @@ In order to access any TACC compute or storage resource you must maintain an "Ac
2020

2121
## Login Problems: Resolving VSCode Issues { #vscode }
2222

23-
<!--
24-
Recent upgrades by Microsoft to the VSCode application have resulted in the program causing issues with user accounts. TACC Staff are aware of the problems users are experiencing. Until Microsoft fixes this bug, we are only able to offer possible solutions and workarounds.
25-
26-
1. Downgrade your VSCode version: Version 1.98 appears to be the most consistent and stable when connecting to TACC resources.
27-
2. Edit your .bashrc file: Connect via a terminal application to the desired compute resource and append the following line to your $HOME/.bashrc file:
28-
29-
export NODE_OPTIONS="--disable-wasm-trap-handler"
30-
31-
3. The TACC Analysis Portal (TAP) offers simplified access to common interactive sessions such as DCV, VNC, or JupyterNotebooks.
32-
33-
Important
34-
35-
36-
Also note that VSCode access is prohibited on TACC's Ranch and Corral storage resources.
37-
-->
38-
3923
Recent upgrades by Microsoft to the VSCode application have resulted in the program causing issues with user accounts. TACC Staff are aware of the problems users are experiencing. Until Microsoft fixes this bug, we are only able to offer possible solutions and workarounds.
4024

4125
1. **Downgrade your VSCode version**: Version 1.98 appears to be the most consistent and stable when connecting to TACC resources.

docs/basics/conduct.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Good Conduct on TACC's HPC Systems { #conduct }
2-
*Last Update: January 13, 2025*
2+
*Last Update: November 5, 2025*
3+
4+
## Notices
5+
6+
* VSCode users please [see below](#vscode) for updated guidance. (11/05/2025)
37

48
**You share TACC's HPC resources with many, sometimes hundreds, of other users, and what you do on the resource affects others**. All TACC account holders must follow a set of good practices which entail limiting activities that may impact the system for other users. Exercise good conduct to ensure that your activity does not adversely impact the resource and the research community with whom you share it.
59

@@ -8,14 +12,15 @@ TACC staff has developed the following guidelines to good conduct on all TACC re
812

913
## 1. Do Not Run Jobs on the Login Nodes { #conduct-loginnodes }
1014

11-
Each HPC system's login nodes are a *shared resource* amongst all users currently logged on. Depending on the system, dozens of users may be logged on at one time accessing the shared file systems. A single user running computationally expensive or disk intensive task/s may negatively impact performance for all other users.
15+
Each HPC system's login nodes are a *shared resource* amongst all users currently logged on. Depending on the system, dozens, or even hundreds, of users may be logged on at one time accessing the shared file systems. A single user running computationally expensive or disk intensive task/s may negatively impact performance for all other users.
1216

1317
!!! important
1418
Do not run jobs or perform intensive computational activity on the login nodes or the shared file systems. Your account may be suspended if your jobs are impacting other users.
1519

1620

1721
Think of the login nodes as a prep area, where you may edit and manage files, compile code, perform file management, issue transfers, submit new and track existing batch jobs etc. The login nodes provide an interface to the "back-end" compute nodes, where actual computations occur and where research is done. Hundreds of jobs may be running on all compute nodes, with hundreds more queued up to run.
1822

23+
1924
All batch jobs and executables, as well as development and debugging sessions, must be run on the compute nodes. To access compute nodes on TACC resources, one must either [submit a job to a batch queue](../../hpc/stampede3#running-sbatch) or initiate an interactive session using the [`idev`][TACCIDEV] utility.
2025

2126

@@ -26,6 +31,14 @@ All batch jobs and executables, as well as development and debugging sessions, m
2631
!!! tip
2732
The login nodes have throttled memory limits for individual processes in order to prevent users from occupying more than their fair portion of the shared resource. The compute nodes do not have this limitation.
2833

34+
### VSCode Users { #vscode }
35+
!!! warning
36+
VSCode consumes significant resources when running and can interfere with the needs of a multi-user environment such as the shared login nodes on each resource. Thus, TACC staff encourage all VSCode users to run the program on a compute node and not any of the login nodes.
37+
38+
If you choose to run VSCode on the login node and it begins to impact the system or other users, your account will be suspended and we will ask you to move to a compute node.
39+
40+
Also note that VSCode access is **prohibited** on TACC's Ranch and Corral storage resources.
41+
2942

3043
### Dos &amp; Don'ts on the Login Nodes { #conduct-loginnodes-examples }
3144

@@ -34,6 +47,7 @@ All batch jobs and executables, as well as development and debugging sessions, m
3447
This includes frameworks like MATLAB and R, as well as computationally or I/O intensive Python scripts. If you need interactive access, use the `idev` utility or Slurm's `srun` to schedule one or more compute nodes.
3548

3649

50+
<!--
3751
!!! hint "Do This"
3852
Start an interactive session on a compute node, then run Matlab.
3953
```cmd-line
@@ -47,11 +61,13 @@ All batch jobs and executables, as well as development and debugging sessions, m
4761
```cmd-line
4862
login1$ matlab
4963
```
64+
-->
5065

5166
* **Do not launch too many simultaneous processes;**
5267

5368
While it's fine to compile on a login node, a command like "`make -j 16`" (which compiles on 16 cores) may impact other users. Similarly, do not launch to many transfer sessions on the login nodes.
5469

70+
<!--
5571
!!! hint "Do This"
5672
Build and submit a batch job. All batch jobs run on the compute nodes.
5773
@@ -67,6 +83,7 @@ All batch jobs and executables, as well as development and debugging sessions, m
6783
login1$ make -j 12 # do not run intense builds/compilations on a login node
6884
login1$ ./myprogram # do not run programs on a login node
6985
```
86+
-->
7087

7188
* **That script you wrote to poll job status should probably do so once every few minutes rather than several times a second.**
7289

0 commit comments

Comments
 (0)