属性文件管理

运行时的一些可配置的功能是通过在运行时基本安装目录下的一个属性文件中定义属性来控制的。这些属性文件在运行时启动时被读取。

属性文件管理

属性的配置和属性文件管理是一个高级主题。在大多数情况下,将根据您与您的支持代表的互动,将您引导到这些信息和配置选项。


运行时的基本安装目录在 Linux 中一般是 /opt/dw/dwcore,在 Windows 中一般是 C:\deviceWISE\Runtime\dwcore。有些产品有一个替代的运行时基础安装目录。

  • 大多数资产网关产品只有一个 dwcore.properties 文件。
  • 大多数企业网关产品有一个 dwcore.properties 文件和一个 dwcore.platform.properties 文件。
  • 所有资产网关和企业网关产品都支持额外的属性文件,使用约定的方式命名:dwcore.<user_defined>.properties 命名。
    • 其中 <user_defined> 是任何有效的操作系统文件名字符串。
    • 例如:dwcore.solution.properties。
  • 从 18.2.2 版本开始,也支持单独的属性文件命名约定:user.<user_defined>.properties
    • 这种对 user.<user_defined>.properties 文件的支持,是在之前对 dwcore.<user_defined>.properties 的支持基础上增加的。
    • 例如:user.solution.properties。
    • 增加了新的文件命名规范,是为了帮助明确用户定义的属性文件,并将用户定义的属性文件的读取顺序与 dwcore.platform.properties 分开。

在运行时启动时期间,属性文件的读取顺序如下:

  1. dwcore.properties
  2. 然后是任何其他的 dwcore.<user_defined>.properties 文件。
    • dwcore.platform.properties 文件就属于这一类。
    • 不同平台读取 dwcore.<user_defined>.properties 文件的顺序是不确定的。有些平台是按照字母顺序来读取文件的,但这种读取方式不可靠。
  3. 从 18.2.2 版本开始,支持任何 user.<user_defined>.properties 文件。
    • 对 user.<user_defined>.properties 文件的支持是在对 dwcore.<user_defined>.properties 文件的支持基础上增加的。
    • 不同平台读取 user.<user_defined>.properties 文件的顺序是不确定的。有些平台是按照字母顺序来读取文件的,但这种读取方式不可靠。

属性、系统变量和默认值

运行时的一些属性存在于属性文件中。其他属性不存在于提供的属性文件中,但在代码中有一个默认值。

对于一个节点来说,许多属性及其当前值可以通过 Workbench(工作台) -> Administration(帐户管理) -> System Variables(系统变量)选项卡来查看。

由于属性是从各种属性文件中读取的,如果一个属性是重复的(相同的属性名称被第二次读取),则使用第二次读取的属性。

这意味着,用户定义的属性文件中的属性,如 user.solution.properties,将覆盖 dwcore.properties 或 dwcore.platform.properties 文件中的属性。

对于 18.2.1 或更早的版本,不支持 user.<user_defined>.properties。用户特定的属性应该被添加到 dwcore.<user_defined>.properties 文件中。
不同平台读取 dwcore.<user_defined>.properties 文件的顺序是不确定的。有些平台是按字母顺序读取文件的,但这种读取方式不可靠:

  • 您应该使用 Workbench(工作台) -> Administration(帐户管理) -> System Variables(系统变量)选项卡来查看正在使用的属性和值,在您的系统上测试和验证文件的处理和属性的使用。
  • 可以修改 dwcore.<user_defined>.properties 文件的名称,使其按字母顺序排列在 dwcore.platform.properties 之后。例如:dwcore.solution.properties。

产品安装或更新

产品安装(.exe、.sh、.ipk 和其他安装格式)和产品更新(使用 .dwu 文件和 Workbench(工作台) -> Administration(帐户管理) -> Node Administration(节点管理)选项卡 Update Firmware(更新固件)功能或使用 SUP 功能)将覆盖 dwcore.properties 文件,以及 dwcore.platform.properties 文件(如果在产品中存在)。

建议所有从默认值更改而来的属性都定义在用户定义的属性文件中,比如 user.solution.properties。对于 18.2.1 或更早的版本,使用用户定义的属性文件,如 dwcore.solution.properties。

被覆盖的属性文件

  1. 由于 dwcore.properties 文件和 dwcore.platform.properties 文件会被覆盖,因此从默认值更改而来的属性应该维护在用户定义的属性文件中,例如 user.solution.properties(或 dwcore.solution.properties)。
  2. 当使用工作台的 Node Back Up(节点备份)功能创建节点配置和设置的备份文件时,请注意属性文件不包含在节点备份输出文件中。属性文件必须单独处理。

相关主题

系统变量

诊断

运行时线程池配置

故障排除节点资源利用问题