The following documentation explains how to install the Linux or UNIX server code, start the server daemon, and make a connection to a remote Linux or UNIX server. Look here for setting up a server on Windows.
To use the Remote System Explorer communications server daemon you need to install Perl. Using the daemon helps eliminate some of the manual steps when you connect to the server.
Installing the server code
tar -xvf rdt-server-linux-1.0.tar
Starting the server
You can start the RSE communications server with the server daemon, or manually. Before starting the server, make sure the Java command is in your path, you can do this by running the following command:
You should see something similar to the following:
java version "1.4.1" Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1) Classic VM (build 1.4.1, J2RE 1.4.1 IBM build cxppc321411-20040301 (JIT enabled: jitc))
If you receive a "command not found" error, then try creating a symbolic link to the java command in /usr/bin by running the following command:
ln -s /opt/IBMJava2-141/jre/bin/java /usr/bin/java
To start the server with the server daemon
Ensure that you are running using the root user ID. (If the daemon is not run under root, it will be unable to authenticate connecting users.) Run the following commands:
su -l root cd /home/user/rdt-server perl ./daemon.pl [daemonPort] [serverPortRange]
Note that the server daemon runs on port 4075 by default. You can pass the optional daemonPort argument to force a different port if you want. If your daemon runs behind a firewall, you may want to specify the optional serverPortRange argument to restrict selected server ports to the range given:
perl ./daemon.pl 4075 10000-10010
To start the server manually
Note: In the following discussion we assume that the RSE server has been installed on Linux. If you are running on a UNIX system the script name is "server.sh" rather than "server.pl".
If you do not have root access on a remote machine, you can start the server manually for your particular user id only. Run the following commands:
cd /home/user/rdt-server perl ./server.pl [port]
These commands run the server.pl script located in the /opt/rseserver directory. The port parameter to the server.pl script is optional. If you do not specify a port, then the server will pick the first one available and print the port number to standard out. By default, it is usually 4033. If you would like to use a different port, you will then have to enter this port number in port property for the Files subsystem for your connection in the Remote System Explorer (see Connecting to the Remote Server, below). Otherwise, you do not need to change this property.
Note: When you connect RSE to the server, the server will terminate as soon as you disconnect the client. The daemon, however, will not terminate.