3.6 Configuring the Mail Server

The Dashboard requires a mail server to perform the following functionality:

  • Users request a new user account and receive an e‑mail with account information. Sending this e‑mail message requires an SMTP host running on an SMTP server.

  • Users request a forgotten password and receive an e‑mail with the password. An IMAP host and POP 3 host need to be configured to send this e‑mail.

By default, the Dashboard uses localhost for the mail server location.

To configure the mail server for Dashboard e‑mails:

  1. Stop the Dashboard server.

    For more information, see Section 2.3.2, Stopping the Dashboard.

  2. Create a ROOT.xml file at Operations_Center_Dashboard_installation_path/server/conf/Catalina/localhost and add the following content:

    <Resource
    name="mail/MailSession"
    auth="Container"
    type="javax.mail.Session"
    mail.imap.host="imap.acme.com"
    mail.pop3.host="pop3.acme.com"
    mail.smtp.host="webmachine.acme.com"
    mail.store.protocol="imap"
    mail.transport.protocol="smtp"
  />

  3. Save the file, then restart the Dashboard server.

    For more information, see Section 2.3.1, Starting the Dashboard.