Lenovo Software Help Center

How to activate the JMX remote console in webRDP Gateway

How can I activate the JMX remote console to debug what Java is doing?

The following assumes the default installation location was used.
  1. Make a backup copy of c:\webRDP-Gateway\jetty\webRDP-Gateway.lax
    or /usr/webRDP-Gateway/jetty/webRDP-Gateway.lax for Linux installs.
  2. Edit c:\webRDP-Gateway\jetty\webRDP-Gateway.lax
    or /usr/webRDP-Gateway/jetty/webRDP-Gateway.lax for Linux installs, using a text editor.
    Find the line that starts with:
    lax.nl.java.option.additional=
  3. Add the following parameters to the end of that line:
    -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8004 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.stoneware.jetty.jmx.enabled=trueSave the webRDP-Gateway.lax
  4. Stop/Start the webRDP-Gateway service

Using JConsole to view the webRDP Gateway Java process

From any machine running the Java JDK (not the standard JRE) of same bit level and equal to or higher than the one running in \webRDP-Gateway\jre\bin\:
Run JConsole from the Java JDK bin directory and connect to the webRDP Gateway server using the server's IP address on port 8004.

Java's current JDK can be downloaded from the following URL: http://www.oracle.com/technetwork/java/javase/downloads/index.html


Getting a HEAP / THREAD dump using jVisualVM or VisualVM

If you need to do a HEAP / THREAD dump please see the following document*:

(*Note, you can jVisualVM in place of the separately downloaded VisualVM, as the JDK now includes jVisualVM in the bin folder.)


To shut the JMX debug off, remove the extra parameters added to the webRDP-Gateway.lax file.


Keywords: Heap Dump, Thread Dump, HotThreads, VisualVM
    • Related Articles

    • How to activate the JMX remote console

      How can I activate the JMX remote console to debug what Java is doing? As of version 6.1 of Unified Workspace (formerly webNetwork), there is now a checkbox in the 8090 to dynamically turn on / off the JMX and does not require modification to the ...
    • webRDP cannot connect to new Windows 10 workstations / Windows Server 2016 servers

      Issue The HTML5 webRDP client will not connect to new Windows 10 workstations, but will connect to Windows 7 or Windows 8 workstations. Possible Errors: Received an error connecting to: <CN_OF_WEBAPP> Solution Clean installations of Windows 10 now ...
    • Customize webRDP Gateway Connection Screen UI

      **Update 10/29/2016** As of the webRDP HTML5 Gateway build 1.2.0.44, the desktop.jsp file is extracted into the /webRDP-Gateway/jetty/explodedWar folder. If you are on an older build of the webRDP HTML5 Gateway, you will either need to upgrade to the ...
    • Adjust webRDP HTML5 Gateway Cipher Suites

      Issue SSL Security scans of our webRDP HTML5 Gateway server are coming back showing vulnerabilities, such as TLS 1.0 is being allowed. What needs to be done to improve the SSL Security of our Gateway server? Solution The attached XML file, includes ...
    • How to adjust webRDP Compression - Gateway

      How to adjust webRDP compression in 1.1.2.49 and higher. WebRDP utilizes a technology which compresses RDP traffic into a PNG image format.  A default value has been set to provide both good compression and network payload size.  WebRDP supports ...
    • Popular Articles

    • Can a Teacher see Students outside of school?

      This content has moved! Visit the new LanSchool Classic Help Desk It looks like you may be interested in LanSchool Classic General FAQ.
    • LanSchool Latest Release Notes

      This content has moved! Visit the new LanSchool Classic Help Desk It looks like you may be interested in LanSchool Classic Latest Release Notes.
    • How to uninstall LanSchool Student and WebHelper from Chromebook

      This content has moved! Visit the new LanSchool Classic Help Desk It looks like you may be interested in Mass Deploying LanSchool Student for Chromebook.
    • LanSchool 8.0.2.82 Release Notes

      LanSchool™ Release Notes Updated: December 16, 2019 Component Versions LanSchool 8.0.2.82, December 16, 2019 Chromebook App 8.0.2.13, December 16, 2019 Chrome Web Helper: 8.0.2.5, December 16, 2019iOS TA and Student 8.2.0, December 16, 2019 Android ...
    • Controlling multiple students at once

      Problem: Can I remote control multiple computers at once? Cause: N/A Prerequisite(s): LanSchool Teacher and Student Solution(s): If all of the computers in the lab are the same basic image or configuration (for example. all Windows XP machines with ...
    • Recent Articles

    • Allow Help Desk to reset Image Challenge images

      Issue Customer would like to allow Help Desk users to only be able to reset user Image Challenge images when they have been forgotten by a user. Solution This can be done by assigning specific users in the system the User Group Admin role, as well as ...
    • Troubleshoot RDS

      This is a good article, from Microsoft, on how to troubleshoot RDS/RDP logon issues. https://social.technet.microsoft.com/wiki/contents/articles/37841.remote-desktop-services-rds-logon-connectivity-overview-and-troubleshooting.aspx
    • Building an Employee Phonebook system

      Building a Mini Application Post #20 Can it really be that simple to create a little application with Report and Form Builder?  This tutorial shows you that it is - and actually helps you make a useful application at the same time as learning how to ...
    • Working with Binary Data in Report Services

      Quick Start Guide - Binary Data This tutorial is designed as a quick "How Do I Work With Binary Data" tutorial.  It walks through the steps necessary to upload an image to a database.  Every webNetwork 6.0 installation ships with a database called ...
    • Lenovo Unified Workspace 6.5.9.41 Released

      Lenovo Unified Workspace 6.5.9.41 Released 05-18-2021 Below is a list of enhancements and fixes for Unified Workspace 6.5.9.41 If you need assistance with your update, please contact support at 800-505-6865 (Monday-Friday, 8:00am-5:00pm EST - ...