Version information
This version is compatible with:
- Puppet Enterprise 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, 2016.4.x
- Puppet >=4.10.8
- , , , , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'enterprisemodules-wls_install', '3.2.2'
Learn more about managing modules with a PuppetfileDocumentation
Table of Contents
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
Overview
This module allows you to install an Oracle WebLogic or Fusion middleware stack. It is part of our family of Puppet modules to install, manage and secure Oracle WebLogic and Fusion Middleware with Puppet. Besides the wls_install
module, this family also contains:
- wls_config For configuring an Oracle WebLogic and other Fusion products
License
This is a commercially licensed module. But you can use the module on VirtualBox based development systems for FREE. When used on real systems a license is required.
You can license our modules in multiple ways. Our basic licensing model requires a subscription per node. But contact us for details.
Check the License for details.
Description
This Puppet module allows you to install Oracle WebLogic and other products in the Oracle Fusion Middleware family.
Fusion Middleware Features 11g & 12.1.3
- installs FMW software(add-on) to a middleware home, like OSB,SOA Suite, Oracle Identity & Access Management, Oracle Unified Directory, WebCenter Portal + Content
- WebTier Oracle HTTP server
- OSB, SOA Suite with BPM and BAM Cluster configuration support ( convert single osb/soa/bam servers to clusters and migrate OPSS to the database )
- ADF/JRF support, Assign JRF libraries to a Server or Cluster target
- IDM/OAM configurations with Oracle OHS OAM WebGate, Also Cluster support for OIM OAM
- OUD Oracle Unified Directory install, WebLogic domain, instances creation & OUD control
- Forms/Reports Oracle Forms & Reports 11.1.1.7 or 11.1.2
- Change FMW log location of a managed server
- Resource Adapterplan and entries for AQ, DB File and JMS
This module supports the installation of WebLogic versions:
- 10g
- 11g
- 12c( 12.1.1 & 12.1.2 & 12.1.3 + FMW infra )
Basic Domain Management
We support the creation of a domain. You can create different types of domains:
- default WebLogic
- JRF + EM + Coherence (12.1.2 & 12.1.3) + OWSM (12.1.2 & 12.1.3) + JAX-WS Advanced + Soap over JMS
- OSB + JRF + EM + OWSM + ESS ( optional with 12.1.3 )
- OSB + SOA Suite + BAM + JRF + EM + OWSM + ESS ( optional with 12.1.3 )
- OSB + SOA Suite + BAM + BPM + JRF + EM + OWSM + ESS ( optional with 12.1.3 )
- SOA Suite + BAM + JRF + EM + OWSM + ESS ( optional with 12.1.3 )
- SOA Suite + BAM + BPM + JRF + EM + OWSM + ESS ( optional with 12.1.3 )
- WC (webcenter) + WCC ( Content ) + BPM + JRF + EM + OWSM
- WC (webcenter) + JRF + EM + OWSM
- OIM (Oracle Identity Manager) + OAM ( Oracle Access Manager)
- OUD (Oracle Unified Directory)
The modules also allow you to pack a domain and copy it to an other node in a cluster.
Security
The module has support for Java Secure Socket Extension support(JSSE) and Custom Identity and Trust Store support]
Startup and shutdown
- Startup a nodemanager
- Start or stop AdminServer, Managed or a Cluster
- Storing WebLogic Credentials and using in WLST
Miscellaneous
- Linux low on entropy or urandom fix
- Dynamic targetting] by using the notes field in WebLogic for resource targetting
Check here to see the full documentation for this module.
Setup
Requirements
The wls_install
module requires:
- Puppet module
enterprisemodules-easy_type
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
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
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)
Installing the wls_install module
To install these modules, you can use a Puppetfile
mod 'enterprisemodules/wls_install' ,'3.0.x'
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_install
Usage
Building a total WebLogic or Fusion setup requires quite some work. To help you, we have built some examples. The repo contains a demonstration of a simple WebLogic installation.
Reference
Here you can find some more information regarding this puppet module:
Here are a 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:
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.
Types in this module release
History
3.2.2
- [ords::software_version] Fix fetch from remote url
- [ords] Add source header
3.2.1
- [ords] Add function ords_installed
3.2.0
- [ords] Add initial support for installing ORDS
3.1.4
- [fmw] Fix FMW detection
- [fmw] Use extracted data type for fmq_product and function for making fmw idempotent
- [fmw_installed] Add function to verify specific if specific fusion product is installed
- [core] extraxt type Fmw_products
- [facts] Add installed features to oracle home fact
3.1.3
- [facts] Fix error when machine of server is undefined
- [docs] Fix documentation
3.1.2
- [domain] Fix syntax error
3.1.1
- [nodemanagerautostart] Fix support for multidomain in later WLS versions
- [core] Add ‘managed by puppet’ notices to templated files
- [copydomain] Add support for mutiple domains
- [domain] Add support for mutiple domains
3.1.0
- [core] Make sure no usernames and passwords are echoed during a run
- [domain] Add support for Forms domain and RCU
- [fmw] handle install type for non soa and osb middleware types
3.0.6
- facts] Fix error when deployment is not targetted
- [core] Add puppet 6 unit tests
- [docs] Added type information and defaul values to docs
- [software_version] Add support for installing multiple homes with same version
- [core] update archive module
3.0.5
- [facts] Remove an other debugger statement
3.0.4
- [facts] Remove debugger
3.0.3
- [facts] return empty hash when directory named in wls_domains.dat doesn’t exist
- [facts] Make sure rexml/document is available
- [test] Update tested Puppet versions
- [docs] First full doc setup
3.0.2
- [copydomain] Fix access to packed domain when using archive
- [quality] Add bundle check
- [development] Fix loading of wrong rspec-puppet gem.
3.0.1
- [nodemanager] Make implementation for 12.2.1.3. idempotent
- [fmw] Update the templates for 12.2.1.3
- [nodemanagerautostart] Add support for 12.2.1.3
- [nodemanager] Add support for 12.2.1.3
- [fmw] Add support for 12.2.1.3
- [domain] Add support for 12.2.1.3
- [release] Update metadata and README
3.0.0
- [facts] Fix FMW domain parsing
- [wls_adminserver] less output on regular run
- [domain] Don’t use deprecated property
- [core] Less standard output
- [fmw] Fix data form fmw class
- [functions] Fix when check returns a nil
- [packdomain] Add specs and make all variables camel case
- [managed_server] Fix default from wls_log_path
- [fmwlogdir] use camel case variables
- [domain] Use camel case variables
- [fmw] add correct prefix to module yaml data
- [functions] Move all functions to wls_install namespace
- [wls_adminserver] Only show wlst output when debugging
- [release] Clean old files
- [release] Add stdlib requirement
3.0.0-alpha.1
- [release] First Puppet 4 and 5 alpha release
2.1.12
- [release] prepare for publishing on forge
2.1.11
- [nodemanager] Idempotentie problem solved.
- [nodemanager] Fix lint errors
- [nodemanager] Fix for multiple nodemanagers on 1 system
- [nodemanager, nodemanagerautostart] Better systemd integration
- [copydomain] Use correct domains file
- [facts] Remove java_version & java_versions facts
- [copydomain] Fix require when using non standard copy
- [nodemanagerautostart] Fix execute bit on systemd service files
- [core] refactored to not use yaml_setting anymore.
- [domain] Filter out unsupported JVM options
- [facts] Add facts for java version numbers
- [nodemanagerautostart] Change unit from simple to notify when using RHEL 7 >
- [core] Use puppet 4 or higher on testing
- [functions] Fix lookup of variables on higher puppet versions
- [copydomain] Added basic support for own copyscript
- [core] Remove old non-used code
2.1.10
- [core] Make 'on_failure' for all log_output parameters
- [domain] Fix templating when non default machine name is used
- [domain] Make default log_output on_failure
- [packdomain] Fix issue with nodemaanager start on non admin-server node
2.1.9
- [nodemanagerautostart] Add parameter systemd_script_location
- [wls_adminserver] Fix reporting changes on refresh
- [wls_adminserver] Fix refreshonly behaviour
2.1.8
- [nodemanagerautostart] Add support for 12.2.1.2
- [domain] Fix creation of wrong nodemanager.properties
- [nodemanagerautostart] Remove keystore passphrase from start command
- [core] Updated to support WebLogic and Fusion 12.2.1.2
2.1.7
- [fmwcluster] Remove server foledrs of removed servers
- [rcu] Remove the pwd file after use. Closes #3
- [fmwcluster] Add missing SOA deployments. Closes #4
- [rcu] make default for rcu_soa_profile undef
2.1.6
- [domain, rcu] Add suppoort for rcu_honor_omf and rcu_soa_profile parameters
2.1.5
- [core] Fix lookuing up of undefined variables
- Fix nodemanager issue on version 12.2.1.1
2.1.4
- Add support for WebLogic and Fusion 12.2.1.1
2.1.3
- [domain] fix old routie call in jrf template
- [software_version] Added support for multiple software trees
- [core] Add geppetto project file
- Security fixes
2.1.2
- [bsu] extract increaed_memory setting for BSU patches
- [software] Fix quoting issue
2.1.1
- [cluster_node] Make ports user configurable
2.1.0
- Added support for WebLogic 12.2.1
2.0.0
- Changed name to wls_install
1.0.39
- Works & Tested on puppet 4.2.1
- Oracle Forms & Reports 11.1.1.7 or 11.1.2 support
- Wls_server new attributes frontendhost, frontendhttpport and frontendhttpsport
1.0.38
- wls_server new attributes auto_restart & autokillwfail for automatic restart when the server crashes, or automatically kill when the server hangs
- wls_jms_queue, wls_jms_topic new attribute messagelogging
- wls_domain new attributes setinternalappdeploymentondemandenable, setconfigbackupenabled, setarchiveconfigurationcount, setconfigurationaudittype
- Dynamictargetting for wls_cluster, wls_datasource, wls_mail_session
- wls_datasource new attribute shrinkfrequencyseconds
1.0.37
- xa properties fix for wls_datasource
- custom weblogic home directory for WebLogic 10.3 and BSU patch
- target attribute used in wls types are now idempotent
1.0.36
- support for FMW installation which has 3 install files like oim/oam 11.1.2.3
- Webtier configuration for OAM
- wls_server_channel added keystore attributes
- wls_jms_queue ForwardDelay bug plus new attribute templatename
- wls_datasource new attributes row prefetch and initsql
- wls_workmanager new attribute fairshare
- wls_coherence_template new attribute classpath
- wls_deployment bug when version is none
1.0.35
- custom wls resource types now also supports t3s with customtrust done by wls_settings
- adminserver_ssl_port parameter on the domain.pp manifest
- wls_settings don't show the password in the output
- new resource type wls_jdbc_persistence_store
- new resource type wls_jms_template
- wls_deployment planpath fixes
- wls_datasource fixes
- removed default value -1 on forward delay on wls_jms_queue
- wls_server, new attribute listenportenabled
- wls_jms_connection_factory, xa fix plus new attributes localjndiname, defaultdeliverymode, defaultredeliverydelay
- wls_workmanager_constraint, Add the ability to manage fairshare class.
1.0.34
- Copydomain FMW apps_dir fix
- FTP Resource adapter plus resource adapter fixes
- New type wls_coherence_server
- Moved 12c nodemanager properties from domain.pp to nodemanager.pp so custom trust will also work
- Added urandom fixes and use notify when there is rngd configuration refresh
1.0.33
- added ESS (enterprise schedular) to OSB domain + FMW cluster option
- RCU prefix compare check fix ( Uppercase )
- SOA FMW cluster fixes for latest 12.1.3 soa patch
- SOA FMW cluster fix for soa with bam
- Java tmp dir option for 12c FMW software install
- wls_server, new attribute WeblogicPluginEnabled
- Optional DefaultUserNameMapperAttributeType fix in wls_identity_asserter
- Added bash shell to su -c commands like opatch, bsu, wls_adminserver, rcu types
1.0.32
- new wls_singleton_service type
- wls_jms_bridge_destination fix for username and password
- fiddyspence/sleep fix so it works with hiera and string value as input
- added log file to tmp dir + level for the weblogic 10.3 or 11g installation output
- Multiple targets for wls_jms_module type
- new wls_deployment attributes for stagingmode, remote and upload
- able to provide the sys username for the FMW domain RCU action
- derby flag on false in setDomainEnv when it is an OSB or SOA domain
1.0.31
- wls_jms_queue, new attribute forwarddelay
- wls_foreign_server_object, bug when removing object plus also removing dependencies
- wls_cluster, new attribute clusteraddress
- nodemanager.properties was overwritten in case of weblogic 12c and a domain extension
- nodemanager with 12c didn't start when log_dir was empty
1.0.30
- download dir dependency cycle error between weblogic and domain manifest.
- bsu unzip -o option instead of -n so the new readme is also added to the cache_dir
- wls_server, new attributes log_redirect_stderr_to_server, log_redirect_stdout_to_server, restart_max, log_http_file_count, log_http_number_of_files_limited, bea_home
- wls_jmsserver, new attributes bytes_maximum, allows_persistent_downgrade
- wls_datasource, new attributes secondstotrustidlepoolconnection, testfrequency, connectioncreationretryfrequency
- wls_server_channnel, new attributes publicport, max_message_size
1.0.29
- calculated_listen_port attribute for wls_dynamic_cluster
- mincapacity, statementcachesize, testconnectionsonreserve for wls_datasource
- wls_managedserver type fix when target is cluster, doesn't use ps -ef but uses wlst to check the cluster status
- new wls_messaging_bridge wls type
- new wls_jms_bridge_destination wls type
- wls_setting added a 'default' entry in wls_settings.yaml even when default is not used
1.0.28
- new wls_identity_asserter type for customising default identy asserter
- xaproperties attributes in wls_datasource
- better error handling for wls_authentication_provider ordering
- option to skip the OPSS security store migration from file to the database in fmwcluster.pp
- Custom type for oracle weblogic/domain directory structure instead of using a structure manifest
- logintimeout attribute for wls_server
- added some extra autorequire on wls resource types
1.0.27
- bug fixes in auto require and post classpath parameter bug when running in debug mode
- wls_multi_datasource resource type added
1.0.26
- auto require based on the wls resource parameters, no need to use require on the all wls resource types
- wls_adminserver type used plain as a default in nmconnect
1.0.25
- Auto require on wls resource types
- urandom fix for rngd service on RedHat Family version 7
- Secure replication parameter for wls_cluster
- ignore ldap providers for wls_user & wls_group
- Support for nodemanagers without security ( plain, with nodemanager_secure_listener = false) on control.pp, nodemanager.pp & domain.pp
1.0.24
- Wls_setting resource type check for required attributes
- Timeout parameter bug on all wls resource types ( the default 120 was always used)
- Nodemanager.pp exec sleep command replaced by fiddyspence/sleep resource type, will check every 2 seconds with netstat
1.0.23
- Solaris 11 fixes for nodemanager, wls_adminserver & wls_managedserver resource types
- wls_server resource type changes like: check for Adminserver creation/deletion, new properties tunnelingenabled, log_http_format_type, log_http_format, default_file_store, log_datasource_filename
- wls_domain resource type properties: platform-m-bean-server-enabled, platform-m-bean-server-used, show-archived-real-path-enabled
- wls_jms_connection_factory resource type properties: client-id-policy, subscription-sharing-policy, messages-maximum, reconnect-policy, load-balancing-enabled, server-affinity-enabled, attach-jmsx-user-id
- changed oraInst.loc permissions to 0755
1.0.22
- fix for copydomain when the standard domains location is used
- enable storage on wls_coherence_cluster
- AdminServer option to listen on all interfaces, adminserver_listen_on_all_interfaces = true on domain.pp
1.0.21
- puppet custom type for 12.1.2, 12.1.3 RCU, checks first if it already exists
- refactor all domains py scripts to standard one with an FMW extension (optional)
- fmw temp directory bug fix
1.0.20
- unset DISPLAY on install/configurations actions to avoid X timeout
- exclude the standard puppet attributes from the wls_setting yaml files
- Print the WLST scripts of all the wls types when puppet runs in debug mode
- Added new attributes log_http_filename & log_datasource_filename to the wls_server type
- SOA Cluster 12.1.3 fix for activating soa-infra application
- control the startup delay for the nodemanager with the sleep parameter
- option to assign the jrfcluster to a opss database
1.0.19
- changed property and removed propertyvalues of wls_mail_session, now there is no change detected when there is a different sorting
- changed users of wls_group, no change when there is a different sorting
- removed extrapropertiesvalues of wls_datasource, you can use now extraproperties with key=value,key1=value
- removed extrapropertiesvalues of wls_foreign_server, you can use now extraproperties with key=value,key1=value
- New Order parameter on the wls_authentication_provider type so you can change the order
- Timout parameter for all the wls types, can be used to override the default timeout (120s) on every wls resource
- MaxMessageSize parameter for wls_server resource type
1.0.18
- small fix for the server_template type with the arguments parameter
- Frontend parameters for wls_cluster
- Option to skip RCU with a domain creation ( weblogic > 12.1.2)
- new WebLogic type wls_mail_session
- new parameter default file store with wls_server
1.0.17
- utils.py fix for multiple domains
- Refactor for rubocop warnings
1.0.16
- Gridlink support for the Datasource type
- Extra properties can now be removed in a update of the Datasource
- Refactor domain py scripts and use a utils.py script for common functions
1.0.15
- RCU 12.1.3 support for MFT
- BSU fix for hard mdw path in patch policy
- OPatch, check the outcome of the action else fail
- SOA Cluster also works for FMW version 11.1.1.6
- wls_server type new attributes two_way_ssl, client_certificate_enforced
- wls_authentication_provider type now works for DefaultIdentityAsserter
1.0.14
- Change log Tab for puppetlabs forge
1.0.13
- Support for multiple jrf clusters
- New WLS 12c types like wls_server_template, wls_coherence_cluster, wls_dynamic_cluster
1.0.12
- SOA 12.1.3 Cluster support
- 12.1.3 FMW fixes
- BSU policy patch
- OAM & OIM cluster support
- 11g option to associate WebTier with a domain
1.0.11
- OSB 12.1.3 Cluster support
- FMW domains update for datasources based on servicetable
- Target & targettype on all wls types expects an array
- Same for servers parameter on wls_domain type
- Same for users parameter on wls_group type
- Same virtualhostnames parameter on wls_virtual_host
- Same for jndinames, extraproperties, extrapropertiesvalues parameters on wls_datasource & wls_foreign_server
1.0.10
- fixed WebLogic 12.1.2 & 12.1.3 standard domain bug.
1.0.9
- WebLogic 12.1.3 (infra) support
- Support for 12.1.3 SOA,OSB,B2B,MFT installation
- 12.1.3 Standard, ADF, SOA, OSB domain (no cluster)
- wls_adminserver type fix when using no custom trust
1.0.8
- wls_server pass server arguments as an array, as it makes it easier to use references in YAML
- Added log file options to wls_server
1.0.7
- wls_adminserver,wls_managedserver type to start,stop and refresh a managed server ( or subscribe to changes and do an autorestart )
- BSU
- Opatch
- Resource adapter
- Small nodemanager fix
1.0.6
- Readme with links
- wls types title cleanup
- Multiple resource adapter entries fix
- wls_domain fix
- bsu & opatch also works on < puppet 3.2
- hiera vars without an undef default
1.0.5
- wls_domain type to modify JTA,Security,Log & JPA
- Oracle Unified Directory install, domain, instances creation
- OUD control
1.0.4
- wls_deployment type/provider
- Post_classpath param on wls_setting
- WebTier for 12.1.2 and 11.1.1.7
- OIM & OAM 11.1.2.1 & 11.1.2.2 support with OHS OAM Webgate
1.0.3
- WLST Domain daemin for fast WLS types execution
- BSU & OPatch absent option and better output when it fails
1.0.2
- Custom Identity and Custom Trust
1.0.1
- Multi domain support with Puppet WLS types and providers
Dependencies
- fiddyspence/sleep (>=1.2.0)
- puppetlabs-stdlib (>= 4.13.0 < 5.0.0)
- puppet-archive (>= 2.0.0 < 4.0.0)
- enterprisemodules-easy_type (>= 2.3.0 < 3.0.0)
Enterprise Modules License d.d. January 2018 This license (“License”) governs the terms and conditions under which wls_install module (“the Software”) is licensed by Enterprise Modules B.V, a limited liability company in the Netherlands, registered in the Dutch Chamber of Commerce: 63689537 (“Licensor”), to the user of the Software (“Licensee”). Article 1. Grant of license 1.1 Licensor hereby grants to Licensee the right to use the Software for its internal business purposes. 1.2 The license granted in the previous paragraph is limited to the use on VirtualBox Virtual machines. For further use a commercial license must be directly obtained from Licensor. Article 2. License limitations 2.1 All right, title and interest to the Software, the accompanying documentation and all modifications and extensions thereto rest and remain with Licensor. Licensee only has the rights and permissions explicitly granted by this License or granted in writing otherwise. Licensee shall not use, copy, modify, distribute or publish the Software in any other manner. Nothing in this License is intended to, and shall not be construed to, transfer to Licensee any rights in intellectual property developed by Licensor. 2.2 In particular, Licensee shall not: a) provide copies of the Software to third parties, including to entities controlling, controlled by or under common control with Licensee; b) sublicense the Software or otherwise make available the Software to such third parties, including by rental, Software-as-a-Service models or otherwise; c) remove indications of Licensor as copyright holder of the Software or to remove or render illegible any part thereof. 2.3 The Software comprises third-party open source software. The respective third-party rights holders grant Licensee the rights indicated in the applicable open source licenses. These licenses can be found in the documentation. The License does not apply to this open source software, and nothing in this License shall be construed as a limitation of any right granted under an open source license. Article 3. Trademark 3.1 This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Software. Article 4. Limitation of Liability 4.1 Licensor provides the Software on an "AS IS" basis, and expressly disclaims all conditions, representations or warranties, express or implied, including without limitation any implied warranties of merchantability, fitness for a particular purpose, and non-infringement of third party rights regarding the Software. Licensor is solely responsible for determining the appropriateness of using the Software and assume any risks associated arising out of or in connection with the Software and this License. 4.2 Licensor shall not be liable for any damages, including consequential, special, punitive and/or incidental damages or fines imposed by regulatory bodies, arising out of or in connection with the Software and this License. 4.3 Licensee shall release, defend, indemnify and hold harmless Licensor from and against any and all claims, damages and liability arising in connection with the Software, including from claims, damages or liability from customers of Licensee. Article 5. Miscellaneous 5.1 Licensor reserves the right to change any or all parts of this License without prior notice. 5.2 The law of the Netherlands governs this License and the terms and conditions therein. 5.3 Any disputes arising between Licensor and Licensee in connection with the License will be settled by the competent courts in the Netherlands for the principal place of business of the Licensor.