使用工作台创建软件更新包

  1. 从工作台的左侧窗格中,选择要用作软件更新包创建源的网关。

    请确保源网关和目标网关的平台类型相同,以使 SUP 文件兼容。

    例如,Write Core DB(写入核心数据库)和 Write Master DB(写入主数据库)动作将分别更新目标网关的数据库。这些数据库具有针对特定平台的内容。

  2. 右键单击源网关。
    随即显示快捷菜单。
  3. 单击 Prepare Update Package(准备更新包)。
    随即显示 Local directory(本地目录)界面,这是 Prepare Update Package(准备更新包)向导的一部分。
  4. 选择 Local directory(本地目录)进行打包。

    本地目录是保存要纳入软件更新包 (SUP) 的所有文件的文件夹。从本地目录中删除未使用的文件将减小 SUP 文件的大小,这对于使用蜂窝连接进行连接时产生的数据传输成本和传输时间非常重要。

  5. 单击 Next(下一步)。
    随即显示 Staging Files(暂存文件)界面。
  6. 在网关的暂存浏览器区域中选择要纳入 SUP 的所有目录(及其子目录和文件)或单个文件。

    Staging Files(暂存文件)界面使您可以选择要包含在 SUP 中的任何目录(及其子目录和文件)或网关的暂存浏览器区域中的单个文件。
    1. 选择要复制的文件。
    2. 如果需要,选中 Copy to staging subdirectory of local directory(复制到本地目录的暂存子目录)复选框:
      • 如果选择 Copy to staging subdirectory of local directory(复制到本地目录的暂存子目录)参数,所选目录和文件将在其路径中保留暂存目录。
        在 SUP 中使用 Add Directory from Package(从软件包中添加目录)动作或 Add Directory from Package to Staging(将软件包中的目录添加至暂存)动作时,需要了解对暂存目录路径的保留。
      • 如果未选择 Copy to staging subdirectory of local directory(复制到本地目录的暂存子目录)参数,所选目录和文件在其路径中将不保留暂存目录。此项为默认选项,将用于大多数情况下。
    3. 选择目录或文件后,单击 Get(获取)。
      此时将显示一条消息,要求您确认要获取的文件。
    4. 单击 Yes(是)。
      此时将显示一条消息,其中包含一个或多个文件已保存至 Local directory(本地目录)指定的本地目录文件夹的信息
    5. 单击 OK(确定)。
    6. 单击 Refresh(刷新)以更新文件列表。
  7. 单击 Next(下一步)。
    随即显示 Create(创建)界面。
  8. 请在 Create(创建)界面上执行以下操作之一:
    1. 选择 Create using selected directory(使用所选目录创建)以创建新的 SUP 文件。在随后的一组创建步骤中,将要求您提供文件名。
    2. 选择 Create from existing package(从现有软件包中创建),使用现有 SUP 的内容创建 SUP。
      • 现有 SUP 的内容将用于配置新 SUP。这包括动作和软件包名称(第 5 步:动作和第 6 步:软件包摘要)。
      • 选择 Extract files from package(从软件包中提取文件)选项,从 SUP 中提取文件并将它们写入第 1 步Local directory(本地目录)中指定的本地目录。
  9. 单击 Next(下一步)。
    随即显示 Configuration Image(配置图像)界面。
  10. 选择导出本地软件包目录中的配置数据库。
    Configuration Image(配置图像)界面可用于从源网关导出配置(核心)数据库,并将其与 Write Core DB(写入核心数据库)动作或 Write Master DB(写入主数据库)动作结合使用。有关更多信息,请参见:数据库部署。配置数据库包括网关上所有已定义的项目,例如项目和触发器、传输、传输映射和设备。系统会将配置数据库导出至您在 Local directory(本地目录)指定的文件夹中。

    如果您不希望将配置数据库和 Write Core DB(写入核心数据库)动作或 Write Master Db(写入主数据库)动作纳入动作纳入 SUP 中,则不需要执行此步骤。
    1. 选择 Export configuration database(导出配置数据库)。
      随即显示 Export(导出)窗口。
    2. 接受默认名称或为文件输入新的名称,然后单击 OK(确定)。
      此时将显示一条消息,指示数据库已成功导出。
    3. 单击 OK(确定)。
  11. 单击 Next(下一步)。
    随即显示 Action(动作)界面。
  12. 选择在安装软件包时要执行的动作。
    Actions(动作)界面可用于添加将在网关上执行的动作(类似于命令)。
    您定义的 SUP 动作可能具有针对特定操作系统或 deviceWISE 产品的文件或参数。SUP 文件的设计及其在多个网关上的使用必须考虑网关的操作系统和 deviceWISE 产品特定的特性。
    要添加动作:
    1. Actions(动作)界面的底部单击 Add(添加)。  随即显示 New Action(新动作)窗口。

      New Action(新动作)窗口列出可用的操作。可使用 Actions(动作)界面底部的按钮添加、删除动作或将动作重新排序。
    2. 选择动作,然后单击 Add(添加)。

      Actions(动作)部分适应您添加的动作。Details(详细信息)窗格中定义了当前所选动作的细节。
      动作及其参数的列表可参见软件更新包动作页面。
      对于许多 SUP,建议基于包含的动作将 Stop Runtime(停止运行时)动作添加为第一个动作,将 Start Runtime(启动运行时)动作添加为最后一个动作。此项并非必需项,但是如果不重启网关上的 deviceWISE 运行时,许多更改(代码、属性文件、主 DB 或核心 DB)将不会生效。
  13. 在 SUP 中添加所需的动作并排序后,单击 Next(下一步)。
    随即显示 Package Summary(软件包摘要)窗口。
  14. 输入软件包描述。
    Package Summary(软件包摘要)界面可用于指定 SUP 文件的 Name(名称)、软件包的标识 Version(版本),以及 SUP Output file(输出文件)的名称。

    Package Summary(软件包摘要)界面的下部会显示已纳入 SUP 的文件和动作。最好在每次修改 SUP 时都更新(递增)版本号。可以指定 SUP 输出文件位于工作台计算机上的任何目录中,但不应选择与 Local Directory(本地目录)相同的目录。本地目录应仅包含将纳入生成的 SUP 文件中的源文件。由于您可以新建 SUP 文件并重新使用本地目录,因此应注意将无关文件排除在 SUP 本地目录之外。
  15. 要创建 SUP 输出文件,请单击 Next(下一步)。
    随即显示 Processing Update Package(正在处理更新包)界面。Processing Update Package(正在处理更新包)界面显示正在创建的 SUP。创建的详细信息会在 Packaging build output(打包构建输出)部分下列出。

    成功创建 SUP 输出文件后会显示一条消息。
  16. 单击 OK(确定),然后单击 Done(完成)。
    文件位于您在 Output file(输出文件)参数中指定的文件夹中。
    如果发生错误,会显示一条消息,然后您可以返回到上一个窗口以更正错误。
    如果您无法解决这些错误,您的所有文件将保留在 Local directory(本地目录)指定的本地目录中。

成功创建软件更新包后,可以将其上传至物联网设备管理门户并部署到网关。有关这些主题的信息,请参见软件更新包处理