platform-ui-home/builds/index.html

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.9 - (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 :     <li><a href="#BUILDS">Build Submissions</a></li>
32 :     <li><a href="#INSTALLING">Installing Release Engineering Tools</a></li>
33 :     <li><a href="#RELENGMAP">Making a Build Submission with Release
34 :     Engineering Tools</a></li>
35 :     <li><a href="#CVSMAP">Making a Build Submission with CVS Only</a></li>
36 :     <li><a href="#RECOVERY">Recovery Builds</a></li>
37 :     </ul>
38 :     </td>
39 :     </tr>
40 :     </table>
41 :     <a name="BUILDS">
42 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
43 :     <tr>
44 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
45 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Build Submissions</font></b>
46 :     </td>
47 :     </tr>
48 :     <tr>
49 :     <td width="98%">
50 :     <p>Build submissions are done before every integration build and
51 :     milestone build. Integration builds typically occur on Tuesday. Please
52 :     see the <a href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-releng-home/index.html">Platform
53 :     Release Engineering</a> page for more information. We do our build
54 :     submission for an 8 a.m. build, at 4 p.m. the previous day.</p>
55 :     <p>If you miss the cut-off for the official build submission, but
56 :     it is still before the build has started, then you can do your own build
57 :     submission to make sure your fix gets into the build.</p>
58 :     <p>A warning email should be sent to "platform-ui-dev@eclipse.org" (or
59 :     all committers) at the beginning of the days on which an official build
60 :     submission is to occur, or if you do your own build submission.</p>
61 :     </tr>
62 :     </table>
63 :     <a name="INSTALLING">
64 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
65 : dpollock 1.1 <tr>
66 : dpollock 1.3 <td align=LEFT valign=TOP bgcolor="#0080C0">
67 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Installing the Release Engineering Tool</font></b>
68 :     </td>
69 :     </tr>
70 :     <tr>
71 :     <td>
72 : dpollock 1.1 <p>The Platform-UI team suggests that the Release Engineering (releng)
73 :     tool be installed before doing a build submission. It reduces the
74 :     chance of error.</p>
75 :     <ol>
76 :     <li>Exit Eclipse (if running)</li>
77 : 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>
78 : dpollock 1.1 <li>Unzip the tool into your <code>plugins</code> directory.</li>
79 :     <li>Start Eclipse</li>
80 :     </ol>
81 : dpollock 1.3 </td>
82 :     </tr>
83 :     </table>
84 :     <a name="RELENGMAP">
85 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
86 :     <tr>
87 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
88 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Making a Build Submission with the Release Engineering Tool</font></b>
89 :     </td>
90 :     </tr>
91 :     <tr>
92 :     <td>
93 : dpollock 1.9 <ol>
94 :     <li>Make sure that you workspace contains all of the plug-ins
95 :     contained in our modules. This includes <code>plat-ui</code>,
96 :     <code>plat-ui-examples</code> and <code>plat-ui-tests</code>. Make
97 :     sure to include fragments that are not appropriate for your
98 :     platform, as they may need to be versioned as well.</li>
99 :     <li>Get rid of all outgoing changes in your workspace.</li>
100 :     <li>Run all the test suites. The definitive list of test suites is
101 :     given by inspecting the <code>test.xml</code> files in all our test
102 :     plug-ins. At the time of writing, they are roughly: databinding
103 :     tests, navigator tests, parts references tests, session tests,
104 :     rcp tests, JFace tests, and the rather large UiTestSuite. <em>Be
105 :     careful not to disturb focus while the test are running. If you're
106 :     leaving the machine running, you may wish to increase the time it
107 :     takes for the screensaver to kick in.</em></li>
108 :     <li>Run the <a href="cvs-comment.sh">build notes script</a>. On
109 :     Windows XP, I would recommend installing <a
110 :     href="http://www.cygwin.com">cygwin</a>. Check to make sure the
111 :     list of bugs fixed makes sense.</li>
112 :     <li>Update the <code>buildnotes_workbench.html</code> file with the
113 :     results of the build scripts. Commit to CVS.</li>
114 :     <li>Select a project in the Package Explorer, right-click and select
115 :     "Team > Release".</li>
116 :     <li>Use the default map project, and then select all the projects in
117 :     the "ui.map" file.</li>
118 :     <li>If the release is small, it is a good idea to check the list of
119 :     changes.</li>
120 :     <li>Supply the name of the release. Our convention is to use
121 :     TYYYYMMDD-HHHH, where T is the type (e.g., I for an integration
122 :     build), YYYY is the year, MM is the month, DD is the day and HHHH is
123 :     the hour the build is scheduled to start. If the name is already in
124 :     use, then use a letter suffix (i.e., a, b, c, etc.).</li>
125 :     <li>As the commit comment, enter the information from the build
126 :     notes script.</li>
127 :     <li>Send an email to <a
128 :     href="mailto:platform-ui-dev@eclipse.org">platform-ui-dev</a> with
129 :     the information from the build notes script.</li>
130 : dpollock 1.1 </ol>
131 : dpollock 1.3 </td>
132 :     </tr>
133 :     </table>
134 :     <a name="CVSMAP">
135 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
136 :     <tr>
137 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
138 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Making a Build Submission with CVS Only</font></b>
139 :     </td>
140 :     </tr>
141 :     <tr>
142 :     <td>
143 : dpollock 1.9 <p>To do a build submission using CVS, use the above steps above, but do
144 :     the following instead of using the releng tool:</p>
145 : dpollock 1.1 <ol>
146 :     <li>Tag all projects you have changed with the name of the release. Our
147 : dpollock 1.9 convention is to use TYYYYMMDD-HHHH, where T is the type (e.g., I for an
148 :     integration build), YYYY is the year, MM is the month, DD is the day and
149 :     HHHH is the hour the build is scheduled to start. If the name is already
150 :     in use, then use a letter suffix (i.e., a, b, c, etc.).</li>
151 : dpollock 1.1 <li>Checkout "org.eclipse.releng".</li>
152 :     <li>Open "<code>maps/ui.map</code>".</li>
153 :     <li>Change the version(s) of the project(s) you have tagged.</li>
154 :     <li>Save the map.</li>
155 :     <li>Commit your changes to the map to CVS.</li>
156 :     </ol>
157 : dpollock 1.3 <p>
158 :     </td>
159 :     </tr>
160 :     </table>
161 :     <a name="RECOVERY">
162 :     <table border=0 cellspacing=5 cellpadding=2 width="100%">
163 :     <tr>
164 :     <td align=LEFT valign=TOP bgcolor="#0080C0">
165 :     <b><font color="#FFFFFF" face="Arial,Helvetica">Recovery Builds</font></b>
166 : dpollock 1.1 </td>
167 : dpollock 1.3 </tr>
168 :     <td>
169 :     <p>In the event of a test failure, our team must respond to
170 : dpollock 1.9 <a href="mailto:platform-releng-dev@eclipse.org">platform-releng-dev</a>
171 :     with one of two responses. We can say that we want a recovery build the
172 :     following day. Alternatively, we can say that the test failure is not
173 :     significant, and that the quality of the build should not be affected.
174 :     (In either case, a bug should likely be entered into the bug
175 :     database.)</p>
176 : dpollock 1.3 <p>A recovery build can also be requested if there is a problem affecting
177 :     the usability of the build. This problem should make the build unusable
178 :     for testing and development use.</p>
179 :     <p>For a recovery build, the map will need to be updated to include our
180 :     fixes. This can either be everything on the head in CVS, or just the
181 :     particular fixes we need. The former should only be done if no risky
182 :     changes have gone onto the head since the last (i.e., the failed) build
183 :     submission.</p>
184 :     </td>
185 :     <tr>
186 : dpollock 1.1 </tr>
187 :     </table>
188 :     </body>
189 :     </html>