S1

  少于1分钟  

概述

此文档主要说明S1 for A8c（以下简称S1）中各项功能的使用。

关于S1的安装请参考《致远服务S1 for A8c安装维护手册》

适用浏览器：IE9及之后版本，Edge，Chrome，FireFox。

协同主服务安装完成时，一般会自动安装并启动S1服务

S1脚本说明【协同主目录】/S1/bin/ 目录下

start.sh/start.bat linux/windows启动服务脚本

stop.sh/stop.bat linux/windows停止服务脚本

resetPwd.sh/resetPwd.bat linux/windows修改S1登陆密码脚本

1.1 进入首页

S1 for A8c采用B/S结构，请使用浏览器访问。

在服务器访问

打开服务器的浏览器，访问 http://127.0.0.1:8864/agent

在PC端访问

打开PC端的浏览器，访问 http://服务器ip:8864/agent

进入登录页面，如下图：

登录名为admin。

获取密码以及修改密码请参考《致远服务S1 for A8c安装维护手册》

进入首页后需阅读并同意《隐私保护协议》，同意后即可使用各项功能。示意图如下

1.2 功能概述

S1主要功能包含：运维监控、服务启停配置、数据库服务、补丁更新、应用包安装：

• 运维监控：提供服务器及服务的资源监控。
• 服务启停配置：支持协同服务、微服务的服务启动、停止、多节点配置下发
• 多节点配置下发日志查看与追踪
• 补丁更新：修复程序缺陷
• 应用包安装：增购应用包的部署

功能说明

2.1 许可管理

通过许可管理功能上传License，首次上传页面如下，License支持在线和离线更新

2.2 服务启动配置

服务启动配置支持协同服务、扩展服务等服务的启动、停止及配置。配置参数参考协同安装维护手册。

服务启停配置中的自动启动是指当S1服务启动后，当前环境中的其它服务会随着S1的启动而启动。

2.3 应用配置

组件版本及端口

资源	最低版本	默认维护端口	备注
Redis	5	6379
Mysql	5.7	3306
Nginx	适配	80、443
ElasticSearch	7.15	9200、9300

服务管理>基础配置

主服务入口配置、扩展服务负载均衡配置：

数据库配置

redis配置

存储配置

es配置

2.4 补丁包更新

补丁包更新支持可视化的上传、下载产品标准补丁包，可视化的进行补丁包安装（自动备份程序，安装补丁包）、补丁包卸载（自动还原至打包前），并记录补丁包的操作日志。

内网用户（无法连接外网的用户），可通过“离线安装“功能，上传标准补丁包，并自动安装补丁包（安装过程会自动停止协同服务）。

联网用户（可以连接外网的用户），可通过“在线下载补丁包“功能，查看适用于协同系统的标准补丁包。在该列表中，可视化的安装、卸载补丁包。

选择补丁包安装时，自动检查当前列表中的所有补丁包，若选择的补丁包发布时间前，存在其他补丁包，则会默认勾选，不可取消，然后一并安装

除了安装完的提示信息，我们也可以点击补丁包名称或补丁包描述，来查看补丁包详细信息。

安装补丁包后可以在列表中选择补丁包进行卸载。若选择的补丁包发布时间后存在其他的已安装补丁包，则一并卸载。

对于卸载后的补丁包若我们之后不想再次安装，则可以通过点击忽略，将补丁包置为忽略状态，即下次打包不会安装此补丁包。

2.5 应用包安装

此模块可以对新购应用包进行安装、更新、回滚等操作。

已安装列表

罗列已经安装的应用包，包含自带和后期新购后安装的应用包。

根据实际需要可以后安装的应用包进行回滚

未安装列表

罗列离线导入的许可文件中的新购应用包。

若需在线查看新购应用包，请点击在线安装。

本页可以通过列头排序，通过搜索框快速查找应用。

对新购应用包执行更新、或者安装操作。

在线安装应用列表

在线获取并罗列新购应用包，减少导入离线许可操作。

本页允许在线安装或者先下载再择机安装。

应用包下载、配置

若新购应用存在特有配置，会在应用配置中展现，并配置。

配置完成后执行安装操作

安装完成后提示信息。

所有安装完成后，请启动A8C服务验证。

2.6 国际化

S1默认支持中文、英文两种语言，国际化设置如下：

2.7 日志管理

可以对配置下发和license上传更新做日志记录与状态跟踪

可以查看每次配置更新的详情

2.8 运维监控

2.8.1 简介

运维监控主要监控：服务器CPU、服务器内存、磁盘使用率、网络利用率。

2.9 多节点建联

对于协同集中部署，S1内置数据库使用默认配置即可，不需要配置。

对于协同分离部署、集群部署，存在多台服务器多个S1。

此时需对S1内置数据库的

• IP设置为同一台，必须设置为协同主节点的IP.
• ismaster参数仅协同主节点设置为true，其他节点设置为false

修改h2.ip

