WebEA故障排除

1

在网络服务器上，打开 Web 浏览器并测试访问WebEA登录页面。例如，输入：

http: localhost

如果失败，请检查网络服务器是否已按照WebEA安装和配置帮助主题中的说明进行设置。

2

在客户端计算机上测试访问WebEA登录页面。例如，输入：

http://<服务器名称>/webea/login.php

如果失败，则客户端和 Web 服务器之间存在网络/通信问题。

3

在尝试通过WebEA访问模型之前，请确认您可以使用Enterprise Architect的“连接到云”选项成功打开该模型。

如果失败，请参阅Pro云服务器故障排除帮助主题。

4

在 webea_config.ini 文件中，添加一个包含最低要求选项的模型连接，具体参见此处。确保这些选项与通过Enterprise Architect连接时使用的设置一致。注记，“sscs_db_alias”应与“模型名称”字段中输入的值一致。

sscs_protocol = "<协议>"

sscs_server = "<服务器名称或 IP 地址>"

sscs_port = "<端口>"

sscs_db_alias = "<模型名称>"

auth_code = "" ;留空

如果项目启用了Enterprise Architect用户安全，则还包括：

登录提示 = "true"

如果使用的协议是 HTTPS，则还包括：

sscs_use_ssl =“true”

如果您使用带有自签名证书的 HTTPS，则还包括：

sscs_enforce_certs =“ false ”

5

尝试在WebEA中访问模型。如果失败， WebEA登录屏幕返回的错误可能有助于识别问题的原因。

找不到服务器

在网络上找不到服务器！

当WebEA未从指定的服务器名称（或 IP 号码）收到任何类型的响应时，通常会出现此错误。

可能的原因：

• 服务器已关闭
• 服务器位于防火墙后面， WebEA无法与其建立连接

连接被拒绝

服务器无响应，请检查专业云服务器是否正在运行！

可能的原因：

• 专业云服务器未安装
• 专业云服务器未运行
• 专业云服务器没有监听预期的端口
• 专业云服务器的 IP 地址已在客户端允许列表中定义，但不包括WebEA服务器 IP；有关详细信息，请参阅访问控件帮助主题

不支持 OSLC

服务器端口未配置为支持 OSLC。

可能的原因：

• WebEA通过 OSLC 与Sparx Systems专业云服务器通信，但定义的Sparx Systems专业云服务器已配置为不允许此端口的 OSLC 请求

协议不匹配

协议和端口不匹配。选择已配置正确的协议和端口。

可能的原因：

• 连接设置不匹配；例如，“sscs_use_ssl”已设置为“true”，但指定了 HTTP 协议

连接超时

请求错误：连接在 5001 毫秒后超时。

可能的原因：

• 无效的专业云服务器设置 (sscs_*)， WebEA无法连接到定义的服务器/端口
• Apache/PHP Web 服务器需要代理服务器才能访问专业云服务器，而 .config 文件中定义的代理设置不正确或无效

连接失败

请求错误：无法连接到 xxx.xxx.xxx.xxx 端口 yy：连接被拒绝

可能的原因：

• webea_config.ini 文件中的“sscs_port”选项与您的专业云服务器配置文件 (SSProCloud.config) 中的端口设置不匹配；使它们相同

所选模型未定义

所选模型未在专业云服务器中定义。

可能的原因：

• webea_config.ini文件中的'sscs_db_alias'选项与添加数据库管理员中定义的'数据库别名'不对应；更正这些值，使它们确实对应
• SSProCloud.config 文件已定义 DEFAULT_MODEL；我们建议从 SSProCloud.config 文件中删除此行 - 有关详细信息，请参阅“添加端口定义帮助主题

模型正在关机

所选模型已关闭。

可能的原因：

• 您尝试访问的云服务器模型连接未启用

需要安全连接

所选模型需要安全A 。

此消息表示为此模型连接/数据库管理员启用了“需要安全且经过身份验证的连接”选项。

要通过WebEA访问此模型，您必须使用 HTTPS 协议。您还必须使用启用了“需要 SSL”的端口，并将“身份验证”选项设置为“模型”或“全局”。

