SAP HANA Cockpit Installation Guide en
SAP HANA Cockpit Installation Guide en
SAP HANA Cockpit Installation Guide en
This guide describes how to install and update the SAP HANA cockpit.
Related Information
SAP HANA cockpit is the main administration tool for SAP HANA.
The SAP HANA cockpit provides tools for the administration and monitoring of SAP HANA databases, and for
development capabilities through the SAP HANA database explorer. You can manage multiple databases, each
running version SAP HANA 1.0 SPS 12, or later. databases running version SAP HANA 2.0 SPS 01 or later run in
multi-container mode, but you can also monitor single-container systems running earlier versions of SAP
HANA.
Note
While the cockpit was an integral part of earlier versions of SAP HANA, the new SAP HANA cockpit for SAP
HANA 2.0 is installed separately. This provides more flexibility, as it allows you to manage more than one
SAP HANA system in a single administration environment. SAP HANA cockpit runs on an SAP HANA
Express database, which is included in the installation. The SAP HANA cockpit can also be installed in an
existing SAP HANA system in a separate tenant database (shared database).
The SAP HANA cockpit provides aggregate, system and database administration features, for example,
database monitoring, user management, and data backup. Administrators can use the SAP HANA cockpit to
start and stop services, to monitor the system, to configure system settings, and to manage users and
authorizations. Cockpit pages that allow you to manage separately-installed contexts (for example, SAP HANA
dynamic tiering) are only available if they are installed.
Through the Cockpit Manager, you, as the cockpit administrator, need to register resources and create groups
of resources that other cockpit users will be able to access with SAP HANA cockpit. A resource is an SAP HANA
system, identified by a host and instance number. Suppose that a business unit has set up a new SAP HANA
system and wants it to be managed through the cockpit. The first step is to register the SAP HANA system, or
resource, in the cockpit.
Initially, the SAP HANA cockpit displays data at a landscape or enterprise level. You can quickly drill down to an
overview of an individual resource. Links, data, cards, and different parts of a single tile are drillable, providing
access to more detailed information and functions.
Integrated into the cockpit is the SAP HANA database explorer. The database explorer provides the ability to
query information about the database using SQL statements, as well as the ability to view information about
your database's catalog objects.
The connectivity between SAP HANA cockpit and managed resources includes:
This SAP HANA Cockpit Installation and Update Guide describes how to install or update the SAP HANA
cockpit with the SAP HANA database lifecycle manager (HDBLCM).
For SAP HANA cockpit, a number of hardware and software requirements apply.
For information about supported operating systems for SAP HANA cockpit, see the Related Information in this
section.
Hardware Requirements
In production environments, you have the following options to install the SAP HANA cockpit:
● The SAP HANA cockpit can be installed on dedicated hardware. A minimum of 16GB of RAM and 16GB of
disk space is required. Additional disk space is required for data generated as the cockpit runs. We
recommend that the installation directory is not located in the root file system.
● The SAP HANA cockpit can be installed in an existing SAP HANA system. For sizing guidelines, see SAP
Note 2780721 (SAP HANA 2.0 Cockpit Recommended Sizing Guidelines).
Example
Each configuration snapshot consumes about 5 MB of storage. You will therefore need about 1 GB to store
200 snapshots.
The XS advanced runtime environment supplied with the SAP HANA cockpit on dedicated hardware in a
separate SAP HANA system cannot be used to deploy XS Advanced applications.
Related Information
In the SAP Software Download Center, you have access to the installation media and components for SAP
HANA cockpit. For more information and a link to the SAP Software Download Center, see Related Information.
Prerequisites
You require the SAPCAR archiving tool to be able to unpack software component archives (*.SAR files), which is
the format of software lifecycle media and tools that you can download from the SAP Software Download
Center .
Note
It is recommended that you update your system to the latest support package for SAP HANA cockpit.
Support packages and patches for SAP HANASAP HANA system.
Procedure
Related Information
SAP HANA cockpit can be deployed on dedicated hardware, on shared hardware, or in an existing SAP HANA
system (shared database). All deployment options are approved for production environments, but note that
deploying on shared hardware has restrictions.
Shared Database ● Leverage existing infrastructure ● SAP HANA system must be prop
erly sized to handle memory re
quirements for your applications
and the cockpit
● Requires SAP HANA 2.0 SPS 02 or
higher and SAP HANA XS Ad
vanced runtime 1.0.86 or higher
Be sure to implement High Availability (HA) for the cockpit, particularly in a production environment. For
information on how to set up HA for the cockpit, please refer to this document: How To: High Availability for SAP
HANA cockpit using SAP HANA system replication.
Virtualization
The SAP HANA cockpit can be installed in either a dedicated virtual machine, or in a virtual machine that is
shared with an SAP HANA system. For best results, a dedicated virtual machine is preferable.
Google Chrome or Microsoft Edge web browsers do not cache content from sites that use self-signed SSL
certificates, meaning that each time a site loads that uses such a certificate, the content must be downloaded
over the network rather than from the browser’s cache. Please configure SSL for the SAP HANA cockpit to
improve response times when using those web browsers.
Related Information
The SAP HANA database lifecycle manager (HDBLCM) is used to install the SAP HANA cockpit in a graphical
user interface or the command-line interface. The SAP HANA cockpit can be uninstalled using the resident
version of the SAP HANA database lifecycle manager (HDBLCM).
Installation Configuration
You can review the existing configuration settings for the SAP HANA cockpit. Installation settings can be found
in the auto_install.cfg file (standalone installation) or auto_install_hdb.cfg file (installation in an
existing SAP HANA system) inside the HDB__LCM_LINUX_X86_64/configurations or
HDB__LCM_LINUX_PPC64LE/configurations folder, depending on your hardware platform. The default
database server properties can be found inside the *.ini files inside the custom folder inside the
configurations folder of the database (HDB_SERVER_LINUX_X86_64 or HDB_SERVER_LINUX_PPC64LE).
Ports
Ports, through which the SAP HANA cockpit and the cockpit manager can be accessed, are assigned
automatically by the installer. Once the cockpit installation is successfully completed, information about host
and ports is displayed. If this information is no longer available, you can determine the ports through the XS
console. For more information, see Determine Ports for SAP HANA Cockpit and Cockpit Manager.
You can also assign free ports to SAP HANA cockpit during installation. For more information, see SAP Note
2389709.
Batch Mode
You can run the SAP HANA database lifecycle manager (HDBLCM) from the command line in batch mode using
default values for unspecified parameters. Every value listed in the auto_install.cfg file can be overridden
by passing new values in the command line. If mandatory values are omitted or if invalid values are specified,
the program issues an error message. For more information on installation parameters, see Parameter
Reference in the SAP HANA Server Installation and Update Guide.
./hdblcm.sh --action=install -b
Example
Install the SAP HANA Cockpit Using the Graphical User Interface [page 13]
Install the SAP HANA Cockpit Using the Command-Line Interface [page 15]
Install the SAP HANA Cockpit in an Existing SAP HANA System Using the Graphical User Interface [page 16]
Install the SAP HANA Cockpit in an Existing SAP HANA System Using the Command-Line Interface [page 18]
Determine Ports for SAP HANA Cockpit and Cockpit Manager [page 22]
SAP Note 2389709 - Specifying the port for SAP HANA Cockpit before installation
4.1 Install the SAP HANA Cockpit Using the Graphical User
Interface
The SAP HANA cockpit can be installed using the SAP HANA database lifecycle manager (HDBLCM) graphical
user interface.
Prerequisites
Context
In standalone cockpit installations, during the installation process, the installer creates a single, fully
authorized, administration user, COCKPIT_ADMIN, and associates it with the master password, which you are
prompted to enter. Ports, through which the SAP HANA cockpit and the SAP HANA cockpit manager can be
accessed, are assigned automatically by the installer. The local host name, ports, and the master password are
required to set up the SAP HANA cockpit. Make sure that you pass this information along to the cockpit
administrator.
Procedure
1. Change to the directory where you unpacked the SAP HANA cockpit *.SAR archive:
cd <installation medium>
2. Start the SAP HANA database lifecycle manager interactively in the graphical user interface:
./hdblcmgui.sh
Results
The selected components are installed. A log file is available. The most recent log file is always available
under /var/tmp/hdblcmgui.log. Additionally, a copy of the log files is archived in the directory
hdb_<SID>_hdblcm_<action>_<date>.
Next Steps
Configure your firewall to allow access to the host and port of the cockpit-web-app https://
<hostname>:<port> and https://<hostname>:3<instance number>32
After installation, and before other users are able to access the SAP HANA cockpit, there are several steps that
you, as a cockpit administrator, have to perform. This includes launching the cockpit manager using the URL
created during installation, signing in to the cockpit manager as the COCKPIT_ADMIN user and registering
resources. For more details about these and other post-installation steps, see Set up SAP HANA Cockpit for the
First Time in SAP HANA Administration with SAP HANA Cockpit.
Related Information
The SAP HANA cockpit can be installed using the SAP HANA database lifecycle manager (HDBLCM)
command-line interface.
Prerequisites
Context
In standalone cockpit installations, during the installation process, the installer creates a single, fully
authorized, administration user, COCKPIT_ADMIN, and associates it with the master password, which you are
prompted to enter. Ports, through which the SAP HANA cockpit and the SAP HANA cockpit manager can be
accessed, are assigned automatically by the installer. The local host name, ports, and the master password are
required to set up the SAP HANA cockpit. Make sure that you pass this information along to the cockpit
administrator.
Procedure
1. Change to the directory where you unpacked the SAP HANA cockpit *.SAR archive:
cd <installation medium>
2. Start the SAP HANA database lifecycle manager interactively in the command line:
./hdblcm.sh
3. Select Install new SAP HANA Cockpit system, then select Enter.
4. Specify the SAP HANA system properties.
For a list of all system properties, see System Properties in Related Information.
5. After specifying all system properties, review the summary, and select y.
The selected components are installed. A log file is available. The most recent log file is always available
under /var/tmp/hdblcm.log. Additionally, a copy of the log files is archived in the directory
hdb_<SID>_hdblcm_<action>_<date>.
Next Steps
Configure your firewall to allow access to the host and port of the cockpit-web-app https://
<hostname>:<port> and https://<hostname>:3<instance number>32
After installation, and before other users are able to access the SAP HANA cockpit, there are several steps that
you, as a cockpit administrator, have to perform. This includes launching the cockpit manager using the URL
created during installation, signing in to the cockpit manager as the COCKPIT_ADMIN user and registering
resources. For more details about these and other post-installation steps, see Set up SAP HANA Cockpit for the
First Time in SAP HANA Administration with SAP HANA Cockpit.
Related Information
The SAP HANA cockpit can be installed in an existing SAP HANA system using the SAP HANA database
lifecycle manager (HDBLCM) graphical user interface.
Prerequisites
If the cockpit is installed in an existing SAP HANA system, during the installation process, the installer creates a
new tenant database and a separate XS advanced space that is mapped to it. The cockpit XS advanced apps
are installed in this space. If you are running the SAP HANA system in high isolation mode, a tenant database
must be created manually in advance. A tenant in which cockpit is installed is excluded from the license
capacity calculation as long as it is only used for administrative purposes.
Procedure
1. Change to the directory where you unpacked the SAP HANA cockpit *.SAR archive:
cd <installation medium>
2. Start the SAP HANA database lifecycle manager interactively in the graphical user interface:
./hdblcmgui.sh
The SAP HANA database lifecycle manager graphical user interface appears.
3. Select Install on SAP HANA Database and the system in which you want to install the cockpit, then select
Next.
4. Select the components you would like to install, then select Next.
5. Specify the SAP HANA cockpit system properties.
For a list of all system properties, see System Properties in Related Information.
6. After specifying all system properties, review the summary, and select Install.
Results
The selected components are installed. A log file is available. The most recent log file is always available
under /var/tmp/hdblcmgui.log. Additionally, a copy of the log files is archived in the directory
hdb_<SID>_hdblcm_<action>_<date>.
Next Steps
Configure your firewall to allow access to the host and port of the cockpit-web-app https://
<hostname>:<port> and https://<hostname>:3<instance number>32
After installation, and before other users are able to access the SAP HANA cockpit, there are several steps that
you, as a cockpit administrator, have to perform. This includes launching the cockpit manager using the URL
created during installation, signing in to the cockpit manager as the XSA_ADMIN user and registering
resources. For more details about these and other post-installation steps, see Set up SAP HANA Cockpit for the
First Time in SAP HANA Administration with SAP HANA Cockpit.
The SAP HANA cockpit can be installed in an existing SAP HANA system using the SAP HANA database
lifecycle manager (HDBLCM) command-line interface.
Prerequisites
Context
If the cockpit is installed in an existing SAP HANA system, during the installation process, the installer creates a
new tenant database and a separate XS advanced space that is mapped to it. The cockpit XS advanced apps
are installed in this space. If you are running the SAP HANA system in high isolation mode, a tenant database
must be created manually in advance. A tenant in which cockpit is installed is excluded from the license
capacity calculation as long as it is only used for administrative purposes.
Procedure
1. Change to the directory where you unpacked the SAP HANA cockpit *.SAR archive:
cd <installation medium>
2. Start the SAP HANA database lifecycle manager interactively in the command line:
./hdblcm.sh
3. Select the index for Install SAP HANA Cockpit on SAP HANA Database version <version number>, then
select Enter .
Results
The selected components are installed. A log file is available. The most recent log file is always available
under /var/tmp/hdblcm.log. Additionally, a copy of the log files is archived in the directory
hdb_<SID>_hdblcm_<action>_<date>.
Next Steps
Configure your firewall to allow access to the host and port of the cockpit-web-app https://
<hostname>:<port> and https://<hostname>:3<instance number>32
After installation, and before other users are able to access the SAP HANA cockpit, there are several steps that
you, as a cockpit administrator, have to perform. This includes launching the cockpit manager using the URL
created during installation, signing in to the cockpit manager as the XSA_ADMIN user and registering
resources. For more details about these and other post-installation steps, see Set up SAP HANA Cockpit for the
First Time in SAP HANA Administration with SAP HANA Cockpit.
Related Information
SAP HANA cockpit system properties can be defined during installation. Default values are provided for all
properties except for the master password. Some parameters may not apply, depending on your installation
scenario.
System Properties
In standalone cockpit installations, during the installation process, the installer creates a single, fully
authorized, administration user, COCKPIT_ADMIN, and associates it with the master password, which you are
prompted to enter. Ports, through which the SAP HANA cockpit and the SAP HANA cockpit manager can be
accessed, are assigned automatically by the installer. The local host name, ports, and the master password are
required to set up the SAP HANA cockpit. Make sure that you pass this information along to the cockpit
administrator.
The default for this parameter is the host name of the current machine.
SAP HANA System ID Specifies a system ID. The SAP system ID (SID) is the identifier for the
SAP HANA system.
Requirements
Instance Number Specifies the instance number of the SAP HANA system.
The default value for this parameter is 96, or, if 96 is already in use, the
next successive un-used instance number.
Master Password Specifies the master password for all users created during installation.
Cockpit Tenant Database Name Specifies the cockpit tenant database name (default: COCKPITDB).
Cockpit Tenant Database User Password Specifies the password for the cockpit tenant database user.
Automatically assign XS Advanced Runtime roles Assigns XS_WORKER and XS_STANDBY host roles. The host role
to the hosts with database roles XS_WORKER will be assigned to all worker hosts, the host role
XS_STANDBY will be assigned to all standby hosts. To create a multiple-
host system with dedicated xs_worker and xs_standby hosts, assign host
roles to each host individually during installation. Do not choose the op
tion to assign XS Advanced host roles automatically.
Organization Name For Space "SAP" Sets the name of the customer organization. Organizations enable devel
opers to collaborate by sharing resources, services, and applications. Ac
cess to the shared resources, services, and applications is controlled by
the organization manager (default: orgname).
Customer Space Name Sets the name of the customer space for the SAP HANA XS advanced
runtime. In an organization, spaces enable users to access shared re
sources that can be used to develop, deploy, and maintain applications
(default: PROD).
Run Applications in Customer Space with Run applications in customer space with a separate OS user
Separate OS User
Routing Mode Specifies the routing mode to be used for XS advanced runtime installa
tions. For more information on routing configurations, see SAP Note
2245631 .
XS Advanced Admin User Creates an SAP HANA XS advanced runtime admin user. An admin user
can add and manage users, view users, edit organization roles, view the
organization quota, and perform other administrative tasks (default:
COCKPIT_ADMIN).
XS Advanced App Working Path Specifies the XS advanced runtime app working path for runtime data of
application instances. For best performance, specify a local directory,
which is then created on all XS_WORKER hosts.
XS Advanced Domain Name Specifies the domain name of an xs_worker host. The domain name has
to resolve to the SAP HANA host which is running the xscontroller and
xsuaaserver service.
XS Advanced SAP Space OS User ID OS user ID used for running XS advanced runtime applications in SAP
space
XS Advanced Customer Space OS User ID OS user ID used for running XS Advanced applications in customer space
XS Advanced Space for Cockpit Specifies the name for XS advanced space for the SAP HANA cockpit
(default: COCKPIT).
The ports for SAP HANA cockpit and the Cockpit Manager can be determined in the XS console after the
cockpit installation.
Prerequisites
Ports, through which the SAP HANA cockpit and the Cockpit Manager can be accessed, are assigned
automatically by the installer. Once the cockpit installation has successfully completed, information about host
and ports is displayed. If this information is no longer available, you can execute the following commands in the
XS console to determine ports.
You can also assign free ports to SAP HANA cockpit during installation. For more information, see SAP Note
2389709 in the Related Links section.
Procedure
cd <sapmnt>/<SID>/xs/bin
./xs-admin-login
xs apps
A list of all running apps is displayed. Information on host and ports is displayed in the urls column. The
SAP HANA cockpit is listed as cockpit-web-app. The Cockpit Manager is listed as cockpit-admin-
web-app.
Output Code
Related Information
SAP Note 2389709 - Specifying the port for SAP HANA Cockpit before installation
Configure SSL for the SAP HANA cockpit where you have an SAP HANA system installed on a single host with
incoming connections from SQLDBC and HTTP clients for database and administrative access.
Prerequisites
The global.ini file of your HANA database has the following parameters settings:
● sslenforce=true
● sslvalidatecertificate=true
Context
Note
The steps below must be performed after each update of SAP HANA Cockpit.
If you have configured your HANA database to enforce SSL mutual authentication, then you can set up SAP
HANA cockpit to use a client certificate and private key. For HANA Cockpit the cockpit-hdb-svc must be
updated to add these variables using the xs set-env command.
For completeness, SAP HANA Cockpit also supports injection of the CA root certificate using the
HANA_CA_CERTIFICATE environment variable. This should not be needed but is supported if required.
You can obtain the certificate from sapsrv.pse/sapcli.pse by running the sapgenpse command. For
example:
Use the following procedure for connections via the SAP start service and for XSA applications.
1. Import the public-key certificate of the server or the root certificate into the XSA trust store of the SAP
HANA system using the following xs CLI command:
<alias> is an arbitrary name and <path> is the fully-qualified file name of the root certificate, which must
be an x.509 certificate in PEM format.
To get access to an offline HANA server, you also need a trusted certificate to SAP Control. This can be
derived from the SAPSSLS.pse file (root certificate).
2. Ensure that the Encrypt the database connection setting is set for your resource.
a. In the SAP HANA cockpit, go to the Database Directory and then click Manage Resources.
a. In the Cockpit Manager set the Encrypt the database connection option either by editing an existing
resource or when you're registering a new resource.
3. Specify a client certificate and a private key by setting specific environment variables for SAP HANA
cockpit and SAP HANA database explorer.
a. Use the xs set-env command to update the cockpit-hdb-svc to add the environment variables:
HANA_CLIENT_CERTIFICATE and HANA_CLIENT_KEY.
Insert your private key into a separate file, for example <cockpit.key> and insert your certificate
chain into another file, for example, <cockpit.cert>.
If you are inserting your certificate chain from another file, e.g. xs set-env cockpit-hdb-svc
HANA_CLIENT_CERTIFICATE --from-file <file.cert> then you do not need put the content
all on one line. If you are inserting the certificate content directly, e.g. xs set-env cockpit-hdb-
svc HANA_CLIENT_CERTIFICATE <cert content>, then the certificate content should be all on
one line.
If your system has more than one certificate block, run the following command to show the validity of
the certificates:
b. Set the following environment variables for SAP HANA database explorer:
The certificate and private key must be in PEM format and be all on one line.
Results
All database connections for the specified resource are encrypted using SSL.
Related Information
The SAP HANA cockpit can be updated using the SAP HANA database lifecycle manager (HDBLCM).
To update an SAP HANA cockpit, you need to first download the installation files from Service Marketplace
(SMP). This can be done manually using the SAP HANA database lifecycle manager (HDBLCM) Web user
interface. Once the component packages have been prepared, the system update can be triggered from any of
the three SAP HANA database lifecycle manager user interfaces.
Caution
Do not update the SAP HANA cockpit components individually. Always use the SAP HANA database
lifecycle manager (HDBLCM) to update the cockpit and all of its components in one step.
Related Information
Update the SAP HANA Cockpit Using the Graphical User Interface [page 28]
Update the SAP HANA Cockpit Using the Command-Line Interface [page 29]
Update the SAP HANA Cockpit Using the Web User Interface [page 35]
The SAP HANA cockpit can be updated using the SAP HANA database lifecycle manager (HDBLCM) graphical
user interface.
Prerequisites
● You are updating from an installation medium or you have prepared for update.
● You know the <sid>adm, the database administrator, and the XS organization manager user passwords.
The passwords of these users match the master password, which is set during installation.
Context
The following procedure describes the update of the SAP HANA cockpit in interactive mode and entering
parameters interactively.
1. Change to the directory where you unpacked the SAP HANA cockpit *.SAR archive:
cd <installation medium>
2. Run the SAP HANA database lifecycle manager as root or <sid>adm user:
./hdblcmgui.sh
The SAP HANA database lifecycle manager graphical user interface appears.
3. Select Update Existing System, and choose the SID from the drop-down menu. Then select Next.
4. Select the components you would like to update, then select Next.
5. Specify the SAP HANA authorization information.
6. After specifying all system properties, review the summary, and select Update.
Related Information
Download Components from SAP Support Portal Using the Web User Interface [page 30]
Prepare the Software Archive for the Update [page 32]
The SAP HANA cockpit can be updated using the SAP HANA database lifecycle manager (HDBLCM)
command-line interface.
Prerequisites
● You are updating from an installation medium or you have prepared for update.
● You know the <sid>adm, the database administrator, and the XS organization manager user passwords.
The passwords of these users match the master password, which is set during installation.
Context
The following procedure describes the update of the SAP HANA cockpit in interactive mode and entering
parameters interactively.
1. Change to the directory where you unpacked the SAP HANA cockpit *.SAR archive:
cd <installation medium>
2. Run the SAP HANA database lifecycle manager as root or <sid>adm user:
./hdblcm.sh
3. Select the index for the system to be updated, then select Enter .
4. Select the components you would like to update as a comma-separated list, then select Enter .
5. Specify the SAP HANA authorization information.
6. After specifying all system properties, review the summary, and select y.
Related Information
Download Components from SAP Support Portal Using the Web User Interface [page 30]
Prepare the Software Archive for the Update [page 32]
You can use your SAP HANA database lifecycle manager (HDBLCM) Web user interface to check for available
software component updates and download them from SAP Support Portal.
Prerequisites
Note
Alternatively, you can download the components to a shared location to which the SAP HANA cockpit
has access or copy the downloaded components to the SAP HANA cockpit host manually.
You should verify that the following prerequisites are fulfilled before trying to access the SAP HANA database
lifecycle manager from a Web browser.
Note
For more information about supported Web browsers for the SAP HANA database lifecycle manager
Web interface, see the browser support for sap.m library in the SAPUI5 Developer Guide in Related
Information.
Procedure
Enter the SAP HANA database lifecycle manager (HDBLCM) URL in an HTML5-enabled browser:
https://<hostname>:1129/lmsl/HDBLCM/<SID>/index.html
Note
The URL is case sensitive. Make sure you enter upper and lower case letters correctly.
After downloading components from the SAP Support Portal using the SAP HANA database lifecycle manager
(HDBLCM) Web user interface, prepare the software archive so that it is detected by the SAP HANA database
lifecycle manager during update. For more information about preparing the software archive, see Related
Information.
Related Information
After downloading the software components from SAP Support Portal, the software archive must be prepared
for the update.
Prerequisites
Procedure
cd <sapmnt>/<SID>/hdblcm
./hdblcm --action=extract_components
3. Enter the location of the SAP HANA component archives which you want to prepare for the update.
Next Steps
You can now update the SAP HANA system with the SAP HANA database lifecycle manager.
If the SAP HANA database lifecycle manager doesn't detect the installation kit, you should run it with the
parameter component_root specifying the root directory displayed at the end of the hdblcm_prepare.sh
script:
or
You can upload and extract SAP HANA component archives that were downloaded from the SAP Service
Marketplace for installation or update using the SAP HANA database lifecycle manager (HDBLCM) Web user
interface.
Prerequisites
You should verify that the following prerequisites are fulfilled before trying to access the SAP HANA database
lifecycle manager from a Web browser.
Note
For more information about supported Web browsers for the SAP HANA database lifecycle manager
Web interface, see the browser support for sap.m library in the SAPUI5 Developer Guide in Related
Information.
Procedure
Enter the SAP HANA database lifecycle manager (HDBLCM) URL in an HTML5-enabled browser:
https://<hostname>:1129/lmsl/HDBLCM/<SID>/index.html
Note
The URL is case sensitive. Make sure you enter upper and lower case letters correctly.
Option Description
The Archives are Ac Use this option if the archives are located on a file system accessible from the SAP HANA host.
cessible from the
SAP HANA Host Specify the directory which contains the component archives under Location of SAP HANA
Component Archives. Then select Next.
Upload Archives to Use this option if the archives are accessible only from your local machine.
the SAP HANA Host
Select one or more component archives that you want to upload to the SAP HANA host. Then
select Upload.
4. Specify an empty target directory to extract the software component archives to under Temporary Extract
Directory. Then select Next.
5. After specifying all system properties, review the summary, and select Extract.
Related Information
A standalone installation of SAP HANA cockpit can be updated using the SAP HANA database lifecycle
manager (HDBLCM) Web user interface.
Prerequisites
You should verify that the following prerequisites are fulfilled before trying to access the SAP HANA database
lifecycle manager from a Web browser.
Note
For more information about supported Web browsers for the SAP HANA database lifecycle manager
Web interface, see the browser support for sap.m library in the SAPUI5 Developer Guide in Related
Information.
● The installation medium must be owned by the root user and should not have write permissions for the
group (except for when the group ID is 0) and others.
● You are updating from an installation medium or you have prepared for update.
● You know the <sid>adm, the database administrator, and the XS organization manager user passwords.
The passwords of these users match the master password, which is set during installation.
Context
The following procedure describes the update of the SAP HANA cockpit using the SAP HANA database lifecycle
manager (HDBLCM) Web user interface.
Enter the SAP HANA database lifecycle manager (HDBLCM) URL in an HTML5-enabled browser:
https://<hostname>:1129/lmsl/HDBLCM/<SID>/index.html
Note
The URL is case sensitive. Make sure you enter upper and lower case letters correctly.
Option Description
If you downloaded the components to a different directory, enter the file path to the directory where you
unpacked the server archive.
Related Information
If required, you can uninstall the previously installed SAP HANA cockpit by running either the SAP HANA
database lifecycle manager (HDBLCM) from the SAP HANA resident HDBLCM directory.
Related Information
Uninstall the SAP HANA Cockpit Using the Graphical User Interface [page 37]
Uninstall the SAP HANA Cockpit Using the Command-Line Interface [page 38]
You can uninstall the SAP HANA cockpit using the SAP HANA database lifecycle manager (HDBLCM) graphical
user interface.
Prerequisites
Context
Caution
Uninstalling the SAP HANA cockpit removes all data volumes and log volumes associated with the
persistence of SAP HANA cockpit. It is a permanent action that cannot be undone! The persistencies of the
managed SAP HANA systems, including the system hosting the cockpit, are not affected by this action.
Procedure
cd <sapmnt>/<SID>/hdblcm
The SAP HANA database lifecycle manager graphical user interface appears.
3. Select Uninstall SAP HANA Cockpit Components from the activity options. Then select Next.
4. Select Uninstall SAP HANA Database and all other components from the components options. Then select
Next .
Results
You can uninstall the SAP HANA cockpit using the SAP HANA database lifecycle manager (HDBLCM)
command-line interface.
Prerequisites
Context
Caution
Uninstalling the SAP HANA cockpit removes all data volumes and log volumes associated with the
persistence of SAP HANA cockpit. It is a permanent action that cannot be undone! The persistencies of the
managed SAP HANA systems, including the system hosting the cockpit, are not affected by this action.
cd <sapmnt>/<SID>/hdblcm
Option Action
./hdblcm --action=uninstall --
components=all
To uninstall an SAP HANA cockpit that is bundled with Run the following command to uninstall cockpit:
SAP HANA
./hdblcm --action=uninstall --
components=cockpit
./hdblcm --action=uninstall --
components=xs
Results
You can uninstall the SAP HANA cockpit from an existing SAP HANA system using the SAP HANA database
lifecycle manager (HDBLCM) graphical user interface.
Prerequisites
Caution
Uninstalling the SAP HANA cockpit removes all data volumes and log volumes associated with the
persistence of SAP HANA cockpit. It is a permanent action that cannot be undone! The persistencies of the
managed SAP HANA systems, including the system hosting the cockpit, are not affected by this action.
If you no longer require the XS advanced runtime environment for other applications, you can uninstall it
together with the SAP HANA cockpit.
Note
Always use the SAP HANA database lifecycle manager (HDBLCM) to fully uninstall the SAP HANA cockpit.
Do not drop the COCKPITDB database.
Procedure
cd <sapmnt>/<SID>/hdblcm
./hdblcmgui --action=uninstall
The SAP HANA database lifecycle manager graphical user interface appears.
3. Select Uninstall SAP HANA Database Components from the activity options. Then select Next.
4. Select Uninstall SAP HANA Cockpit Stack from the components options. Then select Next .
5. Specify the SAP HANA cockpit system properties.
For a list of all system properties, see System Properties in Related Information.
6. Review the summary, and select Uninstall to finalize the configuration.
Results
Related Information
You can uninstall the SAP HANA cockpit from an existing SAP HANA system using the SAP HANA database
lifecycle manager (HDBLCM) command-line interface.
Prerequisites
Context
Caution
Uninstalling the SAP HANA cockpit removes all data volumes and log volumes associated with the
persistence of SAP HANA cockpit. It is a permanent action that cannot be undone! The persistencies of the
managed SAP HANA systems, including the system hosting the cockpit, are not affected by this action.
If you no longer require the XS advanced runtime environment for other applications, you can uninstall it
together with the SAP HANA cockpit.
Note
Always use the SAP HANA database lifecycle manager (HDBLCM) to fully uninstall the SAP HANA cockpit.
Do not drop the COCKPITDB database.
Procedure
cd <sapmnt>/<SID>/hdblcm
./hdblcm --action=uninstall
Related Information
SAP Notes contain important information that can help you to successfully install, update, administer, and
work with an SAP HANA system.
2372809 Guideline for Upgrading a SAP HANA 1.0 to SAP HANA 2.0
System
2714742 SAP Web IDE for SAP HANA 2.0 SPS 04 - Central Release
Note
2009879 SAP HANA Guidelines for Red Hat Enterprise Linux (RHEL)
Check the current SAP Notes for the various parts of SAP HANA by searching for any of the following
application areas:
Data Provisioning
● HAN-DP - Data Provisioning
● HAN-DP-BC - SAP HANA Blockchain Adapter
● HAN-DP-DS - Data Services
● HAN-DP-DXC - SAP HANA Direct Extractor Connector
● HAN-DP-ESS - SAP HANA Enterprise Semantic Services (ESS)
● HAN-DP-LTR - Landscape Transformation Replication Server
● HAN-DP-SDI - SAP HANA smart data integration
The search also supports using the wildcard asterisk (*), so you can, for example, also search for BC-DB-HDB*
or similar and you will get results for all subcomponents.
Reporting Incidents
If you encounter any problems with the software, report an incident at http://support.sap.com/incident .
In addition, the Customer Interaction Center (CIC) is available 24 x 7 in every region to help you resolve any
issues you may run into (https://support.sap.com/contactus ).
When reporting an incident, you can choose from the above list of components for the relevant software part.
For information about the capabilities available for your license and installation scenario, refer to the Feature
Scope Description for SAP HANA.
For information about the capabilities available for your license and installation scenario, refer to the Feature
Scope Description for SAP HANA.
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Gender-Related Language
We try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
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.