a template to use to run and use metridoc view templates
Shell Groovy
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This is a basic template / container for the view layer of metridoc. All of the metridoc projects are grails plugins and this application represents starting point to use these components. Although this readme should help you get started, more details about MetriDoc software are available at the MetriDoc wiki.
For the most part, MetriDoc is an api / scripting tool to migrate data and the view part is an optional component to view / download that data. If you want to use any of the view components that have been created for MetriDoc, this is the place to start.

Getting Started

This template represents a default grails application that only contains the metridoc-core plugin. The template is actually a running application. No MetriDoc applications are installed, so by itself it doesn't do anything particularily interesting besides configuring security. The following commands will get it working

git clone https://github.com/metridoc/metridoc-template-app.git
cd metridoc-template-app
./grailsw run-app

You should see a simple home page listing installed applications (which there are none). You can log in as admin with user name admin and password password to see the admin components. At this point the application is running on an in memory database, so any changes you make will be lost on a restart. And given the default password, very insecure.

For production depoyment you have two options, you can either run ./grailsw run-war which fires up the application on a Tomcat server, or run ./grailsw war to create a war archive of the application which can be deployed to your favorite servlet container. MetriDoc components have been tested on Jetty and Tomcat. Tried and failed to get the application to work on Glassfish.

Setting up the Data Source

If you look at Config.groovy, there are two things to notice regarding DataSources. First, configurations from the file ~/.metridoc/MetridocConfig.groovy are imported so you can externalize your database connection parameters. Also, any jdbc driver stored under ~/.grails/drivers/ will be added to the classpath. You can of course change this behaviour by changing the config file.

If you don't mind adding your connection parameters directly to the project, simply change the
DataSource.groovy file. You could also externalize the sensitive data into MetridocConfig.groovy, while keeping the connection parameters in DataSource.groovy. For instance, DataSource.groovy might look like

dataSource {    
    pooled = true
    dbCreate = "update"
    url = "jdbc:mysql://foo.bar:3306/metridoc"
    driverClassName = "com.mysql.jdbc.Driver"
    dialect = MySQL5InnoDBDialect

and your MetridocConfig.groovy might look like

dataSource {
    username = "root"
    password = "foofam"

So anything in MetridocConfig.groovy will override any variable in DataSource.groovy and Config.groovy