Versions Compared

Key

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

...

Section


Column

OpenIFS is available as a git repository, aimed at developers/users who want to work closely with the OpenIFS team and provide updates to the model. Using the git repository to submit branches makes this process easier. Please read the instructions on this page for further details. The OpenIFS git repository is not available to all users.

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

Info

If you are looking for the IFS git repository (not OpenIFS), please follow this link.


Info

git versions > 1.7.1 are required to work correctly with the OpenIFS git repository. If error code 501 appears when attempting to clone the repository, please upgrade.

ECMWF Bitbucket git repository

ECMWF provide a web interface (called 'stash') to git repositories that hold OpenIFS. This is used to browse the sources, branches and create pull requests.  It works much like other web interfaces for git, such as github or bitbucket.

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


Column
width30%


Panel
bgColorwhite
titleBGColorlightgrey
borderStyledotted
titleOn this page...

Table of Contents
maxLevel4
indent15px



...

...

Code Block
titleExample git clone session
% mkdir openifs
% cd openifs
% git clone ssh://git@softwaregit@git.ecmwf.int:7999/oifs/oifs40r1.git       # use: git clone https://nagc@softwarenagc@git.ecmwf.int/stash/scm/oifs/oifs40r1.git external to ECMWF
Cloning into 'oifs40r1'...
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 oifs40r1
% git checkout develop                         # or whichever release version is required (the most recent is recommended)
Branch develop set up to track remote branch develop from origin.
Switched to a new branch 'develop'
% git checkout -b feature/new_idea                      # create new branch. ALWAYS branch from the develop branch, never the master branch.
Switched to a new branch 'feature/new_idea'

...

Code Block
% git clone ssh://git@softwaregit@git.ecmwf.int:7999/oifs/oifs40r1.git oifs40r1v1.1
......
% cd oifs40r1v1.1
% git checkout v1.1
Note: checking out 'v1.1'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.

...

Code Block
% 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://softwaregit.ecmwf.int/stash for more details.

...

  • Log off the ECMWF Single Sign On system www.ecmwf.int
  • Log in manually into Stash, filling the CAPTCHA field (you will be asked for it after you try a first time). https://softwaregit.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

...