You are on page 1of 22

Frequently Used Configuration Parameters in SAP HANA

 SAP HANA Platform Software

Target Audience


Frequently Used Configuration Parameters in SAP HANA

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

SAP HANA platform 3 . installation and administration.Frequently Used Configuration Parameters in SAP HANA 1 Introduction 1. 1.1 About This Document This guide provides information about some of the main configurable parameters in SAP HANA.com/hana_platform. see the SAP HANA platform page of SAP Help Portal at http://help. security.sap.2 SAP HANA Guides For more information about SAP HANA landscape.

Parameter: listeninterface Description: Specifies the network interface that the processes listen on. false Default: false Restart required: Yes SAP HANA platform 4 . . Values: .internal.local Default: . Parameter: global_auditing_state Description: Enables (true)/disables (false) global auditing regardless of the enabled state of the audit policies. Values: true.global.ini This configuration file describes global parameters for each service in the landscape. Values: true.global Restart required: Yes Validity: SAP HANA revisions >= 45 Related information SAP Note 1999797 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. 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. . Section: auditing_configuration This section contains parameters that are related to auditing configuration.Frequently Used Configuration Parameters in SAP HANA 2 Filename: global.

Values: Positive integer or zero Explicit usable Memory in Megabytes or 0 for implicit limit calculation. When set to 0.Frequently Used Configuration Parameters in SAP HANA Validity: SAP HANA revisions >= 70 Related information SAP Note 1891055 Section: memorymanager This section contains parameters that are related to configuration of memory management. which is 90% of 64 GB. Parameter: global_allocation_limit Description: Sets the explicit usable memory for the entire SAP HANA system. Parameter: unload_lower_bound Description: Sets a threshold for table size in bytes.649. it is unloaded from memory. When set to 0. Do not select an explicit value less than 58982.5 TB) Default: 0 Restart required: No SAP HANA platform 5 . since HANA revision 70 Validity: SAP HANA revisions >= 70 Related information SAP Note 1984422 SAP HANA Administration Guide Section: memoryobjects This section contains parameters that are related to configuration of memory objects. Values: Positive integer or zero Example: 1. When a table exceeds this threshold.441. or more than the calculated default value. see the SAP HANA Administration Guide. 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. Default: 0 (implicit limit calculation) Restart required: No. For details.664 (1.267. the SAP HANA system automatically controls the unloading of memory objects.

Parameter: basepath_datavolumes Description: Defines the absolute base file path for data volumes. Values: Positive integer or zero Recommended: 0. the SAP HANA system automatically controls the unloading of memory objects. Make sure you create a full system backup first. All data volumes will be stored under this file path. Do not select an explicit value less than 3600 (one hour). 3600 and larger Default: 0 Restart required: No Validity: SAP HANA revisions >= 70 Related information SAP Note 1999797 SAP HANA Administration Guide Section: persistence This section contains parameters that are related to the configuration of data and log locations as well as data and log backup. When set to 0.Frequently Used Configuration Parameters in SAP HANA Validity: SAP HANA revisions >= 70 Related information SAP Note 1993128 SAP HANA Administration Guide 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. Values: Absolute file path Default: $(DIR_GLOBAL)/hdb/data Restart required: Yes Validity: SAP HANA revisions >= 13 Related information SAP Note 1766708 SAP Note 1900728 Parameter: basepath_logvolumes SAP HANA platform 6 . Caution: Changing this parameter can cause loss of data.

 In overwrite mode.  In normal mode. Make sure you create a full system backup first. not supported since revision 70) Default: normal Restart required: Yes Validity: SAP HANA revisions >= 13 SAP HANA platform 7 . Caution: Changing this parameter can cause loss of data. closed log segments are put into the log segment backup queue.Frequently Used Configuration Parameters in SAP HANA Description: Defines the absolute base file path for log volumes. Values: normal overwrite legacy (deprecated as of SPS 03. no Default: yes Restart required: Yes Validity: SAP HANA revisions >= 13 Related information SAP Note 1645183 SAP HANA Administration Guide (About Log Backup) Parameter: log_mode Description: Sets the logging mode. log segments are kept in the log until a full backup has been executed. Values: yes. Legacy mode is deprecated since SPS 03 and has not been supported since SPS 07. log segments are freed by the next savepoint.  In legacy mode. All log volumes will be stored under this file path. Values: Absolute file path Default: $(DIR_GLOBAL)/hdb/log Restart required: Yes Validity: SAP HANA revisions >= 13 Related information SAP Note 1766708 SAP Note 1900728 Parameter: enable_auto_log_backup Description: Enables/disables automatic log backup of closed log segments.

Default: 900 Restart required: No. When set to 0.Frequently Used Configuration Parameters in SAP HANA Related information SAP Note 1645183 SAP HANA Administration Guide (About Log Backup) Parameter: log_backup_timeout_s Description: Sets log backup timeout in seconds (0 = disabled). Values: Positive integer or zero Recommended: 300 … and 3600. 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. The RPO is the maximum acceptable amount of data loss after an unplanned data-loss incident. expressed as an amount of time. Changes take effect at the next log segment switch. The log backup timeout depends on the Recovery Point Objective (RPO). log segments are only put into the log segment queue when they are full or explicitly closed. Log segments can be closed before they are completely filled. Values: Positive integer or zero Recommended: 10 to 7200 Default: 300 Restart required: Yes Validity: SAP HANA revisions >= 13 Related information SAP Note 1898505 SAP HANA Administration Guide (Persistent Data Storage) SAP HANA platform 8 . Validity: SAP HANA revisions >= 13 Related information SAP Note 1645183 SAP HANA Administration Guide (About Log Backup) Parameter: savepoint_interval_s Description: Sets the savepoint interval in seconds. The savepoint interval controls the frequency at which savepoint operations are performed.

When the table reload option is enabled. to load table columns during SAP HANA system restart. The table preload information comprises all column- store table columns that are currently loaded into memory. Caution: Do not change this parameter unless the reasons described in the “Related information” below apply (see the SAP Notes). The collected information is used as follows: . where NNNNN represents a 5-digit number. the table preload information determines the table columns to load into memory. the table preload information is collected on the primary site and transferred to a secondary site. false Default: true SAP HANA platform 9 . This parameter defines the time period at which table preload information is collected and written to disk. . When the table preload has been enabled on the secondary site. The mountpoint directories are an intermediate layer between the base file paths and the volume directories hdbNNNNN.In a system replication scenario. Make sure you create a full system backup first.Frequently Used Configuration Parameters in SAP HANA Parameter: tablepreload_write_interval Description: Sets the table preload write interval in seconds (0 = disabled). Values: true. The mountpoint directories have the format mntNNNNN. Changing this parameter can cause loss of data. Values: Positive integer or zero Default: 3600 (1h) for SAP HANA Revisions 54-69 86400 (1 day) since SAP HANA Revision 70 Restart required: No Validity: SAP HANA revisions >= 54 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.

and fully qualified hostname no = use internal hostname Values: ip. name. fqdn. hostname. no Default: ip Restart required: Yes Validity: SAP HANA revisions >= 54 Related information SAP Note 1906381 SAP HANA Administration Guide (Mapping Host Names for Database Client Access) SAP HANA platform 10 .name. 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.fqdn = use ip address. External names could be IP addresses.Frequently Used Configuration Parameters in SAP HANA Restart required: Yes Validity: SAP HANA revisions >= 17 Related information SAP Note 1809453 SAP Note 1820553 Section: public_hostname_resolution This section specifies how internal hostnames are resolved to external names.

ini Section: authentication This section contains parameters that are related to cache configuration. the default value of this parameter is HOME/.Frequently Used Configuration Parameters in SAP HANA 3 Filename: indexserver. Values: yes. Restart required: Yes Validity: SAP HANA revisions >= 45 Related information SAP Note 1927949 SAP HANA Security Guide (Securing Data Communication) Section: cache This section contains parameters that are related to cache configuration. 3) If OpenSSL is used as cryptographic service provider.pse and the trust store file must be encoded in PSE format. which must contain exactly one certificate. 1) If the cryptographic library CommonCryptoLib has been found.pem and the trust store file must be encoded in PEM format. the default value of this parameter is $SECUDIR/saplogon. Caution: Do not use environment variables in the file path. Parameter: resultcache_enabled Description: Enables (yes)/disables (no) the result cache. no Default: no Restart required: No Validity: SAP HANA revisions >= 13 SAP HANA platform 11 . Values: Absolute file path Default: The SAP HANA system sequentially tests which cryptographic service providers have been installed. Parameter: SapLogonTicketTrustStore Description: Absolute file path to the SAPLogon Ticket trust store file. the default value is the same as in 1). 2) If the SAP Cryptographic library has been detected.ssl/saplogon.

