预订演示

请注意 : 本帮助页面不适用于最新版本的Enterprise Architect. 最新的帮助文档在这里.

前页 后页

PCS 故障排除

浏览器测试

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

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

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

http:// localhost :804/

或者

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 Service Unavailable

表示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-1。 log ' 将始终是最新的log文件,每次创建新文件时,都会通过增加数量来重命名旧文件。例如,SSProCloudServerLog-2。 log重命名为 SSProCloudServerLog-3。 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条目;例如:

[SYSTEM]: SUCCESS 已启动数据库管理器 firebird:anonymous@eaexample

管家

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

当log级别设置为信息时,每次做家务时,专业云服务器将log每个已定义数据库管理器的连接摘要,并报告当前可用的连接数、最大并发使用数和总连接数。自上次审核以来的使用情况。

[审核] firebird:anonymous@eaexample |免费:0 |最大活跃:3 |收购:192 |

通常可以忽略这些条目,因为它们只是纯粹的参考信息。

开放列表端口

专业云服务器在初始启动时,Log Level 设置为 SYSTEM,它会为每个配置的端口log一条成功消息,其中包括管理端口(管理端口(8803)和任何 http/ https端口)。您应该看到如下一行:

[SYSTEM] SUCCESS 绑定并监听端口 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 失败。错误(5):无法连接数据库

这意味着服务器试图打开一个连接但它失败了。如果您看到此消息,请查看Enterprise Architect系统输出表中显示的错误中审阅表潜在原因列表。

了解更多