Table of Contents

1. Overview
2. License
3. Description - What the module does and why it is useful
4. Setup

• Requirements
• Installing the wls_install module

5. Usage - Configuration options and additional functionality
6. Reference - An under-the-hood peek at what the module is doing and how
7. Limitations - OS compatibility, etc.

Overview

The wls_profile module allows an easy path from first simple installation to a fully customized Enterprise setup. It is part of our family of Puppet modules to install, manage and secure WebLogic and Fusion Middleware with Puppet. Besides the wls_profile module, this family also contains:

• wls_config For configuring an Oracle WebLogic and other Fusion products
• wls_install For installing an Oracle WebLogic and other Fusion products

License

Most of the Enterprise Modules modules are commercial modules. This one is NOT. It is an Open Source module. You are free to use it any way you like. It, however, is based on our commercial Puppet WebLogic modules.

Description

This module has a couple of convenient classes to help you setup your WebLogic environment:

• wls_profile::weblogic Ensure WebLogic is installed and patched
• wls_profile::basic_domain Same as weblogic and create an empty domain.
• wls_profile::admin_server Same as basic_domain and create some machines and servers, clusters and some other WebLogic object.
• wls_profile::node Same as weblogic and after that copy the domain from an admin server and load it.

All of these classes contain some steps. All of these stapes have default implementations, but you can add extra Puppet code to the catalog and remove or override the default implementation. This can all be done by adding values to your hiera files.

Check here to see the full documentation for this module.

Setup

Requirements

The wls_profile module requires:

• Puppet module enterprisemodules-easy_type installed.
• Puppet module enterprisemodules-wls_install installed.
• Puppet module enterprisemodules-wls_config installed.
• Puppet version 4.10.8 or higher. Can be Puppet Enterprise or Puppet Open Source
• WebLogic 10g or higher
• A valid Oracle Weblogic or Fusion license
• A valid Enterprise Modules license for usage.
• Runs on most Linux systems.
• Runs on Solaris
• Windows systems are NOT supported

This module uses some other public Puppet forge modules. Check the metadata to ensure you have all dependencies installed.

We support WebLogic versions:

• WebLogic 10g
• WebLogic 11g
• WebLogic 12.1.2
• WebLogic 12.1.3
• WebLogic 12.2.1
• WebLogic 12.2.1.1
• WebLogic 12.2.1.2
• WebLogic 12.2.1.3
• WebLogic 12.2.1.4
• WebLogic 14.1.1.0

And Fusion versions:

• WebLogic 10g
• WebLogic 11g
• WebLogic 12c ( 12.1.1, 12.1.2, 12.1.3, 12.2.1, 12.2.1.1, 12.2.1.2, 12.2.1.3, 12.2.1.4)

Installing the wls_profile module

To install these modules, you can use a Puppetfile

mod 'enterprisemodules/wls_profile'               ,'0.1.0'

Then use the librarian-puppet or r10K to install the software.

You can also install the software using the puppet module command:

puppet module install enterprisemodules-wls_profile

Usage

To get started, include the wls_profile::admin_server class in your role, make sure you have a module called software that has a folder files and that directory contains the next files:

• fmw_12.2.1.3.0_wls.jar WebLogic software
• jdk-8u152-linux-x64.tar.gz Java JDK software
• jce_policy-8.zip Java Encryption Policy

Run Puppet and you have a Server with WebLogic installed, a domain called MYDOMAIN and a cluster called main. Check the documentation for all the settings you can manage. Here is a list of the most basic stuff you'd probably want to change:

wls_profile::domain_name:         MYDOMAIN                      # The domain name
wls_profile::cluster_name:        main                          # Cluster name
wls_profile::weblogic_password:   Welcome01                     # Weblogic password
wls_profile::source:              puppet:///modules/software    # Location where the files are fetched from
wls_profile::weblogic::ssh_setup::public_key:                     AAAAB3N.....M43olbQ==
wls_profile::weblogic::ssh_setup::private_key: |
  -----BEGIN RSA PRIVATE KEY-----
  MIIJKQIBAAKCAgEA5zOPmOVSF3MFXaEoLlbZICXuG0q2uT5kW1BwRzDbzVdiJtuA
  ...
  PsLoml7g3jpGkRb3xgW1N4N4Xt+Vkzp6qAB5aqvCZO3EoHfeOS5DE9O+XbSW
  -----END RSA PRIVATE KEY-----

