Frequently Used Config Parameters in SAP HANA

Frequently Used Configuration Parameters in SAP HANA
SAP HANA Platform Software
Target Audience
Contents
1 Introduction ......................................................................................... 3
1.1 About This Document ............................................................................ 3
1.2 SAP HANA Guides ................................................................................. 3
2 Filename: global.ini ............................................................................. 4
Section: auditing_configuration ................................................................. 4
Section: communication .............................................................................. 4
Section: memorymanager ........................................................................... 5
Section: memoryobjects .............................................................................. 5
Section: persistence .................................................................................... 6
Section: public_hostname_resolution ..................................................... 10
3 Filename: indexserver.ini ................................................................. 11
Section: authentication.............................................................................. 11
Section: cache ............................................................................................ 11
Section: calcengine.................................................................................... 12
Section: distribution .................................................................................. 13
Section: joins .............................................................................................. 13
Section: mergedog ..................................................................................... 13
Section: parallel ......................................................................................... 14
Section: search .......................................................................................... 14
Section: session ......................................................................................... 15
Section: sql ................................................................................................. 17
Section: trace ............................................................................................. 18
4 Filename: nameserver.ini ................................................................. 19
Section: statisticsserver ............................................................................ 19
5 Filename: statisticsserver.ini ........................................................... 20
Section: memorymanager ......................................................................... 20
Section: statisticsserver_general ............................................................. 20
Important Disclaimers on Legal Aspects........................................... 21
Coding Samples ......................................................................................... 21
Accessibility ............................................................................................... 21
Gender-Neutral Language ......................................................................... 21
Internet Hyperlinks ..................................................................................... 21
Copyright .............................................................................................. 22
SAP HANA platform 2

1 Introduction
1.1 About This Document
This guide provides information about some of the main configurable parameters in SAP
HANA.
1.2 SAP HANA Guides

For more information about SAP HANA landscape, security, installation and administration,
see the SAP HANA platform page of SAP Help Portal at http://help.sap.com/hana_platform.
SAP HANA platform 3

2 Filename: global.ini
This configuration file describes global parameters for each service in the landscape.
Section: auditing_configuration
This section contains parameters that are related to auditing configuration.
Parameter: global_auditing_state
Description: Enables (true)/disables (false) global auditing

regardless of the enabled state of the audit
policies.
Values: true, false
Default: false
Restart required: No
Validity: SAP HANA revisions >= 13
Related information SAP Note 1991634
SAP HANA Security Guide (Auditing Activity)
Section: communication
This section contains parameters that are related to configuration of communications.
Parameter: listeninterface
Description: Specifies the network interface that the

processes listen on.
Values: .global, .internal, .local
Default: .global
Restart required: Yes
SAP HANA Administration Guide
Parameter: sslCreateSelfSignedCertificate
Description: Enables (true)/disables (false) the creation of a

self-signed certificate if the key store for external
communication cannot be found.
Values: true, false
Default: false
SAP HANA platform 4


Section: memorymanager
This section contains parameters that are related to configuration of memory management.
Parameter: global_allocation_limit
Description: Sets the explicit usable memory for the entire SAP
HANA system. When set to 0, the SAP HANA
system implicitly calculates a default value based
on the size of physical RAM.
Set an explicit value to use only a portion of
physical RAM.
Do not select an explicit value less than 58982,
which is 90% of 64 GB, or more than the
calculated default value. For details, see the SAP
HANA Administration Guide.
Values: Positive integer or zero
Explicit usable Memory in Megabytes or 0 for
implicit limit calculation.
Default: 0 (implicit limit calculation)
Restart required: No, since HANA revision 70
Section: memoryobjects
This section contains parameters that are related to configuration of memory objects.
Parameter: unload_lower_bound
Description: Sets a threshold for table size in bytes. When a

table exceeds this threshold, it is unloaded from
memory.
When set to 0, the SAP HANA system
automatically controls the unloading of memory
objects.
Example: 1.649.267.441.664 (1.5 TB)
Default: 0
SAP HANA platform 5


