Introducción a SAPControl
La utilidad SAPControl es la herramienta fundamental para administrar el ciclo de vida de los sistemas SAP desde la línea de comandos. Provee una interfaz uniforme tanto para entornos UNIX como Windows.
startsap y stopsap
están obsoletos (deprecated) según las Notas SAP 1763593 y 809477. SAP recomienda
migrar todo el control operativo a SAPControl.
Requisitos Previos
- Haber iniciado sesión en el host del sistema SAP con el usuario
<sapsid>adm. - Conocer el número de instancia (Instance Number) que se desea gestionar.
Comandos de Arranque (Start)
Puede iniciar tanto el sistema completo como instancias individuales.
1. Iniciar el Sistema Completo
UNIX:
/usr/sap/hostctrl/exe/sapcontrol -nr <instance_number> -function StartSystem
Windows:
%ProgramFiles%\SAP\hostctrl\exe\sapcontrol.exe -nr <instance_number> -function StartSystem
2. Iniciar una Instancia Específica (Remota)
Para controlar instancias en otros hosts, es necesario añadir los parámetros de host y credenciales:
sapcontrol –nr <n> -host <remote_host> –user <sid>adm <password> -function Start
Comandos de Parada (Stop)
Del mismo modo que en el arranque, se puede detener el sistema o una instancia.
1. Detener el Sistema Completo
UNIX:
/usr/sap/hostctrl/exe/sapcontrol -nr <instance_number> -function StopSystem
Windows:
%ProgramFiles%\SAP\hostctrl\exe\sapcontrol.exe -nr <instance_number> -function StopSystem
Monitorización y Verificación
SAPControl permite verificar el estado real de los procesos en tiempo de ejecución.
Listar Instancias del Sistema
Muestra todas las instancias registradas y sus puertos asociados:
sapcontrol -nr <n> -function GetSystemInstanceList
Listar Procesos de la Instancia
Muestra el estado detallado de los procesos (disp+work, icman, gwrd, etc.):
sapcontrol -nr <n> -function GetProcessList
Un estado GREEN indica un proceso saludable; YELLOW indica inicialización; GRAY indica que está detenido.
Resolución de Problemas (Troubleshooting)
Error: FAIL: NIECONN_REFUSED
Este error indica que el servicio web de gestión (sapstartsrv) no responde o no está en
ejecución.
Solución: Inicie el servicio antes de intentar el arranque del sistema:
sapcontrol -nr <instance_number> -function StartService <SAPSID>
Ayuda Completa
Para ver todas las funciones disponibles (GetVersion, GetEnvironment, etc.):
sapcontrol -help