Gitiles
Code Review Sign In
asterix-gerrit.ics.uci.edu / incubator-asterixdb-site / e2b799e7f3e90723f409633464b4bd8f25e72573 / . / content / dev-setup.html
blob: 00a4e16feabd526422e727d0db4aa8557ddfa125 [file] [log] [blame]
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]1<!DOCTYPE html>
2<html lang="en">
3 <head>
4 <meta charset="utf-8">
5 <meta http-equiv="X-UA-Compatible" content="IE=edge">
6 <meta name="viewport" content="width=device-width, initial-scale=1">
7 <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
8 <meta name="description" content="">
9 <meta name="author" content="">
10 <link rel="icon" href="https://asterixdb.incubator.apache.org/favicon.ico">
11
12 <title>Contributing to AsterixDB</title>
13
14 <!-- Bootstrap core CSS -->
15 <link href="https://asterixdb.incubator.apache.org/css/bootstrap.min.css" rel="stylesheet">
16 <!-- Bootstrap theme -->
17
18 <!-- Custom styles for this template -->
19 <link href="https://asterixdb.incubator.apache.org/css/theme.css" rel="stylesheet">
20
21 <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
22 <!--[if lt IE 9]>
23 <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
24 <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
25 <![endif]-->
26 <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css">
27 </head>
28
29 <div class="container theme-showcase" role="main">
30 <div class="masthead">
31 <p class="lead">
32 <a href="https://asterixdb.incubator.apache.org/index.html"><img src="https://asterixdb.incubator.apache.org/img/asterixdb.png" style="height:75px; width:auto; vertical-align:bottom; margin-top:10px;"/></a>
33 </p>
34</div>
35
36<nav class="navbar navbar-default">
37 <div class="container">
38 <div class="navbar-header">
39 <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target=".navbar-collapse">
40 <span class="sr-only">Toggle navigation</span>
41 <span class="icon-bar"></span>
42 <span class="icon-bar"></span>
43 <span class="icon-bar"></span>
44 </button>
45 <a class="navbar-brand" href="https://asterixdb.incubator.apache.org/index.html">Overview</a>
46 </div>
47 <div class="navbar-collapse collapse">
48 <ul class="nav navbar-nav">
49 <li><a href="https://asterixdb.incubator.apache.org/download.html">Download</a></li>
Ian Maxona9643c82015-09-01 11:15:57 -1000[diff] [blame]50 <li class="dropdown">
51 <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Documentation<span class="caret"></span></a>
52 <ul class="dropdown-menu" role="menu">
53 <li class="dropdown-header">Stable release</li>
Ian Maxone2b799e2015-11-24 18:20:03 -0800[diff] [blame^]54 <li><a href="docs/0.8.7-incubating/index.html">Documentation for 0.8.7-incubating<i class="fa fa-external-link fa-sm"></i></a></li>
Ian Maxona9643c82015-09-01 11:15:57 -1000[diff] [blame]55 <li class="divider"></li>
56 <li class="dropdown-header">Snapshot release</li>
Ian Maxone2b799e2015-11-24 18:20:03 -0800[diff] [blame^]57 <li><a href="https://ci.apache.org/projects/asterixdb/index.html">Documentation for 0.8.8-SNAPSHOT <i class="fa fa-external-link fa-sm"></i></a></li>
Ian Maxona9643c82015-09-01 11:15:57 -1000[diff] [blame]58 </ul>
59 </li>
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]60 <li><a href="https://asterixdb.incubator.apache.org/about.html">About</a></li>
61 <li><a href="https://asterixdb.incubator.apache.org/community.html">Community</a></li>
62 <li class="dropdown">
63 <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">Contributing <span class="caret"></span></a>
64 <ul class="dropdown-menu" role="menu">
65 <li class="dropdown-header">For New Contributors</li>
66 <li><a href="https://asterixdb.incubator.apache.org/dev-setup.html">Development Setup</a></li>
67 <li class="divider"></li>
68 <li class="dropdown-header">For Committers</li>
69 <li><a href="https://asterixdb.incubator.apache.org/pushing.html">Pushing changes</a></li>
70 </ul>
71 </li>
72 </ul>
73 </div><!--/.nav-collapse -->
74 </div>
75 </nav>
76
77
78 <div class="row">
79<div class="col-md-8 col-centered">
80<h2>Contributing to AsterixDB</h2>
81<hr />
82
83<ul id="markdown-toc">
84 <li><a href="#introduction" id="markdown-toc-introduction">Introduction</a></li>
Ian Maxonacb58492015-10-16 19:12:28 -0700[diff] [blame]85 <li><a href="#master-snapshots" id="markdown-toc-master-snapshots">Master snapshots</a> <ul>
86 <li><a href="#managix-installer" id="markdown-toc-managix-installer">Managix Installer</a></li>
87 <li><a href="#yarn-installer" id="markdown-toc-yarn-installer">YARN Installer</a></li>
88 </ul>
89 </li>
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]90 <li><a href="#setting-up-an-asterix-development-environment-in-eclipse" id="markdown-toc-setting-up-an-asterix-development-environment-in-eclipse">Setting up an Asterix Development environment in Eclipse</a> <ul>
91 <li><a href="#prerequisites" id="markdown-toc-prerequisites">Prerequisites</a></li>
92 <li><a href="#steps" id="markdown-toc-steps">Steps</a></li>
93 </ul>
94 </li>
95 <li><a href="#signing-up-for-gerrit" id="markdown-toc-signing-up-for-gerrit">Signing Up for Gerrit</a></li>
96 <li><a href="#configuring-your-local-working-environment-for-gerrit" id="markdown-toc-configuring-your-local-working-environment-for-gerrit">Configuring your local working environment for Gerrit</a> <ul>
97 <li><a href="#one-time-tasks" id="markdown-toc-one-time-tasks">One-time tasks</a></li>
98 <li><a href="#once-per-repository-tasks" id="markdown-toc-once-per-repository-tasks">Once-per-repository tasks</a></li>
99 </ul>
100 </li>
101 <li><a href="#making-changes---working-method" id="markdown-toc-making-changes---working-method">Making Changes - working method</a></li>
102 <li><a href="#making-more-changes" id="markdown-toc-making-more-changes">Making More Changes</a></li>
103 <li><a href="#using-jenkins-with-gerrit" id="markdown-toc-using-jenkins-with-gerrit">Using Jenkins with Gerrit</a> <ul>
104 <li><a href="#verification" id="markdown-toc-verification">Verification</a></li>
105 <li><a href="#retrigggering-builds-and-triggering-builds-manually" id="markdown-toc-retrigggering-builds-and-triggering-builds-manually">Retrigggering builds and triggering builds manually</a></li>
106 <li><a href="#cross-project-dependencies" id="markdown-toc-cross-project-dependencies">Cross-project Dependencies</a></li>
107 </ul>
108 </li>
109</ul>
110
111<hr />
112
113<h2 id="introduction">Introduction</h2>
114<p>We warmly welcome any contributions to the AsterixDB or related (Hyracks, Pregelix) projects. A great way to start contributing is to pick a bug labelled starter in JIRA and submit a patch for it, to get acquainted with our codebase and development process.</p>
115
116<hr />
117
Ian Maxonacb58492015-10-16 19:12:28 -0700[diff] [blame]118<h2 id="master-snapshots">Master snapshots</h2>
119<p>If you are a developer simply looking for a snapshot of the latest development version of AsterixDB to test out your application that is based on top of AsterixDB, snapshots from the latest successful push to our master branch are available below. These are non ASF-release, automatic builds.</p>
120
121<h3 id="managix-installer">Managix Installer</h3>
Ian Maxon1bd67772015-11-12 16:14:20 -0800[diff] [blame]122<p><a class="btn btn-md btn-warning" href="https://asterix-jenkins.ics.uci.edu/job/asterix-test-full/lastStableBuild/org.apache.asterix$asterix-installer/artifact/org.apache.asterix/asterix-installer/0.8.8-SNAPSHOT/asterix-installer-0.8.8-SNAPSHOT-binary-assembly.zip" role="button">Download AsterixDB 0.8.8-SNAPSHOT <i class="fa fa-download fa-lg"></i> </a></p>
Ian Maxonacb58492015-10-16 19:12:28 -0700[diff] [blame]123
124<h3 id="yarn-installer">YARN Installer</h3>
Ian Maxon1bd67772015-11-12 16:14:20 -0800[diff] [blame]125<p><a class="btn btn-md btn-warning" href="https://asterix-jenkins.ics.uci.edu/job/asterix-test-full/lastStableBuild/org.apache.asterix$asterix-yarn/artifact/org.apache.asterix/asterix-yarn/0.8.8-SNAPSHOT/asterix-yarn-0.8.8-SNAPSHOT-binary-assembly.zip" role="button">Download AsterixDB 0.8.8-SNAPSHOT <i class="fa fa-download fa-lg"></i> </a></p>
Ian Maxonacb58492015-10-16 19:12:28 -0700[diff] [blame]126
127<hr />
128
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]129<h2 id="setting-up-an-asterix-development-environment-in-eclipse">Setting up an Asterix Development environment in Eclipse</h2>
130
131<h3 id="prerequisites">Prerequisites</h3>
132<ul>
133 <li>A suitable *nix environment (Linux, OSX)</li>
Ian Maxon1bd67772015-11-12 16:14:20 -0800[diff] [blame]134 <li>JDK 1.8+</li>
135 <li>Maven 3.1.1 or greater</li>
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]136 <li>A relatively recent version of Eclipse</li>
137</ul>
138
139<h3 id="steps">Steps</h3>
140
141<ol>
142 <li>
143 <p>Check out Hyracks and Asterix master in two folders via git in the command line. Assume that the path is <code>$HOME/workspace</code>.</p>
144
Ian Maxon4baed872015-10-06 19:01:17 -0700[diff] [blame]145 <pre><code> git clone https://github.com/apache/incubator-asterixdb/
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]146 git clone https://github.com/apache/incubator-asterixdb-hyracks/
147</code></pre>
148
149 <p>You will now have <code>$HOME/workspace/incubator-asterixdb/</code> and <code>$HOME/workspace/incubator-asterixdb-hyracks/</code>.</p>
150 </li>
151 <li>
152 <p>Go to the hyracks and install it’s artifacts to the local Maven repository by executing the following commands:</p>
153
Ian Maxon4baed872015-10-06 19:01:17 -0700[diff] [blame]154 <pre><code> cd incubator-asterixdb-hyracks/
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]155 mvn install -DskipTests
156</code></pre>
157 </li>
158 <li>
159 <p>Go to the asterixdb folder and perform the same action:</p>
160
Ian Maxon4baed872015-10-06 19:01:17 -0700[diff] [blame]161 <pre><code> cd ../incubator-asterixdb/asterix-maven-plugins/
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]162 mvn install -DskipTests
Ian Maxon4baed872015-10-06 19:01:17 -0700[diff] [blame]163 cd ../
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]164 mvn install -DskipTests
165</code></pre>
166 </li>
167 <li>In Eclipse, import hyracks as an existing Maven Project.
168 <ul>
169 <li><code>File -&gt; Import -&gt; Maven -&gt; Existing Maven Projects -&gt; Next</code></li>
Ian Maxon4baed872015-10-06 19:01:17 -0700[diff] [blame]170 <li>Specify the Root directory as <code>incubator-asterixdb-hyracks</code> and then click Next until Finish is enabled.</li>
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]171 <li>If Eclipse tries to install the <code>m2e</code> (Maven To Eclipse) connector, let it do so.</li>
172 <li>There might be some plugin errors; however, that is not a big deal. Wait until the job finishes.</li>
173 <li>Then, click Finish.</li>
174 </ul>
175 </li>
176 <li>Then import asterixdb as an existing Maven Project.
177 <ul>
178 <li><code>File -&gt; Import -&gt; Maven -&gt; Existing Maven Projects -&gt; Next</code></li>
179 <li>Specify root directory as <code>$HOME/workspace/asterixdb</code> and then click Next until Finish is enabled.</li>
180 <li>Eclipse may try installing <code>m2e</code> or other plugins again; let it do so.</li>
181 <li>Then, click Finish.</li>
182 </ul>
183 </li>
184 <li>Fix Eclipse’s build path to include compile-time generated sources.
185 <ul>
186 <li>Right click the project where a red X mark is shown(e.g. <code>asterix-algebra</code>. Then resolve by applying the following:
187 <ul>
188 <li>Right click asterix-algebra. Click Build Path and Configure Build Path. Click Add Folder.</li>
189 <li>Under the <code>target -&gt; generated sources</code>, check the parent folder of the <code>edu</code> folder and click OK.</li>
Ian Maxon4baed872015-10-06 19:01:17 -0700[diff] [blame]190 <li>For example, if the directory structure is “target - generated-sources - javacc - org - apache …”, check the javacc directory and click OK. Then X mark will dissapear.</li>
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]191 </ul>
192 </li>
193 <li>Repeat this step to all projects which show a red X mark except “asterix-fuzzyjoin” and “asterix-transactions”.</li>
194 <li>It may be the case that only “asterix-algebra” and “asterix-runtime” will require these steps.</li>
195 </ul>
196 </li>
197 <li>Set up Eclipse code formatting rules
198 <ul>
199 <li>Download files <a href="http://wiki.asterixdb.googlecode.com/git/AsterixCodeFormatProfile.xml">AsterixCodeFormatProfile.xml</a> <a href="http://wiki.asterixdb.googlecode.com/git/AsterixCleanupFormatProfile.xml">AsterixCleanupFormatProfile.xml</a></li>
200 <li>Import profiles into Eclipse
201 <ul>
202 <li>Preferences -&gt; Java -&gt; Code style -&gt; Formatter -&gt; Import -&gt; Select AsterixCodeFormatProfile.xml</li>
203 <li>Preferences -&gt; Java -&gt; Code style -&gt; Clean up -&gt; Import -&gt; Select AsterixCleanupFormatProfile.xml</li>
204 <li>Preferences -&gt; Java -&gt; Editor -&gt; Save actions -&gt; Perform the selected action on save -&gt; Format source code</li>
205 </ul>
206 </li>
207 </ul>
208 </li>
209</ol>
210
211<hr />
212
213<h2 id="signing-up-for-gerrit">Signing Up for Gerrit</h2>
214
Ian Maxon4baed872015-10-06 19:01:17 -0700[diff] [blame]215<p>First, to contribute patches to AsterixDB, you should have an ICLA on file with the Apache Software Foundation.
216For details see the ASF website <a href="https://www.apache.org/dev/new-committers-guide.html#cla">here</a>
217You should only need to perform the following steps once.</p>
Ian Maxon3dffc852015-07-13 20:17:09 -0700[diff] [blame]218
219<p>Our Gerrit server is <a href="https://asterix-gerrit.ics.uci.edu/">here</a></p>
220
221<ol>
222 <li>Visit the above URL, and click on “Register” in the upper right.</li>
223 <li>Gerrit uses OpenID; you may create an account using any OpenID provider, or with a Yahoo! account.</li>
224 <li>Click on “Sign in with a Yahoo! ID”. You will be taken to a page to log in to Yahoo!.</li>
225 <li>From there, you will get a page asking you to allow asterix-gerrit.ics.uci.edu to access your email and basic information. Approve this request.</li>
226 <li>You will be directed back to Gerrit to complete the account signup. Make sure to fill out this page! It is necessary to allow you to push code changes to Gerrit for review.</li>
227 <li>For “Full Name” and “Preferred Email”, enter what you like. If you would like to register a different email address such as an @uci.edu address, you may do so. This is where Gerrit will send you notifications about code review requests, voting, and so on.</li>
228 <li>For “Select a unique username”, choose a short alphanumeric ID. This will be your ssh username for git access. Be sure to click “Select Username” to verify that the name is unique and allowed.</li>
229 <li>Also provide a ssh public key here. There is information on the page on creating one if you do not have one. Click “Add” when done.
230 * Note that you can create a new ssh public key just for Gerrit if you like; if you do so you will need to modify your .ssh/config file to ensure the right key is selected.</li>
231 <li>Click “Continue” at the bottom of the page.</li>
232 <li>
233 <p>Finally, verify that you have everything set up: From a command-line, type
234<code>
235ssh -p 29418 username@asterix-gerrit.ics.uci.edu
236</code></p>
237 </li>
238 <li>You should see</li>
239</ol>
240
241<pre><code> **** Welcome to Gerrit Code Review ****
242
243 Hi Full Name, you have successfully connected over SSH.
244
245 Unfortunately, interactive shells are disabled.
246 To clone a hosted Git repository, use:
247
248 git clone ssh://username@asterix-gerrit.ics.uci.edu:29418/REPOSITORY_NAME.git
249
250</code></pre>
251
252<p>At this point, please send an email to Chris or Ian, specifying the email address of your new account, and ask to be added to the “AsterixDB Devs” group. You may push change proposals to Gerrit, and vote +1/-1 Code Review on any proposals without being in AsterixDB Devs, but you cannot vote +2 on anything to allow a change to be merged.</p>
253
254<hr />
255
256<h2 id="configuring-your-local-working-environment-for-gerrit">Configuring your local working environment for Gerrit</h2>
257
258<h3 id="one-time-tasks">One-time tasks</h3>
259
260<ol>
261 <li>At the command-line, run the following. Replace “username” with the user name you chose in step 7 above.
262<code>
263git config --global gerrit.url ssh://username@asterix-gerrit.ics.uci.edu:29418/
264</code></li>
265 <li>Download my “git-gerrit” utility library:
266<code>
267git clone https://github.com/ceejatec/git-gerrit
268</code></li>
269 <li>Ensure that the <code>git-gerrit/git-gerrit</code> script is on your PATH. You could copy it to somewhere, but it would be best to leave it inside the github clone so you can easily get updates.</li>
270</ol>
271
272<h3 id="once-per-repository-tasks">Once-per-repository tasks</h3>
273
274<ol>
275 <li>
276 <p>To work on (say) Asterix, first clone the Google Code repository (if you already have a local clone, great!).</p>
277
278 <p>git clone https://github.com/apache/incubator-asterixdb</p>
279 </li>
280 <li>
281 <p><code>cd</code> into the clone repo directory, and then run the following command to create the “gerrit” remote.</p>
282
283 <p>git gerrit init</p>
284 </li>
285</ol>
286
287<hr />
288
289<h2 id="making-changes---working-method">Making Changes - working method</h2>
290
291<ol>
292 <li>
293 <p>When you want to start working on a bug, feature, etc, first make a local <code>git</code> branch. Never work directly on <code>master</code>! <code>master</code> should always be a pure mirror of <code>origin/master</code>, ie, Google Code.</p>
294
295 <pre><code> git checkout -b my_branch
296</code></pre>
297 </li>
298 <li>Make your changes, test them, etc. Feel free to <code>git commit</code> as often as you like.</li>
299 <li>
300 <p><strong>Optional</strong>: If you like, you can push your branch up to Google Code, either to share it with others or as a backup. You may do this at whatever point in time you like.</p>
301
302 <pre><code> git push origin my_branch
303</code></pre>
304 </li>
305 <li>
306 <p>Every so often, you should update your local <code>master</code> mirror, and then merge that onto your working branch. This will prevent your branch from falling too far out of date, and ensure that your code review proposals will merge successfully with <code>master</code>. There are a number of ways to do this, but <code>git-gerrit</code> provides a convenience function:</p>
307
308 <pre><code> git gerrit update
309</code></pre>
310 </li>
311 <li>
312 <p>When you are ready to submit changes for code review, first ensure that you have committed everything locally that is necessary (<code>git status</code> should report “nothing to commit, working directory clean”). This is also a good time to update (see step 4). Then run:</p>
313
314 <pre><code> git gerrit submit
315</code></pre>
316 </li>
317 <li>This will pop open your editor to invite you to create a good commit message. This will be the single commit message which will be the only one to appear in the project’s master git history. Take the time to make it clear. The editor will contain the log messages of everything you committed on your branch as a reminder, but generally you will want to delete all this and replace it with a comprehensive message. Also: As noted in the initial message, the last line of the buffer will contain a <code>Change-Id</code> field. Do not delete that line! It is used by Gerrit to identify this particular merge proposal.</li>
318 <li>
319 <p>When you save your commit message, git-gerrit will push all of the changes from your working branch up to Gerrit. Assuming no errors, you should see output similar to the following:</p>
320
321 <pre><code> remote: Resolving deltas: 100% (1/1)
322 remote: Processing changes: new: 1, refs: 1, done
323 remote:
324 remote: New Changes:
325 remote: http://fulliautomatix.ics.uci.edu:8443/30
326 remote:
327 To ssh://ceej@fulliautomatix.ics.uci.edu:29418/ceej-gerrit-test
328 * [new branch] HEAD -&gt; refs/for/master
329</code></pre>
330 </li>
331 <li>That URL under “New Changes” is your code review! Send it to others to request reviews.</li>
332 <li>If you get any negative code reviews and need to make changes, you can just repeat steps 2 - 6 of the working method. Your local branch will still have all the history you put there, if you need to revert changes or look back and see what you did, etc.</li>
333 <li>When you repeat step 6, you will notice two things: First, git-gerrit keeps the change message for you, including the Change-Id, so you don’t have to re-invent it every time. Second, the output from <code>git gerrit submit</code> will not include the URL of the review this time. I’m not sure why; I wish it did. But if you re-visit the old URL in your browser, you should see an additional “Patch Set” containing your revised changes for people to review.</li>
334</ol>
335
336<h2 id="making-more-changes">Making More Changes</h2>
337
338<p>You may have as many feature branches as you want locally, and each may be at any point in the review cycle.</p>
339
340<p>Once you are done with a change (that is, it has been Code Reviewed and approved in Gerrit and merged), it is probably best to start work on the next big thing on a new branch. However, git-gerrit attempts to be smart if you choose to re-use a branch. For example, it should notice if the “current” Change-Id for a branch has been merged to master, and it will create a new Change-Id and a new fresh commit message the next time you run <code>git gerrit submit</code>.</p>
341
342<p>In that case, you may notice that the list of changes on the branch still contains older commits which have been merged. That is due to the unfortunate way Gerrit works; it requires squashing to a single git commit for review, which loses the association with the original commits in your history.</p>
343
344<p>It is also possible that you may want to re-use a branch and git-gerrit fails to notice that the older change has been merged - or perhaps the change was Abandoned on Gerrit and not merged, and you want to continue working on the same branch to create a new proposal. In this case, run
345<code>
346git gerrit new
347</code>
348on your branch. This will force git-gerrit to create a new Change-Id and commit message the next time you run <code>git gerrit submit</code>.</p>
349
350<hr />
351
352<h2 id="using-jenkins-with-gerrit">Using Jenkins with Gerrit</h2>
353
354<h3 id="verification">Verification</h3>
355
356<p>As of right now, whenever a patch set is submitted to Gerrit (i.e. whenever a user performs ‘git gerrit submit’) are automatically picked up by Jenkins, which runs <code>mvn verify</code> to test the patch fully. Once the build finishes, Jenkins comments on the patchset and votes with the result (+1 for all tests passing, -1 for anything less). Ideally, and in most cases, verifocation of a patchset reqires no intervention. However there are a few exceptions to this as detailed below.</p>
357
358<h3 id="retrigggering-builds-and-triggering-builds-manually">Retrigggering builds and triggering builds manually</h3>
359
360<h4 id="retriggering">Retriggering</h4>
361<p>Occasionally, there are builds in which tests failed, but perhaps not for a reason that has anything to do with the proposed patch’s changes. For example, on occasion the Integration tests can have issues with ports on the build server already being bound. The simple work around to this is to try building again.</p>
362
363<p>One way to perform this is by simply visiting the link that is posted on Gerrit by Jenkins, and hitting the ‘Retrigger’ link on the left-hand side of the page. This will try retesting the build with the exact same parameters as last time, hopefully with a different result.</p>
364
365<h4 id="manual-trigger">Manual Trigger</h4>
366<p>Builds of Gerrit patches can also be fully manually triggered from Jenkins. This can be desirable if a change is now dependent on a Hyracks change (via the Topic field feature described below), or if the patch is a draft or is not triggered automatically for any other reason. To manually trigger a build of a patchset, visit the Jenkins front-page, and click the ‘Query and Trigger Gerrit patches’ link. This should link to a page allowing you to manually trigger Gerrit patches. In the search field any query that can be searched in the Gerrit web interface can be used, but the default query of all open patchsets is likely fine. Hit the ‘Search’ button, and then click the checkbox that represents the patch that needs to be built. Then simply click ‘Trigger Selected’ and the patch will start building.</p>
367
368<h3 id="cross-project-dependencies">Cross-project Dependencies</h3>
369
370<p>It is sometimes the case that a change in one related project alters interfaces or expected results that an upstream project relies on. The converse can be true as well, such as an AsterixDB change that needs a Hyracks feature. In these sorts of situations, there is a mechanism to describe to Jenkins this dependenc of one project’s patchset to a particular Hyracks Change, by using the ‘Topic’ field in Gerrit. To utilize
371this feature, perform the following steps:</p>
372
373<ol>
374 <li>First submit the Hyracks change which the upstream (AsterixDB,etc..) change depends on if you have not done so already</li>
375 <li>In the Hyracks change details on the Gerrit web interface, take note of the refspec in the <em>Download</em> field of the patchset details. It will look something like <code>refs/changes/07/207/1</code>. This is what uniquely identifies the Hyracks change in Gerrit.</li>
376 <li>Submit the dependent change now, if you have not done so already. In the Gerrit web interface, view the change’s details. In the upper left-hand corner, there will be an empty field in a table, labeled <code>Topic</code>, with a notepad icon right-justified in the second column of the table. Click the notepad Icon, and in the resulting dialog box, enter in the refspec (<code>refs/changes/07/207/1</code>) as the Topic value.</li>
377 <li>Now, manually trigger the dependent change in Jenkins (see previous section for details)</li>
378</ol>
379
380<hr />
381
382</div>
383</div>
384
385
386 <hr />
387
388 <footer>
389 <div class="row">
390 <div class="col-md-6 col-md-offset-3 text-center">
391 <p>&copy; Copyright 2015 The Apache Software foundation. All Rights Reserved. </p>
392 <p>Apache AsterixDB, Apache, and the Apache feather logo are trademarks of the Apache Software Foundation</p>
393 </div>
394 <div class="col-md-1 text-right">
395 <img src="https://asterixdb.incubator.apache.org/img/egg-logo.png" style="height:auto; width:200px; vertical-align:bottom;"/>
396 </div>
397 </div>
398 </footer>
399 </div> <!-- /container -->
400
401
402 <!-- Bootstrap core JavaScript
403 ================================================== -->
404 <!-- Placed at the end of the document so the pages load faster -->
405 <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
406 <script src="https://asterixdb.incubator.apache.org/js/bootstrap.min.js"></script>
407 </body>
408</html>