云服务器故障排除

浏览器测试

要简单检查Cloud Service是否在配置文件中定义的指定端口上运行，您可以将此地址输入Web浏览器：

<protocol>://<machineName>:<port>

例如，在云服务器上：

HTTP：//localhost：804 /

要么

https://sparxcloud.com

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

Sparx Systems云服务器

恭喜，您的服务器现已准备好托管您的模型。通过连接

配置客户端添加或删除模型。

如果未显示此消息，请确认服务器和端口名称，检查在指定端口上侦听的其他服务，并检查服务器日志文件以获取错误消息。

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

错误信息	含义
HTTP状态401拒绝访问	表示无法通过服务器进行身份验证。使用内置Web服务器时，如果提供了无效的用户名或密码，或者未提供用户名或密码，则会发生此错误。
HTTP状态403	表示尝试访问在服务器上标记为“需要经过身份验证且安全连接”的模型。这可能表示您使用http协议而不是https进行连接，或者您正在使用的端口未向要连接的模型提供身份验证。检查您是否使用https。请与系统管理员联系，确认安全验证选项指向启用了安全性的模型。
HTTP状态500无法连接到服务	该连接未被接受。检查服务器名称检查客户端和服务器上的防火墙设置检查服务器正在侦听的端口
该数据库的数据库管理器已关闭	Enterprise Architect建立了与Cloud Service的连接，并请求连接到已知存储库，但当前已禁用存储库。请系统管理员检查相关数据库的“已启用”选项。
没有为请求的存储库配置数据库管理器	Enterprise Architect建立了与Cloud Service的连接，但请求的模型名称与服务器上任何已定义的数据库都不匹配。
无法连接到数据库	Enterprise Architect建立了与Cloud Service的连接，并请求连接到已知的存储库; 但是，当服务器尝试使用提供的详细信息打开与数据库的连接时，它会失败。注意：每当发生此错误时，包含更多详细信息的警告级别消息都将写入Cloud Server日志。如果存储库是：使用ODBC，请系统管理员检查ODBC连接是否已定义为服务器上的系统DSN（不是用户DSN），所有连接参数都是正确的，并且数据库用户名和密码已保存到ODBC DSN中或连接字符串 Oracle，要求您的系统管理员验证用连接字符串保存的用户名和密码，以及连接中的所有其他选项是否正确 SQL Server通过OLE DB和Windows身份验证连接，请您的系统管理员验证运行Cloud Service的用户名是否已被授予SQL Server数据库的权限（至少需要角色db_datareader和db_datawriter）连接中的所有其他选项都是正确的 SQL Server通过OLE DB和SQLServer身份验证连接，要求您的系统管理员验证已定义的用户名是否已被授予SQL Server数据库的权限（至少需要角色db_datareader和db_datawriter），该选项用于保存启用了连接字符串的密码，并且连接中的所有其他选项都是正确的
重新安装Enterprise Architect后不再有效	您的环境工作正常，然后您更新到最新版本的Cloud Server，现在Enterprise Architect客户端无法连接到您的云模型。在重新安装过程中，Cloud Server安装程序实际上会卸载原始安装程序，然后安装新的安装程序。因此，将删除并重新创建安装程序自动添加的防火墙例外。此问题是，如果有人手动调整了防火墙例外（在原始安装之后），则在安装程序重新创建防火墙例外时，任何手动更改都将丢失。阻止将来发生这种情况的一种方法是创建一个全新的防火墙例外（具有不同的名称），该例外是安装程序创建的一个副本，并对该异常进行任何手动更改。

读取服务器日志

如前所述，Sparx Systems Cloud Service是一个Windows服务应用程序，因此它需要符合一些基本规则。当涉及到故障排除时，最重要的服务规则是它们可以独立于用户输入/交互运行，因此不包含任何类型的屏幕/ GUI。因此，Sparx Systems Cloud Service会将任何可能的消息写入日志文件。

Cloud Service配置文件包含许多控制日志文件的位置，数量和大小的设置。默认情况下，Cloud Service会将所有日志文件保存到\ Services \（C：\ Program Files（x86）\ Sparx Systems \ Cloud Services \ Service \ Logs）下的\ Logs \文件夹中，并且最多可保存3个文件。无论何时启动Cloud Service，或者达到最大文件大小，都将创建一个新文件。文件名'SparxCloudServicesLog-1.log'将始终是最新的日志文件，每次创建新文件时，通过增加数字重命名旧文件。即SparxCloudServicesLog-2.log重命名为SparxCloudServicesLog-3.log。

配置文件还包含一个控制执行日志记录级别的设置，有关详细信息，请参阅“ 全局服务器选项 ”中与日志记录相关的选项。进行故障排除时，建议将Cloud Services LOG_LEVEL属性设置为最高级别SYSTEM。

每个日志条目将包含时间，日志级别和消息，如果发生错误，消息通常将包含问题的描述，并由此可以采取适当的操作。

记录消息	说明
日志文件头	每次创建新的日志文件时，Cloud Service都会写出主要设置的摘要，如果您要求Sparx Systems提供支持，此信息特别有用。
启动数据库管理员	最初启动Cloud Service时，日志级别设置为INFO（或更低），它将注销每个已配置模型的摘要，其中包括模型的连接字符串。 [INFO]：添加了数据库管理器 - ConnectionStr：'eaexample --- Connect = Provider = MSDASQL.1; ... 如果日志级别低于INFO，则将为每个模型写入其他日志条目，例如： [SYSTEM]：SUCCESS启动数据库管理器firebird：anonymous @ eaexample
保管	Cloud Service执行定期“管家”任务，其频率由Cloud Service配置文件中的AUDIT_TIME_PERIOD设置控制。当日志级别设置为INFO时，每次执行内务处理时，Cloud Service将注销每个已定义数据库管理器的连接摘要，并报告当前可用的数量，并发使用的最大数量以及自使用以来的总使用次数上次审核。 [AUDIT] firebird：anonymous @ eaexample \| 免费：0 \| 最大活动：3 \| 收购：192 \| 通常，这些条目可以忽略，因为它们仅是纯粹的参考信息。
打开端口列表	当云服务器最初启动，并且日志级别设置为SYSTEM时，它将为每个配置的端口注销成功消息，其中包括管理端口（803）和任何http / https端口，您应该看到一行如此如： [SYSTEM] SUCCESS绑定并侦听端口804。如果日志文件缺少任何行，或者如果消息未读取“SUCCESS”，则可能表示服务器端口出现问题。这里常见的错误是：无法在端口443上创建安全服务器。可能的原因是：在C：\ Program Files（x86）\ Sparx Systems \ Cloud Services \ Service \ server.pem中找不到证书/私钥文件 server.pem文件不包含有效的证书和私钥在C：\ Program Files（x86）\ Sparx Systems \ Cloud Services \ Service \ cacert.pem中找不到或无效的证书颁发机构文件
无法连接到数据库	在操作期间，服务器将向日志文件写入任何尝试打开模型的失败尝试。在用户尝试连接到数据库之前，通常不会发生这种情况。这里可能出现的错误是： REQUEST_CONNECT失败。错误（5）：无法连接到数据库这意味着服务器尝试打开连接但它失败了。如果您看到此消息，请查看Enterprise Architect 系统输出部分中显示的错误中列出的潜在原因列表。