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]]. | ||