Page History

...

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.

If users want to leave comments they need a userid, all licensed users can have one. If they do not already have an account, they can register for web-only at: https://www.ecmwf.int/register/ Once they register I still have to add them to the list of authorized users on the OpenIFS wiki.

Authentication

Anyone wishing to access the OpenIFS git repository needs an account.

there are actually two ways of login in http://software.ecmwf.int/stash

...

The problem is that to access with git and https (not ssh?) you have to use your JIRA password. And I think were all the problem was. (The same applies to https://software.ecmwf.int:8443/stash/)

Stash setup

Ensure user has an account and password for Stash.  If no userid, go to old.ecmwf.int/login and register. I then need to add this new user to the repository if they are outside ECMWF

...

The passwords can not be set in Stash, it has to be done in JIRA that acts as a Directory Server for Stash.
So you have to go to https://software.ecmwf.int/issues and set the password there. It should sync to Stash after 15 minutes or so.

Cloning

To clone the repository at the remote site (once above login is successful):

...

Use 'ssh' protocol if within ECMWF as https doesn't work.

That's it!

Example email to users

Should you want to clone the git repository for OpenIFS, here's how:

1. If you don't have an account on the ECMWF website go to old.ecmwf.int/login and self register.

2. Once you have a userid, you need to set the password on the website hosting 
the repositories. If you don't have one, or have forgotten, simplest way of doing this is to go 
to the page:   
https://software.ecmwf.int/issues
and click on 'Can't access your account?'. This will forward an email to you with a web address 
to reset (or create) the password.

3. Once the password is set, test it by logging in to the https://software.ecmwf.int/stash. You should see the OpenIFS 
project listed.

4. To clone on your workstation is then easy:

  mkdir ecmwf
  cd ecmwf
  git clone https://software.ecmwf.int/stash/scm/oifs/openifs.git

 which will prompt for username & password.  Then you'll get a complete clone of the repository. 
You can then create branches and push them back to me if you want to!
 

...

    git checkout release/v04

Configure Git for the first time

git config --global user.name "Glenn Carver"
git config --global user.email "Glenn.Carver@ecmwf.int"

Working with your repository

I just want to clone this repository

If you want to simply clone this empty repository then run this command in your terminal.

git clone ssh://git@software.ecmwf.int:7999/oifs/contrib.git

My code is ready to be pushed

If you already have code ready to be pushed to this repository then run this in your terminal.

cd existing-project
git init
git add --all
git commit -m "Initial Commit"
git remote add origin ssh://git@software.ecmwf.int:7999/oifs/contrib.git
git push origin master

My code is already tracked by Git

If your code is already tracked by Git then set this repository as your "origin" to push to.

cd existing-project
git remote set-url origin ssh://git@software.ecmwf.int:7999/oifs/contrib.git
git push origin master

Useful links

git workflows discussion:  http://www.atlassian.com/git/workflows#!workflow-centralized