In order to send notifications via an SMTP server, the server computer running the SOLIDWORKS PDM Professional database server service must be able to reach and be allowed to relay SMTP commands to the SMTP server. The same applies if you are sending a direct notification by using the (Notify a Colleague) from a client. The client must be able to reach the SMTP server. This article outlines steps for the Windows feature TELNET to test/troubleshoot SMTP notifications.
Note: The steps outlined in this article are intended for IT professionals. Any further assistance will need to be coordinated with IT.
Considerations
- Before using this method of troubleshooting, please do both of the following:
- Restart the SOLIDWORKS PDM Database Server service
- Turn Windows Firewall off
- Install the Windows Telnet Client
- Control Panel > Programs and Features > Turn Windows features on or off >Telnet client
- Only IT or PDM Administrators with windows Administrative access to the server should use this content.
Process
- Open Command Prompt by clicking the Windows Start menu. In the search type CMD or Windows Command Processor.
- Type ‘telnet <servername><portnumber>.
- Example: (telnet mailserver.mycompany.com 25)
- If Telnet is successful you will see one of the following responses from your SMTP server with the following message:
- 220 mailserver.mycompany.com Microsoft Exchange Internet Mail Connector
- A blank screen with a blinking cursor in the top left-hand corner of the CMD prompt.
- Note: If Telnet fails to contact the SMTP server you will get the following message: Connecting To...Could not open connection to the host, on port 25: Connect failed.
- Start communication by typing the following command: EHLO test.com
- Note: You can use the HELO command, but EHLO is a verb that exists in the Extended SMTP verb set that is supported in all current Microsoft implementations of SMTP. It is a good idea to use EHLO unless you believe that there is a problem with the Extended SMTP verbs.
- If the command is successful, you receive the following response: 250 OK.
- Type the following command to tell the receiving SMTP server who the message is from: MAIL FROM:Admin@test.com
- Note: This address can be any SMTP address that you want, but it is a good idea to consider the following issues:
- Some SMTP mail systems filter messages based on the MAIL FROM: address and may not allow certain IP addresses to connect or may not allow the IP address to send email to the SMTP mail system if the connecting IP address does not match the domain where the SMTP mail system resides. In this example, that domain is test.com.
- . If you do not use a valid email address when you send a message, you cannot determine whether the message had a delivery problem because the non-delivery report (NDR) cannot reach an IP address that is not valid.
- If you use a valid email address, you receive the following response from the SMTP server: 250 OK - MAIL FROM Admin@test.com
- Type the following command to tell the receiving SMTP server the address that the email message is being sent to: RCPT TO: User@Domain.Com
- You receive the following response: 250 OK - Recipient User@Domain.Com
- Note: It is a good idea to always use a valid recipient SMTP address in the domain that you are sending email to. For example, if you are sending to john@domain.com, you must be certain that john@domain.com exists in the domain. Otherwise, you will receive an NDR.
- Type the following command to tell the SMTP server that you are ready to send data: DATA
- You receive the following response: 354 Send data. End with CRLF.CRLF
- Now that the DATA command has been sent we can start sending the message contents. This starts with the various headers. At a minimum, a message should contain a To, From, Subject, and Date Header. The headers entered here will be shown to the user in their email client.
- Type the following command to add a subject line: Subject: test message
- Press Enter two times. You do not receive a response from this command.
- Type the following command to add message body text: This is a test message you will not see a response from this command.
- Type a period (.) at the next blank line, and then press Enter. You receive the following response: 250 Received
- Close the connection by typing the following command: QUIT
- You receive the following response: 221 closing connection.
- Verify that the recipient received the message that you sent. If any error event messages occur in the application event log, or if there are problems receiving the message, check the configuration or the communication to the host.
If you have any questions concerning this article, please contact our GoEngineer support by email at support@goengineer.com.
More SOLIDWORKS PDM Articles
How to Set Up Dynamically-controlled Card Lists in SOLIDWORKS PDM
SOLIDWORKS PDM and SQL Server Performance Considerations
New SOLIDWORKS PDM Column Configurations
SOLIDWORKS 2022 Data Management: PDM, Manage, & Admin
SOLIDWORKS PDM Web2 Guide: Server Setup, Accounts, Application Pools & Testing