2006-06-27 12:36:05 +00:00
|
|
|
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
|
|
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
|
|
|
<link rel="stylesheet" href="http://www.eclipse.org/default_style.css" type="text/css">
|
|
|
|
|
<title>Build Notes for RSE @buildId@</title>
|
|
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
<table border="0" cellspacing="5" cellpadding="2" width="100%">
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="LEFT" width="80%">
|
|
|
|
|
<p><b><font class=indextop>Build Notes for RSE @buildId@</font></b><br>
|
|
|
|
|
@dateLong@ </p>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="5" cellpadding="2" width="100%">
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="LEFT" valign="TOP" colspan="3" bgcolor="#0080C0"><b>
|
|
|
|
|
<font face="Arial,Helvetica" color="#FFFFFF">New and Noteworthy</font></b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table><tbody><tr><td>
|
|
|
|
|
<ul>
|
2006-08-11 15:48:53 +00:00
|
|
|
<li>APIs and String Constants have been cleaned up from old artifacts.
|
|
|
|
|
RSE <b>Documentation</b> has been adjusted to latest refactorings. You'll get the
|
|
|
|
|
documentation as part of the installation, or you can browse it online at
|
|
|
|
|
<a href="http://dsdp.eclipse.org/help/latest/">http://dsdp.eclipse.org/help/latest/</a>.
|
|
|
|
|
Note that the online version is updated every night to hold the latest updates.</li>
|
|
|
|
|
<li>The ssh command shell now supports <b>RSE pattern matching</b> in the output.
|
|
|
|
|
Output parsers are installed for make, ls, pwd, cd, ps and many popular compilers.
|
|
|
|
|
If you run such a command, it's output will be parsed by the RSE shell
|
|
|
|
|
and annotations will be added. Double clicking these partially works (Bugs
|
|
|
|
|
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=153270">153270</a>,
|
|
|
|
|
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=153272">153272</a>).</li>
|
|
|
|
|
<li>The ssh command shell also supports <b>content assist</b> for directory names
|
|
|
|
|
and file names in the input box. To use it, press Ctrl+Space. After selecting
|
|
|
|
|
a completion, the command will be sent immediately (Bug
|
|
|
|
|
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=153271">153271</a>).</li>
|
|
|
|
|
<li>RSE now provides an <b>update site</b> at
|
|
|
|
|
<a href="http://download.eclipse.org/dsdp/tm/updates/">http://download.eclipse.org/dsdp/tm/updates/</a>.
|
|
|
|
|
We encourage users to update frequently, since we expect
|
|
|
|
|
RSE quality to improve more and more as we are approaching our 1.0 release.</li>
|
|
|
|
|
<li>Numerous bugs have been fixed, and we consider RSE safe now for
|
|
|
|
|
all kinds of data transfer, even if it's done in multiple background sessions
|
|
|
|
|
(except FTP, which will be enhanced as soon as the Jakarta Commons Net library
|
|
|
|
|
passes EMO legal review).</li>
|
|
|
|
|
<li>See also the
|
|
|
|
|
<a href="http://download.eclipse.org/dsdp/tm/downloads/drops/S-1.0M3-200606300720/buildNotes.php">
|
|
|
|
|
last milestone's New and Noteworthy</a>.</li>
|
2006-08-17 12:57:01 +00:00
|
|
|
<li>Use <a href="https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&classification=DSDP&product=Target%20Management&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bugidtype=include&chfieldfrom=2006-06-30&chfieldto=2006-08-17&chfield=resolution">
|
2006-06-27 12:36:05 +00:00
|
|
|
this query</a> to show the list of bugs fixed for this build.</li>
|
|
|
|
|
<li>Look <a href="http://download.eclipse.org/dsdp/tm/downloads/drops/N-changelog/index.html">
|
|
|
|
|
here</a> for the CVS changelog.</li>
|
2006-08-17 12:57:01 +00:00
|
|
|
<li>New since I20060811-1342:<ul>
|
|
|
|
|
<li><a href="https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&classification=DSDP&product=Target%20Management&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&bugidtype=include&chfieldfrom=2006-08-11&chfieldto=2006-08-17&chfield=resolution">
|
|
|
|
|
bugs fixed</a></li>
|
|
|
|
|
</ul></li>
|
2006-06-27 12:36:05 +00:00
|
|
|
</ul>
|
|
|
|
|
</td></tr></tbody></table>
|
|
|
|
|
|
|
|
|
|
<table border="0" cellspacing="5" cellpadding="2" width="100%">
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="LEFT" valign="TOP" colspan="3" bgcolor="#0080C0"><b>
|
|
|
|
|
<font face="Arial,Helvetica" color="#FFFFFF">Getting Started</font></b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table><tbody><tr><td>
|
2006-08-11 15:48:53 +00:00
|
|
|
<p>The simplest way to get RSE is via the Update Manager: From your running instance
|
|
|
|
|
of Eclipse 3.2, choose <b>Help > Software Updates > Find and Install...</b>.
|
|
|
|
|
Choose "Search for New Features to Install", and add a new Remote Site named
|
|
|
|
|
"RSE" and pointing to <b>http://download.eclipse.org/dsdp/tm/updates/</b>.
|
|
|
|
|
Select the RSE SDK feature, and perform the update process as usual.</p>
|
|
|
|
|
<p>If you prefer manual installation, you can download RSE SDK and either
|
2006-06-27 12:36:05 +00:00
|
|
|
<ul><li>Extract it into your installation of Eclipse 3.2, or</li>
|
|
|
|
|
<li>Extract it into an empty directory and link it as product extension via Help > Install/Update, or</li>
|
|
|
|
|
<li>(If you want to write code for RSE) extract it into an empty directory, and from an Eclipse PDE Workspace
|
|
|
|
|
choose Import > Plug-in development > Plug-ins and Fragemtns. Select the RSE directory and import
|
|
|
|
|
everything.</li>
|
|
|
|
|
</ul>
|
|
|
|
|
Start Eclipse Workbench, and choose <b>Window > Open Perspective > Other > Remote System Explorer</b>.</p>
|
|
|
|
|
|
|
|
|
|
<p>Even without an actual connection to a remote system, you can start experimenting with the RSE UI on the
|
|
|
|
|
local host, which is shown by default:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>Browse the Filesystem, choose contextmenu > show in Table, and observe the Properties view</li>
|
|
|
|
|
<li>Create a new Filter to show specific resources in the file system only
|
2006-08-11 15:48:53 +00:00
|
|
|
<li>Launch an RSE Shell (Shells node > Launch)
|
|
|
|
|
<ul><li>In the Shell, perform commands such as ls, dir, ps, gcc, make and see the output interpreted</li>
|
|
|
|
|
<li>Use Ctrl+Space Content Assist on the shell command entry field</li>
|
|
|
|
|
</ul></li>
|
2006-06-27 12:36:05 +00:00
|
|
|
</ul>
|
|
|
|
|
For operations on an actual remote system, you can either
|
|
|
|
|
<ul>
|
|
|
|
|
<li>use the "<b>SSH Only</b>" system type (<b>New > Other > Remote Systems Explorer > Connection</b>), or</li>
|
|
|
|
|
<li>start a dstore server daemon on the remote system and use any of the other connection types.</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</td></tr></tbody></table>
|
|
|
|
|
|
|
|
|
|
<table border="0" cellspacing="5" cellpadding="2" width="100%">
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="LEFT" valign="TOP" colspan="3" bgcolor="#0080C0"><b>
|
|
|
|
|
<font face="Arial,Helvetica" color="#FFFFFF">Installing the Dstore server</font></b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table><tbody><tr><td>
|
|
|
|
|
<p>
|
|
|
|
|
RSE is a framework that supports plugging in many different communication protocols.
|
2006-06-30 08:36:53 +00:00
|
|
|
By default, the dstore, FTP and ssh protocol plug-ins are provided, with dstore being
|
2006-08-11 15:48:53 +00:00
|
|
|
the richest in features.</p>
|
2006-06-27 12:36:05 +00:00
|
|
|
<p>
|
|
|
|
|
Dstore requirs a server to run on the remote system. There are several methods to
|
|
|
|
|
get a server launched for a particular user, the most easy one to set up is the
|
|
|
|
|
daemon method. To start a dstore launcher daemon,
|
|
|
|
|
<ul>
|
|
|
|
|
<li>On Windows:<ul>
|
|
|
|
|
<li>Extract the rseserver-*-windows.zip package and cd to it.</li>
|
|
|
|
|
<li>Run <b>setup.bat</b>, then run <b>daemon.bat</b>.</li>
|
|
|
|
|
</ul></li>
|
|
|
|
|
<li>On Linux or AIX or other Unix:<ul>
|
|
|
|
|
<li>Extract the appropriate rseserver-*.tar package.</li>
|
|
|
|
|
<li>Become <b>root</b> and cd to the package directory.</li>
|
|
|
|
|
<li>Make sure that a <b>Sun or IBM JRE 1.4</b> or higher is in the PATH. The gcj-based java installation
|
|
|
|
|
that comes with many Linux distributions will not do! You can download a Sun JRE from
|
|
|
|
|
<a href="http://java.sun.com">http://java.sun.com</a>.
|
|
|
|
|
<li>Run <b>perl daemon.pl</b>.
|
|
|
|
|
</ul></li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p>
|
|
|
|
|
<b>Note:</b> In its default configuration for testing, the dstore daemon accepts <b>unencrypted
|
|
|
|
|
passwords</b> from the RSE client. For production use, SSL can be enabled in order to encrypt
|
|
|
|
|
connections, or the RSE server can be launched differently (e.g. through ssh).</p>
|
2006-06-30 08:36:53 +00:00
|
|
|
<p>
|
|
|
|
|
When no root access is available on the remote system (typically UNIX), normal
|
|
|
|
|
users can start a dstore server for themselves only, instead of a daemon:
|
|
|
|
|
<ul>
|
|
|
|
|
<li>On the remote system, run <b>perl server.pl [portname]</b></li>
|
|
|
|
|
<li>On the RSE client, create the dstore connection</li>
|
|
|
|
|
<li>After creating the connection, select it and choose Properties
|
|
|
|
|
<ul><li>On <b>Server Launcher Settings</b>, choose <b>Connect to Running Server</b></li>
|
|
|
|
|
<li>On the <b>Subsystem</b> page, enter the port number you used for starting the server</li>
|
|
|
|
|
</ul></li>
|
|
|
|
|
<li>When connecting, enter just anything for username and password (these will be ignored).</li>
|
|
|
|
|
<li>The server.pl script has more options, e.g. for using the first available
|
|
|
|
|
port instead of a well-known one, or for restricting access to a single
|
|
|
|
|
user ID. Since all dstore communication will be on the single TCP port,
|
|
|
|
|
this port can also be forwarded through an ssh tunnel if desired.</li>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
</ul>
|
2006-06-27 12:36:05 +00:00
|
|
|
|
|
|
|
|
</td></tr></tbody></table>
|
|
|
|
|
|
|
|
|
|
<table border="0" cellspacing="5" cellpadding="2" width="100%">
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="LEFT" valign="TOP" colspan="3" bgcolor="#0080C0"><b>
|
|
|
|
|
<font face="Arial,Helvetica" color="#FFFFFF">Using remote connections</font></b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table><tbody><tr><td>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>In the RSE Perspective, Remote Systems View, press the <b>New Connection</b> button.<ul>
|
|
|
|
|
<li>Note: In the Preferences, you can enable displaying available new connection types in the RSE tree.</li></ul></li>
|
2006-06-30 08:36:53 +00:00
|
|
|
<li>Select the desired system type<ul>
|
|
|
|
|
<li>Coose system type "SSH Only" for ssh servers, or any other for dstore.</li></ul></li>
|
|
|
|
|
<li>Enter an IP address for a remote system running an ssh server or dstore server.
|
|
|
|
|
A connection name will be suggested automatically, but can be changed.<ul>
|
|
|
|
|
<li>You can also run a dstore server on the local machine for testing. In this case,
|
|
|
|
|
type "localhost" as address.</li>
|
|
|
|
|
<li>You can press Finish right away, the wizard defaults are usually fine.</li></ul></li>
|
2006-06-27 12:36:05 +00:00
|
|
|
<li>Fill in the username / password dialog.<ul>
|
2006-06-30 08:36:53 +00:00
|
|
|
<li>Note: For ssh, if you have private keys, the password here is just a dummy.
|
|
|
|
|
Enter anything and save it. You can setup ssh private key authentication through
|
2006-06-27 12:36:05 +00:00
|
|
|
the <b>Team > CVS > SSH2 Connection Method</b> Preference page.</li></ul></li>
|
|
|
|
|
<li><b>Browse remote files</b>, or open remote shells.<ul>
|
|
|
|
|
<li>You can <b>drag and drop</b> files between local and remote file systems, between editors and any view.
|
|
|
|
|
Files are transferred as needed.</li>
|
|
|
|
|
<li>On dstore, you can browse into remote archives (*.zip, *.tar) without having to transfer the entire contents. This works thanks
|
|
|
|
|
to "miners" on the remote side. Custom miners can be plugged into the dstore server.<br>
|
|
|
|
|
Note: Some tar formats currently fail to work. See <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=139207">bug 139207</a>.</li>
|
|
|
|
|
<li>On dstore, you can choose <b>Search > Remote...</b>.<ul>
|
|
|
|
|
<li>The dstore miners support searching a remote file system
|
|
|
|
|
without having to transfer any data.</li></ul></li>
|
|
|
|
|
<li>On dstore, when the remote system is Linux, AIX or Other Unix:<ul>
|
|
|
|
|
<li>Browse remote <b>Processes</b>.</li>
|
|
|
|
|
<li>Select "My Processes" and choose context menu > <b>Monitor</b>.
|
|
|
|
|
<li>Enable polling, choose a short wait time. See processes appear and vanish as you perform commands in a remote shell.</li></ul></li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
</td></tr></tbody></table>
|
|
|
|
|
|
|
|
|
|
<!--
|
|
|
|
|
</td></tr></tbody></table>
|
|
|
|
|
<table border="0" cellspacing="5" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td colspan="2"> </td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
<table border="0" cellspacing="5" cellpadding="2" width="100%">
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="LEFT" valign="TOP" colspan="3" bgcolor="#0080C0"><b>
|
|
|
|
|
<font face="Arial,Helvetica" color="#FFFFFF">Known Problems and Workarounds</font></b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table><tbody><tr><td>
|
2006-08-11 15:48:53 +00:00
|
|
|
The following M4 <a href="http://www.eclipse.org/dsdp/tm/development/plan.php">original plan</a> deliverables did
|
2006-06-27 12:36:05 +00:00
|
|
|
not make it into this build:
|
|
|
|
|
<ul>
|
2006-08-11 15:48:53 +00:00
|
|
|
<li>User Actions, and Import/Export were deferred with M3 already.
|
|
|
|
|
A new <a href="http://www.eclipse.org/dsdp/tm/development/plan.php">plan</a>
|
|
|
|
|
has been published.</li>
|
|
|
|
|
<li>JUnit tests did not make it into the build due to pending IP legal review.
|
2006-06-30 08:36:53 +00:00
|
|
|
They are available from Bugzilla
|
2006-08-11 15:48:53 +00:00
|
|
|
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=149080">bug 149080</a>
|
|
|
|
|
instead. Due to the missing Unit Test Framework, automated tests could also
|
|
|
|
|
not yet be added to this build.</li>
|
|
|
|
|
<li>Examples are not yet available as downloadable package. A <b>CDT Launch Integration Example</b>,
|
|
|
|
|
a sample custom subsystem called <b>Daytime Example</b>,
|
|
|
|
|
as well as the <b>Tutorial Examples</b> from the ISV Docs are available
|
|
|
|
|
from the <a href="http://www.eclipse.org/dsdp/tm/development/index.php">
|
|
|
|
|
RSE CVS Repository</a> instead.</li>
|
2006-08-17 12:57:01 +00:00
|
|
|
<li>Jakarta Commons Net is not yet available for <b>FTP and Telnet</b> due to pending legal
|
|
|
|
|
review. We are confident to get these completed in August though.<ul>
|
|
|
|
|
<li>As a consequence, FTP connections are still not quite reliable.</li>
|
|
|
|
|
</ul></li>
|
2006-06-27 12:36:05 +00:00
|
|
|
</ul>
|
2006-08-11 15:48:53 +00:00
|
|
|
The following critical or major bugs are currently known.
|
2006-06-27 12:36:05 +00:00
|
|
|
We'll strive to fix these as soon as possible.
|
|
|
|
|
<ul>
|
2006-08-17 12:57:01 +00:00
|
|
|
<li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=154207">bug 154207</a> - maj - FileServiceSubsystem doesnt forward exception info</li>
|
2006-08-11 15:48:53 +00:00
|
|
|
<li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=150949">bug 150949</a> - maj - RSE gets unusable when full logging is enabled</li>
|
2006-06-27 12:36:05 +00:00
|
|
|
<li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143462">bug 143462</a> - maj - [updating] Dirty remote editors do not get notified</li>
|
|
|
|
|
<li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143292">bug 143292</a> - maj - [mac] Move Resource dialog causes hang/crash</li>
|
2006-06-30 08:36:53 +00:00
|
|
|
<li><a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=139207">bug 139207</a> - maj - Browsing into some remote tar archives fails, and may crash the dstore server<br/>
|
|
|
|
|
-- This problem was only observed with invalid tar archives.</li>
|
2006-06-27 12:36:05 +00:00
|
|
|
</ul>
|
|
|
|
|
Click
|
|
|
|
|
<a href="https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&classification=DSDP&product=Target+Management&component=RSE&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_severity=blocker&bug_severity=critical&bug_severity=major&cmdtype=doit">here</a>
|
|
|
|
|
for an up-to-date list of major or critical bugs, or
|
|
|
|
|
<a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_severity&y_axis_field=op_sys&z_axis_field=&query_format=report-table&classification=DSDP&product=Target+Management&component=RSE&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&format=table&action=wrap">here</a>
|
|
|
|
|
for a complete up-to-date bugzilla status report, or
|
|
|
|
|
<a href="https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_severity&y_axis_field=op_sys&z_axis_field=&query_format=report-table&classification=DSDP&product=Target+Management&component=RSE&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&format=table&action=wrap">here</a>
|
|
|
|
|
for a report on bugs fixed so far.
|
|
|
|
|
</td></tr></tbody></table>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
