Bug 146839 - updating install instructions

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

@@ -20,39 +20,38 @@ or UNIX server.</p>
 <p><b>Prerequisites</b></p>
 <p>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.Also note that Java Development Kit (JDK)
+when you connect to the server.</p>
-version 1.4 or higher is required.</p>
 <p><b>Installing the server code</b></p>
 <div class="p">
 <ol>
+<li>
+Find the package that contains the server.
+The server code is usually packaged with the 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-&lt;version&gt;-&lt;os&gt;.tar. For example, rseserver-1.0-linux.tar contains the release 1.0 server
+for Linux. There are servers for Linux, AIX, a generic Unix version that can be tailored to your particular flavor
+of Unix, and an experimental Mac OS X version.</li> 
 <li>Ensure that Perl is installed.</li>
-  <li>Ensure that JDK version 1.4 or higher is installed.</li>
+<li>Ensure that a Java Runtime Environment (JRE) version 1.4 or higher is installed.</li>
 <li>Create a directory where you want to install the server code. The remainder
 of these instructions will assume the directory /opt/rseserver (suitable for
 team sharing), but you are free to use any directory.</li>
-  <li>Find the <i>x:\product directory</i>\eclipse\plugins\com.ibm.etools.systems.universal_<i>version_number</i>\serverruntime\rseserver.jar
+<li>Upload the server package to this directory. You can use FTP.</li>
-file on your local workstation, where <i>x:\product directory</i> is the directory
-where you installed the product, for example, c:\WSWB.</li>
-  <li>FTP the file rseserver.jar to the /opt/rseserver directory.</li>
 <li>Switch to the /opt/rseserver directory by typing:
 <pre>cd /opt/rseserver</pre>
 </li>
 <li>Run the following command in the /opt/rseserver directory to extract the
-server code:<pre>jar -xf rseserver.jar</pre>
+server code from the package appropriate to your operating system. For linux this command is:
-  <b><span class="attentiontitle">Attention</span></b><span class="attentiontitle">: </span>The
+<pre>tar -xf rseserver-1.0-linux.tar</pre>
-jar command is shipped with the JDK and might not be in your path.  If you
-receive a "command not found" error when running the jar command then try
-to qualify the jar command with the installation directory for the JDK.  For
-example: <samp class="codeph">/opt/IBMJava2-131/bin/jar -xf rseserver.jar</samp>
-<br>
-</br>
 </li>
 <li>Still in the /opt/rseserver directory, run the following configuration
-commands:<pre>dos2unix daemon.linux
+commands:
-dos2unix server.linux
+<pre>
-chmod 755 server.linux
+chmod 755 server.pl
-chmod 755 daemon.linux
+chmod 755 daemon.pl
-chmod 755 auth.pl</pre>
+chmod 755 auth.pl
+</pre>
 </li>
 </ol>
 </div>
