Configuring Email Server for NMIS Notifications including Gmail server
- Keith Sinclair (Deactivated)
- Paul McClendon (Unlicensed)
- José Iván Anguiano Reyes
- Hamilton Watkins (Unlicensed)
NMIS provides the capability to notify users when various events are detected. The main method of notification is using email, but many others are available.
Configuring Mail Server
To access the settings, from the menu access "System -> System Configuration -> NMIS Configuration"
From the configuration widget select "email"
The required configuration needs to be put in here:
Email Server Configuration Table
These are the options we have tested and recommend for various email servers.
| Configuration | Description | Regular SMTP Server | GMail SMTP Server | Office 365 SMTP Server |
|---|---|---|---|---|
| mail_combine | Do you want to combine emails for each email target? | true | ||
| mail_from | Email address you want to use for NMIS notifications | nmis@domain.com | ||
| mail_server | The mail FQDN or IP address | yourmailserver.domain.com | smtp.gmail.com | smtp.office365.com |
| mail_server_ipproto | Should we use IPv4 or IPv6 to connect (IPv6 will only | ipv4 | ipv4 | ipv4 |
| mail_server_port | The TCP port to use for connection | 25 | 587 | 587 |
| mail_use_tls | Should the TLS protocol be used | false | true | true |
| mail_use_sasl | Should the SASL protocol be used | false | false | false |
| mail_user | The username to login with, blank for nothing | youruser@gmail.com | youruser@office365.com | |
| mail_password | The password to login with, blank for nothing | yourpassword | yourpassword | |
| mail_domain | domain name to use for SMTP | domain.com | gmail.com | office365.com |
Testing Email Server Connection
Once you have configured your email server, it is best to test it. To begin, log in to your NMIS server:
NMIS8:
- Navigate to the admin directory – cd /usr/local/nmis8/admin/
- Run the testemail.pl file – ./testemail.pl
- this will send an email to the Contact configured as Contact1
- If there was any error you can debug it with ./testemail.pl debug=true
- Run the testemail.pl file – ./testemail.pl
NMIS9:
- Navigate to the admin directory – cd /usr/local/nmis9/admin
- Run the tests.pl file – ./tests.pl
- This will display a list of options to add to the command. Adding act = email will send a test email using the contact table. i.e ./tests.pl act= email
- If there was any error you can debug it with ./tests.pl debug=5
- Run the tests.pl file – ./tests.pl
If you don't have the file present in the directory indicated you can request support to help or grab file from GitHub
Github Instructions:
NMIS8.
- Navigate to the admin directory – cd /usr/local/nmis8/admin
- Issue the following cmd: "wget https://raw.githubusercontent.com/Opmantek/nmis8/nmis8_dev/admin/testemail.pl"
- This will drop the file testemail.pl to the admin directory
- You will need to change ownership and make executable with the cmd below
- chown nmis:nmis testemail.pl
- chmod 770 testemail.pl
NMIS9
- Navigate to the admin directory – cd /usr/local/nmis9/admin
- Issue the following cmd: "wget https://raw.githubusercontent.com/Opmantek/nmis9/nmis9_dev/admin/testemail.pl"
- This will drop the file testemail.pl to the admin directory
- You will need to change ownership and make executable with the cmd below
- chown nmis:nmis testemail.pl
- chmod 770 testemail.pl
GMAIL Issues:
If you still are having problems with testing email to your Contact1, please turn on option for Access for less secure apps, in the link https://support.google.com/accounts/answer/6010255
You will be able to see all the missing steps in you google accounts.
