Connecting to a remote Windows server

The following documentation explains how to install the Windows server code, start the server daemon, and make a connection to a remote Windows server. Look here for setting up a server on Linux, General UNIX or Mac, and additional configuration options.

Installing the server code

Create a directory where you want to install the server code. The remainder of these instructions will assume the directory name and location is C:\rseserver, but you are free to use any directory you choose.
Find the package that contains the server. The server code is usually packaged with a containing product and you should refer to that product's documentation for finding and installing the server package. The server is also available, however, on the Eclipse DSDP Target Management download site as the package rseserver-<version>-<os>.zip. For example, rseserver-1.0-windows.zip contains the release 1.0 server for Windows.
Copy the rseserver.zip to the C:\rseserver directory (this could be on a different machine).
Using an unzip utility to extract the server code to the C:\rseserver directory.

Starting the server

You can start the RSE communications server with the server manually, or with a daemon.

To start the server manually:

Configure your CLASSPATH and then start the communications server. In a command prompt, enter:
```
c:

cd \rseserver

setup.bat

server.bat [port]
```
The port parameter to the server.bat program is optional. If you do not specify a port, the server will pick the first port available and print the port number to standard out. By default, it is usually 4033. You will then have to enter this port number in the port property for the Files subsystem for your connection in the Remote System Explorer (see Connecting below).

To start the server with a the server daemon:

First, you need to configure your CLASSPATH and then start the server daemon. In a command prompt, enter:
```
c:

cd:\rseserver

setup.bat

daemon.bat
```
Note that the server daemon does not enforce any user authentication. If you run the server daemon, any user can connect to the machine, work with the file system and run commands. Use of the server daemon on Windows systems is not recommended.

To connect to a remote Windows server:

Switch to the Remote System Explorer perspective.
In the Remote Systems view, New Connection is automatically be expanded to show the various remote systems you can connect to through the Remote System Explorer. Expand Windows to invoke a dialog and configure a connection.
Enter a name for your first profile and click Next. (This step only occurs if you have never defined a connection before.)
Enter a connection name. This name displays in your tree view and must be unique to the profile.
Enter the name or TCP/IP address of your Windows server in the Host Name field, for example, jsandler.
Enter a Description(optional); the description appears in the Properties view after the connection is created.
Click Finish to define your system.

Note: To check your port number, right-click your connection or subsystem from the Remote Systems view and select Properties. Click Subsystem to see the relevant information. If your port is "0," then your Remote System Explorer communications server will pick any free port on the Windows server. If you specified a port number when starting the server, you need to enter it here, for example, to work with a firewall.