SSL 错误

错误：SSL 证书问题：无法获取本地颁发者证书

此错误表明您使用了由您自己的证书颁发机构 (CA) 签名的 SSL 证书，但是 PHP/cURL 尚未配置为信任该 CA。

更新您的 PHP/cURL 配置以信任您的 CA。有关详情，请参阅“配置WebEA以信任您自己的证书颁发机构”帮助主题。

自签名证书错误

请求错误：SSL 证书问题：自签名证书

此错误表明您正在尝试使用自签名证书建立带有 SSL 的 HTTPS 连接；但是， WebEA尚未配置为允许自签名证书。

可能的原因：

• webea_config.ini 文件不包含此模型的“sscs_enforce_certs = " false "”；请尝试添加此文件，然后尝试再次访问该模型

无法访问安全会话cookie

无法访问安全会话cookie

此错误表明 PHP 配置为仅使用安全 cookie（session.cookie_secure = true）。

选择用于访问WebEA URL。在这种情况下，应通过 HTTPS 访问WebEA网站。

尚未指定模型

如果WebEA无法设置或读取 PHP 会话变量，则可能会发生此错误。

选择您的 PHP 配置并确认会话变量受支持。

缺少用户身份验证标识符

40x - 缺少用户身份验证标识符

在存储库中验证用户时出现问题。

可能的原因：

• 存储库中的用户身份验证配置不正确
• 将旧版或不匹配版本的WebEA与专业云服务器一起使用

未提供任何凭证

400 -用户安全已启用，但未提供凭据。

可能的原因：

• 该项目已启用Enterprise Architect用户安全性；但是， WebEA未配置为显示登录提示或使用特定凭据自动登录

登录提示 = "true"

或者，所有这些：

登录提示符 = " false "

sscs_model_user = "<用户 ID>"

sscs_model_pwd = "<密码>"

登录信息不正确

指定的登录详细信息对于当前模型无效！

可能的原因：

• 提供的用户 ID 和密码组合与模型中定义的任何用户凭据不匹配

拒绝用户登录：已达到用户限制

专业云服务器拒绝用户登录： WebEA用户限制已达到或

专业云服务器拒绝用户登录： Prolaborate user Limit Reached or

专业云服务器拒绝用户登录：已达到第 3 方用户限制

当使用带有令牌许可证的 ProCloud服务器时，一旦所有令牌都已用完，任何进一步的用户登录请求都将收到“已达到用户限制”错误消息。

可能的原因：

• 用户数量超过可用的专业云服务器令牌许可证数量。
• 之前已登录的用户尚未注销，并且他们的会话尚未过期，因此他们的令牌已被消耗但目前未被使用。
• A物理用户打开多个会话（多个浏览器），每个会话都消耗一个令牌。

使用令牌许可时，务必向用户群强调，他们需要在完成后log WebEA ，以便其他用户不会因缺少许可证而受到影响。

访问代码错误

输入的访问代码不正确！

可能的原因：

• 此模型已配置（在 webea_config.ini 文件中）需要访问代码才能访问WebEA ；输入的访问代码不正确

读取模型根出现问题

读取模型根出现问题。

可能的原因：

• 当前模型的WebEA选项与专业云服务器配置不匹配
• 您正在尝试访问尚未将项目转移到其中的 DBMS 存储库；请参阅基于服务器的存储库帮助主题中的第 4节

选择物件时无反应

WebEA加载初始页面（模型根或默认图表）后，选择对象没有反应。

可能的原因：

• 您的浏览器未启用JavaScript ；请重新启用
• 服务器上未安装并启用 cURL PHP 模块/扩展；请在您的 Web 服务器上安装/启用 cURL
• PHP 版本错误；必须大于 PHP 5.0 并支持所有扩展

收到了意外的回复

收到意外响应，请检查专业云服务器配置！

此错误通常发生在尝试从初始页面log或连接到模型时。每当配置的专业云服务器的响应未返回预期的 XML 消息时，就会显示此错误消息。

选择定义的Sparx Systems专业云服务器详细信息（例如服务器名称和端口）是正确的，而不是 Web 服务器的详细信息。

