Documentation

James Moger

2013-07-24 9359865cf1571d69a464387abb2b0b2c4982580d

Documentation

 src/site/setup_client.mkd

@@ -28,7 +28,7 @@


#### Java-based Clients



When using Java 7-based clients, SNI is enabled by default.  You can disable SNI by specifying the JVM system parameter `-Djsse.enableSNIExtension=false` when your Java-based client launches.

Luckily, Java 6-based clients ignore SNI alerts but when using Java 7-based clients, SNI checking is enabled by default.  You can disable SNI alerts by specifying the JVM system parameter `-Djsse.enableSNIExtension=false` when your Java-based client launches.



For Eclipse, you can append `-Djsse.enableSNIExtension=false` to your *eclipse.ini* file.




 src/site/setup_express.mkd

@@ -10,6 +10,10 @@
Gitblit automatically adjusts itself to running on OpenShift.  Repositories, users,

federation proposals, setting overrides, and Groovy push scripts are stored in *OPENSHIFT_DATA_DIR*.



### Recommended Settings



You should disable the git daemon by setting *git.daemonPort=0*.



It is recommended to enable all RPC settings in the `web.xml` file to allow remote

administration and, more importantly, configuration of your Gitblit Express

installation using the Gitblit Manager.

@@ -25,16 +29,20 @@
- *groovy.scriptsFolder*

- *federation.proposalsFolder*

- *realm.userService* (for standard users.conf)

 
Additionally, it is recommended to force your Gitblit installation to cleanup up

older versions on your OpenShift filesystem to maximize available space for your

repositories.



Append the following command to your ./openshift/action_hooks/build file:

### Native Git Failures



    rm -fr $OPENSHIFT_APP_DIR/jbossas-7.0/standalone/tmp/vfs/*

Unfortunately, sometime in early 2013 RedHat changed their SSL certificate such that cloning from/pushing to Gitblit Express over https fails due to an SNI (server name indication) TLS alert.  There is no known workaround for native git and https.



Lastly, you may want to play with the heap and permgen settings of your Gitblit

However, if your git client is JGit-based, like Eclipse/EGit, then you can workaround this problem and happily push/clone using https and OpenShift.



Luckily, Java 6-based clients ignore SNI alerts but when using Java 7-based clients, SNI checking is enabled by default.  You can disable SNI alerts by specifying the JVM system parameter `-Djsse.enableSNIExtension=false` when your Java-based client launches.



For Eclipse, you can append `-Djsse.enableSNIExtension=false` to your *eclipse.ini* file.



### Heap and PermGen



You may want to play with the heap and permgen settings of your Gitblit

instance because the default heap for the JVM is 95 MB, which may be a little

tight.