James Moger
2012-01-06 679f2bd6e09afe117e9b30fedcf0d351fefaecd5
Updated Express documentation
1 files modified
27 ■■■■ changed files
distrib/openshift.mkd 27 ●●●● patch | view | raw | blame | history
distrib/openshift.mkd
@@ -5,21 +5,26 @@
dependencies bundled.
You should delete the `pom.xml` file and the `src` folder from your application repository
as this Gitblit Express is not a source distribution to be built with Maven on OpenShift.
as Gitblit Express is not a source distribution to be built with Maven on OpenShift.
Gitblit automatically adjusts itself to running on OpenShift.  Repositories, users,
federation proposals, and setting overrides are stored in *OPENSHIFT_DATA_DIR*.
federation proposals, setting overrides, and Groovy push scripts are stored in *OPENSHIFT_DATA_DIR*.
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.
It is also recommended to set *web.forwardSlashCharacter* to ! because OpenShift
runs on JBoss/Tomcat behind a proxy, neither of which are friendly to embedded
forward-slashes.
Please do not change the following settings unless you know exactly what you are
doing:
- *git.repositoriesFolder*
- *groovy.scriptsFolder*
- *federation.proposalsFolder*
- *realm.userService* (for standard users.properties)
- *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
@@ -29,6 +34,22 @@
    rm -fr $OPENSHIFT_APP_DIR/jbossas-7.0/standalone/tmp/vfs/*
Lastly, 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.
To do that you will have to login to your account via ssh:
    ssh hashcode@app-domain.rhcloud.com
and then you will have to manipulate the -Xmx and -XX:MaxPermSize values.
    vi $OPENSHIFT_APP_DIR/jbossas-7.0/bin/standalone.conf
    ctl_app restart
OpenShift currently allows 300MB of memory per application which includes ssh access, JVM, etc.
The Gitblit demo hosted on OpenShift Express operates with -Xmx160m and -XX:MaxPermSize=90m.
For more detailed instructions on how to setup and deploy an OpenShift application
please see this excellent turorial: