Getting Started with Saros

Here you will find a guideline on how to set up Saros.

After that you might want to find out what Saros can do: Here is the complete feature list.

First steps
Exploring Saros

The Host

Before we get started you shoud know that Saros is a host-based system.

To get familiar with this concept check out our comic:

First steps

Step 1: Connecting

You need an XMPP account to use Saros.

You can create a new account within Saros by using the FU-Berlin servers.
You can use an existing account.
For example your Google, GMX or web.de mail address. They are valid XMPP accounts.

To do that simply start the Saros Configuration wizard (Menu > Saros > Start Saros Configuration)

Connecting to Server

Step 2: Adding buddies

To add a buddy to your list you need to know his/her XMPP ID.

After entering your partners XMPP ID, a message will be sent to your contact.
Once s/he accepts your request you will be able to see his/her online status in your buddy list.

Step 3: Starting and joining sessions

You can work together with your buddies by either starting your own session or by being invited to one.

When starting a session, Saros will copy the project to the computer of your invited buddies.

a) Start a session (host)

Right-click on...
1. a project in your Package Explorer and select Share With
  or
2. a buddy in the Saros View and select Work Together on
Wait for your buddies to accept the session invitation

Want to know more about the Saros host role? Check out our comic here.

b) Join a session (client)

Wait for a session invitation to appear on your screen
Click Accept to accept the invitation
Tell Saros where to save the new project:
1. You can create a new project, or
2. synchronise with an already existing copy on your computer.
Select Finish and wait for the project to be copied to your computer

Additional information:

If you accept an invitation and decide to synchronise the incoming project with your own copy, Saros will automatically add, change, or delete all files as necessary. You will have the chance to review changes before accepting.
Saros will share all files which are not marked as derived by Eclipse, because it should be possible to recreate such files (.class files for instance) at the client's side. If you use a build tool such as Ant, it might be necessary to manually set the resulting files or folders to derived on both the host (so they won't be copied to the client) and the client (otherwise the files will be deleted on synchronisation).

Exploring Saros

Step 4: Exploring the Saros View

The Saros View consists of three parts

the buddy list
the session list
the chat area

The buddy list is where all your contacts are, allowing you to check their availability, send them instant messages, and invite them to Saros sessions.

When you are in a Saros session you will see all participants in the session list. Saros also provides instant chat messaging to accompany your sessions.
Whenever you begin a Saros session, a chat session is also automatically started.

Step 5: Exploring the Saros Toolbar

General

Connecting:

Click here to connect or disconnect from the server, or to switch between user accounts if you have more than one. When you connect, you will see information about your buddies (including whether they are connected and also whether they support Saros).

Add Buddy:

To add a new buddy click here (you will need the full XMPP address of your buddy in the format: username@server).

Open Saros preferences:

Opens the Saros section of the Eclipse preferences. This is a shortcut for Eclipse > Preferences > Saros.

Stop Session process:

Stops the Saros repair process.

Inconsistency repair:

Sometimes accidents can happen and your copy of the project can become out of sync with the host's copy. When it does, this button will light up. When you click it, the inconsistencies will be repaired.

Switch Follow Mode on/off:

You can turn the Follow Mode on and of. In Follow Mode Saros will automatically sync your Eclipse view with the user you are following, opening shared files the the other users is opening, and autoamtically scrolling the visible part of the editor of open files, so you always see what the followed user sees.

Leave the session:

Click here to leave the current session. If you are the host, the session will be closed and all participants will be ejected from the session.

Context Menu

Grant Write Access:

Gives the selected participant write access.

Restrict to Read-Only Access:

Removes the write access right from the selected participant. The affected participant will only have read access afterwards.

Follow Participant:

Follows the selected participant as described in section Follow Mode.

Jump to Position:

Jumps to the cursor position of the selected participant and open the corresponding file if necessary.

Send File:

Gives you the opportunity to select a file to be sent to the selected participant.

Share Your Screen:

Lets you share your screen with the selected participant. Please make sure you properly configured the encoder if one of the participants is not using Microsoft Windows.

Start VoIP Session:

Starts a VoIP session with the selected participant.

Leave Access / Stop Session:

If you have been invited to a session this button makes you leave the session without affecting other participants. If you are the host of the session you cannot leave but only stop the session.

Good to know

User Roles

By default all participants of a session have a writing access. To restrict or grant this access to other participants, right-click on that user in the session list and select Restrict to read-only access or Grant writing access. This can only be done by the host.

Follow Mode

You can use this feature to follow a single participant as s/he navigates the project and performs changes. When you follow a participant:

Whenever s/he opens a file on his/her computer, it is opened on yours too.
Any time s/he switches to view a different file, it is switched on yours.
As s/he scrolls through a file, the viewpoint is moved on your computer also, so that you see what s/he sees.

Staying Aware of your Fellow Participants

There are multiple ways of staying aware of what a driver is currently doing:

In the package explorer (or resource navigator):
- A yellow dot decorates all files that a participant has currently open.
- A green dot decorates the file that a participant has currently in focus.
- A blue arrow decorates a file that is shared with other participants.
Cursors:
The position of a participant's cursor appears in the file in his/her color.
Selections:
Any text selected by a particpant also appears highlighted in the file.
Changes:
If a participant writes something, his/her text will appear highlighted in his/her color.
Locate participants:
On the right side of editors you can see colored bars representing the viewports of each user. These show which part of the file each user can see.
Follow participants:
Follow mode allows you to follow all movements of another user as s/he moves within and between files. In the Session list, right click on the user you wish to follow and select Follow Participant.

Search form

You are here