未找到图表图像

未找到图表图像。

这个错误表明该图存在于模型中，但是尚未生成该图的图像。

可能的原因：

• 该模型没有在模型特定选项中启用“自动创建图表图像和图像地图”选项。请参阅云页面帮助主题。
• 该图表是在Enterprise Architect中创建的，但尚未保存
• 用户使用的是Enterprise Architect的旧版本（版本 1350 之前），并且该模型的工作者应用程序未运行（尚未配置、当前未运行或自保存图表以来未运行）

在Enterprise Architect （版本 1350 或更高版本）中打开模型，启用“数据缓存”选项，然后单击“创建”按钮，如“ WebEA安装和配置”主题的“模型配置”部分所述。

或者，确保此模型的工作者应用程序正在运行。有关详细信息，请参阅如何配置自动可视组件帮助主题。

所选数据库未启用专业特征

所选数据库未启用专业特征。

如果所选模型未启用“专业特征”，通常会发生此错误。

可能的原因：

• 在专业云服务器配置客户端中，该模型的数据库管理员没有启用“启用专业特征（OSLC、 WebEA和集成）”选项
• 专业云服务器的许可证已过期，服务器现在作为专业云服务器的免费核心版本运行
• 输入的许可证密钥无效，专业云服务器作为核心版本运行
• 数据库管理器已分配“OSLC访问代码”，但 webea_config.ini 文件中未提供该代码

如果已分配“OSLC访问代码”，请确保已在 webea_config.ini 文件中设置“sscs_access_code”选项。

未找到资源

404 - 无法找到标识符为“{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}”的资源

在当前模型中找不到具有此GUID的项目（元素、包或图表）。

可能的原因：

• 该项目已从模型中删除

如果在图表上选择项目时发生错误，则可能必须重新生成图表图像。

版本不匹配

警告 - WebEA / OSLC版本不匹配

专业云服务器的每个版本都包含一个 OSLC 组件和一个WebEA组件（php 文件）。如果您使用一个版本的 OSLC 组件和另一个版本的WebEA组件，则WebEA可能无法按预期函数。

可能的原因：

• 安装A专业云服务器；但是，新版本的WebEA并没有复制到网络服务器

未显示基本登录字段

在以下情况下尝试log模型时，基本登录字段将不可见：

• webea_config.ini 已定义“sscs_model_user”
• 该模型已启用用户选项“仅限窗口和OpenID用户访问”

无法启动 PHP 会话

错误：无法启动 PHP 会话

WebEA使用 PHP 会话。此错误表明 PHP 无法写入会话“save_path”。这可能是因为该路径不存在，或者运行 PHP 的用户没有该文件夹的写入权限。

此错误消息还包含有关保存路径位置、路径是否可写以及 PHP 运行时的用户名/ID 的信息。请确保该文件夹存在，并且 PHP 用户具有写入权限。如有必要，可以通过 php.ini 文件更改 session.save_path 设置（然后重新启动 Web 服务器）。

单击图表元素时无响应

当单击图表上的元素时，什么也没有发生。

可能原因：

• 元素属性正在属性视图中加载；但是，由于屏幕/浏览器宽度较窄（小于 800 像素），属性视图会自动隐藏

页面加载不正确

服务器更新到新版本的WebEA后，客户端会遇到页面加载不正确的问题。

可能原因：

• 用户的浏览器正在使用WebEA客户端文件的缓存版本，这会导致不可预测的结果
  解决方案是清除浏览器缓存，强制浏览器从服务器下载最新版本的应用程序文件；每个浏览器/设备的清除缓存的过程都不同 - 请查阅浏览器的用户手册

Internet Explorer 中的登录页面

“登录”页面绘制不正确，与其他浏览器的显示不同；也就是说，每个模型名称旁边的选择框不是正方形。

所有通过身份验证登录模型的尝试均失败，并显示“未选择模型！”

可能的原因：

• IE 正在以“兼容性视图”模式运行，不支持 HTML5 和 CSS3；请至少关闭托管WebEA服务器的“兼容性视图”