Java errors occur when Ranger Remote Control (RRC) is installed

Question

How do I enable Java DirectDraw on a workstation with RRC installed?

Symptoms

The errors can vary but they should be relevant to a Java based program failing. The scope of this article is limited to only those issues identified as related to RRC.

Cause

Some Java applications draw directly to the screen using DirectDraw however by default RRC client does not capture video information that uses DirectDraw.

Resolution

Because RRC, by default, does not support DirectDraw the Tutor automatically disables DirectDraw on the client when a connection is made. This forces applications to use GDI calls to draw to the screen. In some situations this can cause applications to fail as they cannot revert to GDI calls.

To prevent the errors from occurring it is possible to stop RRC Tutor from disabling DirectDraw on the client. This does not mean RRC Tutor will be able to view what is drawn on screen however it will no longer disable the clients ability to use DirectDraw.

Instructions

To prevent DirectDraw from being disabled perform the following

1. Navigate to the program folder that RRC is installed e.g. c:Program filesRanger Remote Control.
2. Open the client32.ini file with a text editor and in the CLIENT section add the line EnableJavaDD1.
3. Save the file.
4. Re-checksum the file following the instructions (starting at no.4) CheckSum the client32.ini file
5. Re-start the workstation (or restart the Client32 service) to incorporate the changes.
6. If you want this change to be repeated on other clients, you will need to distribute a copy of the modified Client32.ini file to them via Remote Deploy.

Testing

After you have restarted the workstation or Client32 service confirm the Java program now functions correctly.