SAP HANA Cockpit: Guía Completa de Instalación y Administración en Linux

Si administras sistemas SAP HANA sobre Linux, SAP HANA Cockpit es tu herramienta centralizada para monitorización y gestión. A diferencia de SAP HANA Studio (cliente de escritorio basado en Eclipse), el Cockpit es una aplicación web que te permite administrar múltiples bases de datos HANA desde cualquier navegador.

En esta guía técnica encontrarás comandos específicos de Linux, procedimientos de instalación detallados y solución de problemas comunes que todo administrador SAP BASIS necesita conocer.

¿Qué es SAP HANA Cockpit y por qué usarlo?

SAP HANA Cockpit es una aplicación XS Advanced (XSA) que proporciona una interfaz web unificada para:

• Monitorización en tiempo real de rendimiento, memoria y CPU
• Administración de usuarios y roles a nivel de base de datos
• Gestión de backups y recuperación
• Alertas y notificaciones configurables
• Administración multi-tenant (MDC)

Diferencias con SAP HANA Studio

Recomendación: SAP recomienda migrar a Cockpit para tareas de administración, reservando HANA Studio para desarrollo SQL avanzado.

Arquitectura y Puertos de SAP HANA Cockpit

Antes de instalar, es fundamental entender la arquitectura de puertos:

┌─────────────────────────────────────────────────────────────┐
│                    SAP HANA Cockpit                         │
├─────────────────────────────────────────────────────────────┤
│  Puerto HTTPS Cockpit:  4${instance}39  (ej: 51039)         │
│  Puerto XSA Controller: 4${instance}00  (ej: 51000)         │
│  Puerto Web Dispatcher: 4${instance}01  (ej: 51001)         │
└─────────────────────────────────────────────────────────────┘

Donde ${instance} = número de instancia HANA (00-99)
Ejemplo: Instancia 10 → Puerto Cockpit: 51039

Verificar puertos activos en Linux

Listar puertos HANA en uso
sudo netstat -tlnp | grep hdb

Alternativa con ss (más moderno)
sudo ss -tlnp | grep -E ':(3[0-9]{4}|4[0-9]{4}|5[0-9]{4})'

Ver puertos específicos del Cockpit
sudo lsof -i :51039

URLs de acceso típicas

SAP HANA Cockpit Manager (administración del Cockpit)
https://:51039/sap/hana/cockpit

SAP HANA Cockpit (monitorización de bases de datos)
https://:51039/sap/hana/cockpit/resource/index.html

XSA Controller (administración XSA)
https://:51000

Requisitos del Sistema

Hardware mínimo para el servidor Cockpit

Verificar recursos disponibles en Linux

Memoria RAM total y disponible
free -h

Información detallada de CPU
lscpu | grep -E 'Model name|Socket|Core|Thread'

Espacio en disco
df -h /hana/shared /hana/data /hana/log

Versión del sistema operativo
cat /etc/os-release

Sistemas operativos soportados

• SUSE Linux Enterprise Server (SLES) 12 SP5, 15 SP2+
• Red Hat Enterprise Linux (RHEL) 7.9, 8.x, 9.x

Verificar versión SLES
cat /etc/SuSE-release 2>/dev/null || cat /etc/os-release

Verificar versión RHEL
cat /etc/redhat-release

Instalación de SAP HANA Cockpit

Método 1: Instalación integrada con SAP HANA

Si instalas SAP HANA 2.0 SPS05 o superior, el Cockpit se incluye por defecto con XSA.

Verificar si XSA está instalado
sudo su - adm
xs apps

Salida esperada si está instalado:
name                    requested state   instances   urls
cockpit-admin-web-app   STARTED           1           ...
cockpit-web-app         STARTED           1           ...

Método 2: Instalación standalone del Cockpit

Para gestionar múltiples sistemas HANA, puedes instalar el Cockpit de forma independiente.

#### Paso 1: Descargar el software

Accede al SAP Software Download Center (requiere S-User):

• Producto: SAP HANA COCKPIT
• Versión: 2.0 (última disponible)

