Skip to content

Commit 9aa6c12

Browse files
susanunitsusanunit
committed
Accounts: added VSCode instructions
1 parent 58e07cb commit 9aa6c12

File tree

1 file changed

+69
-33
lines changed

1 file changed

+69
-33
lines changed

‎docs/basics/accounts.md‎

Lines changed: 69 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,39 @@
1-
<style>
2-
.grid {
3-
grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
4-
}
5-
</style>
6-
7-
81
# Managing your TACC Account
9-
*Last update: April 14, 2025*
10-
11-
## Notices
2+
*Last update: November 3, 2025*
123

13-
!!! warning
14-
Beginning immediately, all TACC account holders are required to have an active MFA pairing. If you do not have an active MFA pairing your account will be deactivated.
15-
16-
In order to access any TACC compute or storage resource you must maintain an "Active" TACC user account. You may view your account status at any time on the [TACC Accounts Portal][TACCACCOUNTS] in the User Profile section. [Table 1.](#table1) below lists all possible conditions for your account.
174

5+
## Notices
186

19-
!!! tip
20-
If you are having login issues see TACC's [Login Support Tool][TACCLOGINSUPPORT] to resolve problems.
7+
* (11/03/2025) **VSCode users: TACC staff are aware of the difficulties VSCode users are experiencing when attempting to login to TACC HPC resources.** Please see [Resolving VSCode issues](#vscode) below.
8+
* (04/14/2025) Beginning immediately, all TACC account holders are required to have an active MFA pairing. If you do not have an active MFA pairing your account will be deactivated.
219

22-
If your [account status](#table1) is "Active" and you still can't login, try [un-pairing and re-pairing your MFA device][TACCMFA].
10+
## How to Access TACC Resources
2311

12+
In order to access any TACC compute or storage resource you must maintain an "Active" TACC user account. You may view your account status at any time on the [TACC Accounts Portal][TACCACCOUNTS] in the User Profile section. [Table 1.](#table1) below lists all possible conditions for your account. New users please see the [New Accounts](#newaccounts) section below. If you are a current user having issues logging in, see TACC's [Login Support Tool][TACCLOGINSUPPORT] to resolve problems.
2413

25-
## Deactivated Accounts
14+
!!! important
15+
An active TACC user account does not guarantee or imply access to any of TACC's compute resources. You must be added to an active allocation in order to gain access to that project's resources.
2616

27-
If you have not accessed your account within the past 120 consecutive days, your account will be automatically deactivated in accordance with UT's [security protocols](https://security.utexas.edu/policies/irusp). To re-activate your acccount, login to the [TACC Accounts Portal][TACCACCOUNTS] and request an activation link.
2817

29-
!!! important
30-
Once you have re-activated your account, you will need to [un-pair and re-pair][TACCMFA] your two-factor authentication.
18+
!!! tip
19+
If your [account status](#table1) is "Active" and you still can't login, try [un-pairing and re-pairing your MFA device](https://docs.tacc.utexas.edu/basics/mfa/#unpair).
3120

32-
## New Accounts
3321

22+
## Login Problems: Resolving VSCode Issues { #vscode }
3423

35-
Any user of TACC resources must first obtain a TACC account. A TACC account email is of the form *username*@tacc.utexas.edu. All new users are required to authenticate with a [UT approved Identity Provider](#identity-management).
24+
Recent upgrades by Microsoft to the VSCode application have rendered it incompatible when trying to access TACC's compute resources. 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.
3625

37-
To create a new account:
26+
* **Downgrade your VSCode version**: Version 1.98, in particular, has been seen to be the most consistent and stable when connecting to TACC resources.
27+
* **Edit your .bashrc file:** Connect via a terminal application to your compute resource and append the following line to your `$HOME/.bashrc` file:
3828

39-
1. Go to the [TACC Accounts Portal][TACCACCOUNTS] and click "Create a New Account" to begin registration.
40-
1. Set up [Multi-Factor Authentication][TACCMFA] (MFA) on your account.
41-
1. Check for an email containing a confirmation and activation link. Once you confirm your email, your account status will update to either "Pending" or "Active".
42-
1. If your account status is "Pending" then your account request will need further review by our User Services team. No action is required and a team member will reach to you.
43-
1. Once your account is "Active" log onto the [TACC User Portal][TACCUSERPORTAL] to view your allocation status.
29+
export NODE_OPTIONS="--disable-wasm-trap-handler"
4430

45-
!!! warning
46-
An individual may not have more than one TACC account. Shared accounts and/or multi-user accounts are strictly prohibited.
31+
* The [TACC Analyis Portal][TACCANALYSISPORTAL] (TAP) offers simplified access to common interactive sessions.
4732

48-
!!! tip
49-
In order to log on to TACC's HPC resources, your TACC account must be "[Active](#table1)" **AND** you must have an active allocation on that particular resource.
33+
!!! important
34+
VSCode is a voracious consumer of resources and thus is inherently disrespectful to the needs of a multi-user environment, e.g. the shared login nodes. Thus, TACC staff discourages developing/editing your code with VSCode on any TACC resources.
5035

36+
Also note that VSCode access is **prohibited** on TACC's Ranch and Corral storage resources.
5137

5238
## Login Problems: `Improper ssh Configuration!`
5339

@@ -77,6 +63,26 @@ This is most likely because you have modified your `./ssh/known_hosts` file. Th
7763
3. Log out of the system and then log back in. This will auto-generate a new `.ssh` folder and key for you.
7864

7965

66+
## New Accounts { #newaccounts }
67+
68+
Any user of TACC resources must first obtain a TACC account. A TACC account email is of the form *username*@tacc.utexas.edu. All new users are required to authenticate with a [UT approved Identity Provider](#identity-management).
69+
70+
To create a new account:
71+
72+
1. Go to the [TACC Accounts Portal][TACCACCOUNTS] and click "Create a New Account" to begin registration.
73+
1. Set up [Multi-Factor Authentication][TACCMFA] (MFA) on your account.
74+
1. Check for an email containing a confirmation and activation link. Once you confirm your email, your account status will update to either "Pending" or "Active".
75+
1. If your account status is "Pending" then your account request will need further review by our User Services team. No action is required and a team member will reach to you.
76+
1. Once your account is "Active" log onto the [TACC User Portal][TACCUSERPORTAL] to view your allocation status.
77+
78+
!!! warning
79+
An individual may not have more than one TACC account. Shared accounts and/or multi-user accounts are strictly prohibited.
80+
81+
<!-- repeated above
82+
!!! tip
83+
In order to log on to TACC's HPC resources, your TACC account must be "[Active](#table1)" **AND** you must have an active allocation on that particular resource.
84+
-->
85+
8086
## Table 1. TACC Account Status { #table1 }
8187

8288
Account Status | Description
@@ -88,6 +94,13 @@ Deactivated | Reactivate your account by logging into the [TACC A
8894
Suspended | If your account is suspended you will be prohibited from logging into the TACC User Portal and as well as any TACC HPC resources. Please [submit a help desk ticket](SUBMITTICKET) and a member of our User Services team will respond. Account suspension may result if: <li>your HPC jobs are violating [Good Conduct Policies][TACCGOODCONDUCT] or causing harm to our systems <li>your account usage is in violation of TACC's [Acceptable Use Policy][TACCAUP].
8995

9096

97+
## Deactivated Accounts
98+
99+
If you have not accessed your account within the past 120 consecutive days, your account will be automatically deactivated in accordance with UT's [security protocols](https://security.utexas.edu/policies/irusp). To re-activate your acccount, login to the [TACC Accounts Portal][TACCACCOUNTS] and request an activation link.
100+
101+
!!! important
102+
Once you have re-activated your account, you will need to [un-pair and re-pair][TACCMFA] your two-factor authentication.
103+
91104
## TACC Portals
92105

93106
TACC provides two portals for account and job management, the [TACC Accounts Portal][TACCACCOUNTS] and the [TACC User Portal][TACCUSERPORTAL].
@@ -147,6 +160,29 @@ The [TACC User Portal][TACCUSERPORTAL] provides the following services:
147160

148161
{% include 'aliases.md' %}
149162

163+
<!-- sources
164+
Jack sez there's a workaround
165+
* **Kill Zombied processes**: We have seen issues with zombied processes remaining on the login nodes after users run with VSCode, leading to them running into the process limits set in "`ulimit -a`". This can manifest with this error:
166+
To remedy, You can always check the logins for running tasks from your account with "ps -ef | grep $USER" and shut down anything that isn't needed with "kill [process_id]".
167+
168+
https://consult.tacc.utexas.edu/Ticket/Display.html?id=111310
169+
170+
"computationally expensive" as noted in Good Conduct Guide
171+
-->
172+
173+
<!--
174+
### Corrupted Mac on Input
175+
PS C:\Users\allis> ssh ans5695@ls6.tacc.utexas.edu
176+
Corrupted MAC on input.
177+
ssh_dispatch_run_fatal: Con
178+
179+
180+
We recently updated security ciphers for TACC systems, which has been determined to be root cause of the issue you are experiencing. While we work to resolve this, a temporary work around is to slightly change your ssh command to the following:
181+
182+
ssh -m hmac-sha2-512 <user_name>@<remote_address>
183+
-->
184+
185+
150186

151187

152188
<!--

0 commit comments

Comments
 (0)