How to activate the JMX remote console in webRDP Gateway

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

    • Old Browser Versions

      Question: I am using an older browser version and am having problems. What can be done ? We are not able to upgrade the browser at this time.   This is a challenge for any company that makes software that utilizes a browser. Since Stoneware does not ...
    • LCS Redirection

      Problem: How to redirect the LCS in an environment with multiple LCSs and students connecting to them. Solution(s): Create an allow.cfg on all LCS(s) (including the Master) in the network, however, even if no allow.cfg is present on an LCS, machines ...
    • Time windows allows for Service Shutdown

      Issue: Can the time windows gives a service to shut down before it kills the service be increased? Solution: Yes, the following information comes from the Microsoft URL : http://support.microsoft.com/kb/146092 To specify the wait time, do the ...
    • How to disable password saving - Internet Explorer

      Having multiple methods for saving a password in the browser can cause confusion for the user.   To disable password saving in Internet Explorer, launch Internet Explorer and perform the following steps. Click the blue Settings menu icon in the upper ...
    • How to disable password saving - Chrome

      Having multiple methods for saving a password in the browser can cause confusion for the user.  To disable password saving in Chrome, launch Chrome and perform the following steps. Click the Chrome menu button in the upper right corner of the Chrome ...
    • Recent Articles

    • Lenovo Unified Workspace 7.0.0.63 Released

      Highlights of Unified Workspace 7.0.0.63 If you need assistance with your update, please e-mail support at support@lenovosoftware.com or visit https://unifiedworkspace.com/support/ for more information. Below is a list of enhancements and fixes for ...
    • How to fix customized login and profile after upgrading to v7.0

      With the release of 7.0 the default login page has been modified to simplify the customization process.  If you are having an issue with the login page not displaying, after upgrading to v7.0, you will need to delete the custom CSS code and start ...
    • SAML SP - Sync Directory Password

      Login script to prompt for directory password Since the user does not login into Unified Workspace with a password, we cannot capture the password to use in the @@password@@ variable.  If you would like to use the Active Directory password for other ...
    • MySQL 8 SSL

      Issue Admin is making a database connection to a MySQL 8 database.  When clicking the Ping button on the DB Connection object, the following error is presented: WARN: Establishing SSL connection without server's identity verification is not ...
    • 7.0 excludeProtocols - includeProtocols - allowCiphers - denyCiphers config file

      excludeProtocols - includeProtocols - allowCiphers - denyCiphers config file The following configuration is recommended for systems running 7.0.0.63, and higher. (For older 6.5 releases of UW, please see this article.) ...