安装更新或升级到新版本的 Polyspace Access

您可以使用相同的过程来安装 Polyspace® Access™ 更新，例如 R2025b Update 1，或者升级到新版本的 Polyspace Access。在开始之前，请通知用户在更新或升级期间，Polyspace Access 将不可用。后续部分中的某些步骤需要更高的用户特权 (sudo)。

步骤 1：前提条件

  • 下载新的安装镜像。请参阅下载说明。

  • 如果您要安装新版本的 Polyspace Access，请按照更新网络许可证文件主题中列出的步骤更新您的许可证。

  • 创建当前安装文件夹的快照。如果安装过程中出现问题，您可以使用快照来回滚更新或升级。检查您的计算机是否有足够的内存来存储该快照。例如，如果您的安装文件夹为 /usr/local/Polyspace_Access，请使用以下命令：

    sudo tar -cvpzf /usr/local/ps-access.old.tgz /usr/local/Polyspace_Access

另请参阅其他安装前检查。

步骤 2：停止并删除当前安装的容器

为避免当前安装与新安装的 Docker® 容器版本冲突，请停止并删除当前安装的 Docker 容器：

  1. 在 Cluster Admin 仪表板中，点击 Stop Apps。此操作会停止大部分但并非所有容器。

  2. 在启动了 admin-docker-agent 二进制文件的命令行终端中，按 Ctrl+C 来停止该二进制文件。

    或者，使用 docker stop admin && docker rm admin 命令停止并删除 admin 容器。

  3. 在命令行中，输入以下命令来停止并删除剩余的容器：

    docker stop polyspace-access issuetracker usermanager gateway
docker rm polyspace-access issuetracker usermanager gateway

要检查是否已删除所有容器，请使用 docker ps -a 命令查看系统上所有正在运行的容器和已停止的容器。

步骤 3：安装并启动新的 Polyspace Access 服务

解压缩和安装

通常，您可以通过将步骤 1 中下载的安装镜像的内容提取到当前 Polyspace Access 安装的安装文件夹中，来安装更新或升级。此操作将覆盖现有的安装文件，但会保留您的设置和数据库。例如，如果您的当前安装文件夹为 /usr/local/Polyspace_Access，请导航到您下载的压缩安装镜像所在的文件夹，然后运行以下命令：

unzip polyspace-access-R2025b.zip -d /usr/local/Polyspace_Access
根据您要安装的版本和更新编号，压缩的安装镜像将具有不同的名称。

启动 Cluster Admin 界面

在命令行中，导航到安装文件夹并运行以下命令：

./admin-docker-agent --hostname `hostname -f`
指定其他选项以使用不同端口或配置 HTTPS。请参阅 admin-docker-agent。

使用上一个命令的输出中提供的 URL 以转至 Cluster Admin 界面，然后：

  1. 点击 Configure Apps 并检查设置。检查文件和文件夹路径是否正确，然后保存并验证设置。

  2. 返回 Cluster Admin 仪表板并点击 Restart Apps。

检查安装状态

根据现有数据库的大小，Polyspace Access 服务可能需要长达数小时才能重新启动，即使在状态指示器变为绿色且所有 App 在 Cluster Dashboard 中均列为正在运行状态之后也是如此。

在 Polyspace 将您的数据迁移到新版本的 Polyspace Access 时，如果您尝试登录，将会看到一条置顶消息，内容如下：

Polyspace Access is temporarily unavailable while your administrator performs some planned maintenance.
 Try again later

注意

在迁移过程中，请勿点击 Restart Apps 或重新启动任何容器。

打开 Polyspace Access ETL 服务的日志，搜索 migration 并查找消息 Data migration completed successfully。一旦该消息出现在日志中，即表示安装成功。要打开该日志，请在 Cluster Admin 仪表板中点击 Polyspace Access，然后点击与 Polyspace Access ETL 服务对应的 Show Logs。

如果您在日志中发现迁移错误，请参阅就 Polyspace Access 问题联系技术支持。

您可以通过将在步骤 1 中创建的快照解压缩到新文件夹中来还原先前的安装。请勿将快照解压到现有的安装文件夹中，因为数据库基本架构可能不再与旧版本的 Polyspace Access 兼容。

步骤 4：安装后配置

完成更新或升级后，请执行以下操作：

其他安装前检查

检查许可证管理器版本

要避免许可证文件操作出现任何潜在问题，请检查您运行的是否是最新版本的许可证管理器软件。要查看可用的最新版本的许可证管理器软件，请参阅此页面上的 FlexNet® 版本。

要查看当前许可证管理器软件的版本，请在命令行中根据您的操作系统输入下表中列出的命令。

Windows®

LM_Folder\etc\win64
lmgrd.exe -v

Linux® 
LM_Folder/etc/glnx64
./lmgrd -v

LM_Folder 是您安装许可证管理器的文件夹。另请参阅更新网络许可证管理器软件。

检查是否存在 Docker 网络冲突

Polyspace Access 服务在 Docker 网络内运行。请参阅网络概述。当更新 Polyspace Access 时，除非您显式指定一个不同的 Docker 网络，否则这些服务将重用现有的 Docker 网络。

为避免网络冲突，请与网络管理员确认您当前安装使用的 Docker 网络的 IP 范围未被其他服务使用。如果您在之前的安装中已执行了此检查，并且未遇到网络问题，则可以跳过本部分。否则，请按以下步骤进行操作。在您安装 Polyspace Access 的计算机上运行以下命令。

  1. 要查看当前安装使用的是哪个 Docker 网络，请在 Polyspace Access 服务处于运行状态时使用以下命令：

    docker container inspect polyspace-access-etl-0-main
    然后，检查输出中的 NetworkSettings.Networks 节点。

    如果输出中列出了多个网络，请针对每个网络执行步骤 2。

  2. 要从步骤 1 查看 Docker 网络使用的 IP 范围，请运行以下命令：

    docker network inspect networkName
    然后，检查 IPAM.config 节点。联系您的网络管理员来确定 IP 范围是否被其他服务使用。networkName 是 Docker 网络的名称，例如 mathworks。

    • 如果您的 Docker 网络与现有网络冲突，请创建一个网络并指定子网和网关，以避免与现有网络冲突。请参阅创建 docker 网络。要使用新网络，请在启动 admin-docker-agent 二进制文件时指定 --network-name newNetworkName 选项。

      使用命令 docker network rm networkName 删除不再使用的 Docker 网络。

    • 如果 Docker 网络与现有网络不存在冲突，则无需执行任何操作。新安装将重用该网络。

兼容性注意事项

  • 对于不同版本，Polyspace Access Docker 容器名称可能有所不同。如果您运行的脚本使用容器名称，请查看新版本中的这些名称并相应地更新您的脚本。

    要查看当前正在运行的容器的名称，请使用 docker ps --format '{{.Names}}' 命令。

  • 如果您将 Polyspace Access 版本 R2021a 或更低版本更新到版本 R2021b 或更高版本，且满足以下两个条件：

    • 您使用公司 LDAP 进行用户身份验证。

    • 在为新安装启动 admin-docker-agent 二进制文件时，使用选项 --force-exposing-ports。

    在点击 Restart Apps 启动服务之前，请检查是否已为所有服务分配了有效端口号。

    要查看当前为服务分配的端口，请在 Cluster Admin 仪表板中点击 Configure Nodes，然后转至 Nodes 设置的 Services 选项卡。

  • 要使用 polyspace-access -download 命令下载存储在 Polyspace Access 版本 R2022a Update 1 或更高版本中的结果，请将运行此命令的 Polyspace 产品更新到版本 R2022a Update 1 或更高版本。

另请参阅

主题