预订演示
前页 后页

PCS 故障排除

浏览器测试

为了简单检查专业云服务器是否在配置文件中定义的指定端口上运行，您可以在 Web 浏览器中输入此地址：

<协议>://<机器名称>:<端口>

例如，在安装了专业云服务器的机器上使用默认设置：

http:// localhost :1804/

或者

https

如果端口已启用，则返回以下消息：

Sparx Systems专业云服务器vX.X.XX

恭喜，您的服务器现在可以托管您的模型了。通过配置客户端连接即可添加或删除模型。

如果未显示此消息，请确认服务器名称和端口，检查在指定端口上侦听的其他服务，检查服务器log文件中的错误消息，并检查客户端和服务器之间的任何防火墙以确认存在连接并且相关端口已打开。

连接测试

如果您对与专业云服务器服务器的现有连接的响应速度有问题，那么简单的初始检查是使用专业云服务器连接测试。该测试可从以下位置访问：

  • 功能区：开始>帮助>帮助>专业云服务器连接。
它以以下格式在系统输出窗口中返回详细信息：
  • 专业云服务器版本号
  • 从当前机器到专业云服务器机器的 Ping 响应时间（以毫秒为单位）
  • 完成简单查询的时间。
例如：
  • 专业云服务器：版本'5.0.100'
  • 专业云服务器：响应时间：26 ms
  • 专业云服务器：简单数据库查询执行时间：23 ms
如果 Ping 测试结果较高，则必须检查一般连接，包括 WAN 连接或代理服务器。

如果 Ping 测试处于合理范围内，但查询执行率很高，则有必要检查 PCS 与 DBMS 的连接或 DBMS 本身的响应。

Enterprise Architect系统输出中显示的错误

错误信息

意义

也见

Http状态代码：503 服务不可用

表示服务器云未运行Pro 。

  • 选择您有正确的服务器名称和端口
  • 选择“ Sparx Systems专业云”服务当前正在服务器上运行
 专业云服务器配置

HTTP状态401访问被拒绝

表示服务器身份验证失败。

使用内置 Web 服务器时，如果提供了无效的用户名或密码，或者没有提供用户名或密码，就会发生此错误。

HTTP状态403

表示尝试访问服务器上标记为“需要经过身份验证和安全连接”的模型。

这可能表明您正在使用http协议而不是https进行连接，或者您使用的端口没有为您正在连接的模型提供身份验证。

选择您正在使用https 。

与系统管理员一起选择安全认证选项指向启用了安全性的模型。

如果在专业云服务器中启用“需要经过身份验证的安全连接”选项后，相关模型又启用了用户安全，请让系统管理员关闭并重新打开“需要经过身份验证的安全连接”选项，并确保每次都保存数据库管理员。这将重置专业云服务器保留的内部标志，以便其能够验证用户凭据。

 配置数据库管理员 端口配置

HTTP状态500 无法连接到服务

连接未被接受。

  • 选择服务器名称
  • 选择客户端和服务器上的防火墙设置
  • 选择服务器正在侦听的端口
 端口配置 专业云服务器配置 防火墙设置

该数据库的数据库管理器已关闭

Enterprise Architect与专业云服务器建立了连接，并请求连接到已知存储库，但该存储库当前已被禁用。

请您的系统管理员检查相关数据库管理器的“已启用”选项。

 配置数据库管理员

没有为请求的存储库配置数据库管理器

Enterprise Architect建立了与专业云服务器的连接，但请求的模型名称与服务器上任何定义的数据库不匹配。

使用Enterprise Architect云连接屏幕访问模型时，请确保输入的模型名称与专业云服务器配置客户端中显示的别名相匹配。有关别名，请参阅配置数据库管理员帮助主题。

 配置数据库管理员 将Enterprise Architect连接到云模型

无法连接到数据库

Enterprise Architect与专业云服务器建立了连接，并请求连接到已知存储库；但是，当服务器尝试使用提供的详细信息打开与数据库的连接时，连接失败。

注记：每当发生此错误时，包含更详细信息的警告级别消息将被写入专业云服务器日志中。

如果存储库是：

  • 使用 ODBC，请系统管理员检查 ODBC 连接是否在服务器上定义为系统DSN（而不是用户DSN），所有连接参数是否正确，以及数据库用户名和密码是否已保存到 ODBC DSN 或连接string中
  • Oracle，请您的系统管理员验证用户名和密码是否与连接string一起保存，以及连接中的所有其他选项是否正确
  • #
    服务器通过 OLE DB 和窗口身份验证进行连接，请您的系统管理员验证专业云服务器服务正在运行的用户名并且已被授予#
    的权限#
    服务器数据库（至少需要角色 db_datareader 和 db_datawriter）并且连接中的所有其他选项都是正确的
  • #
    通过 OLE DB 和 SQLServer 身份验证进行服务器时，请系统管理员验证定义的用户名是否已被授予#
    服务器数据库（至少需要角色 db_datareader 和 db_datawriter），使用连接string保存密码的选项已启用，并且连接中的所有其他选项均正确

12007 - 无法解析服务器名称或地址

表示服务器名称（或 IP 地址）不正确。

  • 选择服务器名称是否正确
  • 尝试本主题开头描述的浏览器测试

12029 - 无法与服务器建立A