off Default: on Restart required: No Validity: SAP HANA revisions 70.Frequently Used Configuration Parameters in SAP HANA Related information SAP Note 1980765 Parameter: enable_single_value_caching Description: Enables (on)/disables (off) cache handling for columns with one value. 71 (temporary workaround) Related information SAP Note 1980765 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. apply: SAP Note 1856131 SAP Note 1942407 SAP HANA platform 12 . Values: on. Caution: Use this parameter only in the case described in “Related information” below (see the SAP Note). 4194304 (4 GB) Default: 1048576 (1 GB) Restart required: No Validity: SAP HANA revisions >= 32 Related information For SAP BW systems. Values: Positive integer Recommended: 1048576 (1 GB).

connection: client side load balancing is enabled. Default: statement Restart required: Yes Validity: SAP HANA revisions >= 26 Related information SAP Note 1743225 SAP Note 1745057 SAP Note 1774187 SAP Note 1785171 Section: joins This section contains parameters that are related to Join Engine configuration. Values: Positive integer Default: 2000 Restart required: Yes Validity: SAP HANA revisions >= 70 Related information SAP Note 1840954 Section: mergedog This section contains parameters that are related to mergedog configuration. Parameter: translator_cache_size Description: Defines the maximum number of tables in the JoinEngine translation table cache. Values: off: all distribution features are disabled. no SAP HANA platform 13 . statement: statement routing is enabled.Frequently Used Configuration Parameters in SAP HANA Section: distribution This section contains parameters that are related to client distribution configuration. Translation tables are created for caching join column entries of join engine queries. Parameter: active Description: Switches automatic delta merge on (yes)/off (no) Values: yes. all: all distribution features are enabled. Parameter: client_distribution_mode Description: Sets the client distribution mode.

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 Restart required: No 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 Values: Positive integer Default: 5 Restart required: Yes Validity: SAP HANA Revisions >= 50 Section: search This section contains parameters that are related to search configuration. This processing mode is also called late materialization. Values: Positive integer Default: 20000 SAP HANA platform 14 .Frequently Used Configuration Parameters in SAP HANA Default: yes Restart required: Yes Validity: SAP HANA revisions >= 13 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: late_materialization_threshold Description: Sets the lowest number of rows for chunk-wise and rowid-based processing of large data sets.

