Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
caviness:login [2019/06/27 15:46] frey [Workgroups] |
caviness:login [2020/11/09 15:14] (current) frey [Shell customization] |
||
---|---|---|---|
Line 19: | Line 19: | ||
When reporting connection problems, please include the ''-vvv'' flag in your ''ssh'' command to produce verbose output and include that output in your help ticket. | When reporting connection problems, please include the ''-vvv'' flag in your ''ssh'' command to produce verbose output and include that output in your help ticket. | ||
- | **Do not run the ''ssh-keygen'' command on Caviness.** This command can destroy your account's ability to login to compute nodes without requesting a password. | + | **Do not run the ''ssh-keygen'' command on Caviness.** This command can destroy your account's ability to login to compute nodes without requesting a password. If you do this by mistake, you can either: |
+ | |||
+ | * recover an older copy of ''~/.ssh'' from your home directory's [[abstract:zfs-snapshots|ZFS snapshots]] | ||
+ | * execute ''mv ~/.ssh ~/.ssh.bak'', logout and log in to Caviness again (the system will generate a new key pair for you) | ||
===== Workgroups ===== | ===== Workgroups ===== | ||
Line 38: | Line 41: | ||
</code> | </code> | ||
- | The ''workgroup'' command is often the first command you will issue after logging-in to the cluster, since it prepares the shell for work within a specific workgroup context((The workgroup's VALET package definitions will become available to you, and the ''$WORKDIR'' environment variable will point to the shared storage. Also, the Slurm ''sbatch''/''srun''/''salloc'' commands will default to using the «workgroup» account for job submission.)). Thereafter, the ''exit'' command will return you to your original login shell: | + | The ''workgroup'' command is often the first command you will issue after logging-in to the cluster, since it prepares the shell for work within a specific workgroup context((The workgroup's VALET package definitions will become available to you, and the ''$WORKDIR'' environment variable will point to the shared storage. Also, the Slurm ''sbatch''/''srun''/''salloc'' commands will default to using the «workgroup» account for job submission.)). |
+ | |||
+ | <WRAP center round tip 60%> | ||
+ | Workgroups can create a ''$WORKDIR/sw/bin'' directory and add executables to it. If that directory exists, it is automatically prepended to a sponsored user's ''$PATH'' when using the ''workgroup'' command to enter that workgroup. | ||
+ | </WRAP> | ||
+ | |||
+ | Thereafter, the ''exit'' command will return you to your original login shell: | ||
<code> | <code> | ||
Line 44: | Line 53: | ||
[«username»@login00 ~]$ | [«username»@login00 ~]$ | ||
</code> | </code> | ||
+ | |||
+ | ==== Workgroup queries ==== | ||
+ | |||
+ | The ''workgroup'' command also allows you to query to which workgroups you belong: | ||
+ | |||
+ | <code> | ||
+ | [«username»@login00 ~]$ workgroup --query workgroups | ||
+ | 1001 workgroup1 | ||
+ | 1010 workgroup10 | ||
+ | </code> | ||
+ | |||
+ | All available options are summarized using the ''workgroup --help'' command. | ||
===== Shell customization ===== | ===== Shell customization ===== | ||
Line 51: | Line 72: | ||
^Variable^Description^ | ^Variable^Description^ | ||
- | |''IT_WANT_ENV_EXTENSIONS''|Set to ''yes'' to enable the affects of the other variables| | + | |''IT_WANT_ENV_EXTENSIONS''|Set to ''yes'' to enable the effects of the other variables| |
|''IT_SET_WORKGROUP_ON_LOGIN''|Set to ''yes'' to automatically change to your default workgroup at login| | |''IT_SET_WORKGROUP_ON_LOGIN''|Set to ''yes'' to automatically change to your default workgroup at login| | ||
|''IT_DEFAULT_WORKGROUP''|The name of the workgroup to use by default; if unspecified, then the first workgroup listed by the ''workgroup --query workgroups'' command| | |''IT_DEFAULT_WORKGROUP''|The name of the workgroup to use by default; if unspecified, then the first workgroup listed by the ''workgroup --query workgroups'' command| | ||
Line 75: | Line 96: | ||
[(«workgroup»:«username»)@login01 «workgroup»]$ | [(«workgroup»:«username»)@login01 «workgroup»]$ | ||
</code> | </code> | ||
+ | |||
+ | All additional adjustments to the shell environment should be handled using [[caviness:valet|VALET]]. |