JULES Virtual Machine setup
JULES can be run on a Virtual Machine (VM).
The metomi team at the Met Office provide a VM with FCM, Rose and Cylc installed and configured. To use the VM, follow the instructions for the Ubuntu 16.04 VM.
You will need root access to your laptop/computer to be able
to install of the software required:
(version 5.1.6 or later required) and
(version 1.9.1 or later required) then you
need to download the metomi VM setup files from
Then extract the files, these will be put into a directory
For Window 10 specific advice please read JULES development using a virtual machine.
This has been installed on Mac and Windows.
To see both the
tmp and the
rosie go by default please
update the following to your
[rosie-id] prefixes-ws-default=tmp u
VM JULES Data
VM JULES Data
can be obtained by running the three scripts in the link.
You need to run
sudo install-jules-* for all
three of the scripts:
# For the extras needed. sudo install-jules-extras # For the benchmarking and ERAINT data for rose-stem and the smallest GSWP2 for rose-stem sudo install-jules-benchmark-data # For the full set of GSWP2 data if needed! NOTE: this is 22GB. Only install if you have space and need it. sudo install-jules-gswp2-dataThe FTP site password.
The location of the install-jules-* scripts on GitHub are provide by the link for full details if required.
Known Good Output (KGO) is the good data that
to compare with the new output that the rose stem suite has created in the
current suite run.
- VN=vn4.9_t??? #replace with the appropriate KGO version
- mkdir -p $KGO_DIR/$VN
- JULES_TRUNK=<path/to/jules/vn4.9/trunk> #replace vn4.9 with the appropriate JULES version number
- cd $JULES_TRUNK #This suite will fail, but do it anyway as we need to create the KGO
rose stem --group=all --source=. -S HOUSEKEEPING=false --new
- cd ~/cylc-run/trunk
- cp work/1/loobos_*/output/* $KGO_DIR/$VN
- cp work/1/gswp2_*/output/* $KGO_DIR/$VN
- Test rose stem
rose stem --group=all --source=. --newYou should have no failures this time.
Now rose stem should be configured for your site and compliers.
VM Other help
To start the VM for the first time:
cd ~/metomi-vm=master #Start the VM for the first ever time vagrant up #when run for the first time since installing this takes about 10-20 minutes depending on your internet connection speed. #when it has completed the install it will shut itself down #Start the VM after the first ever time vagrant up #this takes about 2-5 mins #you will be asked for your MOSRS password <enter your MOSRS password> #if you fail to enter your password correctly: mosrs-cache-password #this will allow you to try your password again. #To quit the VM safely vagrant halt #or within the ssh session sudo shutdown -h now #To remove your VM and start again use the following command. #This will delete all the files downloaded. #Remember to commit any local changes back to the repositories before doing this# as all local files will also be deleted, this include any data analysis. vagrant destroy
Helpful commands for the VM:
- rose slv #to open rose bush
- rose edit #to open the rose editor GUI
- rose suite-shutdown --name=SUITE_NAME -- --now #to shutdown you suite
- cylc scan -c #to see what suites you have running
- cylc gscan #to see what suites you have running via the GUI