WLSDM ReadMe

The license agreement (EULA) can be found on  wlsdm-license.html page which is located in "lic" folder

$wlsdm_package.zip file contains following directories and files:

• Senior or Junior WebLogic Administrator. *WLSDM custom action is recommended for Senior (Advanced) WebLogic Administrators!
• Mission critical WebLogic domain
• SMTP/Mail server information and SMTP relay for the server which WebLogic Admin Server is running. Highly recommended!

WLSDM improves administrative and DevOps WebLogic knowledge and skills. Use " / info" icons for MBean explanations and descriptions on WLSDM console

NOTE: No additional server, database, memory, CPU, operational cost... etc. is required!

Easy installation!

• Add wlsdm_agent.jar to managed server's JVM Arguments ${JAVA_OPTIONS}*
• Copy wlsdm.war file to WebLogic domain's console-ext folder
• (Re)start WebLogic admin server and managed server(s)
• That's all! WLSDM console will deploy automatically
• Login to WLSDM Console then complete configuration wizard for once
• Start proactive monitoring and move forward your WebLogic management infrastructure and team!

WLSDM Installation Best Practice Architecture

Quick Step by Step Installation Guide

!!! Already RUNNING Domain !!!

 1. copy $wlsdm_package/jar/wlsdm_agent.jar to /path/to/wlsdm_agent.jar on the managed server machine(s)

            [user@machine]$ mkdir $DOMAIN_HOME/wlsdm_agent
            [user@machine]$ cp $wlsdm_package/jar/wlsdm_agent.jar $DOMAIN_HOME/wlsdm_agent/wlsdm_agent.jar

 2. add wlsdm_agent.jar to WebLogic managed server´s JVM Arguments as below: --> *${JAVA_OPTIONS}
   (Consider above best practice architecture...)

  *2.1. JRockit and JDK 1.6: Add the following WLSDM JVM parameters to WebLogic managed server´s JVM Arguments:

    -javaagent:/path/to/wlsdm_agent.jar -Dwlsdm.agent.logger.level=INFO -XX:FlightRecorderOptions=repository=WLSDM/temp/JFR

  *2.2. Lower JDK 1.7.0_40: Add the following WLSDM JVM parameters to managed server´s JVM Arguments:

    -javaagent:/path/to/wlsdm_agent.jar -Dwlsdm.agent.logger.level=INFO

  *2.3. JDK 1.7.0_40 and Higher and JDK 1.8: Add the following WLSDM & JFR JVM parameters to managed server´s JVM Arguments:

    -javaagent:/path/to/wlsdm_agent.jar -Dwlsdm.agent.logger.level=INFO 
    -XX:+UnlockCommercialFeatures -XX:+FlightRecorder -XX:FlightRecorderOptions=repository=WLSDM/temp/JFR

  How to add WLSDM JVM Parameters to WebLogic managed server arguments?

 a) With WebLogic NodeManager:
    to instrument managed server instances started and stopped through the Node Manager, use the administration console

    from the administration console, navigate to "Environments > Servers > (select your server) > Server Start > Arguments"
    add the above suitable JVM entry to Arguments section and save the page:

    Environments > Servers > (select your server) > Server Start > Arguments
    
 b) Without WebLogic NodeManager:
    add the following entry (add before Java executes) to the "startManagedServer" file

 UNIX / LINUX / MAC OS X:"startManagedServer.sh"  
export JAVA_OPTIONS="$JAVA_OPTIONS -javaagent:/path/to/wlsdm_agent.jar -Dwlsdm.agent.logger.level=INFO -XX:+UnlockCommercialFeatures -XX:+FlightRecorder"
 WINDOWS:"startManagedServer.cmd"
set JAVA_OPTIONS=%JAVA_OPTIONS% -javaagent:"C:\path\to\wlsdm_agent.jar" -Dwlsdm.agent.logger.level=INFO -XX:+UnlockCommercialFeatures -XX:+FlightRecorder
 NOTE: there is no need to install "wlsdm_agent.jar" to the WebLogic Admin Server!
                        

 3. (re)start WebLogic managed server(s) which wlsdm_agent.jar is installed. after restarting managed server(s),
    below logs must be seen in managed server log files. this means WLSDM agent is deployed successfully.

  ManagedServer Log:
