SAP HANA Cockpit installation steps

SAP HANA cockpit is a comprehensive tool that unifies individual, multiple, and tenant database management. It replaces both the SAP DB Control Center and the SAP HANA cockpit that were available with SAP HANA 1.0. SAP HANA cockpit 2.0 can be used with systems running SAP HANA 2.0 and SAP HANA 1.0 SPS 12.

System requirement

Starting with SAP HANA cockpit SP 07, its persistence can be installed in an existing SAP HANA 2.0, enterprise edition system.  In this scenario, the cockpit install program creates a new tenant database, COCKPITDB, to act as the persistence to store all metadata needed by the cockpit.  SAP recommends the following guidelines for memory and disk space:

  • Host memory: minimum 22 GB.
  • Disk space: minimum 1.5 GB + 2 MB per 100 registered resources.

Download latest version

Search “SAP hana cockpit” on sap software download and choose “SAP HANA COCKPIT 2.0”

SAP Hana cockpit 2.0 sap downloads

Select your OS and download the latest available SP and Patch level.

SAP HANA cockpit 2.0 Support packages and patches

Uncar the SAR file to a local directory on your HANA db server using below command:

SAPCAR  -manifest  SIGNATURE.SMF -xvf SAPHANACOCKPIT<version number>.SAR


Login as root user and make sure the root user has read and execute authorization on the local directory where we extracted the data from SAR file.
To start the installation we need to execute below command:


You get option to install a new HANA cockpit system or you can install on an existing hana system.
For Production environment, it’s recommended to install hana cockpit on a separate server to avoid overloading of the Production environment. Also another benefit would be if the production server on which the hana cockpit was installed is itself down then you won’t be able to monitor other systems via hana cockpit.

Pre-requisite: To install it on an existing hana system, you would need the SYSTEM user password for both SYSTEMDB as well the tenant databases. So keep it ready before starting the installation. If SYSTEM user is disabled, then enable it using HANA Studio.

In below example, we are going to install it over an existing test hana system.

sap hana cockpit installation with ./

During installation of XS advanced, you have to select one of the following routing modes, which has an influence on the URLs by which applications are exposed.

Routing Modes

Important Note: Changing the routing mode after installation is not supported!

Port-based Routing Mode

In this setup, applications and services are distinguished using different ports while sharing the same domain name, for example:


This allows using a single non-wildcard DNS entry for all application and platform endpoints.

Note, that browsers share cookies among all endpoints below a particular domain. Thus, one application might “see” cookies set by another application. Hence, from a security point of view, port-based routing mode is not recommended for productive use.

Hostname-based Routing Mode

In this setup, applications and services are distinghuised using different sub-domains (aka hostnames) on a single port, for example:


In this mode, browsers don’t share cookies amongst different domains. Thus, from a security point of view, hostname-based routing mode is the setup recommended for productive use.

To allow the XS advanced Platform Router to dispatch requests to these URLs to the target application, a wildcard DNS entry is required for the XS advanced default domain, for example: IN A

In this example, the default domain “” is mapped to the IP address, which would be the the SAP HANA host running the ‘xscontroller’ and ‘xsuaaserver’ services.

summary before execution

After entering all the parameters, setup will give an overview and ask if you want to continue. Verify everything and then enter “y”. If you feel that you want to change something then press “n” for No and start the setup again using ./

Once you press “y”, installation will start and it will first stop all the services on your hana database. So you will need a downtime of around 1-2 hours for it to get finished.

Stopping services on hana database

At the end of the installation, it will provide you 2 URLs to access SAP HANA cockpit and cockpit manager.

SAP hana cockpit installation completed succesfully.

Post Installation steps

For the first time use, we need to do some basic setup. Open the SAP HANA cockpit manager URL and login with user COCKPIT_ADMIN which is ideally created by default and use the Master password which was provided during the installation. In some cases, it may not exist, so you may login using  XSA_ADMIN user and the master password.

Once you are logged in, you can create another cockpit user to provide access.

Create User.
User Information

Assign all the required roles for administrator

Cockpit Roles

Current we don’t have any database groups, but can be created at a later stage.
Click on “Activate User”.

Activate User

You may even create a dedicated user like COCKPIT_ADMIN using this menu.

Now to add database to hana cockpit, we first need to configure “Database Groups”.
Click on “Create Database Group” button

Create Database Group.

Enter the Group Name like ECC, SCM, GRC etc and Description (Optional)

Enter Group Name and its description

As currently we don’t have any registered database yet, so we will select option “Register databases after the group is created”.

Select the databases to be included in this database group.

Add the users to which you want to give access to and click on “Create group”

Select the cockpit users that will have access to this database group.

The next step would be to “Register Database”.
Enter the details for the required database which you want to register in SAP HANA Cockpit.

Specify the information for the database you want to register.

Select the encryption options available for the connection to the database and to the start/stop service.

Use encryption for the connection to the database and to the start/stop service.

Enter user/password required to connect to SYSTEMDB

Enter the credentials of an existing technical database user.

Select the “Database group” which we just created in above steps

Specify the database groups

Now open the SAP HANA cockpit, to check more information on the added database. On Cockpit manager, you should see a button to open SAP hana cockpit.

Go to SAP HANA Cockpit button

SAP HANA Cockpit will open as Fiori application with below multiple default tabs.

SAP HANA Cockpit fiori application

Refer below SAP blogs or notes for more information:

SAP HANA Cockpit Installation and Update Guide
2245631 – Routing Mode and Default Domain configuration for SAP HANA extended application services, advanced model

3 thoughts on “SAP HANA Cockpit installation steps”

  1. Hello

    Many Thanks
    I installed my HANA Cockpit on a server where the productive SAP ABAP application server is running.

    Is one installation like that, recommended by SAP? Can any problems arise with such an installation?

    Many thanks

    1. Hi Adam,

      Thanks for your comment.
      It is highly recommended to install HANA Cockpit on a separate server. If you install it on a server where you have a productive instance running, then it may cause some performance issues as CPU and RAM will need to be shared between these 2 applications (Hana cockpit and ABAP application server). I would rather recommend installing the HANA cockpit on a Development server (if a separate server is not feasible). Let me know if you have any further queries.


Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top