# Connecting to a remote Windows server

Installing the server code:

1. 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.
2. Find the x\eclipse\plugins\com.ibm.etools.systems.universal_version_number\serverruntime\rseserver.jar file on your local workstation, where x is the directory where you installed the product.
3. Copy the rseserver.jar to the C:\rseserver directory (this can be on a different machine).
4. Open a command prompt, and run the following command in the C:\rseserver directory to extract the server code:

       jar xf rseserver.jar

   If you receive an error, ensure that you have an entry for the /bin JDK directory in your Path environment variable. JDK version 1.4 is required.

Starting the server:

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

To start the server manually:

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

       c:

       cd:\rseserver

       win.env.bat

       run.win.bat [port]

   The port parameter to the run.win.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:

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

       c:

       cd:\rseserver

       win.env.bat

       daemon.win.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:

1. Switch to the Remote System Explorer perspective.
2. 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.
3. Enter a name for your first profile and click Next. (This step only occurs if you have never defined a connection before.)
4. Enter a connection name. This name displays in your tree view and must be unique to the profile.
5. Enter the name or TCP/IP address of your Windows server in the Host Name field, for example, jsandler.
6. Enter a Description(optional); the description appears in the Properties view after the connection is created.
7. 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.

Related tasks
Connecting to a remote Linux or UNIX server