✒️El manejo de la herramienta SAPinst

Lección 7: Manejando la Herramienta SAPinst

Luego de cumplir con los pasos preparatorios a la instalación del sistema SAP, procedemos utilizar la herramienta SAPInst para ejecutar la misma. Además de conocer como iniciar la herramienta y las funciones principales, debemos saber dónde y que archivos de logs son generados por SAPInst en el caso que ocurra un error en el proceso de instalación y debamos analizarlo.

Resumen de SAPinst

SAPinst incluye un SAPinst GUI y un servidor SAP GUI, estos usan 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. En caso de ser necesario, de manera simultánea podemos hacer la instalación desde un computador de manera remota. En el host de instalación se ejecutara SAPInts y el servidor GUI, y en la computadora remota se ejecuta SAPInst GUI.

Cuando iniciamos SAPinst, también se inicia SAPinst GUI y el servidor GUI. SAPInst se conecta al servidor GUI mediante una conexión SSL, y el servidor GUI se conecta a SAPinst.

Iniciando SAPint

Mediante el siguiente procedimiento se inicia SAPinst en Windows en un host:

1.- Nos logueamos al host mediante un usuario con roles de administrador local.

2.- Iniciamos SAPinst desde la ruta donde copiamos o desde donde descargamos el DVD, esta se denomina Installation Master. El programa sapinst.exe esta en la ruta IM_Windows_.

SAPinst crea el directorio de instalación sapinst_instdir, y aquí guarda los archivos de log, este está en la carpeta Program Files. En caso que SAPinst no pueda crear el directorio en esta dirección, intentara crearlo en el directorio definido en la variable de ambiente TEMP. SAPinst crea un subdirectorio para cada tipo de instalación que ejecutemos en ese host.

SAPinst primero busca por la variable de ambiente SAPINST_JER_HOME, en caso de que nos exista recurre a JAVA_HOME.

Los directorios temporales (TEMP, TMP, TMPDIR, o SystemRoot) son extraídos por el auto-extrator SAPinst. Estos se borran una vez que SAPinst detiene su ejecución. Los directorios sapinst_exe.xxxxxx.xxxx por lo general permanecen en el directorio temporal, así como también el archivo de log dev_selfex.out(este es útil si ocurre algún error durante la extracción). Estos se pueden borrar sin ningún problema.

Si SAP no encuentra un directorio temporal, la instalación termina con el error FCO-00058.

Para finalizar SAPinst y el auto-extractor de SAPinst, contamos con una de estas opciones:

.- Clic-derecho en el icono de SAPinst que está en la bandeja de Windows y luego opción Exit.

.- Clic sobre el icono de SAPinsten la bandeja Windows y luego File -> Exit.

En Unix inicia SAPinst así:

.- Ingresamos al host con root

.- Inicia SAPinst desde el directorio de descargar o copia del Installation Master con el comando. /sapinst.

Nos debemos que el usuario root no tiene configurada variables de ambiente para otros sistemas SAP p BD.

SAPinst crea el directorio de instalación sapinst_instdir debajo del directorio temporal. Este directorio lo encuentra verificando la variable de ambiente TEMP, TMP o TMPDIR. Si no se ha configurado ninguna valor para estas variables, entonces se usara por defecto el /tmp. El directorio temporal debe tener los permisos 777.

En caso que haya que detener el SAPinst y el auto-extractor de SAPinst, lo podemos hacer mediante CTRL C.

Hay que asegurarse que el SO no borre el contenido del directorio temporal /tmp o el contenido de los directorios a los las variables TEMP, TMP, o TMPDIR apuntan.

SAPinst usa el puerto 21200 para comunicarse con el servidor GUI y el GUI server usa el puerto 21212 para comunicarse con SAPinst GUI. Por lo que estos puertos deben estar disponibles para que no haya ningún inconveniente. En este caso podemos iniciar SAPinst con estos parámetros:

SAPINST_DIALOG_PORT=

GUISERVER_DIALOG_PORT=

Para conseguir una lista de todas las propiedades de SAPinst, iniciamos con el parámetro –p:

.- En Windows: sapinst.exe –p

.- En Unix: ./sapinst –p

Instalación Remota con SAPinst

Esto permite instalar SAP en un host diferente ( el host remote) mientras monitoreamos la instalación con el SAPinst GUI en una computadora local (host local), Windows o Unix.

Los prerrequisitos son:

.- Las dos computadoras deben estar en la misma red y pueden verse mediante un ping.

.- SAPinst usa el puerto 21200 para comunicarse con el servidor GUI y el GUI server usa el puerto 21212 para comunicarse con SAPinst GUI. Por lo que estos puertos deben estar disponibles para que no haya ningún inconveniente.

Iniciamos SAPinst con el siguiente procedimiento:

1.- Ingresamos al host remoto

Windows: Nos logueamos al host mediante un usuario con roles de administrador local.

Unix: como root.

2.- Iniciamos SAPinst desde el directorio donde descargamos el Installation Master media con el comando:

Windows: starinst.exe –nogui

Unix: ./sapinst -nogui

3.- En el host local iniciamos SAPIsnt GUI ejecutando el cromando:

Windows: starinstgui.bat –host

Unix: ./startInstGui.sh –host

Para iniciar SAPinst GUI para una lista de opciones, usamos el comando:

Windows: startinstgui.bat –h

Unix: ./startInstGuis.sh –h

Resolver Problemas con SAPinst

Observamos el archive log seleccionado View Log. Si el error se puede resolver de forma manual, dejamos abierto SAPinst y luego le damos a Retry para continuar la instalación.

Existen caso de error donde solo seleccionando Retry continua la instalación sin problemas, por lo que primero que nada debemos hacer esto.

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

.- sapinst.log: información sobre progreso de la instalación

.- sapinst_dev.log: mensajes de cada paso de la instalación en detalle.

Estos archivos están en el directorio de instalación. También son creados otros archivos log durante el proceso de instalación.

Los logs de SAPinst GUI y e servidor GUI estañen carpetas:

Windows: %userprofiles%.stdgui

Unix: /.stdgui

Si no inicia SAPinst verificamos el archivo sdtstart.err en el directorio de instalación.

SAPinst – Archivos XML

SAPinst es controlado por XML. Los principales son XML son:

.- dialog.xml: están todos los mensajes de diálogos usados en la instalación

.- keydb.xml: progreso de la instalación y las entradas realizadas por el usuario en este archivo.

.- messages.xml: mensajes usados en la instalación.

.- control.xml: definición de componentes usadas por SAPinst.

.- packages.xml: administración de los paquetes de SW.

Manejo de SAPinst GUI

Estas funciones están disponibles es las pantallas de diálogos (pantalla de progreso, de instalación y ventana de mensajes) al usar SAPinst:

.- F1: información detallada sobre cada parámetro de entrada.

.- Back: pantalla anterior al dialogo para edición.

.- Exit: cancela la instalación con estas opciones:

Stop: Detiene la instalación sin cambios en el archivo. Luego se puede reiniciar la instalación desde el punto en que se detuvo con SAPinst.

Continue: Continua la instalación.

Log Off: Detiene el SApinst GUI, pero SAP GUI y el servidor GUi siguen corriendo. Luego es posible conectarse a la instalación desde la misma computadora u otra iniciando de nuevo SAPinst GUI de forma separada.

View Log: nos da el contenido de sapinst.log durante la instalación.

Retry: realiza el último paso de la instalación nuevamente, en caso que haya ocurrido un error.

Agradecimiento:

Ha agradecido este aporte: Victor Navarro Naranjo