Forge Home

oracle_webgate

Install and configure Oracle Webgate

13,585 downloads

7,797 latest version

3.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.2.9 (latest)
  • 0.2.8
  • 0.2.7
  • 0.2.6
  • 0.2.5
  • 0.2.4
  • 0.2.2
  • 0.2.1
  • 0.2.0
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0
released May 5th 2016
This version is compatible with:
  • Puppet 2.7.x
  • ,

Start using this module

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

Add this module to your Puppetfile:

mod 'elibus-oracle_webgate', '0.2.9'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add elibus-oracle_webgate
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install elibus-oracle_webgate --version 0.2.9

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

elibus/oracle_webgate — version 0.2.9 May 5th 2016

Build Status

####Table of Contents

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

##Overview

This puppet module will install and configure Oracle Access Manager Webgate for Apache on Linux.

##Module Description

Oracle Access Manager Webgate has a really crappy installation process, this module automates the installation and configuration process. This is what it does:

  • Download the installation package from a remore repository (http/https)
  • Create a temp dir where to extract the required content
  • Ensure the necessary dependencies are installed
  • Copy the system libs requirered by the install (please refer to: http://docs.oracle.com/cd/E15217_01/doc.1014/e12493.pdf)
  • Copy the OAM certificates
  • Run the installa process
  • Run the configuration process

##Setup

###What oracle_webgate affects Notes:

  • The (crappy) Oracle installer requires a copy of libgcc_s.so.1 and libstdc++.so.6 in a specified directory to work properly. The module will take care of copying those files if they are available
  • The software will be installed in the default installation path, i.e. /opt/netpoint/access, this cannot be changed
  • This module will install libstc++.i686 and libstc++.x86_64 on 64 bit systems. Puppet might fail because of multilib if a libstc++.i686 version newer than the libstc++.x86_64 already installed is available (see https://projects.puppetlabs.com/issues/23245)

###Setup Requirements

Before you start, you need:

  • a working OAM server
  • OAM Certificates copied either on your puppet server on available in hiera
  • OAM Webgate installation ZIP file available on a http/https repository

###Beginning with oracle_webgate

The very basic steps needed for a user to get the module up and running.

  class { 'oracle_webgate':
    serverId        => 'oamServerId',
    hostname        => 'oam.example.com',
    webgateId       => 'thisServer',
    port            => '5575',
    password        => 'password',
    passphrase      => 'passphrase',
    remoteRepo      => 'https://www.example.com/repo/oracle',
    installPackage  => 'Oracle_Access_Manager10_1_4_3_0_linux64_APACHE24_WebGate.zip',
  }

This is a full example with bundle patch for Apache 2.2.

  class { 'oracle_webgate':
    serverId        => 'oamServerId',
    hostname        => 'oam.example.com',
    webgateId       => 'thisServer',
    port            => '5575',
    password        => 'password',
    passphrase      => 'passphrase',
    remoteRepo      => 'https://www.example.com/repo/oracle',
    installPackage  => 'Oracle_Access_Manager10_1_4_3_0_linux64_APACHE22_WebGate.zip',
    patchPackage    => 'Oracle_Access_Manager10_1_4_3_0_BP13_Patch_linux64_APACHE22_WebGate.zip',
    patchVersion    => '13',
  }

Defaults:

Option Defaults to Description
certFile puppet:///modules/oracle_webgate/certFile.pem Certificate file
keyFile puppet:///modules/oracle_webgate/keyFile.pem Key file
chainFile puppet:///modules/oracle_webgate/chainFile.pem Chain file
downloadDir /tmp/oracle_webgate_install Temp dir where to download and unzip installation files
defaultLang en-us
installLang en-us
securityMode cert See Oracle docs
patchVersion 0 Version of the bundle patch

###Removing oracle_webgate

To fully remove the Oracle Webgate just include the class oracle_webgate:uninstall.

##Usage

The module does not require any special configuration besides what just showed. If you are using puppet 3.0+ you can take the most out of the hiera integration installing the hiera-file backend. An example might shade some light:

  • Leave the oracle_webgate::* variable undefined

  • Create a hiera structure like the following:

     /etc/puppet/hiera/data/default
       oracle_webgate.d/
         oracle_webgate::certFile
         oracle_webgate::keyFile
         oracle_webgate::chainFile
    
  • Hiera searches for a file called oracle_webgate.d/oracle_webgate::certFile in your hiera data folder providing the file content as content for the variable

    The outcome is... the file is copied on the client!

##Reference

Classes

Facts

Here, list the classes, types, providers, facts, etc contained in your module. This section should include all of the under-the-hood workings of your module so people know what the module is touching on their system but don't need to mess with things. (We are working on automating this section!)

##Limitations

This module has been tested on:

  • RedHat 7 64 bit + OAM Webgate for Apache 2.4
  • RedHat 6 64 bit + OAM Webgate for Apache 2.2

It should work also on:

  • 32 bits RedHat systems with Apache 2.2

##Development

See https://github.com/elibus/puppet-oracle_webgate/blob/master/CONTRIBUTING.md