Kit para dispositivos › Apéndice › Formatos de archivo de configuración de CA 3Tera AppLogic › Descriptor de instancia del dispositivo

Descriptor de instancia del dispositivo

El archivo del descriptor de instancia contiene todos los datos de la descripción de clases del dispositivo (tal y como aparecen en el editor, en el cuadro de diálogo para ver o editar clases), modificados por algunos atributos y valores de configuración de valores de propiedades aplicados a la instancia (consulte la documentación del editor de aplicaciones de CA 3Tera AppLogic para obtener más detalles sobre cómo definir la configuración y propagarla en las aplicaciones).

Tenga en cuenta que en todos los dispositivos, salvo los más avanzados, no hay ninguna necesidad de acceder directamente a los datos del descriptor de dispositivos, puesto que los valores de configuración específicos de la aplicación se proporcionan en formatos procesados, tal y como se describe en el capítulo Límite del dispositivo.

El descriptor de instancia es un archivo de texto estructurado, con el formato siguiente:

instance main. instance-path : .class= catalog . classname

   { 
   . clsattr = value 
   .... 
   resource cpu: min= num , max= num , dflt= num 
   resource mem: min= num , max= num , dflt= num 
   resource bw: min= num , max= num , dflt= num 
   (input|output) trmname : protocol= filter , dev=eth num 
      { 
      hwaddr=' macaddr ' 
      } 
   ... 
   interface default: dev=eth num 
      { 
      hwaddr=' macaddr ' 
      ip= ipaddr 
      } 
   volume boot: dev= devfile [, class, type=(instantiable|shared)] [(mandatory|ro|shared|class), ... ] [, mount= dir ] [, disconnected] [, static] 
   volume volname : dev=.... 
   ... 
   property prpname : value= prpval , attr = val , ... 
   property ... 
   ... 
   } 

Éstas son las secciones en que se divide el archivo, y lo que contienen:

Encabezado

Incluye la ubicación del dispositivo dentro de la aplicación (ruta de instancia), que refleja la jerarquía de ensamblajes donde está contenido y la clase a partir de la que se ha creado (catalog . classname). Si el dispositivo es un singleton definido en una aplicación, el nombre del catálogo está vacío.

Atributos de clase

Esta sección contiene diversos atributos de clase, cuyos nombres empiezan con un punto. Su valor puede ser el valor predeterminado de la clase, o bien un valor establecido explícitamente para la instancia del dispositivo. Excepto en aquellos casos en que se indica otra cosa, cada atributo corresponde a un valor de configuración del cuadro de diálogo Atributos del editor. Están disponibles los siguientes atributos:

    .hostname= cadena (no la puede establecer el usuario, pues se genera a partir del nombre de instancia) 
    .migrateable= (0|1) 
    .locked= (0|1) 
    .start_order= num 
    .boot_tout= num 
    .shutdown_tout= num 
    .field_opt= num (se trata del valor del código FE del cuadro de diálogo Editar clase de la clase de atributo; no le afecta ningún valor de configuración que se proporcione en el cuadro de diálogo Atributos) 
    .inst_field_opt= num (se trata del valor del código FE tomado del cuadro de diálogo Atributos) 
    .restart_mode (container|self)= 

Configuración de recursos

Esta sección contiene solamente los límites de los recursos (tal y como se han establecido en la aplicación). Los recursos reales asignados no están visibles en el descriptor de instancia.

Terminales

Esta sección contiene una entrada por cada terminal de dispositivo. Puede estar vacía, si el dispositivo no tiene ningún terminal. Para cada terminal, se proporcionan los datos siguientes:

• tipo de terminal (entrada o salida)
• nombre del terminal (trmname)
• nombre de filtro de protocolo (filter)
• número de dispositivo (dev=ethnum). Tenga en cuenta que no se corresponde necesariamente con un nombre de dispositivo válido (los nombres de dispositivo dependen del SO).
• dirección de control de acceso a medios del dispositivo (macaddr)
• dirección IP del dispositivo (ipaddr); únicamente está presente si el terminal está conectado

Interfaz predeterminada

Define la configuración de la interfaz de servicio del dispositivo (que se utiliza para configurar el dispositivo inicialmente y comunicar el estado al controlador del grid). Incluye los datos siguientes:

• dirección de control de acceso a medios del dispositivo (macaddr)
• dirección IP del dispositivo (ipaddr); únicamente está presente si el terminal está conectado

Volúmenes

Esta sección contiene una entrada por cada volumen e incluye por lo menos una entrada (el volumen de arranque del dispositivo). Se definen los siguientes valores para cada volumen:

Archivo especial del dispositivo (u otro identificador específico del SO del dispositivo que representa a este volumen en el dispositivo): devfile Si el volumen contiene un sistema de archivos montable, este nombre se puede usar en el comando mount y puede referirse a un dispositivo que no sea el físico (por ejemplo, puede ser un nombre de dispositivo de partición). De lo contrario, este nombre se refiere al dispositivo real.

Si el volumen pertenece a la clase de dispositivo, posee el atributo de clase, y el atributo de tipo se establece en uno de estos valores: (instantiable|shared|blank).

El volumen puede tener uno o más atributos opcionales: (mandatory|ro|shared|class).

Los volúmenes que se montan, o los que tienen un punto de montaje definido para sí en la clase de dispositivo (aunque no se haya podido montar) tienen el atributo mount=, con el nombre del punto de montaje real o solicitado, como sigue:

• El APK monta los volúmenes para los que el usuario haya especificado un punto de montaje en la clase de dispositivo; su punto de montaje se definirá en la clase reflejada en el descriptor de instancia (tanto si el APK consigue montarlos correctamente como si no).
• Los volúmenes que no tienen un punto de montaje especificado en la clase, pero que se montan en el dispositivo otros medios (por ejemplo, el SO monta los volúmenes de arranque), tendrán su punto de montaje real en el atributo mount=, y también se establecerá el atributo static.

Los volúmenes marcador de posición opcionales definidos en el dispositivo, pero a los que no se ha asignado un volumen de datos real, tendrán el atributo disconnected.

Propiedades

Existe una entrada de propiedad presente por cada propiedad definida para la clase de dispositivo. Para cada propiedad, se proporciona la siguiente información:

• prpval: valor efectivo de la propiedad para la instancia. Puede ser el valor predeterminado de la clase, o bien un valor configurado explícitamente.
• attr=val: diversos atributos de propiedad, copiados de la descripción de clase del dispositivo (incluyen el tipo de propiedad o el intervalo de valores válidos, entre otros).