isuftin edited this page Jul 21, 2011 · 6 revisions
Clone this wiki locally

Our GitHub account is USGS-CIDA @ https://github.com/USGS-CIDA (See Ivan or Jordan for the password)

The account set up has the ability to add 5 collaborators and 10 repositories totaling 1.2GB of space.

In order for you to push or pull( ? ) from the GitHub repository as USGS-CIDA, you will probably need to create a set of SSH keys.

The instructions for that can be found here: Linux: http://help.github.com/linux-set-up-git/ OSX: http://help.github.com/mac-set-up-git Windows: http://help.github.com/win-set-up-git

If you would like to create a repo, as long as it falls under the maximum amount allowed under our plan (10), the instructions are here: http://help.github.com/create-a-repo/

How to create pull requests: http://help.github.com/send-pull-requests/

How to work with remote repositories: http://help.github.com/remotes/

This walkthrough assumes that you are using Linux, namely Ubuntu. This walkthrough should also work on OSX.

It also assumes that you have Java, Maven and Git installed on your system and properly configured. Also, you will need to have access to the CIDA GitHub repository.

The first thing we want to do is pull our application from GitHub.

Go to https://github.com/login and log in to (or create) your GitHub account.

http://help.github.com/linux-set-up-git/ or http://help.github.com/mac-set-up-git/ This tutorial shows you how to:

Set up SSH keys Set up your information in GIT's config Put your API token into GIT's config At this point if you've gotten this far successfully, you should be ready to pull the project from GitHub to your local repository.

When you are in a directory where you would like to pull the ncETL project down to, issue the following command:

git clone git@github.com:USGS-CIDA/ncETL.git

You should see the following: Cloning into ncETL... remote: Counting objects: 5082, done. remote: Compressing objects: 100% (1941/1941), done. remote: Total 5082 (delta 2180), reused 5082 (delta 2180) Receiving objects: 100% (5082/5082), 3.53 MiB | 1.35 MiB/s, done. Resolving deltas: 100% (2180/2180), done.

Congratulations, you just pulled ncETL down from GitHub.

At this point you should have the ncETL source code in a local git repository.

In the pom.xml of ncETL, comment out the following: <repositories> <repository> <id>cida-gdp-thirdparty</id> <name>CIDA GDP Third-party</name> <url>http://igsarmewfsbbl.er.usgs.gov:8081/nexus/content/repositories/cida-gdp-thirdparty</url> </repository> <repository> <id>cida-snapshots</id> <name>CIDA Snapshots</name> <url>http://igsarmewfsbbl.er.usgs.gov:8081/nexus/content/repositories/cida-snapshots</url> </repository> <repository> <id>cida-gdp-development</id> <name>CIDA GDP Development</name> <url>http://igsarmewfsbbl.er.usgs.gov:8081/nexus/content/groups/cida-gdp-development</url> </repository> </repositories> Try running 'mvn clean'. This should be successful.

If you have no problem with that, try 'mvn package'.

You should see an error telling you that you are missing dependencies.

Because you don't have access to CIDA's Nexus repository, you will need to install two jars into your local maven repository.

Unpackage the jar zip and when you are in the same directory as the jars (ncETL/src/main/resources/jars/Archive), type the following:

mvn install:install-file -Dfile=ncISO-1.2.1-1-SNAPSHOT.jar -DgroupId=gov.noaa.eds -DartifactId=ncISO -Dversion=1.2.1-1-SNAPSHOT -Dpackaging=jar

mvn install:install-file -Dfile=jdbc-spec-library-0.5.7.jar -DgroupId=gov.usgs.cida -DartifactId=jdbc-spec-library -Dversion=0.5.7 -Dpackaging=jar

Once that's done, try 'mvn package' again. Now you should be good to go.

The current chat area is: http://ietherpad.com/HxDD6OfV3k