Parameter: unused_retention_period
Description: Sets a retention period in seconds to unload

memory objects that have not been used for the
specified period of time.
When set to 0, the SAP HANA system
automatically controls the unloading of memory
objects.
Do not select an explicit value less than 3600 (one
hour).
Recommended: 0, 3600 and larger
Default: 0
Section: persistence
This section contains parameters that are related to the configuration of data and log
locations as well as data and log backup.
Parameter: basepath_datavolumes
Description: Defines the absolute base file path for data volumes.
All data volumes will be stored under this file path.
Caution: Changing this parameter can cause loss of

data. Make sure you create a full system backup first.
Values: Absolute file path
Default: $(DIR_GLOBAL)/hdb/data

SAP Note 1900728
Parameter: basepath_logvolumes
SAP HANA platform 6

Description: Defines the absolute base file path for log volumes.
All log volumes will be stored under this file path.
Caution: Changing this parameter can cause loss of

data. Make sure you create a full system backup first.
Default: $(DIR_GLOBAL)/hdb/log

SAP Note 1900728
Parameter: enable_auto_log_backup
Description: Enables/disables automatic log backup of closed log

segments.
Values: yes, no
Default: yes
SAP HANA Administration Guide (About Log Backup)
Parameter: log_mode
Description: Sets the logging mode.
In normal mode, closed log segments are put

into the log segment backup queue.
In overwrite mode, log segments are freed
by the next savepoint.
In legacy mode, log segments are kept in the
log until a full backup has been executed.
Legacy mode is deprecated since SPS 03 and
has not been supported since SPS 07.
Values: normal
overwrite
legacy (deprecated as of SPS 03, not supported since
revision 70)
Default: normal
SAP HANA platform 7


Parameter: log_backup_timeout_s
Description: Sets log backup timeout in seconds (0 = disabled).
The log backup timeout specifies the maximum time

between a COMMIT until a log segment containing
the COMMIT is closed and put into the log segment
backup queue. Log segments can be closed before
they are completely filled.
When set to 0, log segments are only put into the log
segment queue when they are full or explicitly closed.
The log backup timeout depends on the Recovery

Point Objective (RPO). The RPO is the maximum
acceptable amount of data loss after an unplanned
data-loss incident, expressed as an amount of time.
Recommended: 300 and 3600.
Default: 900
Restart required: No. Changes take effect at the next log segment
switch.
Parameter: savepoint_interval_s
Description: Sets the savepoint interval in seconds.

The savepoint interval controls the frequency at
which savepoint operations are performed.
Recommended: 10 to 7200
Default: 300
SAP HANA Administration Guide (Persistent Data
Storage)
SAP HANA platform 8

Parameter: tablepreload_write_interval
Description: Sets the table preload write interval in seconds (0 =

disabled).
This parameter defines the time period at which table

preload information is collected and written to disk.
The table preload information comprises all column-

store table columns that are currently loaded into
memory.
The collected information is used as follows:

- When the table reload option is enabled, to load
table columns during SAP HANA system restart.
- In a system replication scenario, the table preload
information is collected on the primary site and
transferred to a secondary site.
When the table preload has been enabled on the

secondary site, the table preload information
determines the table columns to load into memory.
Default: 3600 (1h) for SAP HANA Revisions 54-69
86400 (1 day) since SAP HANA Revision 70
Related information SAP HANA Administration Guide (Starting and
Stopping)
SAP HANA Administration Guide (System Replication)
Parameter: use_mountpoints
Description: Includes (true)/excludes (false) mountpoint

directories in the file path of data and log volumes.
The mountpoint directories have the format
mntNNNNN, where NNNNN represents a 5-digit
number. The mountpoint directories are an
intermediate layer between the base file paths and
the volume directories hdbNNNNN.
Caution: Do not change this parameter unless the
reasons described in the Related information below
apply (see the SAP Notes).
Changing this parameter can cause loss of data. Make
sure you create a full system backup first.
Values: true, false
Default: true
SAP HANA platform 9


