- STTA proporciona un asistente para Instalar/Actualizar el módulo y coordinar la configuración y puesta en marcha de algunos servicios.
- El asistente es una heramienta para proporcionar una secuencia apropiada de pasos o fases, al mismo tiempo que porporciona los detalles necesarios como: ayuda on-line, características de las opciones, verificación de los pasos, etc. %W%
- El asistente permite recargar los valores predefinidos para la tarea en ejecución (reglas, procedimientos, ayudas, etc.), además permite cargar procedimientos nuevos en tiempo de ejecución del mismo.%OK%
- Se ofrecen dos modos de operación: <exec $text{browse}> o <exec $text{run}>, bajo esta última se asegura el bloqueo de acceso a STTA.
- Entre las opciones disponibles está la de inicializar la configuración de STTA con un mínimo de valores entorno a 58. %I%
- Se incorporan procedimientos y funcionalidades de STTA entre las opciones.
- Según las tareas, permite cargar ficheros con parches, reglas, procedimientos, etc.
- Los elementos "comunes" a todas las tareas son:

  - Bloqueo de STTA
  - Tareas definidas
  - Procedimientos
  - Reglas
  - Interface del Asistente de STTA

  Nota: en los gráficos que se muestran los "links" no son operativos, son sólo imágenes de pantalla.

Tareas definidas
%HRTABLE%
Las tareas definidas aparecen entre las opciones posibles en la primera pantalla de seleción del asistente:

- <exec $text{install}>
- <exec $text{update}>
- <exec $text{upgrade}>
- <exec $text{patch}>
- <exec $text{joinarray}>
- <exec $text{masterstta}>
- <exec $text{loadfiles}>

El fichero de log generado en cada sesión permite trazar cada petición de <exec $text{run}> solicitada:

- Se indica: # ---- opción --- tarea ---------------------------
- task= tarea en ejecución
- now= día y hora del sistema operativo
- step= ocpión ejecutada
- next= siguiente opción en la secuencia
- rule= regla de la tarea con las opciones y su secuencia
- tdone= lista de opciones ya ejecutadas separadas por comas ( 1 ya ejecutada )
- steps= lista de valores de cada opción separados por comas ( 1 ejecutar una sola vez )
- proc= procedimiento principal de la tarea

Los logs de la sesión son registrados en el directorio <exec $config_directory>/stta/[nombre-de-la-tarea], donde se crea un archivo del tipo año_mes_dia_HoraMinutosSegundos (ejemplo: <exec &out_now_filename()>_log).

Bloqueo de STTA
%HRTABLE%

- Para <exec $text{run}> tareas se requiere el BLOQUEO de STTA (usar el botón de la interface en la esquina derecha), esto significa que:

  - Cualquier petición de acceso al módulo es redirigida a una pantalla que muestra el "status" de bloqueo y el icono de "Instalar/Actualizar" para acceder al asistente.
  - Se genera un fichero ".insupd.lock" en <exec $config_directory>/stta con detalles de log de las reglas ejecutadas, etc.
  - No se puede acceder a la interface de menús de STTA mientras el bloqueo esté activo ( exista el fichero ".insupd.lock" en <exec $config_directory>/stta).
  - El bloqueo es un método de precaución, establece un modo operativo, pero no asocia o asegura bloqueos exclusivos a las peticiones http/https.
- La opción del "botón" de <exec $text{unlockstta}> cierra coherentemente los logs de la sesión, que son registrados en el directorio correspondiente. Además se libera el bloqueo de STTA.

Procedimientos
%HRTABLE%

- Cada tarea tiene un procedimiento principal y cada opción de su secuencia de pasos está relacionada con un procedimiento o funcionalidad del entorno.
- Se utilizan procedimientos establecidos pero también pueden cargarse otros nuevos en tiempo de ejecución si la tarea carga ficheros adicionales.
- Se incorporan procedimientos específicos que usan otras funcionalidades de STTA para:
  - <exec &hlink($text{sttaconfig},'sttaconfig')>
  - Servicios con <exec &hlink($text{stup_ldapcache},'stup_ldapcache')>
  - Configuración de OpenLDAP (ver <exec &hlink($text{stup_ldaptypes},'stup_ldaptypes')>)
  - Informes/comprobaciones del entorno
  - Ajustes en Tarantella
  - Creación de infraestructuras de ficheros, logs,etc.
  - Creación de scripts y herramientas del entorno (ver <exec &hlink($text{inface_scripts},'inface_scripts')>).
  - Al <exec $text{sv_histAct_title}> para ver detalles de errores en los logs.
- Es recomendable primero usar <exec $text{browse}> sobre los procedimientos de modo que pueda leerse la información adicional, gran parte de los procedimientos, sobre todo los que sólo se pueden ejecutar una sola vez, puden cambiar y alterar los servicios del entorno.
- Los errores que producen la ejecución de los procedimientos se muestran el la cabeza del cuerpo de la pantalla y pueden estabnlecer enlaces a <exec $text{sv_histAct_title}>.
- Lo aconsejable es seguir el orden de la secuencia establecida de ejecución pero algunas opciones pueden ejecutarse más de una vez y realizar comprobaciones adicionales.
- La selección de cada opción presenta un formulario o al menos un botón de <exec $text{make}> para continuar la ejecución.