<Mar 4, 2015 1:13:24 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM agent loaded successfully. Version: v3.1.2>
<Mar 4, 2015 1:13:24 PM PDT> <Info> <WLSDM> <BEA-000000> <RJVM operation is bound in the registry with the name wlsdm_agent_remote_operation.>
                            

 4. copy $wlsdm_package/war/wlsdm.war to ${WEBLOGIC_DOMAIN_HOME}/console-ext/. folder on the admin server machine

 5. then (re)start WebLogic admin server. that is all, WLSDM console will deploy automatically
    after restarting admin server, below logs must be seen in admin server log files
    this means WLSDM console is deployed successfully and WLSDM console is ready to monitor WebLogic domain

  AdminServer Log:
<Mar 4, 2015 1:12:12 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM console deployed successfully. Version: v3.1.2>
<Mar 4, 2015 1:12:12 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM garbage collection monitoring initialized successfully.>
<Mar 4, 2015 1:12:12 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM metric monitoring initialized successfully.>
<Mar 4, 2015 1:12:12 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM health monitoring initialized successfully.>
<Mar 4, 2015 1:12:12 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM performance monitoring initialized successfully.>
<Mar 4, 2015 1:12:12 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM back-end monitoring initialized successfully.>
<Mar 4, 2015 1:12:12 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM data archiver initialized successfully.>
<Mar 4, 2015 1:12:12 PM PDT> <Info> <WLSDM> <BEA-000000> <WLSDM custom MBean handler initialized successfully.>

 6. make sure all your WebLogic domain resources (wl servers, deployments, data sources, jms servers... etc.)
    are RUNNING and ACTIVE

 7. access WLSDM console
     How to access WLSDM console?
    

 8. complete WLSDM quick configuration wizard carefully according to WebLogic domain characteristic
     How to complete WLSDM wizard?
    

Installation and Introduction Video Tutorial

This tutorial also contains basic information about usage

Easy upgrade!

1. Replace wlsdm_agent.jar file with the new release and keep wlsdm_agent.jar JVM arguments. *($JAVA_OPTIONS)
2. Replace wlsdm.war file with the new release to WebLogic domain's console-ext folder
3. (Re)start WebLogic managed server(s) then admin server
4. That's all! WLSDM will be upgraded after restart processes

Fresh Re-installation!

1. Replace wlsdm_agent.jar file with the new release and keep wlsdm_agent.jar JVM arguments. *($JAVA_OPTIONS)
2. Shutdown admin server
3. Delete $DOMAIN_HOME/WLSDM runtime folder
4. Replace wlsdm.war file with the new release to WebLogic domain's console-ext folder
5. Start WebLogic admin server and restart managed server(s) which wlsdm_agent.jar installed
6. That's all! WLSDM will be reinstalled after restart processes
7. Complete WLSDM configuration wizard

How to uninstall?

1. Remove wlsdm_agent.jar JVM arguments on Managed Server(s) if it is installed then restart relevant WebLogic Managed Server(s)
2. Shutdown admin server
3. Delete WLSDM runtime folder: ${WEBLOGIC_DOMAIN_HOME}/WLSDM/
4. Delete wlsdm.war file: ${WEBLOGIC_DOMAIN_HOME}/console-ext/wlsdm.war then start WebLogic admin server

WLSDM offers complete monitoring infrastructure for WebLogic Application Server. monitorWLAdmin is a simple "Plug & Play" standalone application for monitoring WebLogic Admin Server externally. After the WLSDM installation and wizard setup completion, standalone monitorWLAdmin application will appear in runtime WLSDM folder as below content

($DOMAIN_HOME/WLSDM/monitorWLAdmin) Contents:

How to start?

Unix/Linux: nohup ./start_monitorWLAdmin.sh &

How does monitorWLAdmin work?

It monitors WebLogic Admin console periodically. When "Admin Server" goes down or slows down monitorWLAdmin sends alarm notification instantly

Help is available

• on the "Help" page of WLSDM console at WebLogic domain
  Help page Console URL:   http(s)://$IP:$PORT/console/WLSDM/consolehelp/index


• at HTML page in "$wlsdm_package/docs" directory. Open   WLSDM-HELP.html


• online at   http://www.wlsdm.com/docs/help

Post your WLSDM or WebLogic monitoring issues on  Community Portal

