如何在Guidewire 10.0.2中启用本地Studio并发数据库连接？

问题场景与报错信息 #

多名开发者使用本地Guidewire Studio 10.0.2（自托管）连接同一SQL Server 14.0.3数据库，已在database-config.xml中配置相同jdbc-url，但启动Billing Center时触发集群冲突报错，核心错误为检测到其他活跃服务器，但集群已禁用，完整报错日志如下：

INFO 启动单节点集群通道
INFO 加入集群的成员：[Local machine id 2] 注：Local machine id 1的服务器已启动
ERROR 集群成员仍处于活跃状态：[Local machine id 1]
WARN 无法启动集群通道，正在停止通道
抛出异常，Billing Center无法启动
GW Lifecycle Exception
由GWConfigurationException引起：检测到其他活跃服务器，但集群已禁用

解决步骤 #

• 配置单节点集群允许独立运行
  编辑cluster-config.xml文件，找到<cluster>节点，添加allow-single-node-cluster="true"属性，修改后配置如下：

  <cluster enabled="false" allow-single-node-cluster="true"/>
  

  该配置会让每个开发者的Studio实例以独立单节点模式启动，跳过跨节点的集群活跃检测。

• 清理数据库残留集群节点记录
  连接目标SQL数据库，执行以下SQL命令删除gw_cluster_member表中的残留节点记录：

  DELETE FROM gw_cluster_member;
  

  注意：仅在开发环境执行此操作，操作前确认无重要生产数据。

• 配置唯一节点标识
  在cluster-config.xml中为本地实例设置唯一的machine-id，确保每个开发者的节点ID不重复，示例配置：

  <machine-id>dev-${user.name}</machine-id>
  

  也可手动指定固定唯一值，避免节点ID冲突触发集群检测逻辑。

• 重启验证
  保存所有配置修改后，重启Guidewire Studio，重新启动Billing Center服务。

内容的提问来源于stack exchange，提问作者HelsinkiNF