Configure the Stages Server

E-mail Notifications

The Stages e-mail notification service informs Stages users about Process Release tasks. A Stages administrator gets informed about the result of regular background tasks like the CMS prefetch.

Before using this notification service, a few configuration parameters must be set in the $STAGES_CONF/config.xml configuration file.

Example: (STARTTLS)

<notification>
 <!-- URL of Stages server -->
 <serverurl>https://${general.external.hostname}/stages</serverurl>

 <!-- hostname of SMTP server where e-mail can be delivered -->
 <mailserver>mail.example.com</mailserver>
 <!-- server port; optional; default: 25 -->
 <mailserverport>587</mailserverport>
 <!-- use STARTTLS; optional; default: false -->
 <mailserverusestarttls>true</mailserverusestarttls>

 <!-- address that should be used as the "Reply-To:" header -->
 <replyto>noreply@yourdomain.com</replyto>

 <!--address that should be used as the "From:" header -->
 <sender>Stages Notification Service <noreply@yourdomain.com></sender>

</notification>

Example: (SMTPS)

<notification>
 <!-- URL of Stages server -->
 <serverurl>https://${general.external.hostname}/stages</serverurl>

 <!-- hostname of SMTP server where e-mail can be delivered -->
 <mailserver>mail.example.com</mailserver>
 <!-- server port; optional; default: 25 -->
 <mailserverport>465</mailserverport>
 <!-- use smtps (SSL); optional; default: smtp -->
 <mailserverprotocol>smtps</mailserverprotocol>

 <!-- address that should be used as the "Reply-To:" header -->
 <replyto>noreply@yourdomain.com</replyto>

 <!--address that should be used as the "From:" header -->
 <sender>Stages Notification Service <noreply@yourdomain.com></sender>

</notification>

Email Authentication

If the specified notification e-mail server requires user authentication, additional tags have to be inserted.

The following example describes such an authentication configuration:

<!—- username that should be used for authentication -->
<mailuser>${mailserver.username}</mailuser>

<!—- password to authenticate mailuser -->
<mailpassword>${mailserver.password}</mailpassword>

<!—- name of the SASL realm -->
<saslrealm>SASL.YOURDOMAIN.COM</saslrealm>

$STAGES_CONF/secret.properties

mailserver.username = John Doe
mailserver.password = secret