idle connections/sessions will be disconnected and associated resources released after the specified duration has elapsed. Values: Positive integer Default: 2000000 Restart required: No Validity: SAP HANA revisions >= 20 Related information SAP Note 1975448 Section: session This section contains parameters that are related to sessions. This processing mode is also called late materialization. Values: on. Values: Positive integer or zero Default: 1440 (1 day) Restart required: Yes Validity: SAP HANA revisions >= 52 Related information SAP Note 1836774 Parameter: socket_keepalive Description: Enables (on)/disables (off) monitoring of active connections/sessions by means of keep-alive probes.Frequently Used Configuration Parameters in SAP HANA Restart required: No Validity: SAP HANA revisions >= 13 Related information SAP Note 1975448 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. When set to a positive value. Parameter: idle_connection_timeout Description: Maximum duration of idle connections/sessions in minutes (0 = disabled). The monitoring may help to detect network errors. When set to 0. idle connections/sessions will not be disconnected. off Default: on SAP HANA platform 15 .

Values: Positive integer Recommended: 5 Default: 5 Restart required: No Validity: SAP HANA revisions >= 60 Related information SAP Note 1836774 SAP HANA platform 16 . Values: Positive integer Recommended: 60 Default: 600 Restart required: No Validity: SAP HANA revisions > 60 Related information SAP Note 1836774 Parameter: tcp_keepalive_intvl Description: Sets the time interval between subsequent keep- alive probes in seconds.Frequently Used Configuration Parameters in SAP HANA Restart required: No Validity: SAP HANA revisions >= 60 Related information SAP Note 1836774 Parameter: tcp_keepalive_time Description: Sets the time interval between the last packet sent and the first keep-alive probe in seconds. Values: Positive integer Recommended: 1 Default: 10 Restart required: No Validity: SAP HANA revisions >= 60 Related information SAP Note 1836774 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. a subsequent keep-alive probe is sent after the specified time interval. If no acknowledgement has been received to a previous keep-alive probe.

