VoyenceControl: Emails are not being sent from the VoyenceControl application server for job notifications or reports; How do I verify or troubleshoot email connectivity from the server?

Products

• VMware

Issue/Introduction

Symptoms:


How do I verify or troubleshoot email connectivity from the VoyenceControl server?

Emails are not being sent from the VoyenceControl application server for job notifications or reports

Environment

VMware Smart Assurance - NCM

Resolution

To verify or troubleshoot emaill connectivity from the VoyenceControl server, do the following:

1. Do one of the following to verify that the sendmail service is running:
   
   service sendmail status
   
   OR 
   
   /etc/init.d/sendmail status
   
    
2. Test sendmail functionality from the command line as follows:
   
   echo "This is a test message" " sendmail [email protected]
    

If the preceding steps do not work, sendmail is misconfigured for your network and no application (including VoyenceControl) will be able to email via sendmail until this is resolved. See the Note statement at the end of this solution for some sendmail troubleshooting suggestions. If your mail server requires mail-relay hosts, you will need to change the VoyenceControl and sendmail settings as described in the following sections of this Fix statement.

VoyenceControl settings for mail servers that require mail-relay hosts

1. Open the $VOYENCE_HOME/cm/vc-server/deploy/mail-service.xml file for editing.
2. Change the following line from localhost to the correct value for the mail-relay host. Ensure that the mail administrator allows mail relays from this server IP address.
   
   property name="mail.smtp.host" value="localhost" 
   
    
3. Restart the following services:
   
   service sysadmin stop
   service jboss stop
   service jboss start
   service sysadmin start

Sendmail settings for mail-relay hosts

1. Change to the mail directory as follows:
   
   cd /etc/mail
   
    
2. Open sendmail.mc as follows:
   
   vi sendmail.mc
   
   
3. Find the following line:
   
   dnl define(`SMART_HOST',`smtp.your.provider')
   
   
4. Remove the dnl from this line, and change smtp.your.provider to the correct fully-qualified domain name (FQDN) of your SMTP server.
5. Run the following command:
   
   make -C /etc/mail
   
   
6. Restart sendmail using one of the following methods:
   
   service sendmail restart
   
   OR 
   
   /etc/init.d/sendmail restart
    

Additional Information

Troubleshooting sendmail

Verify the /var/ partition is not full for mail spooling.  If you do not have a separate /var partition, check the / partition.

df -h

Filesystem            Size  Used Avail Use% Mounted on
/dev/sda2              72G   44G   24G  65% /
/dev/sda1              99M   27M   67M  29% /boot
none                  999M     0  999M   0% /dev/shm

Verify DNS settings are correct in /etc/resolv.conf  (sample settings below)

; generated by /sbin/dhclient-script
search yourdomain.com
nameserver 192.168.0.10

Verify your hostname matches settings in /etc/hosts

hostname

yourserver.yourdomain.com

cat /etc/hosts

# Do not remove the following line, or various programs
# that require network functionality will fail.
127.0.0.1       localhost.localdomain   localhost
192.168.0.100    yourserver.yourdomain.com yourserver

Send an email via the echo statement (echo "This is a test message" " sendmail [email protected]) or by scheduling a job while tailing /var/log/maillog

tail -f /var/log/maillog

IMPORTANT! You should Report any errors received from the mail server to your local mail administrator for troubleshooting.