Difference between revisions of "Quick Start Guide"

From Geos-chem
Jump to: navigation, search
(19 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
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 [http://git-scm.com/book/en/Getting-Started-Installing-Git here].
 
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 [http://git-scm.com/book/en/Getting-Started-Installing-Git here].
  
#Request an 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 [mailto:daven.henze@colorado.edu daven.henze@colorado.edu]
+
# Sign up for the GEOS Chem Adjoint mailing list. This can be done by Send an email to [mailto:geos-chem-adjoint+subscribe@g.harvard.edu geos-chem-adjoint+subscribe@g.harvard.edu] or  going to the [https://groups.google.com/a/g.harvard.edu/forum/#!forum/geos-chem-adjoint Adjoint Google Group ] and hit apply for membership.
# Sign up for the [mailto:geos-chem-adjoint-join@seas.harvard.edu GEOS Chem Adjoint mailing list].
+
# Review our policy on [[GEOS-Chem_Adjoint#Distribution_and_Use|Distribution and Use]].
#Review our policy on [http://wiki.seas.harvard.edu/geos-chem/index.php/GEOS-Chem_Adjoint#Distribution_and_Use Distribution and Use].
+
# Create a wiki account on [[Special:RequestAccount|GEOS-Chem wiki]].
# Create an account on [http://wiki.seas.harvard.edu/geos-chem/index.php/Special:RequestAccount GEOS-Chem wiki].
+
# Add yourself to the [[GEOS-Chem_Adjoint#Current_GEOS-Chem_Adjoint_Research_Projects_.28please_add_yours.21.29|list of current users and projects]].
# You will receive an email letting you know that your account has been created. This email will contain a random generated password, please change it on your first log into the server.
+
# Request a GIT account by sending an email to [mailto:geos-chem-adjoint@seas.harvard.edu?subject=GIT_Account_Request GEOS Chem Adjoint mailing list]. Please include your name, a desired username, organization and a brief description of how you plan to use the code. Note: If you don't request a username the default one will be NAME.LASTNAME
# Now you can log in our server by going to http://adjoint.colorado.edu:8080
+
# You will receive an email letting you know that your GIT account has been created. This email will contain a random generated password, you will be asked to change it on your first login .
# Once you login, go to '''My Profile (Top Right Corner Icon) -> Account'''  and change your password.
+
# Now you can log in our GIT server by going to http://adjoint.colorado.edu:8080 Note: You can login using your username or email.
# Now you are ready to download the code. Do so by typing this on a terminal  
+
# 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.  
 +
# Now you are ready to download the code. Do so by typing this on a terminal.
  
  git clone http://adjoint.colorado.edu:8080/gcadj_std.git  
+
  git clone ssh://git@adjoint.colorado.edu/yanko.davila/gcadj_std.git
  
It will ask for your username (email that you used for registration) and your password, please note that if you have X11 session open it will popup a window asking for the username and password instead of asking it on the terminal. 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 [http://adjoint.colorado.edu/~daven/gcadj_std/GC_adj_man.pdf GEOS Chem Adjoint Manual] instructions. If you want to compare your result with our results please download our [http://adjoint.colorado.edu/~daven/gcadj_std/bench/ Benchmark Results].
+
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 [http://adjoint.colorado.edu/~yanko/gcadj_std/GC_adj_man.pdf GEOS Chem Adjoint Manual] instructions. If you want to compare your result with our results please download our [http://adjoint.colorado.edu/~yanko/benchmarks/ Benchmark Results].
 +
 
 +
 
 +
[[GEOS-Chem_Adjoint#Quick_guide_to_GIT|GO BACK]]

Revision as of 15:50, 16 March 2017

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. Sign up for the GEOS Chem Adjoint mailing list. This can be done by Send an email to geos-chem-adjoint+subscribe@g.harvard.edu or going to the Adjoint Google Group and hit apply for membership.
  2. Review our policy on Distribution and Use.
  3. Create a wiki account on GEOS-Chem wiki.
  4. Add yourself to the list of current users and projects.
  5. Request a GIT account by sending an email to GEOS Chem Adjoint mailing list. Please include your name, a desired username, organization and a brief description of how you plan to use the code. Note: If you don't request a username the default one will be NAME.LASTNAME
  6. You will receive an email letting you know that your GIT account has been created. This email will contain a random generated password, you will be asked to change it on your first login .
  7. Now you can log in our GIT server by going to http://adjoint.colorado.edu:8080 Note: You can login using your username or email.
  8. 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.
  9. Now you are ready to download the code. Do so by typing this on a terminal.
git clone ssh://git@adjoint.colorado.edu/yanko.davila/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.


GO BACK