How to adjust webRDP compression in webNetwork 6.2.1.159 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 adjusting this compression level. If the desired effect is to increase compression, thereby decreasing network payload size, then set the level to 9. If the effect is to increase server performance, lowering compression, thereby increasing network payload size, then set the value to 1. The trade off to consider is server CPU load: a higher compression utilizes more processing. More processing slows down server CPU performance and load capacity.
Here are the following compression levels,
1 – best speed (lower compression, larger network payload, lower CPU load)
2
3
4 - default
5
6
7
8
9 – best size (higher compression, smaller network payload, higher CPU load)
Which do I choose? If the system default is not adequate, then you can adjust the level. Consider these factors,
- Low bandwidth, low volume – best size will help
- High bandwidth, high volume – best speed will help
- Low bandwidth, high volume – somewhere in the middle, leaning toward best size will help
- High bandwidth, low volume – somewhere in the middle, leaning toward best speed will help
The compression levels can be changed via the webRDP.properties file. The webRDP.properties file needs to be placed in, C:\stoneware\temp\swWebRDP.war\webapp\WEB-INF\lib\webRDP.properties
Be aware that this file will be overwritten when webNetwork is updated. A future version of webRDP will implement a more permanent way to set the properties.
A sample file is attached.
To use the standard Java compression (non-optimized) set the value to 0 or to anything but 1-9.