WLSDM ReadMe

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

$wlsdm_package.zip file contains following directories and files:

• Senior or Junior WebLogic Administrator. * WLSDM custom actions 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!


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

Easy installation!

• Add wlsdm_agent.jar to managed server CLASSPATH
• Copy wlsdm.war file to WebLogic domain's console-ext folder.
• (Re)start managed server(s) then WebLogic admin server.
• That's all! WLSDM console will deploy automatically.

Installation and Introduction Video Tutorial

Quick Step by Step Installation Guide (Already Running Domain)

copy $wlsdm_package/jar/wlsdm_agent.jar to /path/to/wlsdm_agent.jar on the managed server machine(s)
add wlsdm_agent.jar to WebLogic managed server´s *${CLASSPATH}: --> Recommended at least one

*1. JRockit and JDK 1.6: Add below WLSDM JVM parameters to WebLogic managed server´s ${CLASSPATH}:

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

*2. Lower JDK 1.7.0_40: Add below WLSDM JVM parameters to managed server´s ${CLASSPATH}:

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

*3. JDK 1.7.0_40 and Higher and JDK 1.8: Add below WLSDM&JFR JVM parameters to managed server´s ${CLASSPATH}:

 -javaagent:/path/to/wlsdm_agent.jar -Dwlsdm.agent.logger.level=INFO -XX:+UnlockCommercialFeatures -XX:+FlightRecorder

(re)start WebLogic managed server(s) that wlsdm_agent.jar is installed
copy $wlsdm_package/war/wlsdm.war to ${WEBLOGIC_DOMAIN_HOME}/console-ext/. folder on the admin server machine
(re)start WebLogic admin server
make sure all your WebLogic domain resources (wl servers, deployments, data sources, jms servers... etc.)
are RUNNING and ACTIVE
access WLSDM console: http://$IP:$PORT/console/WLSDM
How to access WLSDM console?

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

*Optional: There is no need to install wlsgm_agent for MBean, Log and Response Times monitoring. For back-end monitoring and remote JVM actions please install $wlsdm_package/jar/wlsdm_agent.jar

Important Note: WLSDM agent has almost zero overhead on managed servers and only used for RJVM operations. Its cost is negligible. WLSDM injecting nothing to runtime codes.

After the installation, login to WebLogic admin console then WLSDM portlet will be visible under WebLogic domain structure.

Help is available

• from the "Help" page on WLSDM console at WebLogic domain. Help page URL: http(s)://$IP:$PORT/console/WLSDM/consolehelp/index
• at HTML page under "docs" directory. Open WLSDM-HELP.html
• online at http://www.wlsdm.com/docs/help

Post your WLSDM or WebLogic monitoring issues on Community Portal

•   How to install and use WLSDM?
        YouTube Tutorial
  
  
•   Advanced WebLogic Monitoring and Automation:
        Develop JMX MBeans (YouTube Tutorial, Sample JAVA Code, Documentation)
  
  
•   How to get WebLogic thread dump continuously?
        Community Blog Post
  
  
•   Dashboard Usage
        YouTube Tutorial
  
  
•   Actions (Thread Dump, Heap Dump, Java Flight Recorder (JFR), WLDF Image)
        YouTube Tutorial
  
  
•   JMX MBean Metric Browser & Email Notifications
        YouTube Tutorial
  
  
•   Application Response Times & Log Inspector
        YouTube Tutorial
  
  

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 under "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
• Anymore all users and user groups able to login WLSDM console. Page authorization is enriched.

v1.2.0:

• Profiling Dumps page is added under "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