RemoteLinux Installation Guide

Step 1 - Download the server application:

Download the Windows Server application. You can download the newest version of the server application from here.

When prompted to save or open, click open.

This will download the server application and then open it in your default zip application. The server application can be extracted and ran from any location.

I suggest just creating a folder in your documents folder and putting it there.

Now there will be 4 files extracted, RemoteServer.exe, Server.dll, InputHandler.jar, Remote Server.sh.

Step 2 - Install Mono

The server application uses the mono platform. If you are running Ubuntu 8+ I belive this is already installed for you. But if not go to Mono-Project and get a copy of the mono platform.

Step 3 - Install Java Runtime Environment

The server application also makes use of a small java application for handling input. You will need to have the java run time environment installed. Consult your linux distro for what package to install. Most should already have this installed.

On Ubuntu I had to:

"sudo apt-get install sun-java6-jre"

"sudo update-java-alternatives -s java-6-sun"

Step 4 - Setup the Launch Script

Open the file Remote Server.sh in a text editor change the PATHTO/RemoteLinux to point to the directory you extracted the server app to. Save that and run the script. It it doesnt execute check the permissions and make sure they are set to executable.

Another way to execute would be "mono RemoteServerLinux.exe"

Step 5 - Setup the server:

You will be prompted with the server settings screen.

From this screen you can control the server application.

First we will click the connection tab.

On the connection tab we have will specify the port to use. By default port 5200 is set. This port will work fine for most people so we will go ahead and use that.

Now for security reasons we will want to check Authentication Required, and specify a password.

If you want to be very secure and require the a user of the desktop to approve all incomming conections check the "Prompt RemoteLinux to approve user connections".
What this means is when a connection is atempted to the server, a dialog will show on the desktop asking the user if they want to accept the connection. So do not set this unless there will be a user to approve the connection at the computer you are connecting to.

Thoose are the basic settings needed for connection. So now click save settings.

Step 6 - Set input allowed (OPTIONAL)

You can limit the connecting client's input to the server from the Inputs tab.

By unchecking the boxes on the inputs tab you can respectively disable the ability of these functions to work.

Step 7 - Start the server

Save the settings, and go to the server info tab. Now we are ready to start the server, so click start RemoteWin Server.

If you get a message about "only one usage of socket address is normally permitted", then you have something else using the port that you specified. Change your port setting and try again.

Step 8 - Setup the WebOS Client

You can install it using WebOS Quick Install, or FileCoaster

After you have installed the client on the WebOS Device run it and you will be prompted with the login screen

Select a refresh rate you want to use. Generaly you will want to keep it at 1. Selecting 0 would be no refresh. And anything over 2 would be rather slow.

Select the image quality you want to see, the lower the quality the faster the refresh will be.

Next Click Edit Server Info

Step 9 - Setup Server Info

Under server address, the first line is the address of your server.

All addressed are formatted http://ADDRESS HERE

The address that you put in here depends on your setup.

It is HIGHLY recommended that you get this working over WIFI before you try using EVDO.

To setup for WIFI it is much easier, do the following:

• On the server box click start, then run, and type "cmd"
• You will see a command prompt window
• Next type "ipconfig"

• You will see something similar to this, now there is a line that says IPv4 Address. That is the address of the server computer.
• Input the IPv4 address into the server address box.

To setup for EVDO (Internet) access do the following:

• First follow the directions for the wifi access to get your server ip address.
• Next you must setup port forwarding to forward the port you specified in the server application.
• For more information about port forwarding check out http://portforward.com/
• Basicaly you have to forward the port you setup in the server application "5000" to the ip of the server, in this example 192.168.1.7
• Next you need your server's public ip, which can be found by going to http://whatismyip.com
• This is the value you will put into the server address box.
• OPTIONAL - Setup a dynamic url for the server address. Go to dyndns.com and register for a free dynamic url. Then install the dyndns updater on the server machine. With a dynamic url you will have a url that will never change and will be updated to point to the ip of ther server computer always.

The second line is your port number, the same one you specified in your server settings, default being 5000.

Then finaly input the password.

Click Save Server

Step 10 - Login!

That is all you have to do to setup the client, you just have to click login and it will access the server application and you should be seeing your desktop!

Functions of the viewer

The viewer works just like any pre app, you can pinch zoom and move around the screen with your finger. Double tap will zoom in our out. Back gesture will go back to the login screen.

There is 4 buttons visible on the screen. "Scroll up" "Scroll Down" "Double Click" "Right Click"

Scroll Up - This button will page up any open selected document. Making it easy to scroll up on a document without having to click the scroll bars.

Scroll Down - Same as up but goes down.

Double Click - To Preform a double click, click this button then the next time you tap the screen it will be a double click.

Right Click - To preform a right click, click this button then the next time you tap the screen it will be a right click.

Menu Options

• Show / Hide Command buttons - Toggles the visibility of the double click and right click keys.
• Show / Hide Scroll Buttons - Toggles the visibility of the scroll buttons
• Refresh Screen - Forces the screen to do a complete refresh
• Function Keys - Brings up the scene containing all the function keys, tab, ctrl, alt, and esc. Clicking a key on this screen will send that key to the server. To get back to the server screen click the back key.

CTRL + Key Sending

To send a ctrl + key combo, tap the gesture area to send the ctrl key, then tap the key you want to do in combo with it. So to do ctrl+c aka copy, tap the gesture area do not hold it, just tap it. Then tap the C key.

ALT + Key Sending

To send a alt + key combo, bring up the function keys scene from the main menu. Next tap the alt key, this will tell the server you pressed alt. Next press back, then push the key you wish to do in combo with it.

Trouble Shooting

-Instant Unable to connect message : This usualy means the server address provided is not valid. The address was unable to resolve to anything so it imediately was unable to connect. If it takes a while then displays the message, then there is something blocking the connection on your server. Check your windows firewall settings, and any virus or spyware software that may block the connection.

-No mouse and keyboard input: You have to turn on mouse and keyboard input from the inputs tab. Else you will be in view only mode.

-Wont connect over the EVDO: Try changing the port used on the server, and make sure that your router is set to forward to the new port. Port 9000 has been suggested as working.

Try running with and without password, and various color settings to get the best speed and function ratio.