Remote Vision(Java RDP Client) User Manual

(1)

Remote Vision(Java RDP

Client)

(2)

Remote Spark Corp. Page 2 of 9

1. Overview

Remote Vision is a Java RDP (Remote Desktop Protocol) client which provides end-users with remote access to following RDP hosts:

• RDP enabled Windows desktops, including: Windows 2000 Server, Windows XP Professional, MCE 2005, Windows Server 2003, Windows Vista Business or Ultimate, Windows Server 2008, Windows 7 Professional, Business or Ultimate, Windows Server 2008 R2.

• Linux desktops with xrdp installed.

1.1. Features

It has following advantages compared with traditional RDP clients: • Cross-platform, can run on any platform which has Java installed. • Support clipboard, bidirectional audio, drive redirections etc. • Support RemoteFX for LAN video acceleration.

• Support Network Level Authentication • Full screen support.

• Connect to Hyper-V console.

(3)

2. Installation

2.1. Install JRE (Java Runtime Environment)

Download the JRE, release version 1.6 or later, from:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

Install the JRE according to the instructions included with the release.

Verify the Java version you are using, run following command in a command prompt: java –version

JDK 1.6.0_27 or the newest JDK 1.8 are recommended. SSL encryption in JDK 7 is not compatible with RDP server's Network Level Authentication (credSSP).

2.2. Run Remote Vision as Java Application without parameters

Download Remote Vision from:

http://www.remotespark.com/download/RemoteVision.jar

Execute following command to start Remote Vision without any parameters: java -jar RemoteVision.jar

(4)

Remote Spark Corp. Page 4 of 9 You can create, edit, or launch a .rdp or .vnc file from the main screen.

Click to create a new connection and save the configuration in a .rdp file:

Click or double click the .rdp file to launch the connection.

2.3. Run Remote Vision as application with parameters

You can let Remote Vision connect to a server directly without the connection management interface by specifying connection parameters:

java -jar RemoteVision.jar server=192.168.8.20 credSSP=auto username=user password=password width=800 height=600 shareDir=D:\apps

(5)

To launch the connection in full screen mode, you can: set width = 0 and height=0; or set fullscreen=true Please check Chapter 3 for the parameters you can use.

2.4. Run Remote Vision as a Java Applet in browser

Here is an example of the HTML page:

<title>Remote Vision</title>

To launch the connection in full screen mode, you can: set width = 0 and height=0; or set fullscreen=true Please check Chapter 3 for the parameters you can use.

Run Remote Vision as a Java Applet in browser

Here is an example of the HTML page:

(6)

Remote Spark Corp. Page 6 of 9 <body>

<h1>Remote Vision</h1> <h2>Java RDP/VNC Client</h2>

</body> </html>

Please check Chapter 3 for the parameters you can use.

2.5. Run it in Juniper Appliance

Example for running it in Juniper Appliance: <html>

(7)

<head>

<title>Remote Vision Applet</title>

<!-- Notes:

1) << CODEBASE >> is a system value that will get replaced at the time the applet is launched. Please do not modify this value.

2) Please modify the remaining values as needed.

3) Please make sure all attribute names/values are enclosed in double quotes. --> <body> <applet code="com.toremote.desktop.ClientApplet.class" codebase="<< CODEBASE >>" archive="RemoteVision.jar" width="640" height="480" name="toremote" align="top">

(8)

Remote Spark Corp. Page 8 of 9 <param name="port" value="3389">

</body> </html>

3. RDP parameters

You can use following parameter in Remote Vision

Parameter Value

server Address of the RDP host.

port RDP listening port. Optional, default is 3389

username User name (Windows User).

password Password for user name.

domain domain name

console Connecting to console session/Admin mode. Default is false.

legacyMode Connecting to xrdp or VirtualBox RDP, default is false

geometry Resolution, e.g. 800x600. You can also use width and height to

specify the resolution

width Screen width of RDP session. Default is 800. Start in full screen

mode if width and height are both 0.

height Screen height of RDP session. Default is 600. Start in full screen mode if width and height are both 0.

bpp Color depth of RDP session. Default is 16

playSound Default is 1: Do not play sound; 0: bring sound to local; 2: leave sound on remote computer.

command Command for “Start a program on connection

directory Directory for running command

mapClipboard Default is false, disable clipboard redirection.

shareDir Redirect this folder as a local drive

loadBalanceInfo Load balance information

vmid Hyper-V VM GUID, For example:

B3D5444C-2611-405A-9CA0-7AA8DA94DF0B, it’s for Hyper-V console connection.

connectType Connecting type:

CONNECTION_TYPE_MODEM 0x01 Modem (56 Kbps)

CONNECTION_TYPE_BROADBAND_LOW 0x02 Low-speed broadband (256 Kbps - 2 Mbps) CONNECTION_TYPE_SATELLITE 0x03

Satellite (2 Mbps - 16 Mbps with high latency) CONNECTION_TYPE_BROADBAND_HIGH 0x04

(9)

CONNECTION_TYPE_WAN 0x05

WAN (10 Mbps or higher with high latency) CONNECTION_TYPE_LAN 0x06

LAN (10 Mbps or higher)

audioRecord Enable remote audio recording, default is false

credSSP Network Level Authentication, Value can be "true", "false" or "auto". default is false. "auto" will connect without credSSP at the first time, reconnect with credSSP if the connection failed.

fullscreen Enable full screen, default is false

performanceflags Default value is 111.

PERF_DISABLE_WALLPAPER = 0x01; PERF_DISABLE_FULLWINDOWDRAG = 0x02; PERF_DISABLE_MENUANIMATIONS = 0x04; PERF_DISABLE_THEMING = 0x08; PERF_DISABLE_CURSOR_SHADOW = 0x20; PERF_DISABLE_CURSORSETTINGS = 0x40; PERF_ENABLE_FONT_SMOOTHING = 0x80; PERF_ENABLE_DESKTOP_COMPOSITION = 0x100; Value 111 will disable cursor shadow, background etc: 111 = PERF_DISABLE_CURSOR_SHADOW |

PERF_DISABLE_CURSORSETTINGS | PERF_DISABLE_FULLWINDOWDRAG |

PERF_DISABLE_MENUANIMATIONS | PERF_DISABLE_THEMING | PERF_DISABLE_WALLPAPER;

Appendix A: shortcut keys

• CTRL+ALT+END Brings up the Windows Security dialog box. • ALT+PAGE UP Switches between programs from left to right. • ALT+PAGE DOWN Switches between programs from right to left.

• ALT+INSERT Cycles through the programs in the order they were started. • ALT+HOME Displays the Start menu.

Remote Vision(Java RDP Client) User Manual