Create an SMTP Configuration

PDF download from SAP Help Portal:

http://help.sap.com/saphelp_hanaplatform/helpdata/en/e2/7c22ec14e14949b66053a4dcdb7570/content.htm

Created on December 15, 2016

The documentation may have changed since you downloaded the PDF. You can always find the latest information on SAP Help
Portal.

Note

This PDF document contains the selected topic and its subtopics (max. 150) in the selected structure. Subtopics from other structures are not included.

© 2016 SAP SE or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose
without the express permission of SAP SE. The information contained herein may be changed without prior notice. Some software products marketed by SAP
SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are
provided by SAP SE and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP
Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set
forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional
warranty. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE in
Germany and other countries. Please see www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.

Table of content

PUBLIC Page 1 of 5
© 2014 SAP SE or an SAP affiliate company. All rights reserved.
 Table of content
1 Create an SMTP Configuration
1.1 SMTP Configuration Details

PUBLIC Page 2 of 5
© 2014 SAP SE or an SAP affiliate company. All rights reserved.
 1 Create an SMTP Configuration
Define the settings an SAP HANA XS application uses for outbound connections to an SMTP server.

Prerequisites
SAP HANA uses roles to determine the level of access to the features provided by the SAP HANA XS Administration Tool . For example, to access the
SMTP Configuration tools that enable you to set up an SMTP server for SAP HANA XS applications, you must have the following roles assigned:
sap.hana.xs.admin.roles::RuntimeConfAdministrator
sap.hana.xs.admin.roles::SMTPDestAdministrator

Context
The SMTP configuration defines the details of the SMTP server that is available for use by all applications running on an SAP HANA XS server. You can
configure one SMTP server per SAP HANA XS server. As part of the configuration, you also specify what authentication type to use when establishing the
connection as well as the security type used to encrypt the transport channel between the SAP HANA XS server and the SMTP sever, for example, SSL or
TLS. To create an SMTP configuration for an SAP HANA XS application, perform the following steps:

Procedure
1. Start the SAP HANA XS Administration Tool .
The SAP HANA XS Administration Tool tool is available on the SAP HANA XS Web server at the following URL:
http:// <WebServerHost> :80 <SAPHANAinstance> /sap/hana/xs/admin/.

Note
In the default configuration, the URL redirects the request to a logon screen, which requires the credentials of an authenticated SAP HANA database
user to complete the logon process. The user who logs on must have the privileges required to perform administration tasks with the SMTP
Configurations tool.

2. Start the SMTP Configurations tool.

In the list of XS Administration tools, choose SMTP Configurations to display the screen where you can manage the configuration of the SMTP server
used by SAP HANA XS applications.

Note
You can configure only one SMTP server for each SAP HANA XS instance.

3. Specify details of the system hosting the SMTP server that the SAP HANA XS applications must use.
Provide the name of the system hosting the SMTP server and the port number required to open a connection. The default value for the port number is
25.

Note
If SSL or TLS is required to encrypt the transport channel, the port number will probably change, for example, to 465.

4. Specify the authentication settings required for access to the SMTP host.
Choose an authentication method from the Authentication Type drop-down list, for example, auto , logon , or none and, if necessary, the user
credentials required to log on to the SMTP server.

Tip
If you choose auto , setup checks the authentication mechanisms supported by the specified SMTP server and selects one in the following order of
preference: Digest-MD5 , CRAM-MD5 , Plain , Login , and None .

5. Specify the security settings for the transport-channel.

The transport channel is used for the communication between the SAP HANA XS application and the SMTP server. If you choose either the
STARTTLS or the SSL/TLS option, use the Trust Store drop-down list to specify the trust store where the certificates and keys for the SMTP sever
are located.

Note
If you choose the option None , the channel used to communicate with the SMTP relay server is not encrypted.

6. Define the timeout setting for connections to the specified SMTP server.
You can specify the maximum length of time (in milliseconds) that SAP HANA XS must wait for a response from the SMTP server with which it is trying
to establish a connection; the default value is 60000 milliseconds (1 minute).

Note
It the specified timeout limit is reached, the connection is reset and the application requesting the connection encounters an error.

7. Define the socket proxy settings.

If your system uses a proxy service for Socket Secure (SOCKS) routing, you need to enable support using the SOCKS Proxy toggle button ( ON ) and,
in addition, provide connection details for the system where the proxy service is running, for example, the host name, the port number to use for
connections, and the user credentials required to log on.

PUBLIC Page 3 of 5
© 2014 SAP SE or an SAP affiliate company. All rights reserved.
 Caution
The proxy-server settings you define here are overriden by any SAP HANA system wide setting for a proxy server, for example, defined by the
enforced_outbound_proxy parameter in the communication section of the xsengine.ini configuration file.

8. Save the changes you have made to the SMTP configuration.

Related Information
Maintaining SMTP Server Configurations
SMTP Configuration Details

1.1 SMTP Configuration Details

The SMTP configuration defines the details of the SMTP server that is available for use by all applications running on an SAP HANA XS server.
As part of the SMTP configuration, you specify the following options:
General SMTP settings
Logon authentication type
Transport security type
Socket proxy settings
Other settings

General SMTP settings

The General SMTP Settings screen area of the SMTP Configurations tool enables you to maintain the basic details of the system hosting the SMTP server
that SAP HANA XS applications use to send e-mail. The following table indicates which information can be maintained.

Table 1:

UI Element Description Example

Mail Server Host The name of the system hosting the SMTP server. localhost

Mail Server Port The port to connect to on the SMTP server; default is 25. 25

Authentication
The Authentication screen area of the SMTP Configurations tool enables you to maintain details of the user credentials required to log on to the system
hosting the SMTP server and the mechanism used during the logon process to carry out user authentication. The following table indicates which information
can be maintained.

Table 2:

UI Element Description Example

Authentication Type The method used by the SMTP server to authenticate the credentials of the user that None, Auto, Logon, Plain, CRAM-MD5,
SAP HANA uses to establish the connection or Digest-MD5.

Username For all authentication-type options except None , the name and password of the johndoe
user whose credentials SAP HANA XS uses to log on to the SMTP server.

Password For all authentication-type options except None , the password of the user whose *****
credentials SAP HANA XS uses to log on to the SMTP server.

Transport Security Settings

The Transport Security Settings screen area of the SMTP Configurations tool enables you to maintain details of the security type used to encrypt the
transport channel between the SAP HANA XS server and the SMTP server. The following table indicates which information can be maintained.

Table 3:

UI Element Description Example

Transport Security The method used by the SMTP server to authenticate the credentials of the user that None, STARTTLS, SSL/TLS
SAP HANA uses to establish the connection

Trust Store Contains the certificates used to establish trust relationships between servers, for sapspv.pse
example, SAP HANA XS and the SMTP server

Socket Proxy Settings

The Socket Proxy Settings screen area of the SMTP Configurations tool enables you to maintain details of the system hosting the proxy service used by
the SMTP server for Secure Socket (SOCKS) routing. The following table indicates which information can be maintained.

Table 4:

UI Element Description Example

SOCKS Proxy Enable/Disable Socket Secure (SOCKS) routing N/A

Proxy Host Name of the system hosting the proxy service for Socket Secure (SOCKS) routing smtp.host.acme.com

Proxy Port Port number to use for connections to the proxy server 1080

PUBLIC Page 4 of 5
© 2014 SAP SE or an SAP affiliate company. All rights reserved.
 Proxy Username Name of the user required to log on to the proxy server johndoe

Proxy Password Password for the user required to log on to the proxy server ****

Other Settings
The Other Settings screen area of the SMTP Configurations tool enables you to maintain additional details of the SMTP server, for example, the connection
timeout setting. The following table indicates which information can be maintained.

Table 5:
UI Element Description Example

Timeout Maximum length of time (in milliseconds) that SAP HANA XS must wait for a 60,000 milliseconds (1 minute)
response from the SMTP server with which it is trying to establish a connection

Related Information
Create an SMTP Configuration

PUBLIC Page 5 of 5
© 2014 SAP SE or an SAP affiliate company. All rights reserved.