Strategy ONE

建模故障排除服务

本节介绍您在使用建模服务时可能遇到的错误以及如何解决这些错误。

对配置文件进行配置更改 行政 文件夹。不要更改 会议 文件夹。所有文件位于 会议 文件夹在升级时将被覆盖 MicroStrategy。

配置文件可以在以下位置找到:

Windows<INSTALL_PATH>\MicroStrategy\建模服务\管理员

Linux<INSTALL_PATH>/MicroStrategy/建模服务/管理员

如有必要,请参阅以下主题以启用相关日志记录:

错误 故障排除

恢复idToken时出错:

模型服务器内部错误:非法 base64 字符:‘~’

确保“modelservice.identity_token.secret_key” modelservice.conf 文件配置了 base64 编码的 512 位密钥。

  1. 使用 Python 脚本生成 512 位新密钥,详情请参阅 KB486418

  2. 将“modelservice.identity_token.secret_key”的新密钥替换为 modelservice.conf 文件和“identityToken.secretKey” Library 服务器 configOverride.properties 文件。

  3. 重新启动建模服务和 Library 服务器。

恢复idToken时出错:

未配置身份令牌生成所需的属性“identityTokenSecretKey”。

  1. 重新启动建模服务。

  2. 升级到 MicroStrategy ONE - 更新 10(2023 年 8 月)或更新版本。

工作站中禁用新建过滤器选项。 确保库服务器已升级到 MicroStrategy 2020 Update 2 或更高版本。
MicroStrategy Modeling 服务未配置正确的密钥。请将“modelservice.config”中的identity_token.secret_key设置为与MicroStrategy Library中相应属性相同的值。 确保“modelservice.identity_token.secret_key” 模型服务配置文件 文件配置正确。它应该与图书馆服务器中的“identityToken.secretKey”相同 配置覆盖.属性 文件。

恢复IdToken时出错:

恢复身份令牌时出错。请验证“identityTokenSecretKey”配置是否正确。

确保“modelservice.identity_token.secret_key” 模型服务配置文件 文件配置正确。它应该与图书馆服务器中的“identityToken.secretKey”相同 配置覆盖.属性 文件。

恢复IdToken时出错:

JWT 签名与本地计算的签名不匹配。JWT 的有效性无法断言,不应被信任。

确保“modelservice.identity_token.secret_key” 模型服务配置文件 文件配置正确。它应该与“identityToken.secretKey”中的相同 Library 服务器 配置覆盖.属性 文件。

构建 Intelligence Server 会话时发生错误:连接失败:无法找到认证目标的路径。请验证认证路径是否正确,然后重新启动 MicroStrategy Web Server。 确保“modelservice.truststore.path” 模型服务配置文件 文件配置正确。

这 MicroStrategy 建模服务未运行,或 MicroStrategy Library 服务器找不到它或配置不正确。

检查以确保:

  1. 建模服务正在运行。
  2. 建模服务正在预期端口上运行。
  3. 防火墙已打开建模服务端口。
在 Linux 上,使用以下命令: sh ./bin/modelservice.sh stop,停止 ModelingService 根目录下正在运行的建模服务,控制台输出中返回“建模服务未运行”。

这可能是由于意外删除了 RUNNING_PID ModelingService 根目录下的文件。要停止建模服务,请在终端中运行以下命令:

复制
# query the running process id of Modeling Service
$ pgrep -f ModelingService
8952
# kill the process directly
$ kill -9 8952

过滤器编辑器中返回一个错误:SSL 配置问题。

错误可以在 Library 日志:

[错误] [main] [CEFPluginBridge.swift:48] logError(_:)> fetchUtils::checkStatus():,{"code":"ERR024","message":"SSL 配置问题","ticketId":"af1441eec17e41969af9ee14492f4bb7"}

当收到 SSL 验证相关错误时,请确保信任库名称和信任库密码在 configOverride.properties 归档于 <tomcat root directory>/webapps/MicroStrategyLibrary/WEB-INF/classes/config

要解决 Library 服务器和建模服务,请启用日志 Library 服务器。看 登录中 Library 建模服务服务器

在命令行中启动建模服务时,日志记录功能失败。

  1. 主要错误无法移动文件 C:\Program Files (x86)\MicroStrategy\ModelingService\.\logs\ModelService.log 到 C:\Program Files (x86)\MicroStrategy\ModelingService\.\logs\ModelService-2020-06-24-15-45.log:java.nio.file.FileSystemException C:\Program Files (x86)\MicroStrategy\ModelingService\.\logs\ModelService.log -> C:\Program Files (x86)\MicroStrategy\建模服务\.\logs\模型服务-2020-06-24-15-45.log:该进程无法访问该文件,因为它正在被另一个进程使用。
  2. 主要错误无法删除文件 C:\Program Files (x86)\MicroStrategy\ModelingService\.\logs\ModelService.log:java.nio.file.FileSystemException C:\Program Files (x86)\MicroStrategy\ModelingService\.\logs\ModelService.log:该进程无法访问该文件,因为它正在被另一个进程使用。
使用时导致此错误 start.bat 在命令行中,而建模服务已经从服务启动。使用 stop.bat 退出并运行 start.bat 再次,或者从服务启动,重新启动模型服务。

返回拓扑错误消息:

  1. 有些事错了。无法启动/停止模型服务,以下是可能的解决方案。
    1. 服务注册使用 SSH 命令来启动/停止服务,请让您的管理员确保 SSH 服务器正在目标机器上运行。
    2. 请重新启动目标机器上的 Web 容器并尝试再次启动/停止该服务。
    3. 如果问题仍然存在,请让您的管理员从日志文件中检索相关信息。
    4. 请检查拓扑服务选项卡以查看所有依赖的服务是否已启动。
  2. 出错了。无法启动/停止服务。当您输入的凭证没有权限或 SSH 命令执行失败时,就会发生这种情况。如果问题仍然存在,请联系您的管理员。
  3. 出错了。

检查以确保:

  1. 建模服务正在运行。
  2. 建模服务正在预期端口上运行。
  3. 防火墙已打开建模服务端口。
  4. 设置的密钥 Library 服务器和建模服务相同。
  5. 如果在 Library 服务器和建模服务,请确保其配置正确。欲了解更多详情,请参阅 配置 HTTPS 连接 Library 服务器和建模服务
无法使用安全 TLS 通道连接到服务。

HTTPS 连接 MicroStrategy Library 并且建模服务配置不正确。

有关配置 HTTPS 连接的步骤,请参阅 配置 HTTPS 连接 Library 服务器和建模服务

由于信任库路径无效,MicroStrategy Modeling 服务和 MicroStrategy Intelligence 服务器之间的 TLS/SSL 配置不正确:提供的路径无效,请仔细检查它是否存在。

建模服务和智能服务器之间的 TLS/SSL 连接配置不正确。

有关在建模服务和 Intelligence 服务器之间启用 TLS 的配置步骤,请参阅 当 Intelligence Server 启用 TLS 时配置建模服务

通过工作站事实编辑器打开事实对象时发生错误:

“模型服务器内部错误:无效的论点:请求的事实不包含请求的表达式。”

或者

“模型服务器内部错误:不存在任何值。

这是一个已知缺陷,技术团队正在调查。

请用 MicroStrategy Developer 作为一种解决方法。请参阅 KB484818

建模服务无法获取 Intelligence 服务器会话:网络:无法连接到 MicroStrategy Intelligence 服务器。

检查以确保新的 Intelligence Server 证书在 application.conf 文件,包括以下字段:

  • play.server.https.keyStore.path

  • play.server.https.keyStore.type

  • play.server.https.keyStore.password