vRealize Hyperic sends emails using the SMTP server specified during vRealize Hyperic server installation. To use a remote SMTP server, you configure the vRealize Hyperic server with the remote host connection information, and set up authentication in hq-server.conf.

About this task

On many Unix and Linux machines, the default - localhost is satisfactory. In this case, no additional configuration is required.

Procedure

  1. Open HQ Server directory/conf/hq-server.conf and navigate to the Email Settings section.
  2. Add the following mail properties to override the default settings of vRealize Hyperic.

    The properties that you define depend on whether you require plain text or SSL communication.

    1. (Optional) : To configure plain text communication, add the mail properties below to the file.

      The values in the following example is equivalent to the vRealize Hyperic default. Replace the values to something appropriate for you environment.

      # Change to the SMTP gateway server
      # maps to mail.smtp.host,
        server.mail.host=localhost
      # Change to SMTP port
        mail.smtp.port=25
      # SMTP properties
        mail.smtp.auth=false
        mail.smtp.socketFactory.class=javax.net.SocketFactory
        mail.smtp.socketFactory.fallback=false
        mail.smtp.socketFactory.port=25
        mail.smtp.starttls.enable=false
      mail.smtp.connectiontimeout=20000
      mail.smtp.timeout=20000
      
    2. (Optional) : To configure SSL communication, add the mail properties below to the file.
      server.mail.host=SmtpServerHost
      mail.user=SmtpUser
      mail.password=SmtpPassword
      mail.smtp.port=587
      mail.smtp.auth=true
      mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
      mail.smtp.socketFactory.fallback=false
      mail.smtp.socketFactory.port=465
      mail.smtp.starttls.enable=true
      mail.smtp.connectiontimeout=20000
      mail.smtp.timeout=20000
      
  3. (Optional) : If you are using SSL/TLS, add the SMTP Server's TLS certificate to the JRE keystore.
    1. Obtain a copy of the public certificate for the SMTP server's TLS configuration (not the private key) on the vRealize Hyperic server.
    2. With vRealize Hyperic installation owner credentials, execute the following command in the server installation directory.

      The certificate import example assumes the use of a JRE that is bundled with the vRealize Hyperic server. When using a non-bundled JRE, use that JRE's keytool and cacerts file.

      jre/bin/keytool -keystore jre/lib/security/cacerts -import -storepass changeit -file /path/to/smtp_server_tls.cert

      .

What to do next

Restart vRealize Hyperic server to implement your changes.