Reglas
%HRTABLE%

- Las reglas se establecen en el fichero "rules" de cada tarea (en $STTA/[nombre-de-tarea], por ejemplo : $STTA/patch/rules )
- Cada regla registra tres entradas:

  - nombre (ej: upgrade) y la lista de las opciones por orden de secuencia separadas por comas. ( ej: upgrade=lockstta,readme1st,doupgrade,fixstampdata,readmelast,unlockstta ).
  - nombre_proc (ej: upgrade_proc) y el nombre del procedimiento principal para ejecutar la tarea. ( ej: upgrade_proc=do_upgrade ).
  - nombre_steps (ej: upgrade_steps) y el valor 0 ó 1 para indicar si se puede o no ejecutar más de una vez la opción correspondiente, cada opción tiene un valor separado por comas. ( ej: upgrade_steps=1,0,1,1,0,1).
- El registro principal de reglas está en $STTA/install/rules, puede ser recargado con los valores del directorio correspondiente a la tarea o del instalado por el archivo de carga si l hubiere.

Interface del Asistente
%HRTABLE%
Presenta la siguiete imagen con distintos paneles:

Ver

En las cabeceras de cada panel se muestra el nombre que lo identifica junto a la tarea u opción que se está procesando, los paneles son:

- El Panel de Mensajes y Status es donde se visualizan los mensajes de ejecución de las opciones, así como la presentación de los formularios necesarios para la ejecución de las mismas.
- El Panel de Opciones muestra las opciones disponibles para la tarea seleccionada y el botón de "envio de peticicón" que corresponda.
- El Panel de Ayuda o INFO presenta los ficheros de ayuda del asistente.
- El Panel de Ayuda General es un leyenda con notas explicativas sobre los iconos y colores de las opciones así como del contenido de cada panel.
- El Modo de Ejecución permite

Panel de Mensajes y Status
%HRTABLE%
Situado al principo del cuerpo de la pantalla como encabezado de la misma:

- Muestra los mensajes de ejecución de las opciones.
- Presenta los formularios necesarios para la ejecución de las opciones y sólo cuando es necesario.
- Muestra el "status" de bloqueo de STTA
- Muestra otros detalles del entorno (Sistema operativo, versiones, hostname, stta-brand, etc.).

Ver

Panel de Opciones
%HRTABLE%
Está situado en la izquierda del centro del cuerpo de la pantalla.
Cada Tarea tiene unas reglas predefinidas en función de las cuales se construye el menú de opciones:

- Muestra las opciones disponibles para la tarea seleccionada.
- Usa iconos para indicar y diferenciar las opciones ver panel de ayuda general más abajo.
- El botón del final de este panel es el que se usa para <exec $text{browse}> o para <exec $text{run}> la opción marcada, según el Modo de Ejecución en el que se encuentre.

Ver

Panel de Ayuda o INFO
%HRTABLE%
Situado en la parte derecha del cuerpo de la patalla, está concebido como una ventana de ayuda, en la que se compone el contenido de la ayuda relacionada con la opción seleccionada de la tarea.

Estos fichero residen en el directorio "$STTA/[tarea]/info" con la misma estructura que la de los ficheros generales de <exec &hlink($text{inface_help},'inface_help')> del módulo.

Ver

Panel de Ayuda General
%HRTABLE%
Situado hacia el final del cuerpo de la pantalla.
Ofrece una "leyenda" o relación de los paneles y el significado de los iconos de las opciones:

<tr <exec $tb>>
<tr <exec $cb>>

<exec $text{help}>: <exec $text{'index_installupd'}>

<tr <exec $cb>>
<tr <exec $cb>>
<exec $text{black_line}> | <exec $text{step_runonce}> | <exec $text{this_colorline}> | <exec $text{step_current}>

<tr <exec $cb>>
(<exec $text{'visited'}> N)

<exec $text{'nro_visited'}>

<tr <exec $cb>>

<exec $text{step_next}> -- (<exec $text{nextstep}>)

<tr <exec $cb>>

<exec $text{steps_done}> -- (<exec $text{done}>)

<exec $text{note}> | <exec $text{help_msg1}>

Modo de Ejecución
%HRTABLE%
Justo al final del cuerpo de pantalla, puede en algunos casos no aparecer si no hay mensajes que mostrar. Se usa para avisos o mensajes de precaución:

Ver

El mensaje "<exec $text{warn_lockstta2}>" indica que se trabaja con <exec $text{browse}> leyendo la secuencia y las informaciones correspondientes sin ejecución alguna de las opciones. Para pasar al modo de <exec $text{run}> hay que usar el botón de <exec $text{lockstta}>.