@@ -70,7 +69,7 @@ Classic VM (build 1.4.1, J2RE 1.4.1 IBM build cxppc321411-20040301 (JIT enabled:
 </div>
 <div class="p">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:<pre>ln -s  /opt/IBMJava2-131/jre/bin/java /usr/bin/java</pre>
+to the java command in /usr/bin by running the following command:<pre>ln -s  /opt/IBMJava2-141/jre/bin/java /usr/bin/java</pre>
 </div>
 <div class="p"><b>To start the server with the server daemon</b>
 <ol>
@@ -78,34 +77,19 @@ 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.linux</pre>
+perl ./daemon.pl</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>
-<p><b>To start the Linux server manually</b></p>
+<p><b>To start the server manually</b></p>
 <div class="p">Run
 the following commands:<pre>cd /opt/rseserver
-perl ./server.linux [port]</pre>
+perl ./server.pl [port]</pre>
-These commands run the server.linux
+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.linux (for example, enter <samp class="codeph">chmod
+changing the permission attributes on server.pl (for example, enter <samp class="codeph">chmod
-755 server.linux</samp>. The port parameter to the server.linux script is
+755 server.pl</samp>. 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 <span class="uicontrol">Connecting to the
-Remote Server</span>, below). Otherwise, you do not need to change this
-property.</div>
-<p><b>To start the UNIX server manually</b></p>
-<div class="p">To run the unix.server
-script, enter the following commands:<pre>cd /opt/rseserver
-perl ./server.unix [port]</pre>
-These commands run the server.linux
-script located in the /opt/rseserver directory. If this does not work, try
-changing the permission attributes on server.unix (for example, enter <samp class="codeph">chmod
-755 server.unix</samp>. The port parameter to the server.unix 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
@@ -118,9 +102,8 @@ property.</div>
 to configure the daemon to run at start up for Linux. To do so, you need to
 append a call to the daemon to your startup script.  Add the following lines
 to the bottom of the /etc/rc.d/rc.local file:<pre>cd /opt/rseserver
-perl ./daemon.linux &amp;</pre>
+perl ./daemon.pl &amp;</pre>
-You can also add <samp class="codeph">perl ./daemon.unix</samp> if
+</div>
-you want to run the UNIX daemon at startup.</div>
 </div>
 </div><br></br>
 <p><b>Connecting to the Remote Server</b></p>

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

@@ -14,41 +14,35 @@
 <h1 class="topictitle1">Connecting to a remote Windows server</h1>
 <div>
 <div class="p">
-<p><b>Installing the server code:</b></p>
+<p><b>Installing the server code</b></p>
 <div class="p">
 <ol>
-<li>Create a directory where you want to install the server code. The
+<li>
+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.</li>
-<li>Find the <span style="font-style: italic;">x</span>\eclipse\plugins\com.ibm.etools.systems.universal_<i>version_number</i>\serverruntime\rseserver.jar
+<li>Find the package that contains the server.
-file on your local workstation, where <i>x</i> is the directory where you
+The server code is usually packaged with a containing product and you should refer to that 
-installed the product.</li>
+product's documentation for finding and installing the server package.
-<li>Copy the rseserver.jar to the C:\rseserver directory (this can be
+The server is also available, however, on the Eclipse DSDP Target Management download site as the package
-on a different machine).</li>
+rseserver-&lt;version&gt;-&lt;os&gt;.zip. For example, rseserver-1.0-windows.zip contains the release 1.0 server
-<li>Open a command prompt, and run the following command in the
+for Windows.</li>
-C:\rseserver directory to extract the server code:
+<li>Copy the rseserver.zip to the C:\rseserver directory (this could be on a different machine).</li>
-<pre>jar xf rseserver.jar</pre>
+<li>Using an unzip utility to extract the server code to the C:\rseserver directory.</li>
-<div class="note">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.</div>
-</li>
 </ol>
 </div>
-<p><b>Starting the server:</b></p>
+<p><b>Starting the server</b></p>
-<p>You can start the RSE communications
+<p>You can start the RSE communications server with the server manually, or with a daemon.</p>
-server with the server manually, or with a daemon.</p>
+<div class="p">To start the server manually:
-<div class="p">To start the server
-manually:
 <ol>
-<li>First, you need to configure your CLASSPATH and then start the
+<li>Configure your CLASSPATH and then start the communications server. In a command prompt, enter:
-communications server. In a command prompt, enter:
 <pre>
 c:<br/>
-cd:\rseserver<br/>
+cd \rseserver<br/>
-win.env.bat<br/>
+setup.bat<br/>
-run.win.bat [port]
+server.bat [port]
 </pre>
-The port parameter to the run.win.bat program is optional. If
+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
@@ -64,13 +58,13 @@ server daemon. In a command prompt, enter:
 <pre>
 c:<br/>
 cd:\rseserver<br/>
-win.env.bat<br/>
+setup.bat<br/>
-daemon.win.bat
+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
+with the file system and run commands.
-of the server daemon on Windows systems is not recommended</span>.</li>
+<span style="font-weight: bold;">Use of the server daemon on Windows systems is not recommended</span>.</li>
 </ol>
 </div>
 </div>