MOI Configuration of Email Notification when SMTP user authentication is via IP address only

Products

• Mainframe Operational Intelligence

Issue/Introduction

You are using MOI in production and would like to start using email notifications. In this situation there is no SMTP user authentication required (mail server only verifies the source IP). However, in MOI the username and passwords are defined as mandatory fields for email notification. 

The resolution below details how to remove the user name and password from the SMTP authentication. 

Environment

Release: 2.0.05

Resolution

Code changes have been incorporated into the MOI 2.0.05 and higher releases to allow the SMTP IP only security to work. In addition, the following procedure has been developed to step the  through the process of removing the user id and password from the notification property file so that the SMTP IP only security will work.

Manual steps for changing email configuration after initial installation of  MOI release 2.0.05 and higher to remove the username and password values:

Username and password are mandatory fields while configuring MOI email notifications. If the SMTP server at your site does not authenticate username and password then you can set a temporary username and password in ISPF panels and edit configuration file to erase username and password. Below are the detailed steps to configure MOI email notifications without username and password after MOI 2.0.05 has been initially installed. 

 

To set temporary username and password in email configuration:

1. Navigate to MOI ISPF panel
2. Select option 1 - Install
3. Select the appliance name
4. Select option 4 - Notifications
5. Select option 1 - Configuration File
6. Specify temporary username and password
7. Press Enter to update the email configuration file
8. This message should be displayed - “Email Yaml created successfully"
9. Press PF3 to return to the MLSS Installation panel
10. Select option 8 - Deploy 
11. Select option 1 - Deploy Property Files 
12. This message should be displayed - "Property files copied"

To edit the username and password in email configuration:

1. Navigate to MOI ISPF panel
2. Select option 0 - Prepare
3. In Prepare panel, under directory paths section there is an SMPE path
4. Copy that SMPE path (SMPE path is usually in this format ${SMPE}/install/${APPLIANCE_NAME}/x86_64/properties/ )
5. Navigate to the ISPF unix directory listing panel (ISPF 3.17)
6. Paste the SMPE path you copied in step 4
7. Press Enter
8. Navigate to the properties directory for the appliance:
   1. Use the "L" line command to list the "install” directory
   2. Use the "L" line command to list directory for the appliance name
   3. Use the "L" line command to list the directory for the architecture (x86_64 or s390x)
   4. Use the "L" line command to list the "properties” directory

9. Use the "ea" line command to edit the email.yaml file
10. Erase the values for the username and password properties. Erase only the values. Be sure to keep the lines containing "username:" and "password:” 
11. Press PF3 to save the changes to the email.yaml file

To repackage the appliance properties file:

1. Go back to MOI ISPF panels
2. Select option 2 - Manage
3. Select the appliance name
4. Select option 9 - Advanced Commands
5. Select option 12 - Update
6. Select option 1 - Resend
7. Press PF3 to exit the log display
8. Select option 2 - Reboot

Please contact Broadcom Support if you have any questions/issues with this process.