In this article
Overview
Use this account type to connect Hadoop Snaps with data sources that use Kerberos accounts.
Prerequisites
None.
Limitations
The security model configured for the Groundplex (SIMPLE or KERBEROS authentication) must match the security model of the remote server. Due to limitations of the Hadoop library, we are only able to create the necessary internal credentials for the configuration of the Groundplex.
Known Issues
None.
Account Settings
Field Name | Field Type | Description |
---|---|---|
Label
| String | Specify a unique label for the account. We recommend that you update the account name if there is more than one account of the same account type in your project. |
Client Principal Default Value: N/A | String | Specify the client principal associated with the account. |
Keytab File Default Value: N/A | String | Specify the path to the Keytab file. |
Hadoop config directory Default Value: N/A | String/Expression | Specify the path of the Hadoop configuration files to read the Hadoop configuration for a given instance of a Hadoop cluster. The account uses the config files from this path to initialize the Hadoop object and establishes a connection with the Hadoop cluster. When you specify a path in this field, the account overrides the value set on the Snaplex system property. This enables you to create multiple Kerberos accounts, each configured to read Hadoop configurations for more than one cluster. A pipeline can then include multiple instances of the Read or Write snap, each using a unique account from the account list. If you leave this field blank, the account uses the path in the Snaplex configuration. If the specified Hadoop config locations (either in the account settings or Snaplex configuration) are invalid, then the Snap generates default security configurations to use. |
Even when you pass both client and server principals here, the Snap only validates the client information and not the server information. This is because server validation requires information that is available only in the Snap's settings and not the Account settings.
Troubleshooting
Error Message | Reason | Resolution |
---|---|---|
Failed to validate account: Kerberos keytab file does not exist or cannot be read. | Specify the location of the keytab file. This typically means that the Keytab File or Client Principal details provided are incorrect. | Verify if the provided credentials are correct. |
Cannot locate default realm | This error appears when the value in the Client Principal field is not in the format expected. | |
Failure in URL connection or file access denial, detail: SIMPLE authentication is not enabled. Available: | Either the value in the Hadoop config directory field or Node properties is empty or the configuration directory is invalid. | Specify a valid path for the Hadoop configuration files. |