✒️El manejo de la herramienta SAPinst

Manejando la Herramienta SAPinst

1.- Resumen de SAPinst

SAPinst incluye un SAPinst 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 estan 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.

2.- Iniciando SAPinst

El siguiente procedimiento inicia SAPinst en Windows en un host:

1. Nos logueremos al host con un usuario miembro del grupo de administradores locales

2. Iniciaremos 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_insdir, 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 ambiente TEMP. SAPinst crea un subdirectorio para cada tipo de instalación que ejecutemos en ese host.

Nota: SAPinst siempre busca por la variable de ambiente SAPINST_JRE_HOME en primer lugar, si esta 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 directo 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.

Nota: 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:

· Realizar 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

· Inicia SAPinst desde el directorio de descarga o copia del installation Master con el comando ./sapinst.

Nota: Asegúrate 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 debajo del directorio temporal. SAPinst encuentra este directorio verificando la variable de ambiente TEMP, TMP o TMPDIR. Si ningun valor se ha configurado para estas variables, SAPinst utiizará por defecto el directorio /tmp. Debemos asegurarnos que el directorio temporal tiene los permisos 777.

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.

Nota: Asegurate 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 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 esta 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

3.- 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 sevidor 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 e siguiente procedimiento:

· Ingresamos al host remoto

a) Windows: como un usuario miembro del grupo local de Administradores.

b) Unix: comando root

· Iniciamos SAPinst desde la ubicación donde copiamos el installation Master media con el siguiente comando:

a) Windows: startinstgui.bat -host

b) Unix : ./startInstGui.sh -host

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

a) Windows: startinstgui.bat –h

b) Unix: ./startInstGui.sh –h

4.- Resolucion de problemas con SAPinst

Si un error ocurre, SAPinst detiene la instalación y muestra un dialogo informando sobre el error.

En este caso, podemos observar el archivo de log seleccionado 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.

Nota: 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.

· 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%.stdgui

b) Unix: /.stdgui

Si SAPinst no inicia, verificaremos 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 dialogo 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

Descripción de Funciones:

· F1: Muestra información detallada sobre cada parámetro de entrada

· Back: Muestra la pantalla anterior de dialogo 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: Continua la instalación

c) Log Off: Detiene el SAPinst GUI, pero SAPinst y el servidor GUI continúan corriendo. Mas tarde es posible volver a conectarse a la instalación desde la misma computadora u otra iniciando nuevamente SAPinst GUI de forma separada.

d) View Log: Muestra el contenido de sapinst.log durante la instalación

e) Retry: Realiza el último paso de la instalación nuevamente, si ha ocurrido un error.