Changes between Initial Version and Version 1 of SCMVM


Ignore:
Timestamp:
07/02/20 11:59:02 (15 months ago)
Author:
simon
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • SCMVM

    v1 v1  
     1= Using the Met Office's Virtual Machine to run the Single Column Model = 
     2 
     3 
     4The Single Column Model (SCM) can be easily run inside the Met Office's UM Virtual Machine (VM). For full details of the VM, please see https://code.metoffice.gov.uk/doc/um/latest/papers/umdp_X10.pdf 
     5and the associated github repository at https://github.com/metomi/metomi-vms 
     6 
     7The VM should be run on a system where the user is able to install third party software. In can be run using a linux or windows host, but only the former is supported by CMS. In both cases, Virtualbox and Vagrant are required. Please see the github page for full details on these software. Access to MOSRS is required. 
     8 
     9= Installation of the VM on linux = 
     10 
     11* Install virtualbox and vagrant using local package manager. 
     12 
     13* Clone git repo 
     14{{{ 
     15git clone https://github.com/metomi/metomi-vms.git 
     16cd metomi-vms 
     17}}} 
     18 
     19* Edit {{{Vagrantfile.ubuntu-1804}}} and remove {{{desktop}}} from 
     20{{{ 
     21config.vm.provision :shell, path: "install.sh", args: "ubuntu 1804 desktop mosrs" 
     22}}} 
     23 
     24 so it looks like 
     25{{{ 
     26config.vm.provision :shell, path: "install.sh", args: "ubuntu 1804 mosrs" 
     27}}} 
     28 
     29 and remove the line 
     30{{{ 
     31v.gui = true 
     32}}} 
     33 
     34* Start the VM with 
     35{{{ 
     36vagrant up 
     37}}} 
     38 
     39* Have a coffee while it builds. You should now be able to log onto the VM with 
     40{{{ 
     41vagrant ssh 
     42}}} 
     43 You will be asked for your MOSRS password and username (in the order). 
     44 
     45* Whiled logged onto the VM, complete the installation with 
     46{{{ 
     47sudo apt-get install xauth 
     48}}} 
     49 and log out and back on again. 
     50 
     51 
     52= Preparation of the UM on the VM = 
     53 
     54Note: the following assumes that UM vn11.3 is required, if a different version is needed, replace 11.3 with that version number. 
     55 
     56* Install addition software packages. 
     57{{{ 
     58sudo install-um-extras -v 11.3 
     59}}} 
     60 
     61* Install additional UM software. 
     62{{{ 
     63um-setup -s fcm:shumlib.x_tr@um11.3 
     64}}} 
     65 
     66* Install UM data 
     67{{{ 
     68install-um-data 
     69}}} 
     70 
     71* Install UM Metadata 
     72{{{ 
     73install-rose-meta 
     74}}} 
     75 
     76* Install UM vn11.3 
     77{{{ 
     78fcm checkout fcm:um.x/trunk@vn11.3 UM11.3 
     79cd UM11.3 
     80rose stem --group=install -S CENTRAL_INSTALL=true 
     81}}} 
     82 
     83 This will start a rose stem suite to install various input files. The UM installation is now complete. 
     84 
     85= Running the SCM = 
     86 
     87* Start rosie 
     88{{{ 
     89rosie go & 
     90}}} 
     91 
     92* Set uo the MOSRS repo by clicking on {{{Edit->Data source}}} and selecting the Met Office's repo. 
     93 
     94* Search for {{{u-br462}}} and make a copy. 
     95 
     96* Load the job, and run the suite. 
     97 
     98