WLSDM ReadMe

v2.1.8 | Released on 2016.01.18


I. License

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


II. Package Directory Layout

$wlsdm_package.zip file contains following directories and files:

war contains wlsdm.war which is the main installation file and WebLogic Smart Dashboard & Monitoring Console extension.
jar contains wlsdm_agent.jar file which is the WLSDM agent for the operational actions. Must be add to the server's CLASSPATH.
docs contains the help documents for WLSDM
lic contains license information files. wlsdm-license.html and other 3rd party license information files

III. Prerequisites

  • 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!


IV. Installation

  Windows / Linux / Unix / MAC OS X

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

  How to install and use WLSDM?

Quick Step by Step Installation Guide (Already Running Domain)

More detailed information about installation is available on WLSDM help document. Go to WLSDM-HELP.html#2.Installation page.
  1. copy $wlsdm_package/jar/wlsdm_agent.jar to /path/to/wlsdm_agent.jar on the managed server machine(s)
  2. 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
  3. (re)start WebLogic managed server(s) that wlsdm_agent.jar is installed
  4. copy $wlsdm_package/war/wlsdm.war to ${WEBLOGIC_DOMAIN_HOME}/console-ext/. folder on the admin server machine
  5. (re)start WebLogic admin server
  6. make sure all your WebLogic domain resources (wl servers, deployments, data sources, jms servers... etc.) are RUNNING and ACTIVE
  7. access WLSDM console: http://$IP:$PORT/console/WLSDM
  8. How to access WLSDM console?
  9. complete WLSDM quick configuration wizard carefully according to WebLogic domain characteristic
  10. 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.


V. Accessing WLSDM Console

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






Click "Smart Dashboard Console" on WLSDM menu.

OR

Type WLSDM URL on browser's address bar for accessing directly.


http:// ${ADMIN_SERVER_IP} : ${PORT} /console/WLSDM

https:// ${ADMIN_SERVER_IP} : ${PORT} /console/WLSDM





VI. Documentation

Help is available

Post your WLSDM or WebLogic monitoring issues on Community Portal


VII. WebLogic Monitoring Tutorials


VIII. Change Log

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