SAP Note 1820553
Section: public_hostname_resolution
This section specifies how internal hostnames are resolved to external names. External
names could be IP addresses, hostnames or fully qualified host names.
Parameter: use_default_route
Description: Defines one or more ways of resolving internal to

external hostnames for the default route:
ip = use ip address
name = use hostname
fqdn = use fully qualified hostname
ip,name,fqdn = use ip address, hostname, and fully
qualified hostname
no = use internal hostname
Values: ip, name, fqdn, no
Default: ip
SAP HANA Administration Guide (Mapping Host
Names for Database Client Access)
SAP HANA platform 10

3 Filename: indexserver.ini
Section: authentication
This section contains parameters that are related to cache configuration.
Parameter: SapLogonTicketTrustStore
Description: Absolute file path to the SAPLogon Ticket trust

store file, which must contain exactly one
certificate.
Caution: Do not use environment variables in the
file path.
Default: The SAP HANA system sequentially tests which
cryptographic service providers have been
installed.
1) If the cryptographic library CommonCryptoLib
has been found, the default value of this
parameter is $SECUDIR/saplogon.pse and the
trust store file must be encoded in PSE
format.
2) If the SAP Cryptographic library has been
detected, the default value is the same as
in 1).
3) If OpenSSL is used as cryptographic service
provider, the default value of this parameter
is HOME/.ssl/saplogon.pem and the trust
store file must be encoded in PEM format.
SAP HANA Security Guide (Securing Data
Communication)
Section: cache
This section contains parameters that are related to cache configuration.
Parameter: resultcache_enabled
Description: Enables (yes)/disables (no) the result cache.

Values: yes, no
Default: no


Parameter: enable_single_value_caching
Description: Enables (on)/disables (off) cache handling for

columns with one value.
Caution: Use this parameter only in the case
described in Related information below (see the
SAP Note).
Values: on, off
Default: on
Validity: SAP HANA revisions 70, 71 (temporary
workaround)
Section: calcengine
This section contains parameters that are related to calcengine configuration.
Parameter: max_cache_size_kb
Description: Used memory for calculation engine operations in

kilobytes.
Do not set a value less than the default.
Values: Positive integer
Recommended: 1048576 (1 GB), 4194304 (4 GB)
Default: 1048576 (1 GB)
Related information For SAP BW systems, apply:
SAP Note 1856131
SAP Note 1942407

Section: distribution
This section contains parameters that are related to client distribution configuration.
Parameter: client_distribution_mode
Description: Sets the client distribution mode.

Values: off: all distribution features are disabled.
connection: client side load balancing is enabled.
statement: statement routing is enabled.
all: all distribution features are enabled.
Default: statement
SAP Note 1745057
SAP Note 1774187
SAP Note 1785171
Section: joins
This section contains parameters that are related to Join Engine configuration.
Parameter: translator_cache_size
Description: Defines the maximum number of tables in the

JoinEngine translation table cache.
Translation tables are created for caching join
column entries of join engine queries.
Default: 2000
Section: mergedog
This section contains parameters that are related to mergedog configuration.
Parameter: active
Description: Switches automatic delta merge on (yes)/off (no)

Values: yes, no

Default: yes
Related information SAP HANA Administration Guide (the Delta Merge
Operation)
Section: parallel
This section contains parameters that are related to the configuration of parallel algorithms.
Parameter: mode
Description: Sets the mode for parallel processing in system

functions that use this parameter:
Values: Off: turns off parallel processing
Auto: lets the system functions decide to
use parallel processing or not
Force: turns on parallel processing
Default: Auto
Validity: SAP HANA Revisions >= 22
Parameter: tables_preloaded_in_parallel
Description: Sets the maximum number of tables that are

preloaded in parallel on system startup
Default: 5
Validity: SAP HANA Revisions >= 50
Section: search
This section contains parameters that are related to search configuration.
Parameter: late_materialization_threshold
Description: Sets the lowest number of rows for chunk-wise and

rowid-based processing of large data sets. This
processing mode is also called late materialization.
Default: 20000

Parameter: late_materialization_threshold_for_insert
Description: Sets the lowest number of rows for chunk-wise and

