> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/pdia-data-integration/9.3-data-integration/advanced-topics-pentaho-data-integration-overview/connecting-to-a-hadoop-cluster-with-the-pdi-client-article/adding-a-cluster-connection-connect-to-a-hadoop-cluster-with-the-pdi-client/add-a-cluster-connection-by-import-add-hadoop-cluster-connection.md).

# Add a cluster connection by import

You can create a new cluster by importing the `site.xml` files from an existing cluster. Perform the following steps to create a cluster by import.

1. In the PDI client, create a new job or transformation or open an existing one.
2. Click the **View** tab and then right-click the **Hadoop Clusters** folder.
3. Click **Import cluster**.

   The **Hadoop Clusters** dialog box appears.

   ![Hadoop Clusters Import dialog](/files/P8keDtMVQZlsZ3AZ7n4B)
4. Enter a user-defined name to assign the cluster connection in the **Cluster name** field.

   Characters allowed in the cluster name field are uppercase and lowercase letters, numbers, and hyphens.

   **Note:** Valid cluster names may include uppercase and lowercase letters, numbers, and hyphens. However, the cluster name cannot end with a hyphen. To ensure a valid cluster name, do not use any other symbols, punctuation characters, or blank spaces.

   After you create the connection, you can locate this named connection in the **View** tab on the PDI client.
5. Use the **Driver** and **Version** options to select the distribution of Hadoop on your cluster and its version number. The [Hitachi Vantara Lumada and Pentaho Support Portal](https://support.pentaho.com) provides drivers that you can download and install for supported versions of Amazon EMR, Cloudera, Google Dataproc, and Hortonworks.
6. Click **Browse to add file(s)** and browse to the directory containing the `site.xml` files that were provided to you by your cluster administrator.

   The required files include:

   * `hive-site.xml`
   * `mapred-site.xml`
   * `yarn-site.xml`
   * `core-site.xml`
   * `hbase-site.xml`
   * `hdfs-site.xml`
   * `oozie-site.xml` (if you are using Oozie in your configuration)
7. Click **Open**.

   The **Site XML files** section displays the files you selected.
8. Enter your user name and password in the **HDFS** section if you are connecting to a secure cluster.
9. Click **Next** and specify the security option for your cluster.
   * If your Hadoop cluster is non-secure, select **None** and then click **Next** to [test your connection](/pdia-data-integration/9.3-data-integration/advanced-topics-pentaho-data-integration-overview/connecting-to-a-hadoop-cluster-with-the-pdi-client-article/adding-a-cluster-connection-connect-to-a-hadoop-cluster-with-the-pdi-client/test-the-cluster-connection-add-hadoop-cluster-connection.md).
   * If your Hadoop cluster is secure, you need to add security to your cluster connection. See [Add security to cluster connections](/pdia-data-integration/9.3-data-integration/advanced-topics-pentaho-data-integration-overview/connecting-to-a-hadoop-cluster-with-the-pdi-client-article/adding-a-cluster-connection-connect-to-a-hadoop-cluster-with-the-pdi-client/secure-cluster-connections-add-hadoop-cluster-connection.md) for instructions.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pentaho.com/pdia-data-integration/9.3-data-integration/advanced-topics-pentaho-data-integration-overview/connecting-to-a-hadoop-cluster-with-the-pdi-client-article/adding-a-cluster-connection-connect-to-a-hadoop-cluster-with-the-pdi-client/add-a-cluster-connection-by-import-add-hadoop-cluster-connection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.