组件工具包 › 附录 › CA 3Tera AppLogic 配置文件格式 › 组件实例描述符

组件实例描述符

实例描述符文件包含来自组件类描述的所有数据（在编辑器中的“查看/编辑类”对话框中可以查看），由任何属性和应用于实例的属性值设置修改（有关如何在应用中定义和传播配置的详细信息，请参阅 CA 3Tera AppLogic 应用编辑器文档）。

请注意，在除最高级组件的所有组件中，无需在应用描述符中直接访问数据，因为处理格式提供了应用特定的配置值，如“组件边界”一章中所述。

实例描述符是结构化的文本文件，具有下列格式：

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 ... 
   ... 
   } 

以下为文件所拆分的部分，以及它们包含的内容：

标题

包括组件在应用内部的位置 (instance-path)，反映包含该组件的组件集以及从中创建该组件的类 (catalog. classname) 的层次结构。 如果组件是在应用中定义的单例，则目录名称为空。

类属性

本节包含名称以点开头的各种类属性。 它们的值为类默认值，或为组件实例明确设置的值。 除了注释的地方外，每个属性均对应于编辑器中“属性”对话框中的设置。 可以使用下列属性：

    .hostname= string（用户不可设置，从实例名称中生成） 
    .migrateable= (0|1) 
    .locked= (0|1) 
    .start_order= num 
    .boot_tout= num 
    .shutdown_tout= num 
    .field_opt= num（这是来自组件类的“编辑类”对话框的 FE 代码值，不受“属性”对话框中可能提供的任何设置影响） 
    .inst_field_opt= num（这是来自“属性”对话框的 FE 代码值）。 
    .restart_mode (container|self)= 

资源配置

本节仅包含资源限制（如在应用中的设置）。 实际分配的资源在实例描述符中不可见。

终端

本节中每个组件终端都有一个条目。 如果组件没有终端，则可能为空。 对于每个终端，提供了下列数据：

• 终端类型（输入或输出）
• 终端名称 (trmname)
• 协议筛选器名称 (filter)
• 设备号 (dev=ethnum)。 请注意，未必对应于有效的设备名称（设备名称依赖于操作系统）。
• 设备 MAC 地址 (macaddr)
• 设备 IP 地址 (ipaddr)－仅当终端连接时才提供

默认接口

它定义组件服务接口的配置（用来最初配置组件，并将状态报告给网格控制器）。 包括以下数据：

• 设备 MAC 地址 (macaddr)
• 设备 IP 地址 (ipaddr)－仅当终端连接时才提供

卷

本节中每个卷有且至少有一个条目（组件的启动卷）。 为每个卷定义以下内容：

设备专用文件（或该卷在组件中充当的设备的另一个操作系统特定标识符）：devfile 如果卷包含可挂接的文件系统，则该名称可以用于挂接命令，并且可以指除物理设备以外的设备（例如：它可以是“分区设备”名称）。 否则，该名称指实际的设备。

如果卷属于组件类，那么它具有类属性，类型属性设置为下列之一：(instantiable|shared|blank)。

卷可以有一个或多个可选属性：(mandatory|ro|shared|class)

挂接的卷，或在组件类中具有为其定义的挂接点的卷（即使针对它们的挂接失败）具有 mount= 属性，带有实际或请求的挂接点的名称，如下所示：

• 用户为其指定组件类中的挂接点的卷由 APK 挂接；它们将具有实例描述符中反映的类中定义的挂接点（无论 APK 是否成功挂接它们）。
• 没有在类中指定挂接点，但是通过其他方式（例如：由操作系统挂接启动卷）挂接到组件中的卷，将在 mount= 属性中具有实际挂接点，并且还将设置静态属性。

在组件中定义，但未分配实际数据卷的可选占位符卷将具有断开连接的属性。

属性

为组件类定义的每个属性均有一个属性条目。 对于每个属性，提供了以下内容：

• prpval－实例的属性的有效值。 它为类默认值，或明确配置的值。
• attr=val－从组件类描述中复制的各种属性的属性（包括属性类型、有效值的范围等）。