Quick Start Guide: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| (11 intermediate revisions by 2 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]. | ||
# | # 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. | ||
# Review our policy on [[GEOS-Chem_Adjoint#Distribution_and_Use|Distribution and Use]]. | # Review our policy on [[GEOS-Chem_Adjoint#Distribution_and_Use|Distribution and Use]]. | ||
# Create a wiki account on [[Special:RequestAccount|GEOS-Chem wiki]]. | <!--# Create a wiki account on [[Special:RequestAccount|GEOS-Chem wiki]].--> | ||
# You will receive an email letting you know that your GIT account has been created. This email will contain a random generated password, | <!--# Add yourself to the [[GEOS-Chem_Adjoint#Current_GEOS-Chem_Adjoint_Research_Projects_.28please_add_yours.21.29|list of current users and projects]].--> | ||
# Now you can log in our GIT server by going to http://adjoint.colorado.edu:8080 | # 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 | ||
# 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 . | |||
# 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. | |||
# 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]]. | # 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.''' | #: '''How to create an SSH Key on GitLab.''' | ||
| Line 15: | Line 15: | ||
#* To check if you already have an SSH key, open your terminal and use the code below. | #* To check if you already have an SSH key, open your terminal and use the code below. | ||
#: cat ~/.ssh/id_rsa.pub | #: 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. | #*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. | #* To generate a new SSH key use code below. | ||
#: ssh-keygen -t rsa -C "<your_email@your_server>" | #: ssh-keygen -t rsa -C "<your_email@your_server>" | ||
| Line 23: | Line 23: | ||
# Now you are ready to download the code. Do so by typing this on a terminal. | # Now you are ready to download the code. Do so by typing this on a terminal. | ||
git clone ssh://git@adjoint.colorado.edu | 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 [ | 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 [https://drive.google.com/drive/folders/1pdp0Rax0V0gNcHj_W--f-TtdK7iTjs5r?usp=sharing GEOS Chem Adjoint Manual] instructions. If you want to compare your result with our results please download our [https://drive.google.com/drive/folders/1jtVGlIbdOpfTy-t05vk4jUpDsQR6a242?usp=sharing Benchmark Results]. | ||
[[GEOS-Chem_Adjoint#Quick_guide_to_GIT|GO BACK]] | [[GEOS-Chem_Adjoint#Quick_guide_to_GIT|GO BACK]] | ||
Latest revision as of 17:45, 5 June 2022
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.
- 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.
- Review our policy on Distribution and Use.
- 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
- 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 .
- 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.
- 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 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.