Forge Home

groundplex

pdk
Configures Snaplogic Groundplex nodes

398 downloads

398 latest version

5.0 quality score

Version information

  • 0.1.0 (latest)
released Sep 1st 2021
This version is compatible with:
  • Puppet Enterprise 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
  • Puppet >= 6.21.0 < 8.0.0
  • CentOS
    ,
    RedHat

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'arden-groundplex', '0.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add arden-groundplex
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install arden-groundplex --version 0.1.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

arden/groundplex — version 0.1.0 Sep 1st 2021

groundplex

pipeline status Version coverage report

Table of Contents

  1. Description
  2. Setup - The basics of getting started with groundplex
  3. Usage - Configuration options and additional functionality
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module

Description

This module installs and configures the Snaplogic Sidekick module on the current node. It also provides a baseline configuration for SAP connectivity and makes managing the additional service definitions relatively trivial.

Setup

What groundplex affects

Primarily does the following:

  • Installs the snaplogic-sidecar
  • Downloads and places the slpropgz file from your Snaplogic Organization
  • Adds appropriate entries into /etc/services to support connections to SAP instances

Setup Requirements

You'll need to have the following components configured:

  • snaplogic-sidekick package must be available to the node via your package manager

The following two puppet modules are also dependencies, however, the needed versions are not currently available on puppet forge.

  • sap - needed for some type alias definitions
  • etc_services - relevant for syntax changes introduced by this version

SAP Java Connector (Deprecated)

This process is no-longer needed as the Java Connector is bundled into the package.

  1. Download the latest version of the SAP Java Connector from their website
  2. Extract the archive and host the files libsapjco3.jnilib and libsapjco3.so on your puppetmaster or a server your nodes can reach easily.
  3. Calculate the checksums of each file and provide both the source URL and the checksum to the groundplex class.
See Also

Also, if using SAP Java Connections consider deploying niping to your node for testing purposes.

Beginning with groundplex

The following puppet code defines a node as a standard execution engine (JCC).

class { 'groundplex':
  slpropz_source => 'https://elastic.snaplogic.com/api/1/rest/plex/config/ExampleOrg/shared/Example?expires=1623084093&user_id=someuser%40example.com&_sl_authproxy_key=SomeRandomTokenStuff
  server_type    => 'JCC',
}

Usage

Puppet configuration including SAP connection definitions.

class { 'groundplex':
  slpropz_source    => 'https://elastic.snaplogic.com/api/1/rest/plex/config/ExampleOrg/shared/Example?expires=1623084093&user_id=someuser%40example.com&_sl_authproxy_key=SomeRandomTokenStuff'
  server_type       => 'JCC',
  array_msg_servers => [
    {
      sid            => 'DEV',
      instance_class => 'cs-abap',
      number         => '01',
    },
    {
      sid            => 'QAS',
      instance_class => 'cs-abap',
      number         => '01',
    },
    {
      sid            => 'PRD',
      instance_class => 'cs-abap',
      number         => '01',
    },
  ],
}

Hiera configuration including SAP connection definitions.

groundplex::slpropz_source: 'https://elastic.snaplogic.com/api/1/rest/plex/config/ExampleOrg/shared/Example?expires=1623084093&user_id=someuser%40example.com&_sl_authproxy_key=SomeRandomTokenStuff'
groundplex::server_type: 'JCC'
groundplex::array_msg_servers:
  - sid: 'DEV'
    instance_class: 'cs-abap'
    number: '01'
  - sid: 'QAS'
    instance_class: 'cs-abap'
    number: '01'
  - sid: 'PRD'
    instance_class: 'cs-abap'
    number: '01'

Limitations

Currently only tested on RHEL/CentOS/Rocky 7 and 8.

Development

Make a pull request and we'll figure it out!