Add Hosts Using the Command-Line

Interface
You can add hosts to an SAP HANA system using the SAP HANA database lifecycle manager (HDBLCM) resident program in the command-line
interface.

Prerequisites
The SAP HANA system has been installed with its server software on a shared file system (export options rw, no_root_squash).

The host has access to the installation directories <sapmnt> and <sapmnt>/<SID>.

The SAP HANA system has been installed with the SAP HANA database lifecycle manager (HDBLCM).

The SAP HANA database server is up and running.

You are logged on as root user or as the system administrator user <sid>adm.

The difference between the system time set on the installation host and the additional host is not greater than 180 seconds.

The operating system administrator (<SID>adm) user may exist on the additional host. Make sure that you have the password of
the existing <SID>adm user, and that the user attributes and group assignments are correct. The SAP HANA database lifecycle
manager (HDBLCM) resident program will not modify the properties of any existing user or group.

Procedure
Change to the SAP HANA resident HDBLCM directory:

cd <sapmnt>/<SID>/hdblcm

By default, <sapmnt> is /hana/shared.

Start the SAP HANA database lifecycle manager interactively in the command line:

./hdblcm --addhosts=<host>[,<host2>]

where the syntax for the addhosts call option is as follows:

<host name>:role=<role name>:group=<group ID>:storage_partition=<partition number>

Field Name Description

<host name> Specifies the host name of the machine.

 Field Name Description

role Specifies the purpose of the SAP HANA host. SAP HANAhosts in production environments
must only have one host role. However, if XS advanced runtime is installed, hosts can
share multiple roles.

worker - A worker host (default) is used for database processing.

standby - A standby host is idle and available for failover in a high-availability

environment.

extended_storage_worker - Worker host for SAP HANA dynamic tiering

extended_storage_standby - Standby host forSAP HANA dynamic tiering

ets_worker - Worker host for SAP HANAaccelerator for SAP ASE

ets_standby - Standby host for SAP HANAaccelerator for SAP ASE

streaming - Host for SAP HANA smart data streaming

rdsync - Host for SAP HANA remote data sync

xs_worker - Host for SAP HANA XS advanced runtime

xs_standby - Standby host for SAP HANA XS advanced runtime

workergroup Specifies the worker group of the host. If undefined, the worker group is named "default".

group Specifies the host group ID for failover scenarios. If undefined, the host group is named
"default".

storage_partition Specifies the storage partition number, which is a logical role number assigned to non-
shared storage devices in a storage connector API. Standby hosts do not have a storage
partition.

The required parameters depend on the type of host addition you are performing: host addition from an integrated host to a
multiple-host system, host addition from an integrated host to a single-host system, or host addition from a non-integrated host. For
more information about host addition types, see Related Information.

Note
When using the command line, the options can be set interactively during configuration only if they are marked as interactive
in the help description. All other options have to be specified in the command line. To call the help, in the hdblcm directory of
the SAP HANA system, execute the following command:

./hdblcm --action=add_hosts --help

Select the index for the add_hosts action.

Define additional system properties.

Field Name Description

 Field Name Description

Inter-Service Communication Specifies the listen interface for the internal network communication.

global - Binds the processes to all interfaces. This option does not require an
internal network address entry.

internal - Binds the processes to this address only and to all local host interfaces.
This option requires an internal network address entry.

Internal Network Address Specifies the internal subnet address in CIDR notation.

If you define a value other than local, the local interfaces will always be open.

Certificate Host Name Specifies the hostname used for generation of self-signed SSL certificates for the SAP
Host Agent.

Review the summary, and select y to finalize the configuration.

Results
You have added one or more new hosts to an SAP HANA system. The SAP HANA system you have configured is a multiple-host system.

The new hosts have been added to the SAP HANA landscape information. If your system is SAP HANA multitenant database container (multiple-
container) enabled system, the new hosts have been added to the landscape information of the system database.

This configuration task can also be performed in batch mode and using a configuration file. For more information about the available configuration
methods, see Using the SAP HANA Platform LCM Tools in Related Information.

Example
The following example adds two hosts, Host1 and Host2 to a single-host SAP HANAsystem. The role of the two hosts is worker, by default. No SSH
keys are installed. A trusted connection between the hosts is configured and therefore, root user password is not required. The listen interface of
the SAP HANA system is changed to global.

./hdblcm --action=add_hosts --addhosts=host1,host2 --root_user=lmroot --listen_interface=global