Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
Column

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 from the ftp site.

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.

Column
width30%
Panel
bgColorwhite
titleBGColorlightgrey
titleOn this page...
borderStyledotted

Table of Contents
indent15px

...

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

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

...

Code Block
titleExample git clone session
% 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'

Possible problems

Getting CAPTCHA problems when trying to login at 'git clone', 'git push' or 'git pull'?

In some situations you may get an error like the following

Code Block
[17:55:48] xx@myhost:client> git pull
fatal: remote error: CAPTCHA required
Your Stash account has been marked as requiring a CAPTCHA to be solved before
you may login again. This is typically caused by too many attempts to login
with an incorrect password. The required CAPTCHA prevents your SCM client from
accessing Stash until it is solved, even if you enter your password correctly.

If you are currently logged in to Stash via a browser you may need to logout
and then log back in in order to clear the CAPTCHA.

Visit Stash at https://software.ecmwf.int/stash for more details.

The solution is to follow this procedure

  • Log off the ECMWF Single Sign On system (www.ecmwf.int or old.ecmwrf.int)
  • Log in manually into Stash, filling the CAPTCHA field (you will be asked for it after you try a first time). https://software.ecmwf.int/stash/login
  • The password is the same password you use with git, that you can change or recover in JIRA (but do allow some minutes for synchronization from JIRA to Stash

 

 

Acknowledgement

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

...