Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Juniper Paragon Automation User Guide
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

Configure SMTP Settings in Paragon Shell

date_range 14-Nov-24

SMTP must be configured in Paragon Automation for Paragon Automation to send e-mail notifications to users when their account is created or modified and when subscribed events occur, By default, SMTP is not configured in Paragon Automaiton and notifications are not sent.

Table 1 lists the behavior for different scenarios when SMTP and local authentication are configured.

Table 1: Behavior for Different Scenarios when SMTP and Local Authentication are configured

Local Authentication

SMTP

Behavior

Enabled

Disabled

User is authenticated locally based on user accounts created within Paragon Automation E-mail notifications are not sent to users.

Enabled

Enabled

User is authenticated locally based on user accounts created within Paragon Automation. E-mail notifications are sent when subscribed alerts or events occur.

Disabled

Enabled

Users are invited to access an organization over an e-mail. Also, users receive notifications for subscribed alerts or events over an e-mail.

Disabled

Disabled

This is not a valid combination. However, a user is locally authenticated based on user account created in Paragon Automation.

E-mail notifications are not sent for subscribed alerts or events.

A system administrator can configure SMTP in Paragon Shell so that users can be notified when their account is created, activated, or modified.

Enable SMTP Based User Management

To enable SMTP settings in Paragon Shell:

  1. SSH to the node on which you deployed the Paragon Automation cluster.
  2. Log in to Paragon Shell as the root user.
    You are placed in the operational mode.
  3. Enter the configuration mode.
    content_copy zoom_out_map
    root@eop-primary> configure
    Entering configuration mode
    
    [edit]
    
  4. Configure the following SMTP parameters.
    content_copy zoom_out_map
    root@eop-primary# set paragon cluster mail-server smtp-allowed-sender-domains sender-domains
    
    [edit]
    root@eop-primary# set paragon cluster mail-server smtp-relayhost relayhost-hostname
    
    [edit]
    root@eop-primary# set paragon cluster mail-server smtp-relayhost-username relayhost-username
    
    [edit]
    root@eop-primary# set paragon cluster mail-server smtp-relayhost-password relayhost-password
    
    [edit]
    root@eop-primary# set paragon cluster mail-server smtp-sender-email sender-e-mail-address
    
    [edit]
    root@eop-primary# set paragon cluster mail-server smtp-sender-name sender-name
    
    [edit]
    root@eop-primary# set paragon cluster mail-server smtp-enabled true
    
    
    Where:

    smtp-allowed-sender-domains are the e-mail domains from which Paragon Automation sends e-mails to users.

    relayhost-hostname is the name of the SMTP server that relays messages.

    relayhost-username (optional) is the username to access the SMTP (relay) server.

    relayhost-password (optional) is the password for the SMTP (relay) server.

    sender-e-mail-address is the e-mail address that appears as the sender's e-mail address to the e-mail recipient.

    sender-name is the name that appears as the sender’s name in the e-mails sent to users from Paragon Automation.

  5. Disable local user management to perform SMTP-based user management configurations.
    content_copy zoom_out_map
    root@eop-primary# set paragon cluster papi papi-local-user-management false
  6. Commit the changes and exit the configuration mode.
    content_copy zoom_out_map
    root@eop-primary# commit and-quit
    commit complete
    Exiting configuration mode
    
  7. Add the SMTP configuration parameters to the configuration files.
    Note:

    Ensure that the following parameters are configured in the config.yml configuration file before adding the SMTP parameters to the file.

    • ntp_servers
    • ingress_vip
    • test_agent_gateway_vip
    • web_admin_user
    • web_admin_password
    content_copy zoom_out_map
    root@eop-primary> request paragon config
    Paragon inventory file saved at /epic/config/inventory
    Paragon config file saved at /epic/config/config.yml
    
  8. Deploy the SMTP configuration on the node.
    content_copy zoom_out_map
    root@eop-primary> request paragon deploy cluster input "-t addon-apps,papi -e target_components=papi-kafka-emitter,mailservice"
    Process running with PID: 2xxxxx2
    The deployment takes about two to three minutes to complete.
  9. (Optional) Monitor the progress of the deployment.
    content_copy zoom_out_map
    root@eop-primary> monitor start /epic/config/log
    After SMTP is enabled, when a superuser invites users to an organization, Paragon Automation sends e-mail invitations to the users. Paragon Automation also validates user accounts and notifies users of any modifications to their accounts through e-mails.

Disable SMTP Based User Management

To disable SMTP settings in Paragon Shell:

  1. SSH to the node on which you deployed the Paragon Automation cluster.
  2. Log in to Paragon Shell as the root user.
    You are placed in the operational mode.
  3. Enter the configuration mode.
    content_copy zoom_out_map
    root@eop-primary> configure
    Entering configuration mode
    
    [edit]
    
  4. Disable the SMTP-based user management configurations.
    content_copy zoom_out_map
    root@eop-primary# set paragon cluster mail-server smtp-enabled false
  5. Enable local user management.
    content_copy zoom_out_map
    root@eop-primary# set paragon cluster papi papi-local-user-management true
  6. Commit the changes and exit the configuration mode.
    content_copy zoom_out_map
    root@eop-primary# commit and-quit
    commit complete
    Exiting configuration mode
    
  7. Add the updated configuration parameters to the configuration files.
    Note:

    Ensure that the following parameters are configured in the config.yml configuration file before adding the SMTP parameters to the file.

    • ntp_servers
    • ingress_vip
    • test_agent_gateway_vip
    • web_admin_user
    • web_admin_password
    content_copy zoom_out_map
    root@eop-primary> request paragon config
    Paragon inventory file saved at /epic/config/inventory
    Paragon config file saved at /epic/config/config.yml
    
  8. Deploy the SMTP configuration on the node.
    content_copy zoom_out_map
    root@eop-primary> request paragon deploy cluster input "-t addon-apps,papi -e target_components=papi-kafka-emitter,mailservice"
    Process running with PID: 2xxxxx2
    The deployment takes about two to three minutes to complete.
    SMTP is disabled in Paragon Automation.
    Users will not be notified when their account is created, activated, or modified. After adding users to an organization, superusers must manually share the Web URL of Paragon Automation and credentials (e-mail ID and temporary password) to log in, with the users.
footer-navigation