Skip to main content
Version: 1.19.1

Configure email notifications

LiveData Migrator supports sending email notifications whenever certain events occur, such as when a migration stops or falls behind filesystem events.

To use email notifications:

  1. Configure an SMTP server to send the emails.
  2. Subscribe to notification types.

Configure an SMTP server with the UI#

Configure an SMTP server in the UI by accessing the SMTP configuration tab and filling in the necessary fields.

  1. Select the LiveData Migrator instance name (for example, "localhost") on the dashboard to access the overview page.
  2. Under the configuration category on the left, select SMTP Settings.
  3. Fill in the form.
  4. Select Save.

SMTP server configuration fields#

  • SMTP Email Server (Required): The host domain or IP address of your SMTP server.
  • SMTP Connection Security (Required): The type of security your SMTP server uses. Can be TLS, StartTLS Enabled & Required, StartTLS Enabled, or None.
    • TLS: Immediately uses a secure SMTPS connection. If the secure connection fails, the connection attempt ends.
    • StartTLS Enabled & Required: Starts using an unsecured connection and tries to upgrade to a secure connection. If the secure connection fails, the connection attempt ends.
    • StartTLS Enabled: Starts using an unsecured connection and tries to upgrade to a secure connection. If the secure connection fails, an unsecured connection is used instead.
    • None: Uses an unsecured connection.
  • SMTP Port (Required): The port used to connect to the SMTP server.
  • Use Authentication: Optional field. Enables the provision of a username and password for authenticating with the SMTP server.
  • SMTP Username: The username to use for authenticating with the SMTP server. Requires Use Authentication to be enabled.
  • SMTP Password: The password to use for authenticating with the SMTP server. Requires Use Authentication to be enabled.
  • Sender Email Address (Required): The email address to use with any emails automatically sent by LiveData Migrator from the SMTP server.
  • Email Subject Prefix (Required): Text that will automatically precede the subject of any email sent by LiveData Migrator from the SMTP server. This can be used to easily identify these emails in the inbox.

Once you've saved the form and the SMTP server is configured, you can configure email notifications with the UI.

Configure an SMTP server with the CLI#

Use the following command to set up a connection to an SMTP server through the CLI:

notification email smtp set

Supply the following parameters:

Mandatory parameters#

  • --host The host address of the SMTP server.
  • --port The port to connect to the SMTP server. Many SMTP servers use port 25.
  • --security The type of security the server uses. Can be either tls or none.
  • --email The email address for LiveData Migrator to use with emails sent through the SMTP server. This address will be the sender of all configured email notifications.

Optional parameters#

  • --login The username to authenticate with the SMTP server.
  • --password The password to authenticate with the SMTP server sign-in. Required if you entered a login.

Example#

notification email smtp set --host my.internal.host --port 587 --security SSL --email livedatamigrator@wandisco.com  --login myusername --password mypassword

You can view the details of your SMTP server configuration at any time by running the command notifications email smtp show.

Once your SMTP server is ready, you can configure email notifications through the CLI.

Configure email notifications with the UI#

Set up email notifications in the UI by accessing the Email Notifications tab and filling in the necessary fields.

  1. Select the product name (for example, "localhost") on the Dashboard to access the overview page (or continue from configuring an SMTP server in the UI).
  2. Under the configuration category on the left, select Email Notifications.
  3. Enter the email address you want to send notifications to.
  4. Opt into the event notifications you want to receive.
  5. Select Save.

Select Send a test email to send a test notification email to the specified address. If you receive an email with the text "This is a test email notification" and a list of email addresses subscribed to notifications, you've configured email notifications correctly.

Email notification types#

  • Data migration has stopped: LiveData Migrator sends this notification any time a migration automatically stops, informing you of the migration's name and the exception message that caused the migration to terminate.
  • LiveData Migrator is falling behind system events: LiveData Migrator sends this notification when it determines the number of events (changes to data) occurring on a source filesystem is too rapid for a migration to keep up with over a given period of time. The email will contain the migration name, the filesystem ID and simple statistics about the events. The sensitivity of this notification is configurable.
  • Data migration is missing events: This notification is thrown when LiveData Migrator doesn't receive the expected number of events in a migration, and fails to retry querying them 10 times.
  • Files are failing to migrate: These notifications are sent when a file fails to transfer in a migration, providing a link to the migration that failed to transfer the files.

Configure email notifications with the CLI#

Use commands in the CLI to: