测量值文件管理

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

测量值文件管理

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


运行时的基本安装目录在 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(节点备份)功能创建节点配置和设置的备份文件时,请注意测量值文件不包含在节点备份输出文件中。测量值文件必须单独处理。

相关主题

系统变量

诊断

运行时线程池配置

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