✒️SAP BASIS / El manejo de la herramienta SAPinst Por Joaquin Moreno Duque

SAPinst

Cuando estamos por instalar un sistema SAP, luego de llevar a cabo los pasos preparatorios, utilizaremos la herramienta SAPinst para ejecutar la misma. Tendremos que conocer, además de como iniciar la herramienta y las funciones principales, donde y que archivos de log son generados por SAPinst para en casos que suceda un error durante el proceso de instalación necesitemos analizarlo.

SAPinst incluye un SAPinst GUI y un servidor GUI, ambos utilizan un Entorno de Ejecución Java (JRE). En una instalación estándar SAPinst, SAPinst GUI y el servidor GUI están corriendo en el mismo servidor. Si fuese necesario, alternativamente, podemos realizar la instalación desde un host remoto. En el host de instalación se ejecutará SAPinst y el servidor GUI, y en el host remoto SAPinst GUI.

Cuando se inicia el SAPinst, SAPins GUI y el servidor GUI también se inicia. SAPinst GUI se conecta al servidor GUI mediante una conexion SSL, y el servidor GUI se conecta a SAPinst.

Iniciando SAPinst

El siguiente procedimiento inicia SAPinst en Windows en un host:

1. Nos logeamos al host con un usuario miembro de grupo de administrador locales.
2. Iniciamos SAPinst desde la ruta donde copiamos o descargamos el DVD denominado Installation Master. El programa sapinst.exe ubicado en la ruta IM_Windows_ .

SAPinst crea el directorio de instalación sapinst_instdir, donde mantiene los archivos de log, el cual se encuentra en la carpeta Program Files. Si SAPinst no puede crear el directorio sapinst_instdir allí, intentará crearlo en el directorio definido en la variable de entorno TEMP. SAPinst crea un subdirectorio para cada tipo de instalación que ejecutemos en ese host.

Nota: Tener en cuante que SAPinst siempre busca por la variable de ambiente SAPINST_JRE_HOME en primer lugar, si está no existe entonces recurre a JAVA_HOME.

El auto-extractor SAPinst extrae los ejecutables a un directorio temporal (TEMP, TMP, TMPDIR, o SystemRoot). Estos ejecutables se borran después de que SAPinst detiene su ejecución. Los directorios llamados sapinst_exe.xxxxxx.xxxx muchas veces permanecerán en el directorio temporal. Estos pueden ser borrados sin inconvenientes.

El directorio temporal también contiene el archivo de log del Auto-Extractor de SAPinst dev_selfex.out, el cual puede ser útil ante algún error durante la extracción.

Si SAPinst no puede encontrar un directorio temporal, la instalación termina con el error FCO-00058.

Si por alguna razón queremos finalizar SAPinst y el auto-extractor de SAPinst, selecciona una de las siguientes opciones:

1. Realiza clic derecho sobre el ícono de SAPinst que se encuentra en la bandeja de Windows y selecciona Exit.
2. Clic sobre el icono de SAPinst en la bandeja de Windows y selecciona File - > Exit

En Unix inicia SAPinst de la siguiente manera:

1. Ingresa al host con el usuario root.
2. Inicia SAPinst desde el directorio de descarga o copia del Installation Master con el comando ./sapinst

tener en cuenta que el usuario root no tiene configurada variables de ambiente para otros sistemas SAP o base de datos.

SAPinst normalmente crea el directorio de instalación sapinst_instdir directamente en el directorio temporal. SAPinst encuentra este directorio verificando la variable de ambiente TEMP, TMP o TMPDIR. Si ningún valor se ha configurado para estas variables, SAPinst utilizará por defecto el directorio /tmp. Debemos asegurarnos que el directorio temporal tiene los permisos 777 ((Rwxrwxrwx) No hay restricciones en los permisos. Cualquier persona puede hacer cualquier cosa. Generalmente no es un escenario deseable.).

El auto-extractor de SAPinst extrae los ejecutables de SAPinst en el directorio temporal. Estos ejecutables son borrados una vez que SAPinst se detiene. Si es necesario, podemos detener SAPinst y el auto-extractor de SAPinst mediante la combinación de teclas CTRL C. El directorio temporal también contiene el log del auto-extractor de SAPinst dev_selfex.out.

Durante la instalación, los puertos por defecto 21200 y 21212 son usados para la comunicación entre SAPinst, el servidor GUI, y SAPinst GUI. SAPinst usa el puerto 21200 para comunicarse con el servidor GUI. El GUI server usa el puerto 21212 para comunicarse con SAPinst GUI.

