Skip to main content
Version: 2.0 (latest)

Configure basic auth

Basic auth enables password-based authentication for Data Migrator and Hive Migrator.


If basic auth is enabled for Hive Migrator or its REST API, ensure that the username and password match those used for Data Migrator.

Basic auth for Data Migrator is set in the following section of /etc/wandisco/livedata-migrator/

# security configuration for basic authenticationsecurity.type=off#security.type=basic#security.basic.user=admin#security.basic.password=$2aBCRYPTPASSWORDSTRING.eMyOt67yEM6TVkz1qeIxDMfaCnI8SjFaRUy

Enable Basic authentication (Data Migrator)#

Use the following steps to enable basic auth:

  1. Open /etc/wandisco/hivemigrator/ in a text editor.

  2. Comment out security.type=off.

  3. Uncomment the following security parameters to make them apply.


    The default username is admin. If you provide your own username, it must not include empty spaces.

  4. Replace the example security.basic.password with your own bcrypt-encrypted password. Paste your password after the prefix {bcrypt}.

  5. Save and close the file.

  6. Restart the Data Migrator service. See System service commands.

Enable Basic authentication (Hive Migrator)#

Use the following steps to enable basic authentication on the Hive Migrator REST API:

  1. Open /etc/wandisco/hivemigrator/

  2. Under the security section, ensure is "true".
  3. View the Integration with LDM section:

    # Integration with LDM# hivemigrator.integration.liveDataMigrator.username=# hivemigrator.integration.liveDataMigrator.password=password# hivemigrator.integration.liveDataMigrator.trustStore.path=# hivemigrator.integration.liveDataMigrator.trustStore.password=# hivemigrator.integration.liveDataMigrator.trustStore.type=
  4. Uncomment and provide a username for hivemigrator.integration.liveDataMigrator.username. For example:

  5. Uncomment and provide an unencrypted password for hivemigrator.integration.liveDataMigrator.password.


    These credentials are used by Hive Migrator to communicate with Data Migrator, so they must match the credentials used for Data Migrator.

  6. Under Credentials used for REST authentication, uncomment and complete Hive Migrator user credentials hivemigrator.username and hivemigrator.password. For example:


    As with the above Data Migrator example, the hivemigrator.password string needs to be encrypted using a bcrypt generator that provides a "2a" prefix at the beginning of the encrypted password.

  7. Restart the Hive Migrator service. See System service commands.

After updating the basic auth settings for Data Migrator and Hive Migrator, the UI will show both filesystems as unhealthy and disconnected. To make them healthy, update the basic auth setting in the UI or CLI, as described in the next section.

Update basic auth settings#

Update your basic auth settings using the UI or CLI.

Use the following steps to set UI basic auth credentials through the UI:

  1. Sign in to the UI and select the Dashboard on the menu.

  2. Select your existing instance from the Products panel.

  3. Select the LiveData Migrator option from the Configuration Menu.

  4. Select Remove. When asked to confirm the removal, select Remove. The Data Migrator instance has now been removed.

  5. Select the plus in the corner of the Products panel.

  6. Enter your Data Migrator details, including new basic auth credentials.

  7. Select Connect.


Repeatedly selecting the Remove button may cause the operation or the UI to hang.

In some cases, the Data Migrator configuration option for removing a Data Migrator instance may take much longer than expected. Repeatedly selecting the Remove button may cause the operation or the UI to hang. See the following knowledge base article - known issue.