Module converter

Enterprise Modules provides a set of high-quality modules to manage Oracle databases and Oracle WebLogic installations. These modules originated from the original Public Domain modules, but where changed to:

• Add better documentation
• Add better error checking
• Add more enterprise options

Why a name change

Puppet doesn't support namespaces. So for Puppet to differentiate between the unsupported Public Domain modules and the supported modules from Enterprise Modules, we needed different names.

Automatically change names

The utility in this repository, automatically converts your Puppet class from using the Open Source Oracle and WebLogic modules into using the supported modules from Enterprise Modules.

Installation

This utility is distributed as a Ruby Gem. So to install it, you'll need a running ruby environment. To install this gem, enter:

$ gem install emconnvert
emconvert (1.0.0) installed.

Usage

The syntax of the emconvert utility is:

$ emconvert [-v] [-b] wildcard_file

Where the options are:

• -v or -verbose Show a log of all files being processed and changed
• -b or --backup Make a backup of a file, when it is changed

Default the converter makes a backup, but doesn't log its activity.

Examples

Here is an example:

$ emconvert -v -b my_module/**/*.pp

This command will check all files with extension .pp and change all calls and references to the Oracle and Weblogic modules to calls and references to the puppet modules provided by Enterprise Modules.

What to convert

Normaly there are several places where the full names are used. In your puppet files - the files with extension .pp - of course. And in your hiera files. Normaly your hiera files have an extension .yaml. So you'll have to run the emconvert over both the set of files. An example:

$ emconvert -v -b all_my_puppet_code/**/*.pp  # Convert all the puppet files
$ emconvert -v -b all_my_hiera_data/**/*.yaml  # Convert all the hiera data

After conversion

After you have converted your modules, you can remove the obsolete Public Domain modules. The are:

• hajee-easy_type
• biemond-oradb
• hajee-oracle
• biemond-orawls
• biemond-orautils

And install the Enterprise Module supported modules:

• enterprisemodules-easy_type
• enterprisemodules-ora_install
• enterprisemodules-ora_config
• enterprisemodules-wls_install
• enterprisemodules-wls_config

What will NOT be converted?

When you are referencing templates or files inside the Public Domain modules, the emconvert utility will not convert that. You will have to change this yourself. You can recognise this kind of error's by this message:

Error: Could not retrieve catalog from remote server: Error 400 on SERVER: Could not find template 'ora_install/weblogic_silent_install_1213.rsp.erb' at /etc/puppet/modules/my_weblogic/manifests/weblogic.pp:151 on node vagrant.example.com
Warning: Not using cache on failed catalog
Error: Could not retrieve catalog; skipping run

When you are using an old version of the Public Domain modules, the API (e.g. the parameters and properties) might be changed. The emconvert utility will not change the parameter and property names. You will have to look at the new API description and change the parameters and properties. Most of the times it is the change of camel case to snake case. You can recognise this kind of errors by this kind of message:

Error: Could not retrieve catalog from remote server: Error 400 on SERVER: Invalid parameter wlHome on Wls_install::Support::Nodemanagerautostart[initd_nodemanager_bam_domain] at /etc/puppet/modules/my_wls2/manifests/bam/domain.pp:170 on node vagrant.example.com