Reference

Here you can find some more information regarding this puppet module:

• The wls_profile documentation
• The wls_install documentation
• The wls_config documentation

Here are related blog posts:

• Introducing version 3 of wls_config
• Know thy WebLogic configuration using Puppet
• Manage your WebLogic JMS config with Puppet
• Using Puppet to install and manage your WebLogic infrastructure

Some example code:

• Simple WLS demo
• Fusion middleware demo

Limitations

This module runs on Solaris and most Linux versions. It requires a puppet version higher than 4.10.8. The module does NOT run on windows systems.

Changelog

All notable changes to this project will be documented in this file.

Release 0.11.1

Chore

• [data] Remove default managed servers

Release 0.11.0

Features

• [apply_patches] Add initial bolt plan to apply WebLogic patches from bolt
• [wls_patches] Add patchlevel functionality

Release 0.10.3

Bugs

• [groups_and_users] Fix OS password generation

Release 0.10.2

Bugs

• [groups_and_users] Leave hashing of os passwords to class

Release 0.10.1

Bugs

• [release] Add WebLogic 14.1.1.0 support to rhe README
• [basic_domain] replace deprecated staged_contain for ordered_steps

Release 0.10.0

Features

• [release] Add support for puppet 7 to the metadata

Release 0.9.0

Features

• [weblogic] Automaticaly fetch EM licenses

Release 0.8.1

Bugfixes

• [wls_startup] Use custom trusts for startup
• [java_software] Add entropy fix

Release 0.8.0

Features

• [java_software] Start using module puppetlabs-java

Release 0.7.0

Features

• [wls_domain] Add support for ssl communication

Bugfixes

• [core] Remove hardcoded passwords

Release 0.6.1

Bugfixes

• [wls_domain] Add repo_sys_password to list of keys to convert to Sensitive

Release 0.6.0

Features

• [core] Generated password added
• [core] Add support for Sensitive data
• [weblogic] Don’t install fusion software when install_type is ADF

Bugfixes

• [core] Also include original lookups of Sensitive passwords in lookup options

Release 0.5.1

Features

• [wls_domain] Add support for more fusion domain types
• [release] Update readme to indicate support for WebLogic 12.2.1.4

Release 0.5.0

Features

[core] Add basic support for Solaris

Release 0.4.0

Features

• [core] Add AIX support

Release 0.3.3

Bugfixes

• [wls_domain] Add extra properties parameter

Release 0.3.2

Bugfixes

• [core] Export the download_dir and temp_dir parameters
• [copy_domain] Fix directory issues

Release 0.3.1

Features

None

Bugfixes

-[copy_domain] Fix used app dir

Release 0.3.0

Features

• [wls_opatch] Initial implementation

Bugfixes

None

Release 0.2.1

Features

None

Bugfixes

• [wls_patches] Fix puppet type for the patches
• [weblogic] Add missing fmw_software variables
• [core] Add support for Sensitive data
• [packages] Use Hash, like other profiles

Release 0.2.0

Features

• Add basic support for Fusion Middleware
• Make ready for Puppet 6

Bugfixes

None

Release 0.1.4

Features

None

Bugfixes

• Fix used resource types in wls_jms

Release 0.1.3

Features

• Manage firewall ports on both RHEL5 and RHEL > 5 systems
• Add unit and acceptance tests
• Remove reliance on old defauts
• implement EM Quality control

Bugfixes

None

Known Issues

None

Release 0.1.2

Features

None

Bugfixes

Fix README

Known Issues

None

Release 0.1.1

Features

None

Bugfixes

Fix README

Known Issues

None

Release 0.1.0

Features

• Install basic Weblogic systems

Bugfixes

None

Known Issues

• No good firewall implementation
• No good wls_patches implementation