Si alguno de estos puertos está ya ocupado por otro servicio se obtendra un mensaje de error . En este caso podemos iniciar sapinst con los siguientes parámetros en una ventana de comandos:

• SAPINST_DIALOG_PORT=
• GUISERVER_DIALOG_PORT=

Para ver las propiedades de SAPinst, se debe inicial sapint con el parámetro -p:

• En Windows: sapinst,exe -p
• En UNIX: ./sapint -p

Instalación Remota con SAPinst

SAPinst también puede ser usado para realizar una instalación remota. Esto permite instalar un sistema SAP en un host diferente (el host remoto) mientras que se monitorea la instalación con el SAPinst GUI en un computador local (host local) ya sea en Windows o UNIX.

Los prerrequisitos para realizar una instalación remota con SAPinst son:

• Que ambos equipos estén en la misma Red y sean alcanzadas con un ping una a la otra.
• El servidor SAPinst usa los puertos 21200 y 21212 para comunicarse con SAPinst GUI. Si uno de estos puertos esta siendo usado por otro servicio, SAPinst devolverá un error.

Iniciamos SAPinst con el siguiente procedimiento:

1. Ingresamos al host remoto con un usuario administrador.

2. Se lanza el SAPinst desde la ubicación donde fue copiado el Installation Master con el siguiente comando:

• En Windows: sapinst.exe -nogui
• En Unix: ./sapinst -nogui

3.En el host

• En Windows: startinstgui.bat -host
• En Unix: ./startInstGui.sh -host

Para esto deberemos contar con una copia del Installation Master en la computadora local.

Para una lista completa de opciones para iniciar SAPinst GUI, podemos usar el comando:

a. Windows: startinstgui.bat –h

b. Unix: ./startInstGui.sh – h

Resolución de Problemas con SAPinst

Si se genera algun error, SAPinst detiene la instalacion y muestra un dialogo informandolo. En este caso, podemos observar el archivo de log seleccionando View Log. Si podemos resolver el error manualmente, podemos hacerlo mientras dejamos el SAPinst abierto. Luego de soluccionar el problema manualmente, seleccinoamos, Retry para continuar con la instalación.

Notas: Hay algunas situaciones de error donde simplemente seleccionando Retry SAPinst continúa la instalación sin problemas, por esto es que es recomendable probar esta opción antes de analizar con mayor profundidad el error.

TOda la información de la instalación se registra en varios archivos de log. Los principales archivos generados por SAPinst son:

• sapinst.log: Información del progreso de la instalación.
• saoinst_dev.log: registra todos los mensajes de cada paso de la instalación en detalle.

Los archivos sapinst.log y sapinst_dev.log pueden ser encontrados en el directorio de instalación.

Adicionalmente otros archivos de log son creados durante el proceso de instalación. Estos archivos son referenciados en sapinst.log y sapinst_dev.log.

Los logs de SAPinst GUI y el Servidor son escritos en la carpeta

• Windows: %userprofile%.stdgui
• Unix: /.stdgui

Si SAPinst ni inicia, verifiquemos el archivo stdstar.err en la ubicación anterior.

SAPinst -Archivos XML

SAPinst es controlado mediante archivos XML. Los principales arhivos XML son:

• dialog.xml: contiene todos los mensajes de dialogos usados en la instalación.
• keydb.xml: SAPinst registra el progreso de la instalación y las entradas realizadas por el usuario en este archivo.
• messages.xml: contiene todos los mensajes usados en la instalación.
• control.xml: contiene la definición de componentes usada por SAPinst.
• packages.xml: para la administración de los paquetes de software.

Manejo de SAPinst GUI

Cuando usamos el SAPinst GUI, las siguientes funciones están disponibles en las diferentes pantallas de diálogo (pantallas de entrada, pantalla de progreso de instalación, ventana de mensajes).

Descripción de Funciones

• F1: Muestra informacón detallada sobre cada parámetro de entrada.
• Back: Muestra la pantalla anterior de diálogo para edición.
• Exit: Cancela la instalación con las siguientes opciones:

1. Stop: Detiene la instalación sin otros cambios a los archivos de instalación Luego es posible reiniciar la instalación con SAPinst desde el punto en que se detuvo.
2. Continue: Continua la instalación.
3. Log Off: Detiene el SAPinst GUI, pero SPAinst y el servidor GUI continua corriendo. Más tarde es posible volver a conectarse a la instalación desde la misma computadora u otra iniciando nuevamente SAPinst GUI de forma separada.

• View Log: Muestra el contenido de sapinst.log durante la instalación.
• Retry: Realiza el último paso de la instalación nuevamente, si ha ocurrido un error.