✒️El manejo de la herramienta SAPinst
El manejo de la herramienta SAPinst
El manejo de la herramienta 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 en casos que necesitemos analizar algún error que suceda durante el proceso de instalación.
El resumen de SAPinst
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 una computadora remota. En el host de instalación se ejecutará SAPinst y el servidor GUI, y en la computadora remota SAPinst GUI.
Cuando iniciamos SAPinst, SAPinst GUI y el servidor GUI también se inicia. SAPinst GUI se conecta al servidor GUI mediante una conexión SSL, y el servidor GUI se conecta a SAPinst.
Iniciando SAPinst
El siguiente procedimiento inicia SAPinst en Windows en un host:
- Nos logueamos al host con un usuario miembro del grupo de administradores locales
- 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 ambiante TEMP. SAPinst crea un subdirectorio para cada tipo de instalación que ejecutemos en ese host.
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 temporario. 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 queremos finalizar SAPinst y el auto-extractor de SAPinst, selecciona una de las siguientes opciones:
- Realiza clic-derecho sobre el ícono de SAPinst que se encuentra en la bandeja de Windows y selecciona Exit.
- Clic sobre el icono de SAPinst en la bandeja de Windows y selecciona File -> Exit.
En Unix inicia SAPinst de la siguiente manera
- Ingresa al host con el usuario root
- I SAPinst desde el directorio de descarga o copia del Installation Master con el comando ./sapinst
Asegurate que el usuario root no tiene configurada variables de ambiente para otros sistemas SAP o base de datos.
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.
Asegúrate que el sistema operativo no borra el contenido del directorio temporal /tmp o el contenido de los directorios a los cuales las variables TEMP, TMP, o TMPDIR apuntan.
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
Obtendremos un mensaje de error si alguno de estos puertos está ya ocupado por otro servicio. En este caso podemos iniciar sapinst con los siguientes parámetros en una ventana de comandos:
SAPINST_DIALOG_PORT= , GUISERVER_DIALOG_PORT=
Para conseguir una lista de todas las propiedades de SAPinst, inicia sapinst con el parámetro –p:
- Windows: sapinst.exe -p
- UNIX: ./sapinst –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 monitoreamos la instalación con el SAPinst GUI en una computadora local (host local) ya sea Windows o Unix.
Los prerrequisitos para realizar una instalación remota con SAPinst son:
- Ambas computadoras se encuentran en la misma red y pueden verse mediante un ping una con otra.
- El servidor SAPinst usa los puertos 21200 y 21212 para comunicarse con SAPinst GUI. Si uno de estos puertos es utilizado por algún otro servicio, SAPinst devuelve un error
Iniciamos SAPinst con el siguiente procedimiento:
1. Ingresamos al host remoto
- a. como un usuario miembro del grupo local de Administradores.
- b. como root.
2. I SAPinst desde la ubicación donde copiamos el Installation Master media con el siguiente comando:
- a. Windows: sapinst.exe –nogui
- b. Unix: ./sapinst – nogui
3. En el host local iniciamos SAPinst GUI ejecutando el siguiente comando:
- a. Windows: startinstgui.bat –host
- b. 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 un error ocurre, SAPinst detiene la instalación y muestra un diálogo informando sobre el error. En este caso, podemos observar el archivo de log seleccionando View Log. Si podemos resolver el error manualmente, podemos hacerlo mientras dejamos SAPinst abierto. Luego de solucionar el problema manualmente, seleccionamos Retry para continuar la instalación.
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 arhivos de log. Los principales archivos generados por SAPinst son:
- sapinst.log: información del progreso de la instalación.
- sapinst_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 GUI son escritos en la carpeta.
a. Windows: %userprofile%.stdguib. Unix: /.stdgui
Si SAPinst no inicia, verifcaremos el archivo sdtstart.err en la ubicación indicada anteriormente.
SAPinst - Archivos XML
SAPinst es controlado mediante archivos XML. Los principales archivos XML son:
- dialog.xml: contiene todos los mensajes de diálogo 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, ventanas de mensajes):
Descripción de Funciones
- F1: Muestra informació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:a. 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.b. Continue: Continúa la instalación.c. Log Off:
- 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.
Sobre el autor
Publicación académica de Maria Camila Cardenas Castellanos, en su ámbito de estudios para la Carrera Consultor Basis NetWeaver.
SAP Master
Maria Camila Cardenas Castellanos
Profesión: Ingeniera Mecatrónica - Colombia - Legajo: XH28L
✒️Autor de: 99 Publicaciones Académicas
🎓Egresado de los módulos:
Presentación:
Ingeniera mecatrónica de la universidad de san buenaventura, con proyeccion en sap s/4 hana. actualmente cuento con un dos de experiencia en sap en el área de roles y perfiles.
Certificación Académica de Maria Cardenas
