1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-07-03 23:25:26 +02:00

[191588] simplified the team support discussion, removing most of it.

This commit is contained in:
David Dykstal 2007-06-20 03:29:10 +00:00
parent 7113be1267
commit 2c6a9629c6
5 changed files with 109 additions and 81 deletions

View file

@ -4,7 +4,7 @@
<head>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2002, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2002, 2007. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" HREF="../book.css">
<title>RSE Artifacts</title>
</head>
@ -30,18 +30,24 @@ The RSE's <A href="view_RS.gif">Remote Systems view</A> shows all existing <b>Ho
Hosts are objects that are persisted, containing the information needed to access a particular remote host.
The view contains a prompt to create new Hosts, and pop-up menu actions to rename, copy, delete, and reorder existing Hosts.
</p>
<p>Hosts contain attributes, or data, that is saved between sessions of the workbench. These attributes are
<p>
Hosts contain attributes, or data, that is saved between sessions of the workbench. These attributes are
the host name, the remote system's host name and system type, an optional description, and a user Id that is
used by default by each subordinate subsystem, at host time.
Underneath, all Hosts are stored via RSE persistence in an Eclipse project named <CODE>RemoteSystemsConnections</CODE></A>, which
the user can enable for team support, allowing Hosts to be shared by a team.
Underneath, all Hosts are stored in profiles by an registered persistence provider.
</p>
<h2><A name="profiles">Profiles</A></h2>
<p>
To facilitate team-shared and user-unique Hosts,
Hosts are owned by <b>profiles</b>. These are simply <A href="file_profiles.gif">folders in the RemoteSystemsConnections
project</A>, as it turns out, within which all other data including Hosts are scoped. Internally profiles are realized as
To facilitate sharing Hosts are owned by <b>Profiles</b>.
In 1.0 these were simply folders in the RemoteSystemsConnections
project. With the introduction of persistence providers in 2.0, profiles
can now be persisted in multiple forms - including the 1.0 scheme.
It is our intention to have RSE allow for the sharing of profiles by exporting to and importing from
the file system or from projects in a future release.
</p>
<p>
Internally profiles are realized as
SystemProfile objects, managed by the SystemProfileManager.
For each profile there is also a SystemHostPool object
created to manage the Hosts within that profile. There are menu actions for the
@ -53,7 +59,11 @@ By default, there exists a profile named <code>Team</code>, and a profile with a
host is created the user is asked to supply this unique name, which defaults to the hostname of their
workstation. Whenever a new host is created, the user is prompted for an active profile to contain the new
host. Both default profiles are active initially, so all Hosts from each are shown. There is a preferences
setting to show the host names qualified by their profile name. After synchronizing the RemoteSystemsConnections
setting to show the host names qualified by their profile name.
</p>
<!-- TODO
<p>
After synchronizing the RemoteSystemsConnections
project with a team repository, using the RSE <A href="plugin/view_Team.gif">team view</A>, all profiles of all members of
the team will exist in the user's workspace, and hence
all the Hosts created by all the team members. However, only the two default profiles are active, so the Hosts
@ -66,13 +76,11 @@ for:
<li>User-roaming, whereby a user uses a different workstation than usual,
and then synchronizes with the team repository and sets their profile to be active.
</ol>
<p>
-->
<!-- TODO rework
As an aside, user IDs and passwords are not shared with the team repository, but rather stored only locally per
workstation.
Each subsystem can have a unique user ID, which if not set is inherited from its host,
which in turn if not set is inherited from the
user ID preferences setting for the appropriate system type.
</p>
-->
<h2><A name="subsystems">Subsystems and subsystem configurations</A></h2>
<p>
@ -98,7 +106,12 @@ remote commands. There is also a Remote Shell view supplied that logs all comman
enter a command to be run remotely. The commands all execute within the same shell, and users
can launch additional shells for the same host.
</ol>
<h2><A name="systems">Systems and System Managers</A></h2>
<p>
Each subsystem can have a unique user ID, which if not set is inherited from its host,
which in turn if not set is inherited from the
user ID preferences setting for the appropriate system type.
</p>
<h2><A name="systems">Connector services and their managers</A></h2>
<p>While not seen by the user, subsystem objects are required to return a <b>connectorservice</b> object via the
<A href="../reference/api/org/eclipse/rse/core/subsystems/ISubSystem.html#getConnectorService()">getConnectorService()</A> method.
A connectorService object is an object implementing the <A href="../reference/api/org/eclipse/rse/core/subsystems/IConnectorService.html">IConnectorService</A> interface.

