partekflow

tasks
Puppet module for installation and configuration of Partek Flow.

Jeffrey Miller

millerjl1701

5,633 downloads

5,276 latest version

5.0 quality score

Version information

  • 1.3.1 (latest)
  • 1.3.0
  • 1.2.0
  • 1.1.0
  • 1.0.0
released Oct 11th 2017
This version is compatible with:
  • Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 6.0.0
  • RedHat
    ,
    CentOS
Tasks:
  • backupdb

Start using this module

Documentation

millerjl1701/partekflow — version 1.3.1 Oct 11th 2017

partekflow

master branch: Build Status

Table of Contents

  1. Module Description - What the module does and why it is useful
  2. Setup - The basics of getting started with partekflow
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module

Module Description

The partekflow module installs, configures, and manages Partek Flow software package and service. Partek Flow is "designed specifically for the analysis needs of next generation sequencing applications including RNA, small RNA, and DNA sequencing" that includes a web interface for creation and utilization of custom pipelines. http://www.partek.com/partekflow

Setup

What partekflow affects

  • User and Group: flow
  • Group: flowuser
  • RPM GPG Key: /etc/pki/rpm-gpg/partek-public.key
  • Yumrepos for accessing partek flow RPM repositories. The stable repositories are enabled while the unstable ones are not.
  • Package: partekflow
  • File: /etc/partekflow.conf
  • Catalina temp directory location
  • Service: partekflowd

Beginning with partekflow

include partekflow should be all that is needed to install, configure and start the partekflowd service. One can also pass parameters in to change the configuration:

class { 'partekflow':
    config_catalina_tmpdir => '/home/flow/partek_flow/temp',
}

Usage

All parameters are passed to the main class via either puppet code or hiera. The other classes should not be called directly. Some usage examples are presented below.

Install and startup partekflowd service

include partekflow

Change the location of the CATALINA_TMPDIR setting in /etc/partekflow.conf

class { 'partekflow':
  config_catalina_tmpdir => '/home/flow/partek_flow/temp',
}

or via hiera:

---
partekflow::config_catalina_tmpdir: '/home/flow/partek_flow/temp'

To use a different template for the partekflow.conf file

class { 'partekflow':
  config_template => 'module_name/path/to/template.erb',
}

To disable the stable repsitory files but still have them present in /etc/yum.repos.d/

class { 'partekflow':
  yumrepo_ensure_stable  => true,
  yumrepo_enabled_stable => false,
}

To use a local repository mirror instead of the Partek repositories

class { 'partekflow':
  yumrepo_baseurl_server       => 'http://yum.example.com',
  yumrepo_baseurl_stablepath   => '/path/to/stable',
  yumrepo_baseurl_unstablepath => '/path/to/unstable',
}

To remove the unstable /etc/yum.repos.d/ files

class { 'partekflow':
  yumrepo_ensure_unstable => false,
}

Reference

This module is setup for the use of Puppet Strings to generate class and parameter documentation. The Puppet Strings doumentation provides more details on what Puppet Strings provides and other ways of generating documentaiton output.

As a quick start, if you are using the gem version of puppet:

gem install puppet-strings
puppet strings generate manifests/*.pp

The puppet strings command should be run from the root of the module directory. The resulting documentation will by default be placed in a docs/ directory within the module.

If you are setup with the development environment as described in the CONTRIBUTING document :

bundle exec rake strings:generate manifests/*.pp

from within the module directory will generate the documentation as well.

Limitations

This module is written to work with Puppet 4.7 or higher. Hiera 5 data is embedded within the module as well for Puppet 4.9 or higher. The module depends on Puppet 4 data types provided by puppetlabs-stdlib as well as the treydock-gpg_key module.

Originally written for CentOS 6/7 systems, it could work on other osfamily RedHat distributions. While Partek Flow supports installation on Debian based distributions, this module does not at this time.

This module was written to reflect initial installation and configuration documentation provided by Partek. This is not an all inclusive module as there are configuration tasks that need to be done via the web UI to configure portions of the application. If you find some configuration option would be helpful for maintaining the software on your own servers, please submit an issue or pull request. The latest released version of Partek flow when this was written was: 6.0.17.0919.278-1 and serves as a start point for reference. It is possible that this module will work with prior partekflow versions; however, that condition has not been tested.

While the module maintainer supports the puppet code contained in the module, support for the application or performance of the Partek Flow software should be directed toward Partek. The module maintainer does not have a relationship with Partek.

Development

Please see the CONTRIBUTING document for information on how to get started developing code and submit a pull request for this module. While written in an opinionated fashion at the start, over time this can become less and less the case.

Contributors

To see who is involved with this module, see the GitHub list of contributors or the CONTRIBUTORS document.