In this blog I will explain how you can troubleshoot vCloud Director 9.7 SMTP settings when you receive a Fail – Error while configuring the SMTP server.
Before we start, I would like to explain the different log files vCloud Director uses:
All the logs for a cell can be found at /opt/vmware/vcloud-director/logs.
Log Name | Description |
---|---|
cell.log | Console output from the vCloud Director cell. |
cell-management-tool | Cell Management Tool log messages from the cell. |
cell-runtime | Runtime log messages from the cell. |
cloud-proxy | Cloud proxy log messages from the cell. |
console-proxy | Remote console proxy log messages from the cell. |
server-group-communications | Server group communications from the cell. |
statsfeeder | Virtual machine metric retrieval (from vCenter Server) and storage information and error messages. |
vcloud-container-debug.log | Debug-level log messages from the cell. |
vcloud-container-info.log | Informational log messages from the cell. This log also shows warnings or errors encountered by the cell. |
vmware-vcd-watchdog.log | Informational log messages from the cell watchdog. It records when the cell crashes, is restarted, and so on |
diagnostics.log | Cell diagnostics log. This file is empty unless diagnostics logging is enabled in the local logging configuration. |
YYYY_MM_DD.request.log | HTTP request logs in the Apache common log format. |
The official VMware article can be found here
vCloud Director 9.7 – Troubleshooting SMTP server settings
Now, let’s zoom into the issue.
SMTP server has been configured, but when I choose “Test SMTP settings” I receive a Fail / error as shown below.
Unfortunately it is not a very useful error..

- The first check you could do is perform a PING check from the vCloud Director cell, but most of the time that’s not very helpful either.
If the SMTP server is not responding to PING, it can have a variety of reasons. However, it will point you in the right direction if you do get a response. - Setup a SSH connection to your vCloud Director cell and start a PING command.
In this example, the SMTP server replies to PING:

In previous screenshot you can see the SMTP server is reachable.. It might have something to do with a blocked port or so?
Let’s check out the vCloud Director logs!
# Perform a recursive search for the SMTP server grep -r SMTP /opt/vmware/vcloud-director/logs/
The search result will look like the example below.
If it doesn’t it likely that you’re running a multi cell vCloud Director environment and you need to perform the search on one of the other cells.
In our example you can see that the cell is not able to connect to the SMTP server on port 25. (the connection timed out)
You need to allow outbound traffic on port 25 on your firewall.

After the port has been opened, you’ll be able to send a test e-mail.

Check our other vCloud Director related articles here