Frequently Used Configuration Parameters in SAP HANA 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. false Default: true Restart required: No Validity: SAP HANA revisions >= 52 Related information SAP Note 1889081 SAP HANA platform 17 . Values: Positive integer Default: Number of available CPU cores Restart required: No Validity: SAP HANA revisions >=17 Related information SAP Note 1763592 Parameter: plan_cache_size Description: Sets the maximum size of the plan cache in bytes. Values: Positive integer Recommended: at least 2147483648 Default: 2147483648 Restart required: No Validity: SAP HANA revisions >= 70 Related information SAP Note 1763592 Parameter: reload_tables Description: On system startup. enables (true)/disables (false) automatic reload of tables that were loaded before shutdown. Values: true.

false Default: false Restart required: Yes Validity: SAP HANA revisions >= 50 Related information SAP Note 1888573 SAP HANA platform 18 . Values: true.python.Frequently Used Configuration Parameters in SAP HANA Section: trace This section contains parameters that are related to tracing.log. 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>.

Frequently Used Configuration Parameters in SAP HANA 4 Filename: nameserver. 80) Restart required: No Validity: SAP HANA revisions >= 74 Related information SAP Note 1925684 SAP HANA platform 19 . Parameter: active Description: Enables (true)/disables (false) the new embedded statistics server.ini Section: statisticsserver This section contains parameters that are related to the statistics server. Values: true. false Default: false (< SAP HANA Rev.

Parameter: active Description: Turns on (true)/off (false) the collection of monitoring data by the statistics server.Frequently Used Configuration Parameters in SAP HANA 5 Filename: statisticsserver. Caution: Do not forget the percentage character %.ini Section: memorymanager This section contains parameters that are related to the memory manager of the “old” stand- alone statistics server. false Default: true Restart required: No Validity: SAP HANA revisions >= 70 SAP HANA platform 20 . Values: 0% to 100% (in theory) Recommended: 5% to 20% Default: 5% Restart required: No Validity: SAP HANA revisions >= 26 Section: statisticsserver_general This section contains parameters that are related to the “old” stand-alone statistics server. Values: true. Parameter: allocationlimit Description: Sets an upper limit of memory usable by the statistics server as a percentage of the global allocation limit.

SAP HANA platform 21 . and SAP shall not be liable for errors or damages caused by the usage of the Code. Accessibility The information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication. 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. and SAP does not warrant that it is error-free. Regarding link classification.sap. OR FITNESS FOR A PARTICULAR PURPOSE. SAP does not warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. 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. the reader is addressed directly with "you".Frequently Used Configuration Parameters in SAP HANA Important Disclaimers on Legal Aspects This document is for informational purposes only. SAP reserves the right to use the masculine form of the noun and pronoun. SAP does not warrant the correctness and completeness of the Code given herein. This is to ensure that the documentation remains comprehensible. Its content is subject to change without notice. see: http://help. These hyperlinks are intended to serve as a hint about where to find related information.com/disclaimer. If when referring to members of both sexes. OR OF MERCHANTABILITY. unless damages were caused by SAP intentionally or by SAP's gross negligence. or a gender-neutral noun (such as "sales person" or "working days") is used. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. 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. SAP MAKES NO WARRANTIES. EXPRESS OR IMPLIED. SAP documentation is gender neutral. it is in no way intended to be a binding guideline on how to ensure accessibility of software products. Gender-Neutral Language As far as possible. Internet Hyperlinks The SAP documentation may contain hyperlinks to the Internet. the third- person singular cannot be avoided or a gender-neutral noun does not exist. however. Depending on the context.

and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. Please see http://www.com/corporate-en/legal/copyright/index.Frequently Used Configuration Parameters in SAP HANA Copyright © 2014 SAP SE or an SAP affiliate company. SAP HANA platform 22 .sap. 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. The information contained herein may be changed without prior notice. 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. without representation or warranty of any kind. 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. Nothing herein should be construed as constituting an additional warranty. All rights reserved. if any. These materials are provided by SAP SE or an SAP affiliate company for informational purposes only. All other product and service names mentioned are the trademarks of their respective companies. National product specifications may vary. Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors.epx for additional trademark information and notices.