Implementation Guide › Installing the Enterprise Management Server › How to Install the Enterprise Management Server Components › Advanced Configuration › Setting Up Email Notifications for Events › How To Set Up Email Notifications for Events › Configure JBoss Email Settings

Configure JBoss Email Settings

To send email notifications, you configure the mail-service.xml and email.properties files in your JBoss installation, and modify existing CA ControlMinder email templates accordingly.

Follow these steps:

1. Connect to the Enterprise Management machine and stop JBoss if it is running. Do one of the following:
   • If JBoss is not installed as a service, interrupt the JBoss application server window (Ctrl+C).
   • If JBoss is installed as a service, stop the JBoss service from the Services panel.
2. Open the mail-service.xml file for editing. By default, the file is located in a subdirectory of your JBoss installation directory:

   JBOSS_HOME/server/default/deploy/mail-service.xml
   

3. Locate the "mail.smtp.host" entry in mail-service.xml. Change the SMTP host default value to the full DNS domain name of your outgoing email server (the SMTP server).

   <property name="mail.smtp.host" value="mail.ca.com" />
   

   Note: The hosts file on the Enterprise Management Server must be able to resolve the full DNS domain name that you specify for this property to the IP address of the SMTP server.

4. Specify the email address of the notification sender.

   <property name="mail.from" value="sendername@ca.com" />
   

5. (Optional) Enable SMTP authentication and TLS security by providing the SMTP user name and password, and by adding SMTP configuration properties.

   <attribute name="User">MySMTPUser</attribute>
   <attribute name="Password">MySMTPPassword</attribute>
   <attribute name="Configuration">
     <configuration>
       <property name="mail.smtp.auth" value="true"/>
       <property name="mail.smtp.starttls.enable" value="true"/>  
     </configuration>
   </attribute>
   

   Note: If you are using an SMTP service that does not require authentication, you can skip this step.

Do the following for each event for which you want to configure email notifications.

Follow these steps:

1. Open the email template that corresponds to the event.

   Examples:

   1. To configure email notifications that informs recipients that a privileged account password request was approved, open the CreatePrivilegedAccountExceptionEvent.tmpl file in the following directory:

      JBoss_HOME/server/default/deploy/IdentityMinder.ear/custom/emailTemplates/default/approved
      

   2. To configure an email notification that informs recipients about a pending endpoint status, open the EndpointStatusEvent.tmpl file in the following directory:

      JBoss_HOME/server/default/deploy/IdentityMinder.ear/custom/emailtemplates/default/pending
      

2. Modify the template host name and port from 'http://localhost:8080/iam/ac" to the Enterprise Management Server host name and port, for example, "https://computer.com:18443/iam/ac".
3. Save and close the file.

Configure the email.properties file.

Follow these steps:

1. Browse to the following directory and open the email.properties file.

   JBoss_HOME/server/default/deploy/IdentityMinder.ear/config/com/netegrity/config/
   

2. Specify the same sender email address as in the mail-service.xml file, using the following format.

   admin.email.address=sendername@ca.com
   

3. Save and close the email.properties file.
4. Restart JBoss.