# tMapRStreamsConnection

Opens a reusable connection to a given MapR Streams cluster so that the other MapR Streams components can reuse this connection.

## tMapRStreamsConnection Standard properties

These properties are used to configure tMapRStreamsConnection running in the Standard Job framework.

The Standard tMapRStreamsConnection component belongs to the Big Data family.

The component in this framework is available in all Talend products with Big Data and in Talend Data Fabric.

## Basic settings

| Properties | Description |
| --- | --- |
| Property type | Either Built-In or Repository.<br><br><br>Built-In: No property data stored centrally.<br><br><br>Repository: Select the repository file where the<br>properties are stored.<br><br>The properties are stored centrally under the Hadoop<br>Cluster node of the Repository<br>tree. |
| Distribution and<br>Version | Select the MapR distribution to be used. Only MapR V5.2 onwards is supported<br>by the MapRDB components.<br><br>If the distribution you need to use with your MapRDB database is not<br>officially supported by this MapRBD component, that is to say, this distribution is MapR<br>but is not listed in the Version drop-down list of<br>this components or this distribution is not MapR at all, select Custom.<br><br><ol> <li> <p>Select <span>Import from existing                        version</span> to import an officially supported distribution as base                    and then add other required jar files which the base distribution does not                    provide.</p> </li> <li> <p>Select <span>Import from zip</span> to                    import the configuration zip for the custom distribution to be used. This zip                    file should contain the libraries of the different Hadoop elements and the index                    file of these libraries. </p> <p>Note that custom versions are not officially supported by                        <span> <span>Talend</span> </span>. <span> <span>Talend</span> </span> and its community provide you with the opportunity to connect to                    custom versions from <span>Talend Studio</span> but cannot guarantee that the configuration of whichever version you choose                    will be easy, due to the wide range of different Hadoop distributions and                    versions that are available. As such, you should only attempt to set up such a                    connection if you have sufficient Hadoop experience to handle any issues on your                    own.</p> <div><span>Information note</span><span>Note:</span> <p>In this dialog box, the active check box must be kept                        selected so as to import the jar files pertinent to the connection to be                        created between the custom distribution and this component.</p> </div> <p>For a step-by-step example about how to connect to a custom                    distribution and share this connection, see <a href="https://help.qlik.com/talend/r/en-US/8.0/hortonworks" target="_blank">Hortonworks</a>.</p> </li> </ol> |
| NameNode URI | Type in the URI of the Hadoop NameNode, the master node of a<br>Hadoop system. For example, we assume that you have chosen a machine called *masternode* as the NameNode, then the location is<br>hdfs://masternode:portnumber. If you are using WebHDFS, the location should be<br>webhdfs://masternode:portnumber; WebHDFS with SSL is not<br>supported yet. |
| Force MapR ticket authentication | If the MapR cluster to be used is secured with the MapR ticket authentication mechanism,<br>set the MapR ticket authentication configuration by following the explanation in [Setting up the MapR ticket authentication](https://help.qlik.com/talend/en-US/components/8.0/mapr/setting-up-mapr-ticket-authentication-standard-component-the-mapr).<br><br>In addition, if your cluster also uses Kerberos to secure your MapR Streams, select the<br>Use Kerberos authentication check box to configure<br>Kerberos for your Job.<br><br><ul> <li> <p>For an example of how to configure Kerberos authentication for a                <em> <span>Talend</span> </em> Job, see <a href="https://help.qlik.com/talend/r/en-US/8.0/kerberos-big-data-troubleshooting" target="_blank">How to use Kerberos in Talend Studio with Big Data</a>. Although this example uses Cloudera for demonstration, the operations it describes are generic and thus applicable to                MapR as well.</p> </li> </ul> |

## Advanced settings

| Properties | Description |
| --- | --- |
| Hadoop properties | *Talend Studio* uses a default configuration for its engine to perform<br>operations in a Hadoop distribution. If you need to use a custom configuration in a specific<br>situation, complete this table with the property or properties to be customized. Then at<br>runtime, the customized property or properties will override those default ones.<br><br><ul> <li> <p>Note that if you are using the centrally stored metadata from the <span>Repository</span>, this table automatically inherits the					properties defined in that metadata and becomes uneditable unless you change the						<span>Property type</span> from <span>Repository</span> to <span>Built-in</span>.</p> </li> </ul> |
| tStatCatcher Statistics | Select this check box to collect the log data at a component<br>level. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | This component is generally used with other MapR Streams components. |
| Prerequisites | The Hadoop distribution must be properly installed, so as to guarantee the interaction<br>with *Talend Studio*. The following list presents MapR related information for<br>example.<br><br><ul> <li> <p>Ensure that you have installed the MapR client in the machine where                  <span>Talend Studio</span> is,               and added the MapR client library to the PATH variable of that machine. According to               MapR's documentation, the library or libraries of a MapR client corresponding to each               OS version can be found under <em>MAPR_INSTALL\                  hadoop\hadoop-VERSION\lib\native</em>. For example, the library for Windows is <em>\lib\native\MapRClient.dll</em> in the MapR client jar file.</p> <p>Without adding the specified library or libraries, you may encounter the following				error: <span>no MapRClient in java.library.path</span>.</p> </li> <li> <p>Set the <span>-Djava.library.path</span> argument,               for example, in the <span>Job Run VM arguments</span> area               of the <span>Run/Debug</span> view in the <span>Preferences</span> dialog box in the <span>Window</span> menu. This argument provides to <span>Talend Studio</span> the               path to the native library of that MapR client. This allows the subscription-based               users to make full use of the <span>Data viewer</span> to               view locally in <span>Talend Studio</span> the               data stored in MapR.</p> </li> </ul><br><br>For further information about how to install a Hadoop distribution, see the manuals<br>corresponding to the Hadoop distribution you are using. |