View Source

OpenIFS is available for download as a git repository. Licensed users may request access to this repository if they prefer to work with git, though we expect most to download OpenIFS as compressed tar files.

Developers/users who want to work closely with the OpenIFS team and provide updates to the model are encouraged to use the git repository to submit branches. Please read the instructions on this page for further details.

Note that the git repository only hosts the source code. All the data files to run OpenIFS must still be downloaded from the ftp site.

ECMWF Stash git repository

ECMWF use software called 'Stash' to provide a web interface to git repositories. This is the interface used to browse the sources, branches and create pull requests. It works much like other web interfaces for git, such as github, and is not to be confused with the git stash command.

To connect to Stash, go to: https://software.ecmwf.int/stash/ and find the OpenIFS project.

Access to Stash web interface

Access to Stash requires that you can login to the main ECMWF page: http://www.ecmwf.int/. This is normally the case if you have an account on ECMWF systems. Use your normal userid and secureid password.

For users without an account, please go to https://www.ecmwf.int/registration/ and fill in the form to register for an account. Note that it will take some time for the new account to be registered on all the websites, please wait about an hour if access does not initially work.

After successfully logging in you find you still cannot see the OpenIFS Stash repository, please contact openifs-support@ecmwf.int. You may need to be granted access.

Access to git repository

To clone the OpenIFS git repository at your local site requires setting a further password to correctly authenticate with the Stash git repository.

Make sure you can successfully log in to the main ECMWF website before following the procedure below.

Authentication

The procedure to get a password to download the OpenIFS git repository is:

Log out from www.ecmwf.int
Go to https://software.ecmwf.int/issues/login.jsp. Choose "Can't access your account"
Write your user id.
Now you should get an email from JIRA offering you a link to reset your JIRA password. Follow this link and type in the new password (it doesn't matter if you don't already have one).
This password should be available in Stash in some minutes. You can test it in Stash's web interface https://software.ecmwf.int/stash/login as long as you are still logged out from www.ecmwf.int

Cloning and branching

To clone the repository at the remote site follow these steps. This will prompt for your username and the password created as described in the previous section:

% mkdir openifs
% cd openifs
% git clone https://software.ecmwf.int/stash/scm/oifs/oifs38r1.git       # or whichever model major release is required
Cloning into 'oifs38r1'...
remote: Counting objects: 4680, done.
remote: Compressing objects: 100% (3654/3654), done.
remote: Total 4680 (delta 1206), reused 4175 (delta 871)
Receiving objects: 100% (4680/4680), 21.45 MiB | 20.71 MiB/s, done.
Resolving deltas: 100% (1206/1206), done.
Checking connectivity... done
% cd oifs38r1
% git checkout release/v04                         # or whichever release version is required (the most recent is recommended)
Branch release/v04 set up to track remote branch release/v04 from origin.
Switched to a new branch 'release/v04'
% git checkout -b my_new_idea                      # create new branch. ALWAYS branch from the release branch, never the master branch.
Switched to a new branch 'my_new_idea'

Acknowledgement

Portions of this page written by ECMWF user support: Daniel Santoalla.