Changes between Version 60 and Version 61 of cypress/using

Timestamp:

12/19/19 14:16:28 (5 years ago)

Author:

cbaribault

Comment:

Added sections for 1) exiting idev and 2) temporarily setting environment variables.

cypress/using

@@ -403 +403 @@
 `idev` transfers the environmental variables to computing node. Therefore, if you have loaded some modules on the login node, you don't have to load the same module again.
 
+==== How to exit `idev` ====
+
+Once you're in the interactive session, at any time before the interactive session times out, you can terminate or leave the interactive session via the `exit` command, and you will be sent back to your login session on the login node with your most recent login prompt.
+{{{
+[fuji@cypress01-100 ~]$ exit
+[fuji@cypress1 ~]$
+}}}
+
 ==== For Workshop ====
 If you use a temporary workshop account, do this.
@@ -458 +466 @@
 
 ==== "interactive" QOS ====
-The "interactive" QOS is intended to be used for testing SLURM script submission, and is limited to 1 job per user.  To use it, set your partition and QOS to "interactive".  For example, with idev:
+The "interactive" QOS is intended to be used for testing SLURM script submission, and is limited to 1 job per user.  To use it, set your partition and QOS to "interactive".  For example, with `idev`:
 
 {{{
@@ -475 +483 @@
 Other QOS's on the system are for staff testing use only.
 
+==== Temporarily Setting Environment Variables ====
+As an alternative to the above, you can avoid possible confusion associated with environment variable values by temporarily setting those variables and invoking a command, e.g. `idev`, all on one line. Thus, when you exit from the interactive session, those variables will be restored to their prior state. Furthermore, you can define and use an alias, e.g. "idevi", as in the following.
+
+Starting from the login session, observe variables initially unset.
+{{{
+[fuji@cypress1 ~]$ echo MY_PARTITION=$MY_PARTITION, MY_QUEUE=$MY_QUEUE
+MY_PARTITION=, MY_QUEUE=
+}}}
+Define and invoke alias "idevi", now entering the interactive session.
+{{{
+[fuji@cypress1 ~]$ alias idevi='MY_PARTITION=interactive MY_QUEUE=interactive idev'
+[fuji@cypress1 ~]$ idevi
+Requesting 1 node(s)  task(s) to interactive queue of interactive partition
+1 task(s)/node, 20 cpu(s)/task, 2 MIC device(s)/node
+Time: 0 (hr) 60 (min).
+Submitted batch job 1255374
+JOBID=1255374 begin on cypress01-089
+--> Creating interactive terminal session (login) on node cypress01-089.
+--> You have 0 (hr) 60 (min).
+--> Assigned Host List : /tmp/idev_nodes_file_fuji
+Last login: Thu Dec 19 12:27:32 2019 from cypress1.cm.cluster
+}}}
+In the interactive session, evaluate the variables and observe they are set.
+{{{
+[fuji@cypress01-089 ~]$ echo MY_PARTITION=$MY_PARTITION, MY_QUEUE=$MY_QUEUE
+MY_PARTITION=interactive, MY_QUEUE=interactive
+}}}
+In the interactive session, do work, then exit back to the login session.
+{{{
+...
+[fuji@cypress01-089 ~]$ exit
+logout
+Connection to cypress01-089 closed.
+Removing job 1255374.
+
+[fuji@cypress1 ~]$
+}}}
+Back in the login session, observe the variables are restored to their prior state - in this case unset.
+{{{
+[fuji@cypress1 ~]$ echo MY_PARTITION=$MY_PARTITION, MY_QUEUE=$MY_QUEUE
+MY_PARTITION=, MY_QUEUE=
+}}}
+
 ==== Questions or Suggestions ====