puppet-mirthconnect

   

Puppet Module For Mirthconnect

About

Mirth Connect allows applications to communicate with disparate health information systems using a wide variety of protocols and messaging systems. It supports Windows, OSX, and RHEL/CentOS distributions, while this module is aimed at CentOS only (untested on RHEL).

Supported Versions (tested)

OS

• AWS Linux
  • Mirth Connect Base install (Mirth Connect not pre-installed)
    • 3.4.0.8000.b1959 (from source only)
• CentOS 6
  • Mirth Connect Base install (Mirth Connect not pre-installed)
    • 3.4.0.8000.b1959

Prerequisites

1. Yum repository with Mirth Connect RPMs available (The EULA does not allow redistribution) if using the 'yum' provider (see usage).
2. Valid license information

Parameters

• admin_password
• The password to set the admin password to post-install.
• db_dbname
• Optional database name for mirth to use in the mirth.properties file.
• Not optional if the db_provider is set to anything but 'derby'
• db_host
• Optional database hostname for mirth to use in the mirth.properties file.
• Not optional if the db_provider is set to anything but 'derby'
• db_pass
• Optional database password for mirth to use in the mirth.properties file.
• Not optional if the db_provider is set to anything but 'derby
• db_port
• Optional database port for mirth to use in the mirth.properties file.
• Not optional if the db_provider is set to anything but 'derby'
• db_provider
• Optional database provider for mirth to use in the mirth.properties file.
• Currently the only valid strings are 'derby' or 'mysql'
• db_user
• Optional database user for mirth to use in the mirth.properties file.
• Not optional if the db_provider is set to anything but 'derby'
• java_version
• Optional java version to install. Defaults to 'java-1.8.0-openjdk'
• provider
• The provider to download the MirthConnect package from. Can be one of 'rpm', 'source', or 'yum'.
• rpm_source
• The source of the RPM if using the 'rpm' provider.
• tarball_source
• Optional source of the source tarball.
• Not optional if using the 'source' provider.

Quick Start

1. Via Yum

    yumrepo { "my mirth repo":
       baseurl  => "http://server/pulp/repos/mirthconnect/",
       descr    => "My Mirth Connect Repository",
       enabled  => 1,
       gpgcheck => 0,
     }
    class { 'mirthconnect':
      provider => 'yum',
    }
   

2. Via RPM (default)

    class { 'mirthconnect::mirthconnect':
      provider       => 'rpm' # RPM is the default.
      rpm_source     => 'www.foo.com/mirth-1.2.1.rpm' # change the source RPM
      admin_password => 'foo',
    }
   

3. Using MySQL instead of derby

    $override_options = {
      'mysqld' => {
        'lower_case_table_names' => '1' ,
      }
    }
    
    $mysql_root_password = 'somerootpass'
    $mirthdbuser = 'mirth'
    $mirthdbpass = 'mirthdbpass'
    $mirthdbname = 'mirthdb'
    
    class { '::mysql::server':
      root_password    => $mysql_root_password ,
      override_options => $override_options ,
    }->
    
    mysql::db { $mirthdbname:
      user     => $mirthdbuser,
      password => $mirthdbpass,
      host     => 'localhost',
    }
    
    class {'mirthconnect':
      db_host        => 'localhost',
      db_user        => $mirthdbuser,
      db_pass        => $mirthdbpass,
      db_provider    => 'mysql',
      db_port        => '3306',
      db_dbname      => $mirthdbname,
      admin_password => $mirth_admin_password,
      provider       => 'rpm',
    }
    
    Mysql_grant["${mirthdbuser}@localhost/${mirthdbname}.*"] -> Service['mirthconnect']
   

Hiera

mirthconnect::admin_password: 'admin'
mirthconnect::db_dbname:      'mirthdb'
mirthconnect::db_host:        'localhost'
mirthconnect::db_pass:        'abc1234'
mirthconnect::db_port:        '3306'
mirthconnect::db_provider:    'mysql'
mirthconnect::db_user:        'mirth'
mirthconnect::provider:       'rpm'
mirthconnect::rpm_source:     'www.foo.com/mirth.rpm'
mirthconnect::tarball_source: 'www.foo.com/mirth.tar.gz'

Testing

• Run the default tests (puppet + lint)

    bundle install
    bundle exec rake
  

• Run the beaker acceptance tests

Due to licensing issues, I cannot distribute the MirthConnect RPM.

    $ for i in `ls spec/acceptance/*_spec.rb`; do echo $i; MIRTH_YUM_URL=http://my.foo.com/yum/ bundle exec rspec $i | grep -A 150 Destroying\ vagrant\ boxes; done