Software AG Products 10.5 | Administering CentraSite | Configuring CentraSite | Configuring Email Server | Configuring Email Server Settings
 
Configuring Email Server Settings
Pre-requisites:
To configure the email server settings through the Command Line Interface, you must have the CentraSite Administrator role.
In addition, you must know the name (or IP address) of the email server that CentraSite is to use and the port number on which that server listens for SMTP requests. If the email server is configured to authenticate users, you must additionally provide the user ID and password that CentraSite is to use to log on to the server.
CentraSite provides a command tool named set Email for this purpose.
*To configure the email server settings
1. Create an XML configuration file (in Java XML properties format) with a set of predefined properties.
Example:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties version="1.0">
<entry key="com.centrasite.config.email.SMTPHost">localhost
</entry>
<entry key="com.centrasite.config.email.SMTPPort">25</entry>
<entry key="com.centrasite.config.email.ReplyTo">
noreply@editthisdomain.com
</entry>
<entry key="com.centrasite.config.email.ConnectionTimeout">20
</entry>
<entry key="com.centrasite.config.email.Authentication">false
</entry>
<entry key="com.centrasite.config.email.User">xyz
</entry>
<entry key="com.centrasite.config.email.Password">xyz
</entry>
<entry key="com.centrasite.config.email.TransportLayerSecurity">
false
</entry>
</properties>
The predefined properties are as follows:
In this property...
Specify...
SMTPHost
The name or IP address of the machine on which the SMTP server is running.
SMTPPort
The port on which the machine specified in SMTP Host listens for SMTP requests.
ReplyTo
The email address to which responses to the emails sent by CentraSite are to be directed.
CentraSite uses this address to populate the From email header in the emails that it sends.
ConnectionTimeout
The number of seconds that CentraSite waits for the email server to accept a connection request.
If the email server does not respond within the specified time period, CentraSite writes an error message to the console and discards the email.
Authentication
Whether the SMTP server authenticates users. Set Authentication to yes if authentication is enabled on the SMTP server.
If you set this field to yes, you must specify the appropriate log-on credentials in the User and Password fields below.
User
The user ID that CentraSite is to use to log on to the SMTP server.
This value is required only when Authentication is set to yes.
Password
The password that CentraSite is to use when it logs on to the SMTP server.
This value is required only when Authentication is set to yes.
TransportLayerSecurity
If true, enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection before issuing any login commands. Note that an appropriate trust store must be configured so that the client trusts the server's certificate. Defaults to false.
2. Run the command set Email.
The syntax is of the format: C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd set Email [-url <CENTRASITE-URL>] -user <USER-ID> -password <PASSWORD> -file <CONFIG-FILE>
The input parameters are:
Parameter
Description
CENTRASITE-URL
(Optional). The URL of the CentraSite registry. Default value is http://localhost:53307.
USER-ID
The user ID of a registered CentraSite user. For example, a user who has the CentraSite Administrator role.
PASSWORD
The password for the registered CentraSite user identified by the parameter USER-ID.
CONFIG-FILE
The absolute or relative path to the XML configuration file. If relative, the path should be relative to the location from where the command is executed.
Example (all in one line):
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd set Email -url http://localhost:53307/CentraSite/CentraSite -user Administrator -password manage -file config.xml
The response to this command could be:
Executing the command : set Email

Successfully executed the command : set Email