View file

@ -23,14 +23,20 @@ each created by a subsystem configuration registered with this extension point.
as it has only one element, <b><samp>&lt;configuration&gt;</samp></b>, with only a few simple attributes to supply:
</p>
<ul>
<li><b>id</b>. Unique id for the extension, as required for all extensions. However, in this case it is used to create
folders within the <samp>RemoteSystemsConnections</samp> project, where all Remote System Explorer data is stored.
<li><b>id</b>.
Unique id for the extension, as required for all extensions.
There is also a way to <A href="../../reference/api/org/eclipse/rse/core/model/ISystemRegistry.html#getSubSystemConfiguration(java.lang.String)">query</A> a subsystem configuration
object via its ID.<li><b>vendor</b>. Your company name, shown in properties dialog for subsystems created by this subsystem configuration.
<li><b>icon</b>. The icon displayed in the Remote Systems view for each subsystem created by this subsystem configuration.
<li><b>iconlive</b>. The icon used when the subsystem is physically connected to its remote system.
<li><b>name</b>. The name displayed in the Remote Systems view for each subsystem created by this subsystem configuration.
<li><b>systemTypeIds</b>. A semi-colon separated list of system type IDs which this subsystem configuration supports. When a user creates a
object via its ID.
<li><b>vendor</b>.
Your company name, shown in properties dialog for subsystems created by this subsystem configuration.
<li><b>icon</b>.
The icon displayed in the Remote Systems view for each subsystem created by this subsystem configuration.
<li><b>iconlive</b>.
The icon used when the subsystem is physically connected to its remote system.
<li><b>name</b>.
The name displayed in the Remote Systems view for each subsystem created by this subsystem configuration.
<li><b>systemTypeIds</b>.
A semi-colon separated list of system type IDs which this subsystem configuration supports. When a user creates a
connection, this configuration will only be asked to create a subsystem for connections to systems of these types. Wildcards are
supported; in order to register against all system types, specify a single "*".
<li><b>serviceType</b>. An optional semi-colon separated list of names and transports that can be used to match this service with remotelly advertised services through DNS-SD or any other supported service discovery protocol.

View file

