Differences

This shows you the differences between two versions of the page.

--- caviness:login [2019/06/27 15:32]
frey [Shell customization]
+++ 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.
-**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 =====
+Each entity that invests in the Caviness cluster is given a //workgroup// which encompasses sponsored user accounts, on-cluster storage, and purchased compute resources.  The workgroup name (referenced as **«workgroup»** in this documentation) can refer to
+  * The Unix group to which all sponsored user accounts are members
+  * The [[caviness:resources#workgroup_directories|shared storage]] allocated to the workgroup
+  * The Slurm:
+    * Account to which jobs are submitted
+    * Partition which grants priority-access to purchased compute resources
+The default workgroup for all users is **everyone**; this workgroup has no Slurm partitions available to it and no shared storage space.  To change your shell to a specific workgroup, use the ''workgroup'' command:
+<code>
+[«username»@login00 ~]$ workgroup -g «workgroup»
+[(«workgroup»:«username»)@login00 ~]$
+</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.)).
+<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>
+[(«workgroup»:«username»)@login00 ~]$ exit
+[«username»@login00 ~]$
+</code>
+==== Workgroup queries ====
+The ''workgroup'' command also allows you to query to which workgroups you belong:
+<code>
+[«username»@login00 ~]$ workgroup --query workgroups
+  workgroup1
+  workgroup10
+</code>
+All available options are summarized using the ''workgroup --help'' command.
 ===== Shell customization =====
@@ Line 28: / Line 72: @@
 ^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_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 53: / Line 97: @@
 </code>
+All additional adjustments to the shell environment should be handled using [[caviness:valet|VALET]].