Skip to content
This repository has been archived by the owner on Apr 21, 2024. It is now read-only.

Latest commit

 

History

History
55 lines (38 loc) · 3.38 KB

README.md

File metadata and controls

55 lines (38 loc) · 3.38 KB

This repository is no longer maintained.

Issue reports and pull requests will not be attended.

⚠️ DISCLAIMER

Use these artefacts as a reference to build your deployment artefacts. Existing artefacts only developed to demonstrate a reference deployment and should not be used as is in production


Puppet Modules for WSO2 Identity Server

This repository contains the Puppet modules for WSO2 Identity Server and the profiles related to Identity Server Analytics.

Supported Puppet Versions

  • Puppet 5.4.0

Quick Start Guide

  1. Download a product package. Product packages can be downloaded and copied to a local directory, or downloaded from a remote location.

    • Local: Download a wso2is-5.11.0.zip to your preferred deployment pattern and copy it to the <puppet_environment>/modules/is_common/files/packs directory in the Puppetmaster.
    • Remote:
      1. Change the value $pack_location variable in <puppet_environment>/modules/is_common/manifests/params.pp to remote.
      2. Change the value $remote_pack variable of the relevant profile in <puppet_environment>/modules/is_common/manifests/params.pp to the URL in which the package should be downloaded from, and remove it as a comment.
  2. Set up the JDK distribution as follows:

    The Puppet modules for WSO2 products use Amazon Corretto as the JDK distribution. However, you can use any supported JDK distribution. The JDK Distribution can be downloaded and copied to a local directory, or downloaded from a remote location.

  • local: Download Amazon Corretto for Linux x64 from here and copy .tar into the <puppet_environment>/modules/is_common/files/jdk directory.
  • remote: Change the value $remote_jdk variable in <puppet_environment>/modules/is_common/manifests/params.pp to the URL in which the JDK should be downloaded from, and remove it as a comment.
  • Reassign the $jdk_name variable in <puppet_environment>/modules/is_common/manifests/params.pp to the name of the downloaded JDK distribution.
  1. Run the relevant profile on the Puppet agent.
    1. Identity Server profile:
      export FACTER_profile=is
      puppet agent -vt

Performance Tuning

System configurations can be changed through Puppet to optimize OS level performance. Performance tuning can be enabled by changing $enable_performance_tuning in <puppet_environment>/modules/is_common/manifests/params.pp to true.

System files that will be updated when performance tuning is enabled is available in <puppet_environment>/modules/is_common/files/system. Update the configuration values according to the requirements of your deployment.

Manifests in a module

Module architecture

The run stages for Puppet are described in <puppet_environment>/manifests/site.pp, and they are of the order Main -> Custom.

Each Puppet module contains the following .pp files.

  • Main
    • params.pp: Contains all the parameters necessary for the main configuration and template
    • init.pp: Contains the main script of the module.
  • Custom
    • custom.pp: Used to add custom configurations to the Puppet module.