Please follow us and get updates. Never miss a post about WebLogic monitoring issues!

  Community / Support

  Twitter Follow

  YouTube Tutorials

  LinkedIn Connect

  Google+ Circle

  Facebook Like

  Instagram follow4follow :)

  Email Send

v3.1.2:

• v3.1.2 is a patch set release
• HTML footer is added to License page. Company signature and logo can be added as footer on HTML email notifications (available for registered products)
• Generic DevOps MBean edit options updated
• JFR FlightRecorder repository additional purge management is added
• Restart required managed servers are listed on wizard page for response times monitoring
• SOA module composite performance daily report wrong calculation defect is fixed
• Smart email delivery at LogInspector log monitoring defect is fixed
• Viewing Hogger and Stuck notifications stack trace problem is fixed
• Other minor bug-fixes, performance and UI improvements

v3.1.1:

• v3.1 is a major release and contains every detail of WebLogic monitoring and management
• Key feature Generic DevOps MBean is published as:
• Add any kind of scripts and transform them to JMX MBeans then visualize on smart dashboards. Supported scripts: sh, bash, cmd, bat, SQL...
• DevOps script integrations: Custom actions, alarm/threshold settings, reporting...
• Thread Pool monitoring is added to smart dashboards
• Identify HOGGER and STUCK thread on metric dashboards
• View HoggingThreadCount and StuckThreadCount threads on Metric Notification page
• View relevant HOGGER and STUCK log notifications on LogInspector
• Browser based WLSDM PUSH NOTIFICATION Service is added for all notification types. Simply click on it and solve the problem
• Notification actions are added to notification pages: View Threads, Go to Smart Dashboard, View Related Logs, Go to Reports...
• Garbage Collection Dashboard is added: Monitoring, Notification, Reporting, GC Log Viewing
• CPU sample (.npss) action is added to system defined actions
• Daily reports tab is added to Monitoring & Diagnostics page
• Back-end Systems Top Events and daily/weekly/monthly reports
• Response Times Top Requests and daily/weekly/monthly reports
• File Explorer: Web based file browser page and upload/download feature is added (CLOUD Feature)
• Custom Log Monitoring: Any type of file and log monitoring is available on LogInspector module
• WebLogic FMW Diagnostics Log and .OUT log monitoring support is added
• Full thread dump generation is added to agentless managed servers
• The whole WebLogic domain WLSDM system settings can be Exported/Imported. Export/Import feature is developed for multiple WLSDM installations with the same standard
• Chart ordering feature is added to smart metric dashboards
• Notification pages linked to every page on Notification dropdown menu
• Refreshing all metric value by one click is added to metric dashboards
• Performance Improvements: Tested on a production WebLogic domain which has more than 40 ADF managed servers successfully. Improved every page of WLSDM and all the heavy pages are loaded under 5 seconds
• UI/UX Improvements: We designed one of the best user interface for WebLogic monitoring by listening our community feedback

v2.5.2:

• FMW OSB Monitoring Module is released. (Supports 11g and 12c)
• WLSDM OSB Monitoring, Diagnostics & Report Modules


• OSB Smart Dashboards
• Monitoring ProxyService Performance
• Monitoring Deployed OSB Services Trend
• Summarizing OSB Service List & Endpoint URIs


• OSB Notifications and Alarms
• ProxyService Performance Notifications


• OSB Reports
• Reporting ProxyService Performance


• OSB Daily Reports (EMAIL)
• Daily OSB Report for ProxyService Performance
• Daily SOA Report for Deployed OSB Service Trend

WLSDM Core:

• "Health History" page is added. Has Grid and Timeline choice
• Performance improved for health monitoring & health dashboard
• Backend health data cache feature is enabled on health dashboard by default
• Webservice User Test Client does not exist warning is added to "Composite and Service URI" pages
• Bug-fixes, performance and UI improvements

v2.4.0:

• Enable Backend HEALTH Cache feature is added to Health Dashboard. Enable this feature for the domains which have too many resources or heavy page loads. WLSDM applies to backend HEALTH cache data for better performance
• Email notification recipients property is enriched. It is possible to send separate HEALTH and METRIC email notifications. Supports L1 and L2 operation teams
• Email addresses are collected as default email list. (Customer request)
• Email Group feature is added (Customer request)
• SMTP connection timeout property is added to system.wlsdm tab
• t3/JMX connection timeout property is added to system.wlsdm tab
• Bug-fixes, performance and UI improvements

v2.3.7:

• Bugs reported by community are fixed
• Performance improved for domains which have more than 40+ managed servers
• LogInspector WLDF query name is added to HTML alert emails
• UI improved with UX

v2.3.5:

• OutOfMemoryError log monitoring is added to Log Inspector
• Back-end dashboard infrastructure is improved and new features/events added:
• Able to create unlimited custom back-end dashboards
• Back-end Generic dashboard is added (All-in-one backend dashboard)
• JDBC Dashboard is added
• EJB (EJB Business Method Invoke) Dashboard is added
• Web Services (JAS-WS & JAX-RPC) Dashboard is added
• Socket I/O Dashboard (Socket Read&Write) is added
• File I/O Dashboard (File Read&Write) is added


• Email notification module is enriched
• Able to disable/enable all METRIC CLEAR emails. Default: ON
• Able to disable/enable all HEALTH CLEAR emails. Default: ON
• Able to disable/enable managed server health warning email notification. Default: OFF
• Able to disable/enable managed server transition states (STARTING, SUSPENDING, FORCE_SUSPENDING, RESUMING, SHUTTING_DOWN, SHUTDOWN_PENDING, SHUTDOWN_IN_PROCESS, FAILED_RESTARTING, FORCE_SHUTTING_DOWN) email notifications.
• Able to disable/enable deployment transition states (STARTING, SUSPENDING, FORCE_SUSPENDING, RESUMING, SHUTTING_DOWN, SHUTDOWN_PENDING, SHUTDOWN_IN_PROCESS, FAILED_RESTARTING, FORCE_SHUTTING_DOWN) email notifications. Default: ON
• Reset to default feature is added to notification settings.


• "Send Log as Email" feature is added to "Monitoring & Diagnostics > Log Inspector" page
• Alert icon is added to metric dashboards. MBean metric values over threshold blinks anymore (On Grid an Chart Headers)
• All SOA Report grid tables has export data feature as (Copy, CSV, Excel, PDF, Print) anymore
• All SOA Report charts support chart type selection (Line, Bar, Pie... etc.) anymore
• New alert HTML Templates is added and HTML email templates will be upgraded automatically
• Support License information is added to licenses and "Config > License" page
• "Free Developer Edition/License/Support/Evaluation" information badge is added to all pages
• WLSDM sends "Support License expiration warning" in remaining 7 days.
• Bug fixes and performance/UI/UX improvements

v2.3.1:

• FMW SOA Monitoring Module is released. (Supports 11g and 12c)
• WLSDM SOA Monitoring, Diagnostics & Report Modules


• SOA Smart Dashboards
• Monitoring BPEL Engine (Only 11g)
• BPEL Engine Dashboard (Historical - Only 11g)
• Monitoring Composite Performance
• Monitoring Callback and Invoke
• Monitoring Composite Faults
• Monitoring Deployed Composites Trend
• Summarizing Composite List & Endpoint URIs


• SOA Notifications and Alarms
• BPEL Engine Notifications
• Composite Performance Notifications
• Callback and Invoke (DLV_MESSAGE) Notifications
• Composite Faults and Errors Notifications


• SOA Reports
• Reporting SOA BPEL Engine
• Reporting SOA Composite Performance
• Reporting SOA Callback and Invoke (DLV_MESSAGE)
• Reporting SOA Composite Faults and Errors


• SOA Daily Reports (EMAIL)
• Daily SOA Report for Composite Performance
• Daily SOA Report for Callback and Invoke (DLV_MESSAGE)
• Daily SOA Report for Composite Faults and Errors
• Daily SOA Report for Deployed Composites Trend

WLSDM Core:

• Auto archive feature is added. Configurable and integrated archive module for all the stored data types
• JVM System Resources dashboard is renewed and enriched
• Monitor JVM CPU Load , Heap (Usage, Free, Size)
• Alarm / Notification feature is added to JVM Resources dashboard
• Grid and Chart feature is added


• Health dashboard is renewed and enriched
• Donut charts are added: Health States (WebLogic Servers, Deployments, Data Sources, JMS)
• Server state feature is enriched
• WebLogic server activation time and counter feature is added


