Difference between revisions of "WRF porting to NCI machine"

m (Protected "WRF porting to NCI machine" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
Line 1: Line 1:
 
These are the steps to follow to install new WRF versions on NCI machine. Only for admins within the wrf group at NCI.
 
These are the steps to follow to install new WRF versions on NCI machine. Only for admins within the wrf group at NCI.
 
If starting from scratch:
 
If starting from scratch:
# Update the Github fork of NCAR Github in coecms/WRFV3
+
# Under your own project, clone the WRF github repo: https://github.com/coecms/WRF and create a new branch for the new version (named Vx.x.x), starting from the most recent HEAD (not master)
# Under your own project, clone the WRF github repo: https://github.com/coecms/WRF and create a new branch for the new version (named Vx.x.x)
+
# Add https://github.com/wrf-model/WPS.git and https://github.com/wrf-model/WRF.git as remotes (named NCAR_WPS and NCAS_WRF if you want to copy-paste the commands) and fetch
# Add https://github.com/coecms/WRFV3.git as a remote (named NCAR if you want to copy-paste the commands) and fetch
 
 
# In the new branch, run the command:
 
# In the new branch, run the command:
> <syntaxhighlight>
+
  git merge -s recursive -Xsubtree=WRFV3 --allow-unrelated-histories NCAR_WRF/master
  git merge -s recursive -Xsubtree=WRFV3 -Xtheirs --allow-unrelated-histories NCAR_WRF/master
+
You may need another branch than master to pick up a specific release.
</syntaxhighlight>
+
# You may need to update the crtm coeffs. You'll probably get a conflict on the file WRFV3/run/crtm_coeffs. This is a link to /projects/WRF/data/WRFDA_files/crtm_coeff_X. Check the version the remote points to. If different from local, download the updates from: http://www2.mmm.ucar.edu/wrf/users/wrfda/download/crtm_coeffs.html
> You may need another branch than master to pick up a specific release.
+
# After resolving conflicts, run WRFV3/configure. See what options are correct for the machine architecture. Update WRFV3/run_compile appropriately.
 
# Clone into /projects/WRF with wrf group ownership. Make sure the master branch there points to the new version branch.
 
# Clone into /projects/WRF with wrf group ownership. Make sure the master branch there points to the new version branch.
  
If you already have a clone of the coecms/WRF repo:
 
# Update the Github fork of NCAR Github in coecms/WRFV3
 
# In your local clone, fetch the NCAR remote
 
# Create a new branch for the new version (named Vx.x.x)
 
# In the new branch, run the command:
 
> <syntaxhighlight>
 
git merge -s recursive -Xsubtree=WRFV3 --allow-unrelated-histories NCAR_WRF/master
 
</syntaxhighlight>
 
> You may need another branch than master to pick up a specific release.
 
# Clone into /projects/WRF with wrf group ownership. Make sure the master branch there points to the new version branch.
 
  
Follow same steps for WPS, but remote is called NCAR_WPS and <span style="font-family: &quot;Courier New&quot;,Courier,monospace;">-Xsubtree=WPS</span>
+
Follow same steps for WPS, but remote is called NCAR_WPS and -Xsubtree=WPS
  
 
==Jenkins setup==  
 
==Jenkins setup==  
 
# Add a new parameter for the version. Just the numbers, no "V".
 
# Add a new parameter for the version. Just the numbers, no "V".
 
# Create a branch for that version in wrf-testing repo. Exact same name as the previous step parameter.
 
# Create a branch for that version in wrf-testing repo. Exact same name as the previous step parameter.

Revision as of 21:24, 15 April 2019

These are the steps to follow to install new WRF versions on NCI machine. Only for admins within the wrf group at NCI. If starting from scratch:

  1. Under your own project, clone the WRF github repo: https://github.com/coecms/WRF and create a new branch for the new version (named Vx.x.x), starting from the most recent HEAD (not master)
  2. Add https://github.com/wrf-model/WPS.git and https://github.com/wrf-model/WRF.git as remotes (named NCAR_WPS and NCAS_WRF if you want to copy-paste the commands) and fetch
  3. In the new branch, run the command:
git merge -s recursive -Xsubtree=WRFV3 --allow-unrelated-histories NCAR_WRF/master

You may need another branch than master to pick up a specific release.

  1. You may need to update the crtm coeffs. You'll probably get a conflict on the file WRFV3/run/crtm_coeffs. This is a link to /projects/WRF/data/WRFDA_files/crtm_coeff_X. Check the version the remote points to. If different from local, download the updates from: http://www2.mmm.ucar.edu/wrf/users/wrfda/download/crtm_coeffs.html
  2. After resolving conflicts, run WRFV3/configure. See what options are correct for the machine architecture. Update WRFV3/run_compile appropriately.
  3. Clone into /projects/WRF with wrf group ownership. Make sure the master branch there points to the new version branch.


Follow same steps for WPS, but remote is called NCAR_WPS and -Xsubtree=WPS

Jenkins setup

  1. Add a new parameter for the version. Just the numbers, no "V".
  2. Create a branch for that version in wrf-testing repo. Exact same name as the previous step parameter.