platform-ui-home/builds/index.html

Parent Directory Parent Directory | Revision Log Revision Log

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

1 : dpollock 1.1 <html>
2 :     <head>
3 :     <title>Builds (Platform-UI)</title>
4 :     <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
5 :     <link rel="stylesheet" href="http://dev.eclipse.org/default_style.css" type="text/css">
6 :     </head>
7 :    
8 :     <body bgcolor="#FFFFFF" text="#000000">
9 :    
10 : dpollock 1.3 <table border=0 cellspacing=5 cellpadding=2 width="100%">
11 :     <tr>
12 :     <td align=left width="72%">
13 :     <font class=indextop>Builds</font><br>
14 :     <font class=indexsub>platform user interface</font>
15 :     </td>
16 :     <td width="28%">
17 :     <img src="http://dev.eclipse.org/images/Idea.jpg" height=86 width=120 alt="Eclipse documentation banner">
18 :     </td>
19 :     </tr>
20 :     </table>
21 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
22 : dpollock 1.1 <tr>
23 : dpollock 1.3 <td align=LEFT valign=TOP bgcolor="#0080C0">
24 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Topics</font></b>
25 :     </td>
26 : dpollock 1.1 </tr>
27 : dpollock 1.3 <tr>
28 :     <td width="98%">
29 :     <b>Topics</b>
30 :     <ul>
31 : dpollock 1.8 <li><a href="#FIXES">Upcoming Fixes</a></li>
32 : dpollock 1.3 <li><a href="#BUILDS">Build Submissions</a></li>
33 :     <li><a href="#INSTALLING">Installing Release Engineering Tools</a></li>
34 :     <li><a href="#RELENGMAP">Making a Build Submission with Release
35 :     Engineering Tools</a></li>
36 :     <li><a href="#CVSMAP">Making a Build Submission with CVS Only</a></li>
37 :     <li><a href="#RECOVERY">Recovery Builds</a></li>
38 :     </ul>
39 :     </td>
40 :     </tr>
41 :     </table>
42 : dpollock 1.8 <a name="FIXES">
43 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
44 :     <tr>
45 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
46 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Upcoming Fixes</font></b>
47 :     </td>
48 :     </tr>
49 :     <tr>
50 :     <td width="98%">
51 :     <p>If you're lucky, then there is a <a href="fixedBugs.html">list of
52 :     fixes</a> that are expected to appear in the next integration
53 :     build.</p>
54 :     </td>
55 :     </tr>
56 :     </table>
57 : dpollock 1.3 <a name="BUILDS">
58 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
59 :     <tr>
60 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
61 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Build Submissions</font></b>
62 :     </td>
63 :     </tr>
64 :     <tr>
65 :     <td width="98%">
66 :     <p>Build submissions are done before every integration build and
67 :     milestone build. Integration builds typically occur on Tuesday. Please
68 :     see the <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-releng-home/index.html">Platform
69 :     Release Engineering</a> page for more information. We do our build
70 :     submission for an 8 a.m. build, at 4 p.m. the previous day.</p>
71 :     <p>If you miss the cut-off for the official build submission, but
72 :     it is still before the build has started, then you can do your own build
73 :     submission to make sure your fix gets into the build.</p>
74 :     <p>A warning email should be sent to "platform-ui-dev@eclipse.org" (or
75 :     all committers) at the beginning of the days on which an official build
76 :     submission is to occur, or if you do your own build submission.</p>
77 :     </tr>
78 :     </table>
79 :     <a name="INSTALLING">
80 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
81 : dpollock 1.1 <tr>
82 : dpollock 1.3 <td align=LEFT valign=TOP bgcolor="#0080C0">
83 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Installing the Release Engineering Tool</font></b>
84 :     </td>
85 :     </tr>
86 :     <tr>
87 :     <td>
88 : dpollock 1.1 <p>The Platform-UI team suggests that the Release Engineering (releng)
89 :     tool be installed before doing a build submission. It reduces the
90 :     chance of error.</p>
91 :     <ol>
92 :     <li>Exit Eclipse (if running)</li>
93 : dpollock 1.7 <li>Download the <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-releng-home/org.eclipse.releng.tools_3.0.4.zip">releng tool</a>.</li>
94 : dpollock 1.1 <li>Unzip the tool into your <code>plugins</code> directory.</li>
95 :     <li>Start Eclipse</li>
96 :     </ol>
97 : dpollock 1.3 </td>
98 :     </tr>
99 :     </table>
100 :     <a name="RELENGMAP">
101 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
102 :     <tr>
103 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
104 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Making a Build Submission with the Release Engineering Tool</font></b>
105 :     </td>
106 :     </tr>
107 :     <tr>
108 :     <td>
109 : dpollock 1.1 <p>Before performing an build submission, it is the responsibility of
110 :     the submitter to verify that the UI tests all pass. To perform a
111 :     submission using the releng tool, please do as follows:</p>
112 :     <ol>
113 :     <li>Select the project you need to version, and select "Team >
114 :     Release".</li>
115 : dpollock 1.8 <li>Supply the name of the release. Our convention is to use
116 :     vYYYYMMDDHHHH, where this the date and the time of the build. If the
117 :     name is already in use, then use a letter suffix (i.e., a, b, c,
118 :     etc.).</li>
119 : dpollock 1.1 <li>The synchronize view will open showing the changes in the file
120 :     "<code>ui.map</code>".</li>
121 :     <li>Continue to version all of the packages that you need.</li>
122 :     <li>When you are done, commit the changes to "<code>ui.map</code>".
123 :     </ol>
124 : dpollock 1.3 </td>
125 :     </tr>
126 :     </table>
127 :     <a name="CVSMAP">
128 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
129 :     <tr>
130 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
131 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Making a Build Submission with CVS Only</font></b>
132 :     </td>
133 :     </tr>
134 :     <tr>
135 :     <td>
136 :     <p>To do a build submission using CVS, please do as follows:</p>
137 : dpollock 1.1 <ol>
138 :     <li>Tag all projects you have changed with the name of the release. Our
139 : dpollock 1.8 convention is to use vYYYYMMDDHHHH, where this the date and time of the
140 :     build. If the name is already in use, then use a letter suffix (i.e.,
141 :     a, b, c, etc.).</li>
142 : dpollock 1.1 <li>Checkout "org.eclipse.releng".</li>
143 :     <li>Open "<code>maps/ui.map</code>".</li>
144 :     <li>Change the version(s) of the project(s) you have tagged.</li>
145 :     <li>Save the map.</li>
146 :     <li>Commit your changes to the map to CVS.</li>
147 :     </ol>
148 : dpollock 1.3 <p>
149 :     </td>
150 :     </tr>
151 :     </table>
152 :     <a name="RECOVERY">
153 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
154 :     <tr>
155 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
156 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Recovery Builds</font></b>
157 : dpollock 1.1 </td>
158 : dpollock 1.3 </tr>
159 :     <td>
160 :     <p>In the event of a test failure, our team must respond to
161 :     <a href="mailto:eclipse-dev@eclipse.org">eclipse-dev</a> with one of two
162 :     responses. We can say that we want a recovery build the following day.
163 :     Alternatively, we can say that the test failure is not significant, and
164 :     that the quality of the build should not be affected. (In either case, a
165 :     bug should likely be entered into the bug database.)</p>
166 :     <p>A recovery build can also be requested if there is a problem affecting
167 :     the usability of the build. This problem should make the build unusable
168 :     for testing and development use.</p>
169 :     <p>For a recovery build, the map will need to be updated to include our
170 :     fixes. This can either be everything on the head in CVS, or just the
171 :     particular fixes we need. The former should only be done if no risky
172 :     changes have gone onto the head since the last (i.e., the failed) build
173 :     submission.</p>
174 :     </td>
175 :     <tr>
176 : dpollock 1.1 </tr>
177 :     </table>
178 :     </body>
179 :     </html>