• Deletion feature is added to "Monitoring & Diagnostics > Profiling Dumps" page. (Asynchronous file deletion for JFR, WLDF Diagnostic Image, HPROF, LOG)
• New "Operational Tools & Utils > MBean Search" page is added
• Search any text in WebLogic MBean Instance Type
• Search any text in WebLogic MBean Attribute Type
• Search any text in WebLogic MBean Instance Name
• Search any text in WebLogic MBean Attribute Name
• See all the WebLogic MBean attribute values on search results
• Compare WebLogic MBean attribute values


• New "Domain Overview > Timeout Values" page is added.
• WLSDM: Timeouts are the most important settings for keeping your WebLogic domain healthy, strong and responsive
• Important and Recommended WebLogic "Domain Timeouts" MBeans are listed with their values
• Important and Recommended WebLogic "JVM Timeouts" MBeans are listed with their values
• Important and Recommended WebLogic "Server Timeouts" MBeans are listed with their values
• Important and Recommended WebLogic "Data Source Timeouts" MBeans are listed with their values


• WebLogic Runtime JVM arguments and WebLogic console arguments values is added to "Domain Overview > Domain Summary" page
• WebLogic Domain Structure menu items are added as integrated and dynamic drop-down menu to all WLSDM pages
• WebLogic Admin Server monitoring plug&play application "monitorWLAdmin" is enriched
• General performance and error handling improvements
• Several bug fixes

v2.1.8:

• Bug-fixes and performance improvements

v2.1.7:

• Fresh installation is recommended instead upgrade
• Log Viewer page is enriched
• Back-end monitoring performance improved
• Fetching WebLogic Server log and Response Time records are limited parametrically
• Log Inspector Email Notifications can be continuous or daily once

v2.1.5:

• Monitor WLSDM Agents page is added
• Shutdown servers blink on JVM System Resources dashboard
• Adding User Defined (Log) File feature is added to Log Viewer page
• Send Log Content as HTML EMAIL feature is added to Log Viewer page
• Viewing and filtering weblogic.Stdout and weblogic.Stderr log files

v2.1.1:

• System Resources generic dashboard is added
• Log Viewer page is added to "Operational Tools". View and tail every log file on WLSDM console

v2.0.0:

• Free Developer Edition (Fully Featured) - WLSDM can be used by developers for free!
• WLSDM Quick installation Wizard is more robust anymore. Monitoring & Diagnostics step is added
• Suggest Button for Metric Thresholds on Wizard pages
• Get manual profiling dumps for JFR, Thread Dump, WLDF Diagnostic Image and Heap Dump
• Self-Tuning Thread Pool Threads detail is added for HoggingThreadCount and StuckThreadCount EMAIL notifications
• Back-end system monitoring
  • JDBC Executement Statement
  • Webservices JAXWS Endpoint
  • EJB Business Method Invoke
• Back-end Reports page is added
• Operational Tools section is added
• WLST Web Console Page
• Storing and Executing WLST Scripts
• Thread Dump Analyzer Page
• Decrypt-Encrypt Page
• Notifications are enriched
• Metric Notifications
• Log Inspector Notifications
• Response Times Notifications
• Back-end Systems Notifications
• Enable/Disable Global Notifications for EMAIL and SNMP By One By
• Enable/Disable All EMAIL-SNMP Notifications feature is added
• SNMP Notification feature is added. Easy SNMP trap configuration:
• SNMP Trap for WebLogic State and Health (Servers, Deployments, Data Sources and JMS)
• SNMP Trap MBean Metric Values
• SNMP Trap for WebLogic Server Logs
• Test SMTP and SNMP settings operations are added to Configuration > System page
• Log Inspector WLDF snippets are added
• Dead Lock
• Heap Space
• Stuck Thread
• Unchecked Exception
• General Severity Error
• WebLogic Domain Summary Page is added
• Data source passwords are listed on domain summary page (Decrypted and Encrypted) - All users are forbidden except administrators.
• View WLSDM Log Page is added
• Response Times Chart is added to Monitoring & Diagnostics > Response Times page
• User Defined Metric Actions feature is added. WebLogic domains can be automated according to MBean values
• All users and user groups able to login WLSDM console anymore. Page authorization is enriched

v1.2.0:

• Profiling Dumps page is added to "Monitoring & Diagnostics" category
• Grid status feature is added to dashboard pages

v1.1.2:

• Java Flight Recorder (JFR) dump action is added
• WLDF (WebLogic Diagnostic Framework) Diagnostic Image dump action is added
• Heap dump action is added

v1.1.0:

• Thread dump action is added