README.md

Table of Contents

• Overview
• Experience the Power of Puppet for Oracle WebLogic
• License
• Description
• Setup
  • Requirements
    • We support WebLogic versions:
  • Installing the wls_profile module
• Usage
• Reference
• Limitations

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

Experience the Power of Puppet for Oracle WebLogic

Installing Oracle WebLogic and/or Fusion software and managing your WebLogic domain configuration can be hard. With Puppet at your side, you get super-powers when installing and managing Oracle WebLogic. If you want to play and experiment with this please take a look at our playgrounds.

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.