platform-update-home/doc/working/scheduler/scheduler.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.2 - (view) (download) (as text)

1 : dejan 1.1 <title>Eclipse Update Scheduler</title>
2 :     <link rel="stylesheet" href="http://dev.eclipse.org/default_style.css" type="text/css">
3 :     <h1>Eclipse Update Scheduler</h1>
4 :     <p>This document describes the new Eclipse 3.0 capability to automatically
5 :     detect and install feature updates. The capability is part of the plan item
6 :     <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=37684">Improve Update
7 :     Manager search</a>.</p>
8 :     <h2>Proposed Behavior</h2>
9 :     <p>Eclipse Update will be able to search for updates to the installed features
10 : dejan 1.2 on a periodic basis without user assistance. The way this search is performed
11 : dejan 1.1 will be configurable by the user via the preference page. Users will be able to
12 :     configure scheduling and downloading options.</p>
13 :     <h3>Scheduling options</h3>
14 :     <p>Each time an Eclipse-based product starts, update scheduler plug-in will
15 :     activate based on the chosen scheduling. Users will be able to choose between:</p>
16 :     <ul>
17 :     <li>No automatic search</li>
18 :     <li>On each startup (default)</li>
19 :     <li>Every day at a specific time (i.e. 3:00PM) *</li>
20 :     <li>On a scheduled day of the week at a specific time (i.e. Monday 8:00AM) *</li>
21 :     </ul>
22 :     <p>* assuming the application is active. If the application is not active at a
23 :     scheduled time and the search is past due, it will immediately start on the next
24 :     startup</p>
25 :     <h3>Downloading options</h3>
26 :     <p>Scheduling options define occurrence of the automated search but do not
27 :     define what is actually happening when the search is due. Downloading options
28 :     control this behavior (this set of options is disabled if automatic search is
29 :     turned off). Users can choose between:</p>
30 :     <ul>
31 :     <li>Search for updates and notify me when they are available (default)</li>
32 :     <li>Download new updates automatically and notify me when ready to install
33 :     them</li>
34 :     </ul>
35 :     <p>In both cases, Update scheduler will create and initiate a search job (using
36 :     the
37 :     <a href="http://dev.eclipse.org/viewcvs/index.cgi/~checkout~/platform-core-home/plan_concurrency_intro.html">
38 :     new scheduling API from Platform Core</a>) that will execute in the background
39 :     when it is due based on the scheduling options. There will be no messages if no
40 :     updates were found. If there are updates, the behavior will depend on the
41 :     selected downloading option.</p>
42 :     <h4>Search and notify</h4>
43 :     <p>If search only is selected, a message box will open, notifying user that new
44 :     updates have been found:</p>
45 :     <p><font color="#0000FF">New updates have been found for this product. Do you want to
46 :     download them?</font></p>
47 :     <p><font color="#0000FF">[Yes] [No] [Later]</font></p>
48 :     <p>If 'Yes' is pressed, a Update wizard will open, listing detected updates. The
49 :     same wizard is used when search for updates has been manually initiated using
50 :     Help&gt;Software Updates&gt;New Updates. </p>
51 :     <p>If 'No' is pressed, dialog will close. If 'Later' is pressed, another dialog
52 :     will pop up allowing you to define when exactly to remind you: in 5 minutes, in
53 :     an hour, tomorrow etc. If you select something and press [OK], that will close
54 :     both the 'Later' dialog and the original message box. If 'Cancel' is pressed,
55 :     the 'Later' dialog will close while the message box will stay opened.</p>
56 : dejan 1.2 <h4>Download new updates</h4>
57 : dejan 1.1 <p>If the second option has been selected (download updates automatically), the
58 :     search job will be scheduled as before, but when new updates are found, the
59 :     download will commence immediately. When all the features have been successfully
60 :     downloaded into the temp. space, a different message box will show up:</p>
61 :     <p><font color="#0000FF">New updates have been found and downloaded. Do you want to install them?</font></p>
62 :     <p><font color="#0000FF">[Yes] [No] [Later]</font></p>
63 :     <p>If 'No' is pressed, dialog will close and all the data in the temporary space
64 :     will be deleted. If 'Yes' is pressed, installation will commence (only a
65 :     progress monitor will be shown - no wizards). 'Later' acts as described above.</p>
66 :     <p>When 'Later' option is chosen (in both cases) and the chosen interval
67 :     expires, a dialog will pop up to remind you about the pending updates. The
68 :     message will be the same for both options:</p>
69 :     <p><font color="#0000FF">There are pending updates waiting to be installed. Do you want to install
70 :     them now?</font></p>
71 :     <p><font color="#0000FF">[Yes] [No] [Later]</font></p>
72 :     <p>Install can be accepted (Yes), definitely declined (No) or postponed again
73 :     (Later).</p>