Crear directorio de instalación
sudo mkdir -p /software/cockpit
cd /software/cockpit


Descomprimir el archivo SAPCAR
./SAPCAR -xvf IMDB_COCKPIT*.SAR

#### Paso 2: Preparar el sistema

Verificar límites del sistema
ulimit -a

Configurar límites recomendados en /etc/security/limits.conf
cat >> /etc/security/limits.conf << EOF
adm soft nofile 1048576
adm hard nofile 1048576
adm soft nproc unlimited
adm hard nproc unlimited
EOF

Aplicar cambios
sysctl -p

#### Paso 3: Ejecutar la instalación

Cambiar al usuario administrador HANA
sudo su - adm

Navegar al directorio de instalación
cd /software/cockpit/SAP_HANA_COCKPIT

Ejecutar instalador
./hdblcm --action=install

O instalación silenciosa con archivo de configuración
./hdblcm --action=install --configfile=/path/to/install.cfg

#### Paso 4: Verificar la instalación

Como usuario adm
xs apps | grep cockpit

Verificar estado de los servicios
xs app cockpit-web-app
xs app cockpit-admin-web-app

Comprobar logs de instalación
cat /var/log/hdb_install.log | tail -50

Configuración Inicial del Cockpit

Registrar sistemas HANA en el Cockpit

Una vez instalado, necesitas registrar las bases de datos que deseas administrar:

Conectar al Cockpit Manager vía línea de comandos
xs login -a https://:51000 -u XSA_ADMIN -p  -s SAP

Listar organizaciones disponibles
xs orgs

Ver espacios
xs spaces

Crear usuarios de administración

-- Conectar a la base de datos del Cockpit
-- Desde hdbsql o HANA Studio

-- Crear usuario administrador del Cockpit
CREATE USER COCKPIT_ADMIN PASSWORD "" NO FORCE_FIRST_PASSWORD_CHANGE;

-- Asignar rol de administración
GRANT COCKPIT_ADMIN TO COCKPIT_ADMIN;
GRANT COCKPIT_RESOURCE_ADMIN TO COCKPIT_ADMIN;

Comando hdbsql para administración

Conectar a la base de datos SYSTEMDB
hdbsql -i  -d SYSTEMDB -u SYSTEM -p 

Listar usuarios del Cockpit
SELECT * FROM "SYS"."USERS" WHERE USER_NAME LIKE '%COCKPIT%';

Ver roles asignados
SELECT * FROM "SYS"."GRANTED_ROLES" WHERE GRANTEE = 'COCKPIT_ADMIN';

Gestión de Usuarios y Roles

Roles predefinidos del Cockpit

Asignar roles desde línea de comandos

-- Crear usuario con acceso al Cockpit
CREATE USER MONITOR_USER PASSWORD "SecurePass123!" NO FORCE_FIRST_PASSWORD_CHANGE;

-- Asignar rol de solo lectura
GRANT COCKPIT_USER TO MONITOR_USER;

-- Para operadores
GRANT COCKPIT_OPERATOR TO MONITOR_USER;

-- Verificar asignación
SELECT * FROM "SYS"."GRANTED_ROLES" WHERE GRANTEE = 'MONITOR_USER';

Monitorización del Sistema

Verificar estado del Cockpit desde Linux

Estado de procesos HANA
sudo su - adm
HDB info

Estado específico de XSA
xs apps

Verificar memoria utilizada por componentes
ps aux | grep -E 'hdb|xsa' | awk '{sum+=$6} END {print "Total MB: " sum/1024}'

Logs del Cockpit
tail -f /hana/shared//xs/controller_data/log/xscontroller*.log

Consultas SQL útiles para monitorización

-- Estado general del sistema
SELECT * FROM "SYS"."M_SYSTEM_OVERVIEW";

-- Uso de memoria
SELECT HOST, 
       ROUND(USED_MEMORY_SIZE/1024/1024/1024, 2) AS USED_GB,
       ROUND(TOTAL_MEMORY_SIZE/1024/1024/1024, 2) AS TOTAL_GB
FROM "SYS"."M_HOST_RESOURCE_UTILIZATION";

