Bug 142952 - Update docs for easier startup of Windows daemon.bat

rse/doc/org.eclipse.rse.doc.user/tasks/tbeginlinux.html

@@ -51,14 +51,6 @@ team sharing), but you are free to use any directory.</li>
 server code from the package appropriate to your operating system. For linux this command is:
 <pre>tar -xf rseserver-1.0-linux.tar</pre>
 </li>
-<li>Still in the /opt/rseserver directory, run the following configuration
-commands:
-<pre>
-chmod 755 server.pl
-chmod 755 daemon.pl
-chmod 755 auth.pl
-</pre>
-</li>
 </ol>
 </div>
 
@@ -83,20 +75,23 @@ to the java command in /usr/bin by running the following command:<pre>ln -s  /op
 not run under root, it will be unable to authenticate connecting users.) Run
 the following commands:<pre>su -l root
 cd /opt/rseserver
-perl ./daemon.pl</pre>
+perl ./daemon.pl [daemonPort] [serverPortRange]</pre>
 </li>
 </ol>
-Note that the server daemon runs on port 4035. You can also start the
-daemon.unix in the same way.<br></br>
+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.<br/>
+If your daemon runs behind a firewall, you may want to specify the optional
+<i>serverPortRange</i> argument to restrict selected server ports to the
+range given:<pre>
+perl ./daemon.pl 4035 10000-10010</pre>
+
 <p><b>To start the server manually</b></p>
 <div class="p">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:<pre>cd /opt/rseserver
 perl ./server.pl [port]</pre>
 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 <samp class="codeph">chmod
-755 server.pl</samp>. 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 <span class="uicontrol">Connecting to the
 Remote Server</span>, below). Otherwise, you do not need to change this
 property.</div>
+<div class="p"><div class="note">
+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.
+</div></div>
+
 <p><b>Rexec Server Launcher</b></p>
 <div class="p">If you have Rexec access enabled to your remote system, you
 can also have the server started automatically by an Rexec command from the

rse/doc/org.eclipse.rse.doc.user/tasks/tbeginwindows.html

@@ -39,42 +39,53 @@ for Windows.</li>
 </div>
 <p><b>Starting the server</b></p>
 <p>You can start the RSE communications server with the server manually, or with a daemon.</p>
-<div class="p">To start the server manually:
+
+<div class="p"><b>To start the server with a the server daemon:</b>
 <ol>
-<li>Configure your CLASSPATH and then start the communications server. In a command prompt, enter:
+<li>Simply double click the <code>daemon.bat</code> program to start a server daemon.</li>
+<li>You can edit the <code>daemon.bat</code> 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).</li>
+</ol>
+<blockquote>
+<p>Note that the server daemon <b>does not</b> 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.
+<span style="font-weight: bold;">Use of the server daemon on Windows systems is not recommended</span>.
+</p>
+The server daemon runs on port 4035 by default. You can pass the optional
+daemonPort argument to force a different port if you want.<br/>
+If your daemon runs behind a firewall, you may want to specify the optional
+<i>serverPortRange</i> argument to restrict selected server ports to the
+range given:<pre>
+daemon.bat 4035 10000-10010</pre>
+</blockquote>
+</div>
+
+<div class="p"><b>To start the server manually:</b>
+<ol>
+<li>Simply double click on the <code>server.bat</code> 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.</li>
+<li>For security reasons, the server will only wait a limited time
+until a client connects (12000 seconds by default).</li>
+<li>In order to start the server with an exactly specified port or
+timeout, open a Windows command prompt and enter:
 <pre>
 c:<br/>
 cd \rseserver<br/>
-setup.bat<br/>
-server.bat [port]
+server.bat [port] [timeout]
 </pre>
-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).
 </li>
-</ol>
-</div>
-<div class="p">To start the server with a the server daemon:
-<ol>
-<li>First, you need to configure your CLASSPATH and then start the
-server daemon. In a command prompt, enter:
-<pre>
-c:<br/>
-cd:\rseserver<br/>
-setup.bat<br/>
-daemon.bat
-</pre>
-Note that the server daemon <b>does not</b> 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.
-<span style="font-weight: bold;">Use of the server daemon on Windows systems is not recommended</span>.</li>
+<li>When you connect RSE to the server, the server will terminate as soon as you
+disconnect the client. The daemon, however, will not terminate.</li>
 </ol>
 </div>
 </div>
-<div class="p">To connect to a remote Windows server:</div>
+
+<div class="p"><b>To connect to a remote Windows server:</b>
 <ol>
 <li><span>Switch to the Remote System Explorer perspective.</span></li>
 <li><span>In the Remote Systems view, <b>New Connection</b> is
@@ -91,6 +102,8 @@ the <b>Host Name</b> field, for example, jsandler.</span></li>
 appears in the Properties view after the connection is created.</span></li>
 <li><span>Click <b>Finish</b> to define your system. </span></li>
 </ol>
+</div>
+
 <div class="p">
 <div class="note"><span class="notetitle">Note: </span>To check your
 port number, right-click your connection or subsystem