Troubleshooting

Git settings

To make sure github recognizes you while you work on your local machine, make sure you configure git with the correct email address. To check your current address, do:

git config user.email

and to change your address, do:

git config user.email "name@example.com"

or

git config --global user.email "name@example.com"

for a more permanent change.

Repository Cloning

If the git clone command doesn't work, try

git clone https://github.com/JeffersonLab/clas12-offline-software.git

or

git -c http.sslVerify=false clone https://github.com/JeffersonLab/clas12-offline-software.git

or

git -c http.sslVerify=false clone git@github.com:JeffersonLab/clas12-offline-software.git

JLab Certificates

One some of the JLab networks, if your computer is not CUE-ified, you may need to deal with certificates to get maven/gradle to cope with JLab's certificate / proxy setup.

OSX

Java/Maven

To get java (maven) to use JLab's certificate, download JLabCA.crt from https://pki.jlab.org, and then install it via (where password=changeit):

cd `/usr/libexec/java_home`/jre/lib/security
sudo cp cacerts cacerts.orig
sudo keytool -importcert -file /path/to/JLabCA.crt -keystore cacerts

Adding this to your ~/.mavenrc may also be necessary:

MAVEN_OPTS="-Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true -Dmaven.wagon.http.ssl.ignore.validity.dates=true"

Gradle

To get gradle to use the JLab certificate, try adding the following to common-tools/clas-jcsg/gradle.properties:

org.gradle.jvmargs=-Djavax.net.ssl.keyStore="$JAVA_HOME/jre/lib/security/cacerts" -Djavax.net.ssl.keyStoreType=KeychainStore -Djavax.net.ssl.keyStorePassword=changeit

where $JAVA_HOME is the output of /usr/libexec/java_home.