-- Conexiones activas
SELECT COUNT(*) AS ACTIVE_CONNECTIONS, 
       CONNECTION_STATUS 
FROM "SYS"."M_CONNECTIONS" 
GROUP BY CONNECTION_STATUS;

-- Alertas activas
SELECT * FROM "_SYS_STATISTICS"."STATISTICS_ALERTS_BASE" 
WHERE ALERT_TIMESTAMP > ADD_DAYS(CURRENT_TIMESTAMP, -1)
ORDER BY ALERT_TIMESTAMP DESC;

Gestión de Backups desde el Cockpit

Configurar backups automáticos

-- Crear backup completo desde hdbsql
BACKUP DATA USING FILE ('/hana/backup/data/COMPLETE_');

-- Backup diferencial
BACKUP DATA DIFFERENTIAL USING FILE ('/hana/backup/data/DIFF_');

-- Verificar backups existentes
SELECT * FROM "SYS"."M_BACKUP_CATALOG" 
ORDER BY UTC_END_TIME DESC 
LIMIT 10;

Script de backup automatizado

#!/bin/bash
/home/adm/scripts/backup_hana.sh

SID=""
INSTANCE=""
BACKUP_DIR="/hana/backup/data"
DATE=$(date +%Y%m%d_%H%M%S)
LOG_FILE="/var/log/hana_backup_${DATE}.log"

echo "[$(date)] Iniciando backup de ${SID}" >> ${LOG_FILE}

Ejecutar backup
/usr/sap/${SID}/HDB${INSTANCE}/exe/hdbsql \
    -i ${INSTANCE} \
    -d SYSTEMDB \
    -u SYSTEM \
    -p "${SYSTEM_PASSWORD}" \
    "BACKUP DATA USING FILE ('${BACKUP_DIR}/COMPLETE_${SID}_${DATE}')" \
    >> ${LOG_FILE} 2>&1

if [ $? -eq 0 ]; then
    echo "[$(date)] Backup completado exitosamente" >> ${LOG_FILE}
else
    echo "[$(date)] ERROR: Backup fallido" >> ${LOG_FILE}
    # Enviar alerta
    mail -s "ALERTA: Backup HANA ${SID} fallido" admin@empresa.com < ${LOG_FILE}
fi

Troubleshooting Común

Problema 1: No se puede acceder al Cockpit

Verificar que XSA está corriendo
xs apps

Si no responde, reiniciar XSA
xs-controller stop
xs-controller start

Verificar logs de errores
tail -100 /hana/shared//xs/controller_data/log/xscontroller_*.trc

Verificar certificados SSL
openssl s_client -connect :51039 -showcerts

Problema 2: Error de autenticación

Verificar usuario en la base de datos
hdbsql -i  -d SYSTEMDB -u SYSTEM -p  \
    "SELECT USER_NAME, USER_DEACTIVATED FROM SYS.USERS WHERE USER_NAME=''"

Desbloquear usuario
hdbsql -i  -d SYSTEMDB -u SYSTEM -p  \
    "ALTER USER  ACTIVATE USER NOW"

Resetear contraseña
hdbsql -i  -d SYSTEMDB -u SYSTEM -p  \
    "ALTER USER  PASSWORD 'NuevaPassword123!'"

Problema 3: Cockpit lento o no responde

Verificar uso de recursos
top -u adm

Verificar espacio en disco
df -h /hana/shared

Limpiar logs antiguos
find /hana/shared//xs/controller_data/log -name "*.trc" -mtime +30 -delete

Reiniciar aplicaciones del Cockpit
xs restart cockpit-web-app
xs restart cockpit-admin-web-app

Problema 4: Error de conexión a base de datos registrada

Verificar conectividad de red
ping 
telnet  315

Verificar puertos abiertos en firewall
sudo iptables -L -n | grep 

Test de conexión SQL
hdbsql -n :315 -u SYSTEM -p  "SELECT 1 FROM DUMMY"

Comandos de Administración XSA Esenciales

Login al controller XSA
xs login -a https://:51000 -u XSA_ADMIN -p  -o  -s 

