You can configure the relay host using tscli or through the Admin Console.
Configure using tscli
Set up SMTP rules to send critical email notifications to ThoughtSpot Support.
Set up the relay host
To set up a relay host:
- Log in to the Linux shell using SSH.
-
Issue the setup command, providing the IP address of the relay host:
On ThoughtSpot release 6.1.1 and later, or on release 6.0.5, you can specify a custom port to connect to the relay host. If you do not specify a port, the system uses the default recommended port, port 25. Use a custom port if port 25 is blocked in your environment.
To use the default port, run the setup command:
$ tscli smtp set-relayhost <IP_address>
To use a custom port instead of port 25, run the setup command, specifying the port you want to use:
$ tscli smtp set-relayhost <IP_address>:<custom_port>
If you are on 6.1 rather than 6.1.1, or an earlier version than 6.0.5, contact ThoughtSpot Support to use a custom port.
-
Verify your settings:
$ tscli smtp show-relayhost
- Verify that email is working.
Configure an email to send alerts
-
Log in to the Linux shell using SSH.
-
Specify the domain of the email address you would like emails to come from. In
example@company.com
, this command specifiescompany
.$ tscli smtp set-mailname <mailname>
-
Specify the name of the email address you would like emails to come from. In
example@company.com
, this command specifiesexample
.$ tscli smtp set-mailfromname <mailfromname>
Configure SMTP authentication
-
Log in to the Linux shell using SSH.
-
If SMTP authentication is required, you must specify a username and password. Skip this step if SMTP authentication is not required.
$ tscli smtp set-saslcredentials
Configure an email to receive alerts
ThoughtSpot sends alerts to the email address specified during installation. If you do not specify an email address, you do not receive any alerts. To add an email to receive alerts, issue the following command.
prod-alerts@thoughtspot.com
, to allow ThoughtSpot Support to receive alerts. ThoughtSpot Support monitors these alerts to ensure your cluster’s health. Do not add this email to POC or demo environments.$ tscli monitoring set-config --email <prod-alerts@thoughtspot.com>,<your_email>
To send to multiple emails, provide a comma-separated list with no spaces.
Verify the relay with an email
Check if the email settings are working properly by using this procedure.
- Log in to the Linux shell using SSH.
-
Try sending an email to yourself by issuing:
$ echo | mail -s Hello <your_email>
- If you receive the email at the address(es) you supplied, email is working correctly.
Configure SMTP through the Admin Console
You can set up the relay host for SMTP from the Admin Console.
tscli
, by running tscli smtp set-relayhost <IP_address>:<custom_port>
.Set up relay host
Navigate to the Admin Console by clicking on the Admin tab from the top navigation bar. Select SMTP from the side navigation bar that appears.
Select Configure.
Specify the following parameters:
1 | Specify the relay host. |
2 | Specify the domain of the email address you would like emails to come from. In example@company.com, it is company. |
3 | Specify the name of the email address you would like emails to come from. In example@company.com, it is example. |
4 | If SMTP authentication is required, you must add a username and password. If you select no, you do not see the step to add a username and password. |
5 | Specify the username. |
5 | Specify the password. |
Click OK.
After you configure SMTP through the Admin Console, use tscli
to configure an email to receive monitoring alerts and verify the relay with an email.
Additional resources
As you develop your expertise in emails and alerts, we recommend the following ThoughtSpot U course: