release notes

Overview

Table of Contents

General

We strive to keep all of your puppet code working throughout any changes we make to our modules. When there is a path-level update of the version, that is ALWAYS the case. On minor version updates, the module contains either new facts, classes, defined types of functions, or the existing facts classes, defined types or functions accept new parameters and/or properties. Still in this case, your current Puppet® code should work without any changes.

However, on major versions, some adjustments to your Puppet® code might be required.

Version 4 release notes

With the transition from version 3 to version 4, we have made the following changes that are not backward compatible:

  • Structure of the facts
  • Removed deprecated parameters remote_file and log_output
  • Removed deprecated types opatch and bsu_patch

besides these changes, we have also added facter caching, to speed up Puppet® runs.

structure of facts

In facter version 4 facter supports caching. To efficiently use the fact caching, however we had to restructure the facts, making them incompatible with the older facts. The old facts were structured like this:

  "wls_install_homes": {
    "/opt/oracle/middleware12": {
      "installed_features": [
        "cieCfg_wls_external",
        "wls_client",
        ...
      ],
      "installed_patches": [
      ],
      "opatch_version": "13.9.4.2.1",
      "product_version": "12.2.1.4.0",
      "running_domains": [
      ]
    }
  }
}

The new facts are structured like this:

{
  "wls_install_homes": {
    "installed_features": {
      "/opt/oracle/middleware12": [
        "cieCfg_wls_external",
        "wls_client",
        ...
      ]
    },
    "installed_patches": {
      "/opt/oracle/middleware12": [
      ]
    },
    "opatch_version": {
      "/opt/oracle/middleware12": "13.9.4.2.1"
    },
    "product_version": {
      "/opt/oracle/middleware12": "12.2.1.4.0"
    },
    "running_domains": {
      "/opt/oracle/middleware12": [
      ]
    }
  }
}

As you can see, we have changed from having the oracle home as top-level, from having the functionality (e.g. installed_features, running_domains etc) as top-level and the oracle home as key for the values.

We have updated all of the functions and Puppet® code in wls_install to this new structure. If you have created your own functions or Puppet® code that uses this fact, you will have to change it to the new structure.

Removed deprecated parameters remote_file and log_output

The parameter remote_file has been deprecated and non-functional for long time. The log_output has already been superseded by the logoutput parameter for a long time, making the log_output parameter deprecated.

When you use these parameters, you need to apply the following changes to your puppet code:

  • remove all references to remote_file
  • change the log_output parameter to logoutput

Removed deprecated types opatch and bsu_patch

We have removed the Puppet® custom types opatch and bsu_patch. The module wls_config contains the Puppet® custom type wls_opatch. This type is much more powerful than the opatch type and we recommend starting using that. If you don’t have a license to use wls_config but do have a license for the wls_install module, contact us to help solve this issue.

The bsu_patch utility is not used for the newer versions of WebLogic. If you are still using these older WebLogic versions, it is best to keep on using version 3 of our modules.

Facter caching

For some of the larger installations, resolving some of the wls_install facts can be very time-consuming. Puppet® added facter caching to Facter version 4. To ensure backward compatibility, by default facter caching is disabled. So this should not cause any problems.

If you want to start using fact caching checkout the documentation here