Listar todas las aplicaciones
xs apps

Ver logs de una aplicación
xs logs cockpit-web-app --recent

Reiniciar aplicación
xs restart cockpit-web-app

Escalar aplicación (aumentar instancias)
xs scale cockpit-web-app -i 2

Ver estado del controller
xs-controller status

Actualizar el Cockpit
xs update cockpit-web-app -p /path/to/new/cockpit.zip

Mejores Prácticas de Seguridad

Configurar HTTPS con certificados propios

Generar CSR para certificado
openssl req -new -newkey rsa:2048 -nodes \
    -keyout cockpit.key \
    -out cockpit.csr \
    -subj "/C=ES/ST=Madrid/L=Madrid/O=Empresa/CN=saphana.empresa.com"

Importar certificado firmado
xs set-certificate -n cockpit-cert -c cockpit.crt -k cockpit.key

Configurar políticas de contraseñas

-- Política de contraseñas estricta
ALTER SYSTEM ALTER CONFIGURATION ('nameserver.ini', 'SYSTEM') 
SET ('password policy', 'minimal_password_length') = '12';

ALTER SYSTEM ALTER CONFIGURATION ('nameserver.ini', 'SYSTEM') 
SET ('password policy', 'password_lock_time') = '1440';

ALTER SYSTEM ALTER CONFIGURATION ('nameserver.ini', 'SYSTEM') 
SET ('password policy', 'maximum_invalid_connect_attempts') = '5';

Conclusión

SAP HANA Cockpit es la herramienta moderna de administración que todo administrador SAP BASIS debe dominar. Con los comandos y procedimientos de esta guía, podrás:

• Instalar y configurar el Cockpit en entornos Linux
• Gestionar usuarios y roles de forma eficiente
• Monitorizar el rendimiento de tus bases de datos
• Resolver problemas comunes rápidamente

Siguiente paso recomendado: Revisa nuestra guía de instalación del SAP HANA Cockpit para un tutorial paso a paso con capturas de pantalla.

Recursos Adicionales

• SAP HANA Studio Tutorial en Español
• Transacciones SAP BASIS
• Puertos utilizados en SAP
• Documentación oficial SAP HANA Cockpit

Preguntas Frecuentes

¿Cuál es la diferencia entre SAP HANA Cockpit y SAP HANA Studio?

SAP HANA Cockpit es una aplicación web moderna que se ejecuta en el navegador, ideal para administración centralizada de múltiples sistemas. SAP HANA Studio es un cliente de escritorio basado en Eclipse, más potente para desarrollo SQL pero en modo mantenimiento. SAP recomienda usar Cockpit para administración y reservar Studio solo para desarrollo avanzado.

¿Qué puerto usa SAP HANA Cockpit por defecto?

El puerto HTTPS del Cockpit sigue el patrón 4${instance}39. Para una instancia 10, el puerto sería 51039. La URL completa sería https://:51039/sap/hana/cockpit.

¿Puedo administrar múltiples sistemas HANA desde un solo Cockpit?

Sí, esa es precisamente una de las ventajas principales del Cockpit. Puedes instalar el Cockpit de forma standalone y registrar múltiples bases de datos HANA para administrarlas desde una única interfaz centralizada.

¿Cómo verifico si el Cockpit está funcionando correctamente?

Desde la línea de comandos Linux, ejecuta xs apps | grep cockpit como usuario adm. Deberías ver las aplicaciones cockpit-web-app y cockpit-admin-web-app en estado STARTED. También puedes verificar accediendo a la URL del Cockpit desde un navegador.

¿Es necesario XSA para usar SAP HANA Cockpit?

Sí, SAP HANA Cockpit es una aplicación XS Advanced (XSA), por lo que requiere que XSA esté instalado y configurado. En SAP HANA 2.0 SPS05 y versiones posteriores, XSA y el Cockpit se incluyen por defecto durante la instalación de HANA.

Si quieres conocer otros artículos parecidos a SAP HANA Cockpit: Guia Completa de Administracion y Monitorizacion puedes visitar la categoría SAP BASIS.