<h1 class="title">Talend Job Execution</h1> <p><a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/Smile-SA/odoo_addons/tree/13.0/smile_talend_job"><img alt="Smile-SA/odoo_addons" src="https://img.shields.io/badge/github-Smile_SA%2Fodoo_addons-lightgray.png?logo=github" /></a></p> <p>This module allows the execution of Talend jobs , it is useful during data integration.</p> <p>Features:</p> <ul class="simple"> <li>Execution of a Talend job by importing its archive.</li> <li>Visualization of the job's execution logs (creation date, end date, details, state, execution duration).</li> <li>Offers the possibility to add context variables to manage various execution types (database to use, username, password, port, host...).</li> <li>Definition of children jobs.</li> <li>Definition of the parent job.</li> <li>Passing a context environment to children jobs.</li> <li>Control the allocated memory for the job execution (by specifying the argument in the args field).</li> <li>Jobs and their executions logs storage.</li> </ul> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#requirements" id="id1">Requirements</a><ul> <li><a class="reference internal" href="#install-java" id="id2">Install Java</a></li> <li><a class="reference internal" href="#configure-java-options" id="id3">Configure Java options</a></li> </ul> </li> <li><a class="reference internal" href="#usage" id="id4">Usage</a></li> <li><a class="reference internal" href="#bug-tracker" id="id5">Bug Tracker</a></li> <li><a class="reference internal" href="#gdpr-eu-privacy" id="id6">GDPR / EU Privacy</a></li> <li><a class="reference internal" href="#credits" id="id7">Credits</a><ul> <li><a class="reference internal" href="#contributors" id="id8">Contributors</a></li> <li><a class="reference internal" href="#maintainer" id="id9">Maintainer</a></li> </ul> </li> </ul> </div> <a name="requirements"></a> <h2><a class="toc-backref" href="#id1">Requirements</a></h2> <a name="install-java"></a> <h3><a class="toc-backref" href="#id2">Install Java</a></h3> <p>You need to install Java on the server hosting Odoo, to execute Talend jobs directly from Odoo.</p> <p>To install Java on Debian/Ubuntu:</p> <pre class="code"> <code class="code">sudo apt-get update sudo apt-get install -y default-jdk java --version</code> </pre> <a name="configure-java-options"></a> <h3><a class="toc-backref" href="#id3">Configure Java options</a></h3> <p>If you encounter the following error during execution:</p> <pre class="code"> <code class="code">Could not allocate metaspace: 1073741824 bytes</code> </pre> <p>That means that Java is not allowed to use enough memory to execute your job.</p> <p>To increase memory that Java can use, set this option to your environment:</p> <pre class="code"> <code class="code">_JAVA_OPTIONS=-Xmx2048m -XX:CompressedClassSpaceSize=256m -Xmx300m</code> </pre> <a name="usage"></a> <h2><a class="toc-backref" href="#id4">Usage</a></h2> <p>To run a Talend job:</p> <ol class="arabic simple"> <li>Go to <code>Settings &gt; Talend Jobs</code> menu.</li> <li>Press the button <code>Create</code>.</li> <li>Insert the name of the job (the name should be the same name used for the job in Talend studio ).</li> <li>Upload the job's archive file (zip format) to <code>archive field</code>.</li> <li>Click on <code>Run</code> button.</li> <li>Click on <code>Refresh logs</code> button.</li> </ol> <div class="figure"> <img alt="Job creation" src="static/description/job_creation.png" style="width: 900px;" /> </div> <p>To propagate a context environment to children jobs :</p> <ol class="arabic simple"> <li>Add the concerned children jobs to <code>Children field</code>.</li> <li>Click on <code>Propagate context</code> button.</li> </ol> <div class="figure"> <img alt="Propagate Context" src="static/description/context_propagate.png" style="width: 900px;" /> </div> <p>Parameters you can specify :</p> <ol class="arabic simple"> <li>Path : to specify the path to the job's directory.</li> <li>Args : add -Xms64M or -Xmx1024M to control the available memory for the job's execution.</li> <li>Loop : to specify the number of times the job will be executed.</li> <li>Parent : to indicate the parent job.</li> <li>Children : to add children jobs.</li> <li>Context : to specify job's context parameters.</li> </ol> <div class="figure"> <img alt="Path Update" src="static/description/path.png" style="width: 900px;" /> </div> <div class="figure"> <img alt="Allocated memory control" src="static/description/args.png" style="width: 900px;" /> </div> <div class="figure"> <img alt="Context Update" src="static/description/context.png" style="width: 900px;" /> </div> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id5">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/Smile-SA/odoo_addons/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback <a class="reference external" href="https://github.com/Smile-SA/odoo_addons/issues/new?body=module:%20smile_talend_job%0Aversion:%2011.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">here</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="gdpr-eu-privacy"></a> <h2><a class="toc-backref" href="#id6">GDPR / EU Privacy</a></h2> <p>This addons does not collect any data and does not set any browser cookies.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id7">Credits</a></h2> <a name="contributors"></a> <h3><a class="toc-backref" href="#id8">Contributors</a></h3> <ul class="simple"> <li>Corentin POUHET-BRUNERIE</li> </ul> <a name="maintainer"></a> <h3><a class="toc-backref" href="#id9">Maintainer</a></h3> <p>This module is maintained by Smile SA.</p> <p>Since 1991 Smile has been a pioneer of technology and also the European expert in open source solutions.</p> <a class="reference external image-reference" href="https://www.smile.eu"><img alt="Smile SA" src="https://avatars0.githubusercontent.com/u/572339?s=200&amp;v=4" /></a> <p>This module is part of the <a class="reference external" href="https://github.com/Smile-SA/odoo_addons">odoo-addons</a> project on GitHub.</p> <p>You are welcome to contribute.</p>