Data Migrator supports sending email notifications whenever certain events occur, such as when a migration stops or falls behind filesystem events.
Email notifications are disabled for trial licenses. To start using this feature, Upgrade to a full license
To use email notifications:
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.
- Select the Data Migrator instance name (for example, "LDM-localhost") on the Dashboard to access the overview page.
- Under the configuration category on the left, select SMTP Settings.
- Fill in the form.
- 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 Data Migrator from the SMTP server.
- Email Subject Prefix (Required): Text that will automatically precede the subject of any email sent by Data 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:
--hostThe host address of the SMTP server.
--portThe port to connect to the SMTP server. Many SMTP servers use port 25.
--securityThe type of security the server uses. Can be either
--loginThe username to authenticate with the SMTP server.
--passwordThe password to authenticate with the SMTP server sign-in. Required if you entered a login.
notification email smtp set --host my.internal.host --port 587 --security SSL --email firstname.lastname@example.org --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.
- Select the product name (for example, "LDM-localhost") on the Dashboard to access the overview page (or continue from configuring an SMTP server in the UI).
- Under the configuration category on the left, select Email Notifications.
- Enter the Recipient email address you want to send notifications to.
- Opt into the event notifications you want to receive.
- 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
- Select all: Select this checkbox to enable all available notifications.
- A filesystem has become unhealthy: Any time a filesystem enters an unhealthy state.
- Data Migrator is falling behind system events: When it is detected that 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.
Backup and Restore
- Backup status: Notifies you whether a backup operation is successful or failed.
- Restore from backup status: Notifies you whether a restore operation is successful or failed.
- Data migration has stopped: Any time a migration automatically stops informing you of the migration's name and the exception message that caused the migration to terminate.
- Data migration is missing events: When Data 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: A file fails to transfer in a migration. The notification includes a link to the failed migration.
- Retry occurred: Data Migrator tried transferring failed files more than once.
- Migration verification started: These notifications are sent when a verification scan has been initiated.
- Migration verification complete: These notifications are sent when a verification scan is completed, outlining any inconsistencies detected.
For more information, see Verify migrations