Source:How to Configure Mail Notification-Jaglion: Difference between revisions

From SEPsesam
m (Sta moved page How to configure Mail Notification to How to Configure Mail Notification without leaving a redirect: Part of translatable page "How to configure Mail Notification")
m (Jus moved page Source:How to Configure Mail Notification to Source:How to Configure Mail Notification-Jaglion without leaving a redirect: Part of translatable page "Source:How to Configure Mail Notification")
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<translate><!--T:1-->
<noinclude><languages />
<div class="noprint"><languages />
{{Copyright SEP AG en}}
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3/4.4.3 ''Beefalo'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|documentation archive]]}}</div></translate><br />
<translate>==Overview== <!--T:2--></translate>
<translate>==Overview== <!--T:2--></translate>
<div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 25%; "><center><b><translate><!--T:3-->
Additional resources</translate></b></center>


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
</noinclude><translate><!--T:40-->
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:4-->
SEP sesam offers two ways to send emails from the application: using the built-in email interface or a local email client. With integrated email interface you can send emails directly from the interface. To use the integrated email interface, [[#email|create an account]] with your mailbox credentials. 
[[File:SEP Tip.png|45px|link=Special:MyLanguage/4_4_3_Beefalo:Configuration#mail|Email settings and interfaces]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:5-->
See also: [[Special:MyLanguage/4_4_3_Beefalo:Configuration#mail|Email settings and interfaces]] – [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|Disaster interface]]</translate>
|}


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
<!--T:41-->
| rowspan="2" style="padding:0px 10px 0px;" |
In addition, you can configure to receive various email notifications from SEP sesam. SEP sesam provides email notification system, which uses a configured <tt>sesam</tt> mail account to connect to the mail server and send automated mail notifications from the configured mailbox.  
<translate><!--T:6-->
[[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
<translate><!--T:7-->
Check [[Special:MyLanguage/FAQ#encryption_and_compression|FAQ]] to find the answers to most common questions.</translate>
|}


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
<!--T:10-->
| rowspan="2" style="padding:0px 10px 0px;" | <translate><!--T:8-->
SEP sesam email notification system is based on [[Special:MyLanguage/SEP_sesam_Glossary#interfaces|''interface'']] scripts that have to be activated first. You can activate them via [[Special:MyLanguage/How_to_configure_Mail_Notification#interfaces|GUI]] or manually by [[Special:MyLanguage/How_to_configure_Mail_Notification#copy|copying]] the templates that are available in the SEP sesam directory {{path|<SESAM_ROOT>/skel/templates}}.  
[[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]]</translate>
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:9-->
Problems? Check the [[Special:MyLanguage/Troubleshooting_Guide| Troubleshooting Guide]].</translate>
|}</div>
<translate><!--T:10-->
SEP sesam email notification is based on [[Special:MyLanguage/SEP_sesam_Glossary#interfaces|''interface'']] scripts that has to be activated first. You can activate them via [[Special:MyLanguage/How_to_configure_Mail_Notification#interfaces|GUI]] or manually by [[Special:MyLanguage/How_to_configure_Mail_Notification#copy|copying]] the templates that are available in the SEP sesam directory {{path|<SESAM_ROOT>/skel/templates}}.
 
<!--T:11-->
SEP sesam interfaces require a [[Special:MyLanguage/How_to_configure_Mail_Notification#email|configured email account]] that is used for sending the selected notifications by email.  


<!--T:12-->
<!--T:12-->
Line 42: Line 18:
''Alarm'' is executed on the SEP sesam Server to warn the system administrator when a fatal error occurs or in case of a license violation.</translate>
''Alarm'' is executed on the SEP sesam Server to warn the system administrator when a fatal error occurs or in case of a license violation.</translate>
*<tt>'''sm_disaster'''</tt>: <translate><!--T:15-->
*<tt>'''sm_disaster'''</tt>: <translate><!--T:15-->
This interface must be properly configured to help carry out the disaster recovery process. For details on how to prepare, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]]. The disaster interface sends an email describing the recovery procedure in the event of a disaster and an attachment containing the SEP sesam bootstrap database with all essential data for the disaster recovery. sm_disaster is always called after the task ''SESAM_BACKUP'' is finished.
''Disaster'' must be properly configured to help carry out the disaster recovery process. For details on how to prepare, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]]. The disaster interface sends an email describing the recovery procedure in the event of a disaster and an attachment containing the SEP sesam bootstrap database with all essential data for the disaster recovery. <tt>sm_disaster</tt> is always called after the task ''SESAM_BACKUP'' is finished.</translate>


=={{anchor|interfaces}}Configuring interfaces== <!--T:16-->
=={{anchor|interfaces}}<translate><!--T:16-->
Configuring interfaces==


<!--T:17-->
<!--T:17-->
The interface templates are located in the SEP sesam directory {{path|<SESAM_ROOT>/skel/templates}}. You can activate them automatically via GUI or manually by copying them.
The interface templates are located in the SEP sesam directory {{path|<SESAM_ROOT>/skel/templates}}. You can activate them automatically via GUI or manually by copying them.</translate>


==={{anchor|GUI}}Activating ''interfaces'' via SEP sesam GUI=== <!--T:18--></translate>
==={{anchor|GUI}}<translate><!--T:18--> Activating ''interfaces'' via SEP sesam GUI</translate>===
<ol><li><translate><!--T:19-->
<ol><li><translate><!--T:19-->
From '''Configuration''' -> '''Interfaces''', select the relevant interface type (''Alarm'', ''Disaster'' or ''Notify''), depending on which information you want to receive.</translate></li>
From '''Configuration''' -> '''Interfaces''', select the relevant interface type (''Alarm'', ''Disaster'' or ''Notify''), depending on which information you want to receive.</translate></li>
{{<translate><!--T:20-->
{{note|<translate><!--T:21-->
note</translate>|<translate><!--T:21-->
The ''Disaster'' interface should always be configured to help carry out the disaster recovery process in case of a SEP sesam Server breakdown.  This means that you have to configure at least one backup task with the name ''SESAM_BACKUP''. For details, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery#preparation|SEP sesam Server Disaster Recovery]].</translate>}}  
The ''Disaster'' interface should always be configured to help carry out the disaster recovery process in case of a SEP sesam Server breakdown.  This means that you have to configure at least one backup task with the name ''SESAM_BACKUP''. For details, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery#preparation|SEP sesam Server Disaster Recovery]].</translate>}}  


<translate><!--T:22-->
<translate><!--T:22-->
[[Image:Configuration_interfaces.png|link=]]</translate>
[[Image:Configuration_interfaces_Apollon.jpg|850px|link=]]</translate>
<br clear=all>
<br clear=all>
<li><translate><!--T:23-->
<li><translate><!--T:23-->
Window with the ''interface script'' opens. Click '''Save'''  to activate the interface.</translate></li>
Window with the ''interface script'' opens. Click '''Save'''  to activate the interface.</translate></li>
<translate><!--T:24-->
<translate><!--T:24-->
[[Image:Alarm_interface.png|link=]]</translate>
[[Image:Alarm_interface_Apollon.jpg|500px|link=]]</translate>
<br clear=all>   
<br clear=all>   
</ol>
</ol>
<translate><!--T:25-->
<translate><!--T:25-->
Upon saving the template script is read and copied to the {{path|<SESAM_ROOT>/bin/sesam}}. You can customize the script according to your needs. Now you have to configure an [[Special:MyLanguage/How_to_configure_Mail_Notification#email|email account]] to enable sending the selected notifications by email.
The template script is read and copied to the {{path|<SESAM_ROOT>/bin/sesam}}. You can customize the script according to your needs. Now you have to configure an [[Special:MyLanguage/How_to_configure_Mail_Notification#email|email account]] to enable sending the selected notifications by email.</translate>


==={{anchor|copy}}Activating interfaces manually=== <!--T:26-->
==={{anchor|copy}}<translate><!--T:26-->
Activating ''interfaces'' manually===


<!--T:27-->
<!--T:27-->
Line 82: Line 59:
Note that on Windows, all interfaces/commands have the ending <tt>.cmd</tt> or <tt>.ps1</tt> when using Powershell.
Note that on Windows, all interfaces/commands have the ending <tt>.cmd</tt> or <tt>.ps1</tt> when using Powershell.
To activate the interfaces, copy the selected interfaces manually to {{path|<SESAM_ROOT>/bin/sesam}}.</translate>  
To activate the interfaces, copy the selected interfaces manually to {{path|<SESAM_ROOT>/bin/sesam}}.</translate>  
{{<translate><!--T:30-->
{{note|<translate><!--T:31-->
note</translate>|<translate><!--T:31-->
The ''Disaster'' interface should always be configured to help perform the disaster recovery process in case of a SEP sesam Server breakdown.  This means that you have to configure at least one backup task with the name ''SESAM_BACKUP''. For details, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery#preparation|SEP sesam Server Disaster Recovery]].</translate>}}  
The ''Disaster'' interface should always be configured to help carry out the disaster recovery process in case of a SEP sesam Server breakdown.  This means that you have to configure at least one backup task with the name ''SESAM_BACKUP''. For details, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery#preparation|SEP sesam Server Disaster Recovery]].</translate>}}  
<translate><!--T:32-->
<translate><!--T:32-->
Now you have to configure an [[Special:MyLanguage/How_to_configure_Mail_Notification#email|email account]] to enable sending the selected notifications by email.
Now you have to configure an [[Special:MyLanguage/How_to_configure_Mail_Notification#email|email account]] to enable sending the selected notifications by email.</translate>
 
=={{anchor|email}}<translate><!--T:33-->
Configuring email account and recipients==
 
<!--T:42-->
To send emails from the application, you can use either a local email client or the integrated SEP sesam email interface. To use the integrated email interface create a mail account following the procedure described below. You can also create multiple mail accounts based on your requirements. Each account specifies the sender email and the list of recipients, which can be customized for specific emails.


=={{anchor|email}}Configuring email account and recipients== <!--T:33--></translate>
<!--T:43-->
This procedure describes how to set up a the default <tt>sesam</tt> account that is required by the SEP sesam notifications. You can use a different account name to create a custom account.</translate>
<ol><li><translate><!--T:34-->
<ol><li><translate><!--T:34-->
From '''Configuration''' -> '''E-mail Settings''', select '''Use Sesam mail program''' option and click '''New'''.</translate></li>
From '''Configuration''' -> '''Email Settings''', select '''Use SEP sesam mail program''' option and click '''New'''.</translate></li>
<translate><!--T:35-->
<translate><!--T:35-->
[[Image:Email_account.png|link=]]</translate>
[[Image:Email_account_Apollon.jpg|700px|link=]]</translate>
<br clear=all>
<br clear=all>
<li><translate><!--T:36-->
<li><translate><!--T:36-->
The ''E-mail Account'' window opens. Use the account name '''sesam''' (the default email account) as shown in the example below, and enter the email addresses of the recipients. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Configuration#mail|Email settings]].</translate></li>
The ''Email Account'' window opens. Use the account name '''sesam''' (all lowercase) as shown in the example below, and enter the information as required: </translate>
*<translate><!--T:44--> '''''Account''''': Name of the account (mandatory)</translate>
*<translate><!--T:45--> '''''Customer''''': Name of the customer</translate>
*<translate><!--T:46--> '''''Sender''''': Email address of the sender</translate>
*<translate><!--T:47--> '''''SMTP server''''': Name or IP address of the outgoing mail server</translate>
*<translate><!--T:48--> '''''SMTP user''''': User name for SMTP server</translate>
*<translate><!--T:49--> '''''Password''''': Password for the mail server. Password is mandatory if SMTP server requires authentication.</translate>
*<translate><!--T:50--> '''''SMTP port''''': Optionally, specify the SMTP port.</translate>
*<translate> <!--T:51--> '''''Recipient''''': Email address of the recipient</translate>
*<translate><!--T:52--> '''''CC''''': Email address for copy of the email</translate>
*<translate><!--T:53--> '''''BCC''''': Email address for hidden copy of the email</translate>
*<translate><!--T:54--> '''''SSL''''': Optionally, you can select encryption type to connect securely via SSL or TLS.</translate>
<translate><!--T:55--> If no SMTP user name is specified, it is assumed that no authorization is required at the SMTP server.</translate></li>
<translate><!--T:37-->
<translate><!--T:37-->
[[Image:Configuring_email_account.png|link=]]</translate>
[[Image:Configuring_email_account_Apollon.jpg|500px|link=]]</translate>
<br clear=all>
<br clear=all>
<li><translate><!--T:38-->
<li><translate><!--T:38-->
Line 103: Line 98:
</ol>
</ol>


<translate><div class="noprint">
<noinclude><div class="noprint">{{Copyright}}</div></noinclude>
==See also== <!--T:39-->
[[Special:MyLanguage/4_4_3_Beefalo:Configuration#mail|Email settings and interfaces]] – [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|Disaster interface]]</div></translate>

Latest revision as of 10:26, 22 March 2024

Other languages:

Overview

SEP sesam offers two ways to send emails from the application: using the built-in email interface or a local email client. With integrated email interface you can send emails directly from the interface. To use the integrated email interface, create an account with your mailbox credentials.

In addition, you can configure to receive various email notifications from SEP sesam. SEP sesam provides email notification system, which uses a configured sesam mail account to connect to the mail server and send automated mail notifications from the configured mailbox.

SEP sesam email notification system is based on interface scripts that have to be activated first. You can activate them via GUI or manually by copying the templates that are available in the SEP sesam directory <SESAM_ROOT>/skel/templates.

The following interfaces exist:

  • sm_notify: Notify is executed on the SEP sesam Server. It can be used for reporting on successfully finished events, such as backup, restore, migration, media initialization, and start/finish of a NEWDAY event.
  • sm_alarm: Alarm is executed on the SEP sesam Server to warn the system administrator when a fatal error occurs or in case of a license violation.
  • sm_disaster: Disaster must be properly configured to help carry out the disaster recovery process. For details on how to prepare, see SEP sesam Server Disaster Recovery. The disaster interface sends an email describing the recovery procedure in the event of a disaster and an attachment containing the SEP sesam bootstrap database with all essential data for the disaster recovery. sm_disaster is always called after the task SESAM_BACKUP is finished.

Configuring interfaces

The interface templates are located in the SEP sesam directory <SESAM_ROOT>/skel/templates. You can activate them automatically via GUI or manually by copying them.

Activating interfaces via SEP sesam GUI

  1. From Configuration -> Interfaces, select the relevant interface type (Alarm, Disaster or Notify), depending on which information you want to receive.
  2. Information sign.png Note
    The Disaster interface should always be configured to help carry out the disaster recovery process in case of a SEP sesam Server breakdown. This means that you have to configure at least one backup task with the name SESAM_BACKUP. For details, see SEP sesam Server Disaster Recovery.

    Configuration interfaces Apollon.jpg

  3. Window with the interface script opens. Click Save to activate the interface.
  4. Alarm interface Apollon.jpg

The template script is read and copied to the <SESAM_ROOT>/bin/sesam. You can customize the script according to your needs. Now you have to configure an email account to enable sending the selected notifications by email.

Activating interfaces manually

Alternatively, you can activate the interfaces by copying the existing templates from the SEP sesam directory <SESAM_ROOT>/skel/templates to the directory <SESAM_ROOT>/bin/sesam. You can customize the script according to your needs.

By default, the interfaces are located in the SEP sesam <SESAM_ROOT>/skel/templates under the names:

sm_notify
sm_alarm
sm_disaster

Note that on Windows, all interfaces/commands have the ending .cmd or .ps1 when using Powershell. To activate the interfaces, copy the selected interfaces manually to <SESAM_ROOT>/bin/sesam.

Information sign.png Note
The Disaster interface should always be configured to help perform the disaster recovery process in case of a SEP sesam Server breakdown. This means that you have to configure at least one backup task with the name SESAM_BACKUP. For details, see SEP sesam Server Disaster Recovery.

Now you have to configure an email account to enable sending the selected notifications by email.

Configuring email account and recipients

To send emails from the application, you can use either a local email client or the integrated SEP sesam email interface. To use the integrated email interface create a mail account following the procedure described below. You can also create multiple mail accounts based on your requirements. Each account specifies the sender email and the list of recipients, which can be customized for specific emails.

This procedure describes how to set up a the default sesam account that is required by the SEP sesam notifications. You can use a different account name to create a custom account.

  1. From Configuration -> Email Settings, select Use SEP sesam mail program option and click New.
  2. Email account Apollon.jpg
  3. The Email Account window opens. Use the account name sesam (all lowercase) as shown in the example below, and enter the information as required:
    • Account: Name of the account (mandatory)
    • Customer: Name of the customer
    • Sender: Email address of the sender
    • SMTP server: Name or IP address of the outgoing mail server
    • SMTP user: User name for SMTP server
    • Password: Password for the mail server. Password is mandatory if SMTP server requires authentication.
    • SMTP port: Optionally, specify the SMTP port.
    • Recipient: Email address of the recipient
    • CC: Email address for copy of the email
    • BCC: Email address for hidden copy of the email
    • SSL: Optionally, you can select encryption type to connect securely via SSL or TLS.
    If no SMTP user name is specified, it is assumed that no authorization is required at the SMTP server.
  4. Configuring email account Apollon.jpg
  5. Click Send Test Email to check if your email account is configured properly, and then click OK.
Copyright © SEP AG 1999-2024. All rights reserved.
Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.