Quick Start Guide

From Geos-chem
Revision as of 21:18, 11 January 2013 by Daven (Talk | contribs)

Jump to: navigation, search

Getting Started with GEOS Chem Adjoint:

Recently our group migrated from cvs to git. This little guide will show the steps to create a new user on our new server and download the latest version of GEOS Chem Adjoint. We assume that you have installed git on your system. If you need information on how to install git on your system, please refer to the guide here.

  1. Request a GIT account by sending an email to our group. Please include your name, organization and a brief description of how you plan to use the code. Send your email to daven.henze@colorado.edu
  2. Sign up for the GEOS Chem Adjoint mailing list.
  3. Review our policy on Distribution and Use.
  4. Create a wiki account on GEOS-Chem wiki.
  5. Add yourself to the list of current users and projects.
  6. You will receive an email letting you know that your GIT account has been created. This email will contain a random generated password, please change it on your first log into the server.
  7. Now you can log in our GIT server by going to http://adjoint.colorado.edu:8080
  8. Once you login, go to My Profile (Top Right Corner Icon) -> Account and change your password.
  9. It's time to create your SSH Key, please note that without this key you won't be able to download the code. Go to My Profile (Top Right Corner Icon) -> SSH Keys and Add new. Please note that you are going to need one ssh key per computer where you donwload the code. Here you have more information about SSH Keys.
    How to create an SSH Key on GitLab.
    • In Title, put the name of the computer where you are creating the ssh key.
    • To check if you already have an SSH key, open your terminal and use the code below.
    cat ~/.ssh/id_rsa.pub
    • If you see something like this "cat: ~/.ssh/id_rsa.pub: No such file or directory" then you need to create one.
    • To generate a new SSH key use code below.
    ssh-keygen -t rsa -C "<your_email@your_server>"
    • Check if you successfully created your key as described before using
    cat ~/.ssh/id_rsa.pub
    • Copy the output of this command, and paste it into the Key section of the GIT ssh key web page.
  10. Now you are ready to download the code. Do so by typing this on a terminal.
git clone ssh://git@adjoint.colorado.edu:2222/gcadj_std.git

If you have any trouble or just need further assistance send an email to yanko.davila@colorado.edu. Now you should have a folder named gcadj_std. If you have it you are done. Now good luck with your work. We strongly encourage you to run the benchmarks following the GEOS Chem Adjoint Manual instructions. If you want to compare your result with our results please download our Benchmark Results.