Forge Home

oracle_dbfs

Configure Oracle DBFS

10,323 downloads

9,515 latest version

4.8 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.1.4 (latest)
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0
released Nov 10th 2014
This version is compatible with:
  • Puppet Enterprise 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >=2.7.20
  • ,

Start using this module

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

Add this module to your Puppetfile:

mod 'elibus-oracle_dbfs', '0.1.4'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

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

Manually install this module globally with Puppet module tool:

puppet module install elibus-oracle_dbfs --version 0.1.4

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_dbfs — version 0.1.4 Nov 10th 2014

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_dbfs
  4. Usage - Configuration options and additional functionality
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module

##Overview

This module configure the Oracle DBFS as a Unix Service on RHEL 6 systems (should work on 7 in compatibility)

##Module Description

This module configure Oracle DBFS as a service and mount all defined remote file systems at boot. This is particularly useful as Oracle does not provide a way to automount DBFS (do not refer to the Oracle DBFS documentation because what's declared is NOT working)

##Setup

###What oracle_dbfs affects

This is what this module will alter:

  • Create /etc/sysconfig/oracle_dbfs
  • Create /etc/sysconfig/oracle_dbfs.mounts a fstab like file for your mounts
  • Create /etc/init.d/oracle_dbfs, chkconfig on the service and ensure it is running
  • Add the oracle user to the fuse group
  • Ensure packages fuse, fuse-libs are installed
  • touch /etc/fuse.conf and (if configured) ensure allow_other option is present
  • Create /etc/oracle/dbfs/{admin,wallet} where to store tnsnames.ora,sqlnet.ora and wallet files
  • Create any required mount point with owner oracle and related group (as configured)

###Setup Requirements

This module requires:

###Beginning with oracle_dbfs

This is a simpe use of the modules:

  include oracle_dbfs {
    user        => 'oracle',
    group       => 'dba',
    oracle_base => '/usr/ora11g/app/oracle',
    oracle_home => '/usr/ora11g/app/oracle/product/11.2.0.4/client',
    ewallet     => 'ewallet content',
    cwallet     => 'cwallet content',
    tnsnames    => 'tnsnames content',
    sqlnet      => 'sqlnet content',
    mounts      => {
      '/mnt/dbfs' => {
        'conn_string' => 'dbfs@DBFS',
        'mount_point' => '/mnt/dbfs',
      },
    }
  }

Defaults:

Option Defaults to Description
user_allow_other true puts in /etc/fuse.conf
config_dir /etc/oracle/dbfs Where to store wallet and tnsnames/sqlnet.ora files
user oracle Self explanatory
group dba Self explanatory
oracle_base /usr/ora11g/app/oracle Self explanatory
oracle_home /usr/ora11g/app/oracle/product/11.2.0.4/client Self explanatory
service_name oracle_dbfs Self explanatory

##Usage

To take the most out of this module I recommend using hiera + the hiera-file backend. This is an example using hiera:

  include oracle_dbfs

Hiera config file:

  ---
  oracle_dbfs:
    user:             'oracle'
    group:            'dba'
    oracle_base:      '/usr/ora11g/app/oracle'
    oracle_home:      '/usr/ora11g/app/oracle/product/11.2.0.4/client'
    config_dir:       '/etc/oracle/dbfs'
    user_allow_other: true
    mounts:
      '/mnt/oradbfs'
        conn_string: 'dbfs_user@DBFS'
        mount_point: '/mnt/oradbfs'
        mount_opts:  'waller,rw,allow_other'
      '/mnt/anotheroradbfs'
        conn_string: 'dbfs_user@DBFS'
        mount_point: '/mnt/anotheroradbfs'
        mount_opts:  'waller,rw,allow_other'

Then somewhere under your hiera hierarchy creates the following files:

  /etc/puppet/data/hiera/common:
    oracle_dbfs::cwallet
    oracle_dbfs::ewallet
    oracle_dbfs::tnsnames
    oracle_dbfs::sqlnet

##Reference

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 only on RHEL 6. It should work on RHEL 7 and Centos.

##Development

Since your module is awesome, other users will want to play with it. Let them know what the ground rules for contributing are.