h2.port默认为1092，若端口被占用可以修改，如需要在单独部署的微服务和从节点的服务器中使用S1，修改完ip后，确保1092端口可通过防火墙等安全系统。

请使用局域网IP，不要使用 127.0.0.1、localhost 和公网IP.

Ismaster 参数设置

ismaster参数仅协同主节点设置为true，其他节点设置为false

服务解析

当我们完每个节点上的S1的h2.ip后，先启动协同主节点上的S1，待启动完成后，再逐一将其他机器的S1启动（顺序没有要求），当启动完成后，我们可以访问协同主节点的S1，然后再到Agent设置里解析其他机器上的IP，解析成功后，就可以在协同主节点的S1去统一管理所有机器的服务（注意：如果机器上只有数据库，只将该机器上的S1的h2.ip配置成协同主节点的IP即可，不用解析）

若S1存在多个节点，当主节点S1重启后，为了保证从节点S1正常使用，需要将各从节点的S1在主节点S1启动完成后，进行重启。

致远互联微服务

“致远互联微服务”是致远服务官方微信服务号，扫描以下二维码关注：

暂不支持

“致远互联微服务“为客户提供移动端在线服务。包含：在线客服、查询服务进度、查询企业信息等服务，并定期推送热点知识。

常见问题

点击登录没反应并且页面样式问题

S1支持IE9及以上版本，但部分环境的IE浏览器可能会出现如下情况：

点击登录没反应，这个和IE配置有关。

可以在IE中开启二进制文件和脚本行为后刷新缓存后再次访问，具体配置方式如下：

打开IE浏览器后进入Internet选项。

进入Internet选项后，进入安全，选择Internet后，点击自定义级别，找到ActiveX控件和插件下的二进制文件和脚本行为，勾选为启用。

数据库文件被锁

S1中内置了H2数据库，当H2数据库被打开时，都会创建一个锁定文件，以指示数据库正在使用的其他进程，若更换过服务器IP，可能会导致文件被锁定导致启动失败，错误提示如下：

遇到此类问题，可手动将S1/userdata/userdata.lock.db文件删掉，其他文件保留。

然后重启即可。

S1启动失败并提示存在多个协同产品。

S1启动失败，并在启动窗口的最后部分出现系统存在多个协同产品字样。

例如【a8c】【a6】等

此问题常见于Windows环境，由于服务转版或其它原因，导致注册表中存在多个OA服务的注册信息。

该文提处理方为，确认当前的协同服务信息，然后将多余的导出备份后删掉。

Windows键 + r 调起运行窗口，然后在运行窗口中输入regedit后打开，即打开注册表。

协同服务在注册表中的路径为：

计算机\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SEEYON\

找到这个目录，就可以看到存在多个协同服务信息。

确认本地的真实环境后，将多余的协同服务信息选中后右键，先导出备份，再删除，最后重启S1即可。

S1由于端口被占用导致的启动失败

S1启动失败，并且在启动窗口的最后部分出现Address already in use: bind

此类错误是因为端口被占用导致，S1默认端口为8864

Windows 环境下，我们可以在DOS窗口中执行netstat -ano|findstr 8864，找到占用改端口的进程ID。（若端口做过修改，则将8864换成对应端口即可）

得到进程PID后，我们可以去任务管理器的详细信息中，通过进程PID找到所对应的程序。

找到对应程序后，若对应程序可以停，则杀掉该进程后重启S1即可，若程序不可停，则也可以修改S1的默认端口，在S1的安装目录下，进到config文件夹，找到application-custom.properties文件，右键编辑，修改server.port。

修改后保存重启S1即可。

服务启动配置页面无服务

Windows

1、检查注册表是否正常注册如下图所示,忽略配置与实际情况的偏差。

2、若没有协同配置，则需手动进行添加，添加后重启S1

Linux

1. 检查/root/.config/目录下是否有seeyoninstall_A8.info 文件
2. 若没有此文件，需手动创建
3. 下图标记的值不需要修改，只需按当前协同版本修改其它项的值

1. 添加完成后重启S1

4.6 主服务和扩展服务安装到同一台机器

主服务和扩展服务进行安装时由于资源受限，只能安装到同一台机器的情况下，S1会随着安装包进行安装。届时未来避免不必要的问题和容易发生混淆等问题，请统一使用主服务下面的S1对安装的协同服务进行运维和监控。主服务和扩展服务安装完毕后需要重启主服务S1才能同时发现主服务和扩展服务。切记安装到一台服务器时要先安装主服务，再安装扩展服务，都安装完毕后重启主服务S1。然后在登陆主服务S1进行配置下发等后续运维工作。

4.7 集群中新增协同服务节点

当集群中新增主服务或者扩展服务节点时，首先需要通过S1的建联机制，统一纳入到S1的管理中，然后再通过配置下发功能将配置重新下发一遍，再通过S1启动新增的协同服务节点。如果安装节点在主服务上，则需要重启S1。