Hi everyone,

in the last post of this series, we talked about logging in at XS advanced using the xs cli. This time, we’re going to start exploring the system and the first task is to get a system overview by means of the xs cli command system-info. Please note, that you need to have XS advanced administrator permissions to be allowed to execute this command:

$ xs system-info

Getting system infrastructure information...

Several sections about the components of an XS advanced landscape are displayed. We will go through each individual section individually:

Execution Agents

The first section displays information about the execution agents that are currently connected to the XS Controller:

Execution agents:
------------------------------------------------
1. host1.example.org:53648
   created at            Dec 14, 2017 9:10:23 AM
   port range            50000-50499
   os.arch               amd64
   os.name               Linux
   java.vendor           SAP AG
   java.version          1.8.0_144
   os.version            3.12.62-60.62-default
   sun.arch.data.model   64
   version               v1.0.72

2. host2.example.org:53574
   created at            Dec 14, 2017 9:11:24 AM
   port range            50000-50499
   os.arch               amd64
   os.name               Linux
   java.vendor           SAP AG
   java.version          1.8.0_144
   os.version            3.12.62-60.62-default
   sun.arch.data.model   64
   version               v1.0.72

In this example, 2 execution agents on “host1.example.org” and “host2.example.org” are connected to schedule application instances on. For each execution agent, additional information is displayed like:

• The host on which the execution agent runs on
• The date at which the execution agent was started
• The port range the execution agent uses for applications on it’s host
• The platform and version of the SAP JVM that is running the execution agent
• The version of the execution agent

Note: For application scale-out, you can add additional execution agents to a SAP HANA system by adding additional HANA hosts with role “xs_worker”, see also System Concepts for XS Advanced Runtime Installations in the SAP HANA Installation Guide.

Controller

Next up is information about the XS Controller, for example:

Controller server version information:
--------------------------------------------------------------------------------------------------------
   name                     XS Controller
   support                  http://service.sap.com/message
   build                    v1.0.72
   api version              1
   software version         1.0.72.0
   content version          1.0.72.0
   installation state       READY
   description              SAP XS Runtime on premise
   controller endpoint      https://example.org:30030
   authorization endpoint   https://example.org:30032/uaa-security
   accept encoding          gzip, x-gzip
   usage                    apps: 8, routes: 8, services: 16
                            instances: 0 starting, 6 running, 3 stopped, 1 crashed, 0 timed out
   database type            HANA_MULTI
   database info            HDB 2.00.022.00.1511184640

In detail, the following information is displayed for the XS Controller:

• name: The name of the component
• support: The URL to approach in support cases
• build: The version of the XS Controller
• api version: The version of the REST interface provided by the XS Controller
• software version: The installed version of the XS advanced system components
• content version: The installed version of the XS Advanced core applications package (e.g. deploy-service and product-installer). In a sane installation, both numbers must match.
• installation state:
  • READY in case XS advanced is installed correctly
  • UPDATE_PENDING in case the installation is not yet completed
• description: A description of the component
• controller endpoint: The REST endpoint for requests to the XS Controller API (also called API URL)
• authorization endpoint: The REST endpoint for authorization requests
• usage: Information about the number of applications and application instances
• database type: The type of the underlying SAP HANA database:
  • HANA_MULTI: SAP HANA multiple database container system
  • HANA_SINGLE: SAP HANA single database container system
• database info: The version of the underlying SAP HANA database

Service URLs

Applications may maintain a service URL during installation to publish their application endpoint:

Registered service URLs:
-----------------------------------------------------------------------
   deploy-service      https://example.org:51004
   product-installer   https://example.org:51005
   [...]

We’re going to cover maintaining service urls in one of the upcoming blog posts.

Application Overview

The next section provides statistics about the deployed applications in the system:

Applications:
-----------------------------
   Deployed applications:   8
   Running applications:    6
   Stopped applications:    2

Organizations And Spaces

The last section provides statistics about the distribution of applications across organizations and spaces:

Organizations and spaces:
   Organization   Space   Number of apps   User
----------------------------------------------------
   myorg
   |-             PROD          0          abcxsa
   |-             SAP           8          sapabcxsa