SAP HANA Express docker hosting module

This module manages multiple SAP HANA Express instances using Docker as described on the official SAP HANA Tutorials page.

Please note, that this module is in no means connected to SAP in any kind. Please don't ask them for support.

Usage

Puppet

Initialize the hanaexpress class with your login credentials for the Docker store:

class {
    'hanaexpress':
        store_username => 'my_user',
        store_password => 'my_password'
}

After that, initialize docker instances using the database type:

hanaexpress::database {
    'testhana1':
        version => '2.00.030.00.20180403.2',
        password => 'TestHanaExpress1',
        systemdb_port => 39017,
        tenantdb_port => 39041
}

This will configure and startup a HANA express which will be available by ports 39017 for the systemdb and 39041 for the tenantdb. The SYSTEM user will have the given password.

Hiera

This module directly supports hiera like this:

classes:
  - hanaexpress

hanaexpress::store_username: my_user
hanaexpress::store_password: my_password

hanaexpress-databases:
    testhana1:
        version: "2.00.030.00.20180403.2"
        password: 'TestHanaExpress1'
        systemdb_port: 39017
        tenantdb_port: 39041

Integration tests

Because HANA express requires a lot of resources, the integration tests can not be run locally or automatically. We have, however, set up a kitchen integration test, that runs on Azure. Check out the configuration docs if you want to start it. Additionally, you need a Docker store login and then run the tests like this:

AZURE_SUBSCRIPTION_ID=your-azure-subscription-id AZURE_LOCATION=azure-location STORE_USERNAME=Docker-store-username STORE_PASSWORD=Docker-store-password bundle exec kitchen test all

Reference

Table of Contents

Classes

• hanaexpress: Setup SAP HANA Express hosting

Defined types

• hanaexpress::database: Sets up a container with a SAP HANA database

Classes

hanaexpress

Sets up basic things needed for SAP HANA Express hosting based on the SAP HANA Tutorial for Docker.

Parameters

The following parameters are available in the hanaexpress class.

store_username

Data type: String

Username for the Docker store

store_password

Data type: String

Password for the Docker store

hana_data_path

Data type: String

Host path for persisting hana data

pass_is_hash

Data type: Boolean

Set to true, if the password is actually the password hash of the user

manage_service

Data type: Boolean

Manage a system service for each managed app

Defined types

hanaexpress::database

Sets up a container with a SAP HANA database

Parameters

The following parameters are available in the hanaexpress::database defined type.

name

Name of the hana instance (only ASCII-characters and numbers are allowed)

version

Data type: String

Version of the HANA image to use (i.e. 2.00.030.00.20180403.2)

password

Data type: String

Master password. [Step 7](See https://www.sap.com/developer/tutorials/hxe-ua-install-using-docker.html) for specifics about valid passwords

systemdb_port

Data type: Integer

Port to use for the HANA System database

tenantdb_port

Data type: Integer

Port to use for the HANA default tenant database (HXE)

manage_service

Data type: Optional[Boolean]

Manage a system service for this database

Default value: undef

Changelog

All notable changes to this project will be documented in this file.

Release 2.0.0

Features

• Support for Puppet 6

Bugfixes

Known Issues

Release 1.0.0

Features

Bugfixes

• Locked this version to Puppet <6

Known Issues

Release 0.1.1

Features

Bugfixes

• Fixing incompatibility with current docker module version (#1)

Known Issues

Release 0.1.0

Features

Bugfixes

Known Issues