From 3be872e172cf63269c03dc89c480aee6a213432b Mon Sep 17 00:00:00 2001 From: Martin Oberhuber < martin.oberhuber@windriver.com> Date: Mon, 25 Sep 2006 16:06:00 +0000 Subject: [PATCH] Bug 142952 - Update docs for easier startup of Windows daemon.bat --- .../tasks/tbeginlinux.html | 28 ++++---- .../tasks/tbeginwindows.html | 67 +++++++++++-------- 2 files changed, 54 insertions(+), 41 deletions(-) diff --git a/rse/doc/org.eclipse.rse.doc.user/tasks/tbeginlinux.html b/rse/doc/org.eclipse.rse.doc.user/tasks/tbeginlinux.html index c7075ca451d..26551230a0c 100755 --- a/rse/doc/org.eclipse.rse.doc.user/tasks/tbeginlinux.html +++ b/rse/doc/org.eclipse.rse.doc.user/tasks/tbeginlinux.html @@ -51,14 +51,6 @@ team sharing), but you are free to use any directory. server code from the package appropriate to your operating system. For linux this command is: 
tar -xf rseserver-1.0-linux.tar
-
  • Still in the /opt/rseserver directory, run the following configuration -commands: -
    -chmod 755 server.pl
-chmod 755 daemon.pl
-chmod 755 auth.pl
-
    -
    • @@ -83,20 +75,23 @@ to the java command in /usr/bin by running the following command:
    ln -s  /op
 not run under root, it will be unable to authenticate connecting users.) Run
 the following commands:
    su -l root
 cd /opt/rseserver
-perl ./daemon.pl
    
+perl ./daemon.pl [daemonPort] [serverPortRange]
    -Note that the server daemon runs on port 4035. You can also start the -daemon.unix in the same way.

    +Note that the server daemon runs on port 4035 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 4035 10000-10010
    +

    To start the server manually

    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 /opt/rseserver
 perl ./server.pl [port]
    These commands run the server.pl -script located in the /opt/rseserver directory. If this does not work, try -changing the permission attributes on server.pl (for example, enter chmod -755 server.pl. The port parameter to the server.pl script is +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 @@ -104,6 +99,11 @@ 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. +
    +

    Rexec Server Launcher

    If you have Rexec access enabled to your remote system, you can also have the server started automatically by an Rexec command from the diff --git a/rse/doc/org.eclipse.rse.doc.user/tasks/tbeginwindows.html b/rse/doc/org.eclipse.rse.doc.user/tasks/tbeginwindows.html index 34b175f721a..1e2f7be4670 100755 --- a/rse/doc/org.eclipse.rse.doc.user/tasks/tbeginwindows.html +++ b/rse/doc/org.eclipse.rse.doc.user/tasks/tbeginwindows.html @@ -39,42 +39,53 @@ for Windows.

    Starting the server

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

    -
    To start the server manually: + +
    To start the server with a the server daemon:
      -
    1. Configure your CLASSPATH and then start the communications server. In a command prompt, enter: +
    2. Simply double click the daemon.bat program to start a server daemon.
      3. +
    3. You can edit the daemon.bat file to change properties for the daemon, +like a specific daemon port to use or to force a port range for the server +(in order to comply with firewalls).
      4. +
    +
    +

    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. +

    +The server daemon runs on port 4035 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:
    +daemon.bat 4035 10000-10010
    +
    +
    + +
    To start the server manually: +
      +
    1. Simply double click on the server.bat program to start a +dstore server. The server will pick the first port available and print +the port number. By default, it is usually 4033. +You will then have to enter this port number in port property for the +Files subsystem for your connection in the Remote System Explorer.
      2. +
    2. For security reasons, the server will only wait a limited time +until a client connects (12000 seconds by default).
      3. +
    3. In order to start the server with an exactly specified port or +timeout, open a Windows command prompt and enter: 
       c:
      
 cd \rseserver
      
-setup.bat
      
-server.bat [port]
+server.bat [port] [timeout]
      -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).
      4. -
    -
    -
    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
      
-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.
      2. +
    2. When you connect RSE to the server, the server will terminate as soon as you +disconnect the client. The daemon, however, will not terminate.
    -
    To connect to a remote Windows server:
    + +
    To connect to a remote Windows server:
    1. Switch to the Remote System Explorer perspective.
    2. In the Remote Systems view, New Connection is @@ -91,6 +102,8 @@ the Host Name field, for example, jsandler.
      3. appears in the Properties view after the connection is created.
    3. Click Finish to define your system.
    +
    +
    Note: To check your port number, right-click your connection or subsystem