The gadi-cylc7-setup
script sets up SSH, the roses subdirectory and the cylc7
module.
Details and examples are shown below.
Set up SSH, the roses subdirectory and the cylc7
and cylc8
modules
The gadi-cylc-setup
script asks for your NCI account password to setup passwordless SSH, then creates the ~/roses
directory, and adds the setup_cylc7
and setup_cylc8
functions to your ~/.bashrc
file.
Each of the setup_cylc7
and setup_cylc8
functions has an optional module version argument that defaults to default
.
The example shown below is for user abc123
. You should see your own NCI username in the prompt.
$ /g/data/hr22/bin/gadi-cylc-setup -y +------------------------------------------------------------------------------+ | Rose/Cylc Gadi connection check | +------------------------------------------------------------------------------+ We are about to perform a few checks to see if your account is set up correctly to run tasks on Gadi. First we will back up your original SSH configuration. If any changes are needed, we will prompt to ask for permission to perform each change before making it. We will then compare your final configuration with the backup. Note: You may be asked for your NCI password or SSH key passphrase a few times during the process. y ... continuing [...] Are you sure you want to continue connecting (yes/no/[fingerprint])? yes abc123@localhost's password: Number of key(s) added: 1 Now try logging into the machine, with: "ssh 'gadi.nci.org.au'" and check to make sure that only the key(s) you wanted were added. SUCCESS: created and sent key to gadi.nci.org.au Retrying with new key result=Success [...] +------------------------------------------------------------------------------+ | RESULT: PASSED | +------------------------------------------------------------------------------+ Press Enter to continue.
Once the setup has completed, the script pauses and asks you to hit Enter
to continue. At this point, if you see any messages that indicate that the setup script has failed, use Ctrl-c
to exit the script.
Changes made to $HOME/.bashrc during initial setup
The cylc7-setup
script adds the following to your ~/.bashrc
file to define the setup_cylc7
and setup_cylc8
functions.
# gadi-cylc-setup: DO NOT EDIT THE FOLLOWING FUNCTION DEFINITION setup_cylc7 () { _version=${1:-default} module use /g/data/hr22/modulefiles module load cylc7/${_version} module list } if in_interactive_shell && in_login_shell; then : # Uncomment the following line to call setup_cylc7 on every interactive login. # setup_cylc7 fi # gadi-cylc-setup: END # gadi-cylc-setup: DO NOT EDIT THE FOLLOWING SETUP_CYLC8 FUNCTION DEFINITION setup_cylc8 () { _version=${1:-default} module use /g/data/hr22/modulefiles module load cylc/${_version} module list } if in_interactive_shell && in_login_shell; then : # Uncomment the following line to call setup_cylc8 on every interactive login. # setup_cylc8 fi # gadi-cylc-setup: END
Setup for each terminal session
Once you have run the initial setup for your NCI account, on each following terminal session you have the following options.
If you just want to use use Rose/Cylc without direct access to the MOSRS repository, run
$ setup_cylc7
To use a specific cylc7
module version, run (e.g.)
$ setup_cylc7 23.03
To automatically load the Cylc 7 environment on every interactive login, uncomment the following line in your ~/.bashrc
file.
# setup_cylc7