La mayoría de las opciones de configuración para Application Server se establecen en los distintos archivos de configuración. Entender cómo funcionan estos archivos es importante si deseas cambiar el comportamiento del sistema.
Todas las configuraciones en los archivos de configuración de Application Server usan el mismo formato:
Variable = Valor
...donde Variable es el nombre de la variable de Application Server que se va a establecer, y Valor es el valor para esa variable. Los nombres de las variables representan las distintas opciones o configuraciones que puedes definir para determinar cómo se comporta Application Server.
A lo largo de los archivos de configuración, el carácter numeral (#) indica un comentario. Application Server ignora estos comentarios al procesar el archivo de configuración. InterAction instala automáticamente el archivo InterAction.cfg. Este archivo incluye varios comentarios que explican el significado de las distintas configuraciones.
Muchas variables permiten múltiples valores. Siempre que ingreses una lista de elementos, sepáralos con punto y coma (;).
Por ejemplo, la variable SMTPSendAlertsTo especifica las direcciones de correo electrónico de las personas que deben recibir alertas por correo si Application Server encuentra un problema. Si quieres que estos mensajes se envíen a dos usuarios diferentes, deberías configurar esta opción así:
Uso de punto y coma para separar valores
SMTPSendAlertsTo = interactionadmin@crawford.com;iaadmin@crawford.com
Cuando ingreses valores especialmente largos, o una lista extensa de valores, puedes dividir el valor en varias líneas. Esto facilita la lectura cuando revises o edites el archivo más adelante.
Para hacer esto, ingresa una barra invertida (\) al final de cada línea. Application Server ignora el salto de línea en este caso.
Por ejemplo, el valor para methodFiles tiene varios elementos ingresados en una lista fácil de leer:
Dividir el valor en varias líneas
methodFiles = $(IRIS_ETC_DIR)/InterActionMethods.xml;\
$(IRIS_ETC_DIR)/IAMethods.xml;\
$(IRIS_ETC_DIR)/InterActionWebPageMethods.xml;\
$(IRIS_ETC_DIR)/pages.xml;\
$(IRIS_ETC_DIR)/nuggetMethods.xml;\
Sin los caracteres de barra invertida, esto se consideraría como cinco líneas separadas.
Uso de sustitución de variables
La sustitución de variables te permite establecer una variable con un valor en un archivo de configuración y luego usar el nombre de esa variable dentro de otras configuraciones. Cuando Application Server procesa el archivo de configuración, los nombres de las variables se reemplazan por sus valores.
La sustitución de variables funciona en todos los archivos de configuración de Application Server y Web Client.
Al ingresar el nombre de una variable en una configuración, debes escribirlo de la siguiente manera:
$(Nombre de la variable)
Por ejemplo, el archivo InterAction.cfg incluye una variable llamada SMTPDomain. Debes establecerla con el dominio de correo electrónico de tu organización, por ejemplo, “crawford.com”. Luego puedes usar esta variable en cualquier lugar donde necesites ingresar “crawford.com”:
Especificar una variable
SMTPDomain = crawford.com
...(otras configuraciones en el archivo)
SMTPSendAlertsTo = appserveradmin@$(SMTPDomain);iaadmin@$(SMTPDomain)
En el ejemplo anterior, Application Server sustituye el texto crawford.com por cada instancia de $(SMTPDomain). La opción SMTPSendAlertsTo se actualiza de la siguiente manera:
Uso de una variable
SMTPSendAlertsTo = appserveradmin@crawford.com;iaadmin@crawford.com
Si por alguna razón necesitas cambiar la configuración de SMTPDomain, solo tienes que modificarla en un solo lugar.
También puedes establecer variables para que no se actualicen de inmediato. Para hacer esto, debes escribirlo así:
$$(Nombre de la variable)
Por ejemplo, si estableces la variable Test como $$(SMTPDomain), el valor de Test será $(SMTPDomain), no el valor actual de SMTPDomain.
Esto se utiliza principalmente al configurar los sitios web para los proveedores de mapas de calles y clima. Las variables se evalúan cuando se genera el nugget.
Definir múltiples archivos de configuración
Puedes crear varios archivos de configuración para Application Server. Esto es útil para organizar grupos relacionados de configuraciones y facilitar el mantenimiento.
Para definir archivos adicionales, debes listarlos en la opción additionalConfigFiles en el archivo InterAction.cfg. El siguiente ejemplo define dos archivos de configuración adicionales:
Definir múltiples archivos de configuración
additionalConfigFiles = $(IRIS_ETC_DIR)/InterActionWebPage.cfg;\
$(IRIS_HOME_DIR)/additionalFields.cfg;\
El archivo InterAction.cfg siempre se lee primero. Los archivos de configuración restantes se procesan en el orden en que aparecen en la variable additionalConfigFiles.
Si la misma variable se define en varios lugares, se utiliza la última que se haya definido. Por ejemplo, supón que tienes un entorno usando la configuración additionalConfigFiles mostrada arriba. Si defines la misma variable tanto en el archivo InterAction.cfg como en el archivo IntDemo.cfg, Application Server usará el valor establecido en el archivo IntDemo.cfg. Esto te permite comenzar con un conjunto de variables y usar archivos de configuración adicionales para sobrescribir esas variables en situaciones particulares.
Puedes usar el informe de Variables de Entorno Global para ver todas las variables actualmente definidas y sus valores. Esto es útil si necesitas saber qué valor prevaleció. Para más detalles sobre cómo usar los informes de Application Server, consulta Informes administrativos para Application Server.
Variables definidas internamente
El archivo InterAction.cfg incluye varias variables definidas internamente que puedes usar al establecer valores. Estas se definen dentro de Application Server, no en el archivo InterAction.cfg.
Las variables típicas que puedes usar incluyen las siguientes:
- hostName
- hostAddress