@ -2,60 +2,52 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2007. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page."/>
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Remote System Explorer Profiles</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2007. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." />
<link rel="stylesheet" type="text/css" href="../book.css" />
<title> Remote System Explorer Profiles </title>
</head>
<body id="cprofile-body">
<a name="cprofile"><!-- --></a>
<h1 class="topictitle1">Remote System Explorer Profiles</h1>
<a name="cprofile">
<!-- -->
</a> <h1 class="topictitle1"> Remote System Explorer Profiles </h1>
<div>
<p>When you define your first connection to your remote server, you
will also define
your first profile. All Remote System Explorer resources such as
connections,
filters, and filter pools are owned by a profile. Profiles help you
manage these resources when you have a lot of connections. The Remote
System Explorer creates
a unique profile per team member (that person's <span
style="font-style: italic;">private profile</span>), plus a common
profile called <i>Team</i>.
You can also create your own profiles. </p>
<div class="p">Profiles contain:
<ul>
<li>Connections -- including subsystem properties. User IDs and
passwords are not shared.</li>
<li>Filters, filter pools, and filters pool references</li>
<li>User-defined actions</li>
<li>Compile commands</li>
</ul>
</div>
<p>Profiles can be active, or inactive. By default, only your private
profile
and the Team profile are active. The Remote System Explorer displays
all connections
from all active profiles and, within a connection, allows filter pools
to
be referenced from any active profile. Further, the user actions and
compile
commands shown in the right-click menu for a remote resource are from
all
active profiles.</p>
<p>Your first profile will be for your local workstation. When you
complete
the steps for your first connection, you can decide whether to use your
personal
profile or the Team profile so that you can share resources and
information
with other people.</p>
<div class="p">Placing all connection and filter data in a profile
<p>
When you define your first connection to your remote server, you will also define your first profile. All Remote System Explorer resources such as connections, filters, and filter pools are owned by a profile. Profiles help you manage these resources when you have a lot of connections. The Remote System Explorer creates a unique profile per team member (that person's <em>private profile</em>), plus a common profile called <i> Team</i>. The intent is to be able to share the Team profile in the future with other members of your team. You can also create your own profiles.
</p>
<div class="p">
Profiles contain:
<ul>
<li>
Connections -- including subsystem properties. User IDs and passwords are not shared.
</li>
<li>
Filters, filter pools, and filters pool references
</li>
<li>
User-defined actions
</li>
<li>
Compile commands
</li>
</ul>
</div>
<p>
Profiles can be active, or inactive. By default, only your private profile and the Team profile are active. The Remote System Explorer displays all connections from all active profiles and, within a connection, allows filter pools to be referenced from any active profile. Further, the user actions and compile commands shown in the right-click menu for a remote resource are from all active profiles.
</p>
<p>
Your first profile will be for your local workstation. When you complete the steps for your first connection, you can decide whether to use your personal profile or the Team profile so that in the future you can share resources and information with other people.
</p>
<div class="p">
<!-- TODO rework
Placing all connection and filter data in a profile
shared by the team
assists in team support, since all connections, filter pools, and team
profiles
can be shared among team members. You can use the Team view to control
which
profiles display in your workspace by making the profiles active.
can be shared among team members.
-->
You can use the Team view to control which profiles display in your workspace by making the profiles active.
<!-- TODO rework
<div class="note"><span class="notetitle">Note: </span>Making
a profile active or inactive does not affect your teammates. For
example,
@ -69,7 +61,9 @@ the profiles are stored. See topics in the help contents and
links
below about team support for more information on profiles and shared
data.</div>
</div>
-->
</div>
<!-- TODO rework
<p>To reduce collisions when you synchronize the user IDs and the
ordering of
resources in a profile are stored locally on your workstation. To
@ -84,21 +78,30 @@ will
then be stored on the server, and any developer can obtain profile
resources
from the central server. </p>
-->
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="cfilters.html" title="">Remote System Explorer filters, filter
pools, and filter pool references</a><br/>
<a href="cbegin.html" title="">Remote System Explorer Connections</a><br/>
<p>
<b class="relconceptshd"> Related concepts</b>
<br />
<a href="cfilters.html" title=""> Remote System Explorer filters, filter pools, and filter pool references</a>
<br />
<a href="cbegin.html" title=""> Remote System Explorer Connections</a>
<br />
<!-- TODO rework
<a href="cteam.html" title="">Team support</a><br/>
</p>
<p><b class="reltaskshd">Related tasks</b><br/>
-->
</p>
<p>
<b class="reltaskshd"> Related tasks</b>
<br />
<!-- TODO rework
<a href="../tasks/tteamsup.html" title="">Using team support</a><br/>
<a href="../tasks/tteamsup1.html" title="">Working with profiles and
team support</a><br/>
<a href="../tasks/tbeginsecprofile.html" title="">Creating a second
profile</a><br/>
</p>
<a href="../tasks/tteamsup1.html" title="">Working with profiles and team support</a><br/>
-->
<a href="../tasks/tbeginsecprofile.html" title=""> Creating a second profile</a>
<br />
</p>
</div>
</body>
</html>

View file

@ -25,7 +25,9 @@ reference</a>.</p>
User actions, Compile Commands and
-->
<a href="../ref/rrsepref.html">Preferences</a> and connection setup
<!-- TODO rework
<a href="../concepts/cteam.html">shared in a team</a>.
-->
</p>
</div>
@ -33,7 +35,9 @@ User actions, Compile Commands and
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="../concepts/cfilters.html" title="">Remote System Explorer filters, filter
pools, and filter pool references</a><br/>
<!-- TODO rework
<a href="../concepts/cteam.html" title="">Team support</a><br/>
-->
</p>
<!--
<p><b class="reltaskshd">Related tasks</b><br/>

View file

@ -28,10 +28,12 @@
<topic label="Creating a second profile" href="tasks/tbeginsecprofile.html"/>
<topic label="Deleting a profile" href="tasks/tbegindeleteprofile.html"/>
</topic>
<!-- TODO rework needed
<topic label="Team support" href="concepts/cteam.html">
<topic label="Using team support" href="tasks/tteamsup.html"/>
<topic label="Working with profiles and team support" href="tasks/tteamsup1.html"/>
</topic>
-->
<topic label="Shells and commands in the Remote Systems view" href="concepts/crunremcmds.html">
<topic label="Running and viewing commands using the Remote Shell view" href="tasks/truncmdsview.html"/>
<topic label="Working with command shells" href="tasks/twrkcmdshl.html"/>