这可能表明专业云服务器未安装、服务未运行或输入了错误的端口。

  • 确认专业云服务器已安装
  • 选择“ Sparx Systems专业云”服务正在运行
  • 选择您输入的有效端口（即它应该与配置客户端中定义的端口匹配）
  • 尝试本主题开头描述的浏览器测试
 端口配置

12031 - 与服务器的连接已重置

如果您尝试使用协议 HTTP 进行连接，但您输入的端口配置为 HTTPS（例如 805），则可能会发生这种情况。

  • 如果您选择了协议 HTTP，请确认您输入的端口已配置为 HTTP 访问
  • 如果您选择了协议 HTTPS，请确认您输入的端口已配置为 HTTPS 访问
有关详细信息，请参阅端口配置帮助主题。 		端口配置

重新安装Enterprise Architect后不再起作用

您的环境运行正常，然后您更新到最新版本的专业云服务器，现在Enterprise Architect客户端无法连接到您的云模型。

在重新安装过程中，专业云服务器安装程序实际上会卸载原始版本，然后安装新版本。因此，安装程序自动添加的防火墙例外会被删除并重新创建。如果您在原始安装后调整了默认防火墙例外以适应您的环境，这些更改将在重新安装过程中丢失。防止将来再次发生这种情况的一种方法是创建一个全新的防火墙例外（使用不同的名称），该例外是安装程序创建的例外的副本，并对该例外进行任何手动更改。

读取服务器日志

如前所述， Sparx Systems专业云服务器是一个窗口服务应用程序，因此它需要遵循一些基本规则。窗口服务的故障排除可能会很麻烦，因为它们的运行独立于所有用户输入/交互，因此不包含任何类型的屏幕/GUI。因此， Sparx Systems专业云服务器会将所有潜在消息写入日志文件。

专业云服务器配置文件包含许多设置，用于控制log文件的位置、数量和大小。默认情况下，专业云服务器会将所有log文件保存到以下目录下的 \Logs\ 文件夹中：

\Services\ (C:\Program Files (x86)\ Sparx Systems \专业云服务器\Service\Logs)

它最多会保留三个文件。每当云服务启动或达到最大文件大小时，都会创建A新文件。文件名“SSProCloudServerLog- log ”始终是最新的log文件，每次创建新文件时，旧文件都会通过增加数字进行重命名。例如，SSProCloudServerLog-2.log log命名为 SSProCloudServerLog- log 。

配置文件还包含一个设置，用于控制执行的日志记录级别；有关更多详细信息，请参阅扩展服务器属性帮助主题中与日志记录相关的选项。进行故障排除时，建议将专业云服务器LOG_LEVEL属性设置为最高级别 SYSTEM。

When trouble shooting it is recommended to set the LOG_LEVEL property to the highest level.

每个log条目将包含时间、日志级别和信息；如果发生错误，信息通常会包含问题的描述，并且可以根据该描述采取适当的措施。

日志信息

解释

日志文件头

每次创建新的日志文件时，专业云服务器都会写出主要设置的摘要；如果您请求Sparx Systems的支持，这些信息特别有用。

启动数据库管理器

当专业云服务器最初启动，并且日志级别设置为信息（或更低）时，它将log每个已配置模型的摘要，其中包括模型的连接string 。

[信息]: 添加了数据库管理器 - ConnectionStr: 'eaexample --- Connect=Provider=MSDASQL. 1 ;...

如果日志级别低于信息，则会为每个模型写入额外的log条目；例如：

[系统]：成功启动数据库管理器firebird：anonymous@eaexample

客房服务

专业云服务器定期执行“内务管理”任务，其频率由专业云服务器配置文件中的 AUDIT_TIME_PERIOD 设置控制。

当log级别设置为信息时，每次执行内部管理时专业云服务器都会log每个定义的数据库管理器的连接摘要，并报告当前可用的连接数、同时使用的最大连接数以及自上次审计以来的总使用次数。

[审计] firebird:anonymous@eaexample | 空闲: 0 | 最大活跃: 3 | 获取: 192 |

通常这些条目可以被忽略，因为它们仅是参考信息。

打开端口列表

当专业云服务器首次启动时，如果日志级别设置为 SYSTEM，它将为每个已配置的端口（包括管理端口(803) 和任何 http/ https端口） log一条成功消息。您应该看到如下一行：

[系统] 成功绑定并监听端口 804。

如果log文件缺少任何行，或者消息不是“SUCCESS”，则可能表示服务器端口存在问题。

这里的A常见错误是：

无法在端口 443 上创建安全服务器。

造成这种情况的可能原因有：

  • 在 C:\Program Files (x86)\ Sparx Systems \专业云服务器\Service\server.pem 中找不到证书/私钥文件
  • server.pem 文件不包含有效的证书和私钥
  • 证书颁发机构文件在 C:\Program Files (x86)\ Sparx Systems \专业云服务器\Service\cacert.pem 中找不到或无效

无法连接到数据库

在一般操作过程中，专业云服务器会将任何打开模型失败的尝试写入log文件。这通常发生在用户尝试连接数据库时。此处可能发生的错误包括：

REQUEST_CONNECT FAIL。错误 (5)：无法连接到数据库

这意味着服务器尝试打开连接但失败了。如果您看到此消息，审阅Enterprise Architect系统输出表中列出的错误中列出的潜在原因列表。

了解更多

前页 后页