系统运维

# 协同产品部署常见问题

北京致远互联软件股份有限公司 2025年06月

# 前言

本手册对协同管理系统在安装及维护时，常见的问题进行说明。如对手册存在疑问，可与致远互联的客户服务人员联系。

# 应用服务常见问题

1、Ubuntu 22.04.2 LTS操作系统，选择postgresql数据库，安装协同服务提示"不存在可用的数据库连接，请确认数据库是否启动"

问题原因：pgsql13.3/data/pg_log/startup.log日志记录启动错误：

2023-04-17 17:02:21.812 CST [3226] LOG:  invalid value for parameter "lc_messages": "zh_CN.UTF-8"
2023-04-17 17:02:21.812 CST [3226] LOG:  invalid value for parameter "lc_monetary": "zh_CN.UTF-8"
2023-04-17 17:02:21.812 CST [3226] LOG:  invalid value for parameter "lc_numeric": "zh_CN.UTF-8"
2023-04-17 17:02:21.812 CST [3226] LOG:  invalid value for parameter "lc_time": "zh_CN.UTF-8"
2023-04-17 17:02:21.812 CST [3226] FATAL:  configuration file "/data/pgsql13.3/bin/../data/postgresql.conf" contains errors

问题异常是：找不到zhCN中文字符集，此时可以通过如下命令检查当前操作系统的语言环境，可以看到语言环境是en_US，并非zhCN：

root@localhost:/data/pgsql13.3/bin# locale
LANG=en_US.UTF-8
LANGUAGE=
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=

【解决方案】 安装中文语言包，命令参考：sudo apt install language-pack-zh-hans

2、启动协同的时候提示80端口被占用

问题现象：启动协同时，日志控制台提示如下异常，这个表示80端口被占用，协同Tomcat默认使用80端口导致无法启动。

严重： Error initializing endpoint
java.net.BindException： Address already in use： JVM_Bind：80

【解决方案】

  1. 检查协同是否已经启动了，本次是重复启动导致冲突
  2. 如果不是协同的，可能当前系统下还有别的服务占用了80端口，此时考虑协同更换端口，可用过SeeyonConfig修改端口解决

3、启动协同报错，日志显示报错信息 - 验证产品加密狗无效: error: xxxx

【解决方案】

  • 常见报错1001：未找到加密狗，请确认服务器是否放置硬件加密狗。

  • 常见报错3001、1014：加密狗或软加密文件绑定MAC地址与当前服务器已启用的有IP地址的网卡MAC不匹配。

4、升级后，协同系统启动失败

【解决方案】

先检查【协同主目录】/Logs的all.log、error.log日志文件，确认在升级过程中是否有报错信息（error、exception关键词）。

如没有升级错误，再检查协同相关异常，通过查阅协同OA启动问题合集分析解决问题 https://open.seeyoncloud.com/#/faq/faq/v1/share?url=Z2JySmU+NDoxMQ==

注意：

  • 在升级之前，必须关闭协同服务。检测方法是在"任务管理器"中，确认协同服务占用的java是否已经关闭；
  • 在升级前，需要确保数据库服务为启动状态。

5、重复安装时提示"数据源读取失败"，且配置数据源连接时URL无法自动生成。

【解决方案】

检查系统中是否存在产品的注册信息：

Windows下检查注册表：
32位 HKEY_LOCAL_MACHINE\SOFTWARE \SEEYON\**；
64位 HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SEEYON\**
Linux下检查/root/.config/seeyoninstall_**.info

检查注册信息中SEEYON_PATH所示路径下的协同是否存在，且其应用配置器（SeeyonConfig）可以配置连接数据库。

6、Linux服务器，服务启动好后，访问不到

【解决方案】

检查服务端口是否监听，端口正常监听，但telnet不通话，应该是端口没放开。尝试直接关闭防火墙，执行命令：systemctl stop firewalld

# 数据库常见问题

问题一、进行数据库连接测试，出现报错提示，如下图所示，从而导致协同启动失败

【解决方案】

  • Oracle10g拷贝 $【oracle_client_home】/client_1/jdbc/lib下的classes12.jar文件到【协同主目录】/ApacheJetspeed/lib下；
  • Oracle11g拷贝 $【oracle_client_home】/client_1/jdbc/lib下的ojdbc5.jar或ojdbc6.jar文件到【协同主目录】/ ApacheJetspeed /lib下（如果【协同主目录】/ApacheJetspeed /lib存在classes12.jar和ojdbc14.jar，则必须删除这两个文件，否则将不能正常运行）

问题二、Oracle数据库alter.log出现Heap size 3392K exceeds notification threshold (2048K)告警

【解决方案】

1、修改此隐含参数
SQL> alter system set "_kgl_large_heap_warning_threshold"=52428800 scope=spfile;
2、使用命令重启Oracle服务，或者直接重启Oracle服务器操作系统
SQL> shutdown immediate
SQL> startup

修改参数后，用sys查看隐藏参数修改是否生效：

select ksppinm, ksppstvl from x$ksppcv cv, x$ksppi pi where cv.indx = pi.indx and pi.ksppinm like '_kgl_large_heap_warning_threshold%';

原因在于Oracle10.2.0.1的Bug，10.2.0.2已经把这个值修改为50M，升级10.2.0.2到也可解决。

问题三、连接SQLserver数据库提示驱动程序无法通过使用安全套接字层（ssl）加密与SQLserver建立安全连接

问题原因：连接报错原因是因为数据库的ssl算法被操作系统给拦截，极个别操作系统会出现该报错，例如：RockyLinux 9.1

【解决方案】

通过安装程序增加jvm参数的解决 -Djava.security.disableSystemPropertiesFile=true

问题四、Mysql新增配置log-bin-trust-function-creators=1参数，避免升级报错

# https常见问题

客户希望协同以及其它包括外网的扩展服务都需要https，如何配置？

推荐全部采用部署Nginx反向代理，由Nginx管理HTTPS，而局域网的协同和其它扩展服务均使用HTTP不做任何改动，这样维护成本最低。

具体可见协同对应部署手册，或参考 Nginx反向代理和负载均衡协同OA（https）https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjM0NzM=

编撰人：het、admin

快速跳转

← 全文检索部署维护手册 →