row-ID based processing of large data sets in insert
operations. This processing mode is also called late
materialization.
Default: 2000000
Section: session
This section contains parameters that are related to sessions.
Parameter: idle_connection_timeout
Description: Maximum duration of idle connections/sessions in

minutes (0 = disabled).
When set to a positive value, idle
connections/sessions will be disconnected and
associated resources released after the specified
duration has elapsed.
When set to 0, idle connections/sessions will not
be disconnected.
Default: 1440 (1 day)
Parameter: socket_keepalive
Description: Enables (on)/disables (off) monitoring of active

connections/sessions by means of keep-alive
probes. The monitoring may help to detect
network errors.
Values: on, off
Default: on

Parameter: tcp_keepalive_time
Description: Sets the time interval between the last packet sent
and the first keep-alive probe in seconds.
Recommended: 60
Default: 600
Validity: SAP HANA revisions > 60
Parameter: tcp_keepalive_intvl
Description: Sets the time interval between subsequent keep-

alive probes in seconds. If no acknowledgement
has been received to a previous keep-alive probe,
a subsequent keep-alive probe is sent after the
specified time interval.
Recommended: 1
Default: 10
Parameter: tcp_keepalive_probes
Description: Sets the number of unacknowledged keep-alive

probes to send before notifying the application
layer that the connection/session is not available
any more.
Recommended: 5
Default: 5

Section: sql
This section contains parameters that are related to sql query processing
Parameter: sql_executors
Description: Sets the maximum number of queries that can be

processed in parallel.
Default: Number of available CPU cores
Validity: SAP HANA revisions >=17
Parameter: plan_cache_size
Description: Sets the maximum size of the plan cache in bytes.

Recommended: at least 2147483648
Default: 2147483648
Parameter: reload_tables
Description: On system startup, enables (true)/disables (false)

automatic reload of tables that were loaded
before shutdown.
Values: true, false
Default: true

Section: trace
This section contains parameters that are related to tracing.
Parameter: python_output
Description: Enables (true)/disables (false) the redirection of

the output of embedded python scripts from
stdout and stderr to a trace file
<service>.python.log.
Values: true, false
Default: false

4 Filename: nameserver.ini
Section: statisticsserver
This section contains parameters that are related to the statistics server.
Parameter: active
Description: Enables (true)/disables (false) the new

embedded statistics server.
Values: true, false
Default: false (< SAP HANA Rev. 80)

5 Filename: statisticsserver.ini
Section: memorymanager
This section contains parameters that are related to the memory manager of the old stand-
alone statistics server.
Parameter: allocationlimit
Description: Sets an upper limit of memory usable by the

statistics server as a percentage of the global
allocation limit.
Caution: Do not forget the percentage
character %.
Values: 0% to 100% (in theory)
Recommended: 5% to 20%
Default: 5%
Section: statisticsserver_general
This section contains parameters that are related to the old stand-alone statistics server.
Parameter: active
Description: Turns on (true)/off (false) the collection of

monitoring data by the statistics server.
Values: true, false
Default: true

Important Disclaimers on Legal Aspects

This document is for informational purposes only. Its content is subject to change without
notice, and SAP does not warrant that it is error-free. SAP MAKES NO WARRANTIES,
EXPRESS OR IMPLIED, OR OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR
PURPOSE.
Coding Samples
Any software coding and/or code lines / strings ("Code") included in this documentation are
only examples and are not intended to be used in a productive system environment. The
Code is only intended to better explain and visualize the syntax and phrasing rules of certain
coding. SAP does not warrant the correctness and completeness of the Code given herein,
and SAP shall not be liable for errors or damages caused by the usage of the Code, unless
damages were caused by SAP intentionally or by SAP's gross negligence.
Accessibility
The information contained in the SAP documentation represents SAP's current view of
accessibility criteria as of the date of publication; it is in no way intended to be a binding
guideline on how to ensure accessibility of software products. SAP specifically disclaims any
liability with respect to this document and no contractual obligations or commitments are
formed either directly or indirectly by this document.
Gender-Neutral Language
As far as possible, SAP documentation is gender neutral. Depending on the context, the
reader is addressed directly with "you", or a gender-neutral noun (such as "sales person" or
"working days") is used. If when referring to members of both sexes, however, the third-
person singular cannot be avoided or a gender-neutral noun does not exist, SAP reserves the
right to use the masculine form of the noun and pronoun. This is to ensure that the
documentation remains comprehensible.
Internet Hyperlinks
The SAP documentation may contain hyperlinks to the Internet. These hyperlinks are
intended to serve as a hint about where to find related information. SAP does not warrant the
availability and correctness of this related information or the ability of this information to serve
a particular purpose. SAP shall not be liable for any damages caused by the use of related
information unless damages have been caused by SAP's gross negligence or willful
misconduct. Regarding link classification, see: http://help.sap.com/disclaimer.

Copyright
2014 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 or an SAP affiliate company. 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 or an SAP affiliate company for informational
purposes only, without representation or warranty of any kind, and SAP or its affiliated
companies shall not be liable for errors or omissions with respect to the materials. The only
warranties for SAP or SAP affiliate company 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 (or an SAP affiliate company) in
Germany and other countries. All other product and service names mentioned are the
trademarks of their respective companies.
Please see http://www.sap.com/corporate-en/legal/copyright/index.epx for additional
trademark information and notices.

Frequently Used Config Parameters in SAP HANA

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Frequently Used Config Parameters in SAP HANA

Hochgeladen von

Copyright:

Verfügbare Formate

Frequently Used Configuration Parameters in SAP HANA

SAP HANA Platform Software

Frequently Used Configuration Parameters in SAP HANA

SAP HANA platform 2

1.2 SAP HANA Guides

SAP HANA platform 3

Description: Enables (true)/disables (false) global auditing

Description: Specifies the network interface that the

Description: Enables (true)/disables (false) the creation of a

SAP HANA platform 4

Validity: SAP HANA revisions >= 70

Description: Sets a threshold for table size in bytes. When a

SAP HANA platform 5

Validity: SAP HANA revisions >= 70

Description: Sets a retention period in seconds to unload

Caution: Changing this parameter can cause loss of

Restart required: Yes

SAP HANA platform 6

Caution: Changing this parameter can cause loss of

Restart required: Yes

Description: Enables/disables automatic log backup of closed log

Description: Sets the logging mode.

In normal mode, closed log segments are put

SAP HANA platform 7

Related information SAP Note 1645183

Description: Sets log backup timeout in seconds (0 = disabled).

The log backup timeout specifies the maximum time

The log backup timeout depends on the Recovery

Description: Sets the savepoint interval in seconds.

SAP HANA platform 8

Description: Sets the table preload write interval in seconds (0 =

This parameter defines the time period at which table

The table preload information comprises all column-

The collected information is used as follows:

When the table preload has been enabled on the

Description: Includes (true)/excludes (false) mountpoint

SAP HANA platform 9

Restart required: Yes

Description: Defines one or more ways of resolving internal to

SAP HANA platform 10

Description: Absolute file path to the SAPLogon Ticket trust

Description: Enables (yes)/disables (no) the result cache.

SAP HANA platform 11

Related information SAP Note 1980765

Description: Enables (on)/disables (off) cache handling for

Description: Used memory for calculation engine operations in

SAP HANA platform 12

Description: Sets the client distribution mode.

Description: Defines the maximum number of tables in the

Description: Switches automatic delta merge on (yes)/off (no)

SAP HANA platform 13

Description: Sets the mode for parallel processing in system

Description: Sets the maximum number of tables that are

Description: Sets the lowest number of rows for chunk-wise and

SAP HANA platform 14

Description: Sets the lowest number of rows for chunk-wise and

Description: Maximum duration of idle connections/sessions in

Description: Enables (on)/disables (off) monitoring of active

SAP HANA platform 15

Description: Sets the time interval between subsequent keep-

Description: Sets the number of unacknowledged keep-alive

SAP HANA platform 16

Description: Sets the maximum number of queries that can be

Description: Sets the maximum size of the plan cache in bytes.