Changing the email notification configuration manually


During installation, you can choose to have no email notifications or use Simple Mail Transfer Protocol (SMTP) notifications (as shown in the following figure) by selecting one of the following options at the time of installation:

  • No Email Notifications: Turns off email notifications
  • Use SMTP: Sends SMTP email to an SMTP account as specified

Email notification information
(click the image to expand it)
installer_email.png

You can also change the notification configuration later manually by using the following procedures, if necessary.

Note

To change the email notification settings, you must edit the smtp_settings.rb file or smtp_settings.default.rb file.

The actual BMC Release Process Management email notification settings are saved in the smtp_settings.rb file.

The smtp_settings.default.rb file is a template and it is used only when there is no smtp_settings.rb file.

Both files are located in RLMhome/releases/productVersion/RPM/portal.war/WEB-INF/config.

It is not recommended to make any changes to the smtp_settings.default.rb file. If you want to make changes to the smtp_settings.default.rb file, make a copy of it with the name smtp_settings.rb, and then save your changes to the smtp_settings.rb file.

To deactivate sending email notifications

  1. Go to RLMhome/releases/productVersion/RPM/portal.war/WEB-INF/config, and open the smtp_settings.rb file in a text editor, and delete the following line, if it exists:
    config.action_mailer.delivery_method = :smtp
  2. Comment out the configure_mail_with_gmail(config) and configure_mail_without_gmail(config) lines by putting the symbol at the beginning of the line, as in the following example:

    #configure_mail_with_gmail(config)
    #configure_mail_without_gmail(config)
  3. Save and close the file.
  4. Restart the server.

To activate sending email notifications

  1. Copy the smtp_settings.default.rb file to smtp_settings.rb in the RLMhome/releases/productVersion/RPM/portal.war/WEB-INF/config directory.
  2. Open the smtp_settings.rb file in a text editor, and then under the def configure_mail(config) line, add the following line if it does not already exist:
    config.action_mailer.delivery_method = :smtp
  3. Update the parameters in the configure_mail_without_gmail method:

    :address => <SMTP_SERVER>,
    :port => <SMTP_PORT>,
    :domain => <SMTP_DOMAIN>

    Based on your SMTP server configuration, you might need to append additional parameters for SMTP settings:

    :authentication => <SMTP_AUTH>,  #(Options are -  none, plain, login, cram_md5)
            :user_name => <SMTP_USER>,
            :password => <SMTP_PASSWORD>,
            :enable_starttls_auto => <SMTP_TLS> #(Options are -  true, false)
    Warning

    All parameters and their values are case-sensitive.

  4. Uncomment the following line by deleting the # symbol before the line:
    configure_mail_without_gmail(config)
  5. To receive a correct link to BRPM in the email notifications, replace the # config.action_mailer.default_url_options = { :host => 'example.com' } line with the following:

    config.action_mailer.default_url_options = {
        :host => 'example.com',
        :protocol => 'https',
        :port => 8443

    and then edit the hostprotocol, and port values.

  6. Save and close the file.
  7. Restart the server.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*