Email Server

To enable automated email notifications in vScope, such as for Scheduled Exports, invitations and Tracker notifications, you need to configure your own email server settings. This article guides you through the process of setting up your email server in vScope.

---

Configuring the Email Server

Follow these steps to configure your email server settings in vScope:

1. Navigate to Email Integration: Go to Settings > Email Integration in the vScope settings menu.

2. Enter SMTP Settings: Fill in the following details for your SMTP server:

   • SMTP Server: Enter the full address of your SMTP server (e.g., smtp.yourcompany.com).
   • Port: Specify the port number used by your SMTP server (e.g., 587 for TLS/STARTTLS or 465 for SSL).
   • Sender Address: Provide the email address that will appear as the sender for all vScope notifications.
   • SMTP Authentication: If your SMTP server requires authentication, check this box and enter the required Username and Password for the server.

3. Save Configuration: Click Save to apply your email server settings.

---

Tip

After saving your configuration, you can send a test email to confirm that vScope is successfully connected to your email server and can send notifications. This helps verify your settings instantly.

---

Common Errors and Troubleshooting

Here are some common email server errors you might encounter and how to troubleshoot them:

Error 550 5.4.1 Recipient address rejected: Access denied

This error typically indicates that the recipient’s email address is invalid or does not have an active mailbox.

• Check Email Addresses: Verify the spelling of all recipient email addresses registered in vScope.
• Verify Mailbox Existence: Ensure that the recipient email addresses have a registered and active mailbox (e.g., in Microsoft Exchange or your email service).

For more detailed information, refer to the Microsoft support article on error 550 5.4.1.

Error 550 5.7.1 Relaying denied

This error occurs when the email server refuses to relay emails from the sender. This can be due to security policies that prevent unauthorized email relaying.

• Verify Recipient Mailbox: Confirm that all recipient email addresses in vScope correspond to a registered mailbox (e.g., in Microsoft Exchange). Incorrect or non-existent recipient mailboxes can sometimes trigger this error.
• Check SMTP Authentication: Ensure that if your SMTP server requires authentication, the SMTP Authentication checkbox is selected and the correct Username and Password are provided in vScope.
• Server Relay Settings: Your email server might be configured to deny relaying from unknown senders or IPs. Consult your email server administrator to ensure vScope’s outgoing connections are permitted to relay emails.

java.net.SocketTimeoutException

This error indicates that the vScope application timed out while trying to communicate with your email server. The email server is not responding within the expected time frame. Common causes include:

• Message Throttling: If you are using an Exchange server, it might have Message Throttling enabled. A large number of queued emails sent within a short period can trigger throttling, causing the server to delay responses.
• Network Connectivity Issues: There might be network latency or an issue preventing data transfer between vScope and the mail server within the specified timeout interval.
• Network Security Rules: Inbound or outbound rules in your network security group (e.g., firewalls, security appliances) might be blocking the communication or acknowledgment messages from the email server. Ensure that the necessary ports are open and no rules are interfering with vScope’s connection to your SMTP server.

---