04 安装一个协同服务

前言

以下内容面向群体：一线人员、客开人员。

作为开发人员，安装一个本地的协同环境，随时方便测试是必须的。

致远提供了完整的安装手册文档和安装程序，另外启动本地协同环境需要获得授权Lic，以上三件套均可以联系致远本地区的客户经理获取。

安装程序和文档取自致远商务公布的统一下载地址，安装部署手册名叫《致远 协同管理软件 XX版本 产品安装维护手册.docx》。

安装相关操作步骤请通过《安装维护手册》学习，本文不做详细的安装过程演示，只介绍几个关键点。

=====================================================================================

注意事项

以下是搭建一个本地协同环境的注意事项：

1）你需要提前准备的内容有：

• 准备一个数据库（简单实用的是MySQL，推荐MySQL5.7）
• 准备一台16G内存的电脑用于安装协同（需占用内存4G以上）
• 联系致远客户经理提前申请好试用加密狗Lic
• 联系致远客户经理获取安装程序下载地址，下载好指定版本的安装程序SeeyonInstall
• 联系致远客户经理获取文档下载地址，下载好安装维护手册，以便随时查阅问题

2）数据库方面需要自行安装，并且一定要按照安装维护手册做相关字符集等配置，否则极易出现安装启动异常。

以MySQL数据库为例，需要做如下配置（安装可参考“MySQL5.7安装”）：

• 1）设置数据库字符集为utf8，使用INNODB引擎
• 2）设置不区分大小写
• 3）配置好端口等信息，端口默认3306
• 4）数据库密码一定要设置字母+数字或更复杂组合，比如Seeyon123456，否则后面安装V5过程中会提示数据库密码不安全，无法安装
• 5）创建一个空数据库，后续安装程序会向空库中初始化脚本

[mysqld]

port = 3306

basedir=C:\Program Files\MySQL\mysql-5.7.12-winx64

datadir=C:\Program Files\MySQL\mysql-5.7.12-winx64\data

max_connections=200

character-set-server=utf8

default-storage-engine=INNODB

sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES

lower_case_table_names=1

[mysql]

default-character-set=utf8

3）安装程序，一般是一个SeeyonInstall文件夹，文件夹里面的内容大概如下图所示，其中A6-1指A6+产品，A8-1指A8+企业版，A8-2指A8+集团版，你需要根据需求安装对应版本。同时你申请的加密狗Lic也对应产品版本，否则无法启动。

功能最全面的是A8-2集团版。

4）安装过程不赘述，按照手册操作即可。这里介绍覆盖安装、升级安装原理。

这里提一个关于“重复安装”的注意事项：当前电脑第一次安装Seeyon服务时，会向注册表中写入版本信息，位置在：cmd命令->regedit->打开注册表->计算机\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SEEYON\A8

如果你已经安装过Seeyon服务，此时重新运行SeeyonInstall安装程序的话，程序会先从注册表读取信息，再与你运行的SeeyonInstall进行比对，根据对应情况对已安装的Seeyon进行升级或修复安装操作。

5）服务器配置工具：安装完成后，可以访问ApacheJetspeed\conf\SeeyonConfig.cmd这个文件来完成协同服务的端口、JVM配置，以及检查数据库连接/调整连接池大小等操作。

JVM配置最小4G

6）关于加密授权：受官方认可的加密狗获取方式只有一条通道--由致远客户经理提请，向致远商务申请的标准Licence！

从致远商务申请，有效的加密授权有四种：

• 通卡：这是一个USB硬件狗，插到电脑上就可以用，有5在线的限制，默认拥有所有插件的使用权限（但无Office控件权限）。需要向商务申请，并且交付押金。
• 正式硬加密狗：这也是一个USB硬件狗，里面有正式用户的授权，没有使用期限，插到服务器上就可以用。其功效跟下面正式软加密一模一样，唯一区别是它是一个USB Key，现在这种狗使用量较少，大多数用户采用正式软加密。
• 正式软加密：这是一个加密文件，里面有正式用户的授权，没有使用期限，将文件拷贝到客户服务器上激活后即可使用。我们的正式用户大多采用此方式。
• 试用软加密：这是一个加密文件，功能跟正式软加密一样，只是里面有使用期限限制（一般3个月左右），过期之后无法启动服务。
• V5 Seeyonconfig共享加密：机制是如果正式环境试用了一个正式或试用软加密文件，多个测试环境如果跟正式环境网络互通，就可以直接复用正式环境的软加密授权，只是最大登录限制是5并发，详情见下面“共享加密”专项说明。

客开长期使用，推荐申请USB Key的通狗；短期使用/需要给某个指定客户客开，推荐使用试用软加密或共享加密，让加密狗插件信息与客户完全保持一致，只是做个期限限制，这样才能最大程度还原客户环境。

至于通过别的渠道获取的.js、.jar类型的所谓的“通狗”都不是正规加密授权（有的只是研发内部专用授权），致远也不受理这类授权环境的咨询工单。

正式硬加密狗、正式软加密、试用软加密在申请下来之后都需要联网激活，激活工具在安装程序SeeyonInstall下面的updateDog文件夹里。

正式软加密、试用软加密需要将激活之后的文件放置在本地协同服务器A8\base\license目录下。

7）启动本地服：开发人员推荐使用ApacheJetspeed\bin\startup.bat进行启动，启动需要一定时间，当出现“startup.Catalina.start Server startup in xxxxxx ms”字样则表示启动成功。如果你很长一段时间都没反应，可能是跟快速编辑模式有关，后面有解。

8）启动本地环境完成之后，本机使用浏览器访问：http://localhost/seeyon则会进入登录页。

9）关于默认登录帐号，不同版本有不同的情况说明：

（大约）V7.1SP3之前的系列版本，安装完成之后，默认预制了group-admin和system帐号，默认密码是123456

（大约）V8.0~V8.0SP2系列版本，在安装过程中就会让你输入集团管理group-admin和系统管理员system的密码（这一切都为了安全考虑）

V8.1版本开始，又有了新的预制变化：系统废弃了group-admin和system帐号，改为了一号多权（三员角色化模式），初始安装的时候只需要设置一个初始化管理员帐号即可

三员角色化：即公司的IT人员有自己的个人帐号，可以让自己的个人帐号绑定集团管理员和系统管理员，随后只需使用一个个人帐号即可快速切换到不同平台去做管理。

如果你按照前面规则安装的A8-2集团版，并且在安装过程中已经输入了对应帐号密码，则可以执行登录操作。首先使用集团管理员帐号，依次建岗位、职务级别、单位名称、单位管理员帐号。再登录自己创建的单位管理员帐号，进行本单位的部门、人员录入。

=============================================================================================

卸载本地协同服务

卸载协同的命令工具在：A8\Uninstall_A8\uninstall.bat，Windows下需要以管理员身份运行，并且注册表信息需要存在。如果你手动删除过注册表，则直接删除整个协同目录即可。

删除过程中如果遇到如下提示，则需要先卸载S1服务。

S1服务在\A8\S1目录下找到nssm_uninstall.bat、uninstall_s1_agent_link.bat这类带unistall的执行文件，以管理员身份运行并执行卸载。如果运行无反应，则考虑直接将整个S1文件夹删除掉。

========================================================================================

关于共享加密

V5高版本（大约从V7.1开始）提供了共享加密的能力。

其使用场景为：只有一套加密狗的情况下，多个测试环境希望复用加密授权信息。此时通过正式环境、测试环境都通过Seeyonconfig应用配置器配置互通互信名单，没有加密狗的测试环境也可以立刻集成正式环境的加密授权，只是并发数只有5。

相关操作方法为：

1）测试环境（无加密狗）先配置好正式环境的地址：

2）正式环境（有加密狗）上配置好测试环境的IP，这样才能算信任相关服务

3）首先正式环境一定要保持启动运行

4）在正式环境保持运行的状态下，启动测试环境，即可共享到正式环境相同的加密插件List。

========================================================================================

关于快速编辑模式

如果运行\ApacheJetspeed\bin\startup.bat打开Tomcat执行控制台之后，启动了N久都没反应，可以看看控制台上面是否有一个白色选中块↓↓↓

如果有白色选中块，就表示快速编辑模式：鼠标点到控制台上就会有一个白色块，此时会导致控制台完全阻塞，无法继续启动。

解决方法是：取消默认快速编辑模式的设置，关闭运行窗口，再重新运行startup.bat。

关于数据库连接工具

大众使用的Navicat premium涉及版权，开发人员可以使用免费开源版DBeaver Community | Free Universal Database Tool

关于一台电脑安装多套不同版本的协同

如果你想在一台电脑上使用SeeyonInatall的方式安装V6.0、V7.0、V8.0等多个版本的服务，让他们共存，那么你需要做的事情是：

1、先删除注册表中SEEYON文件夹以及SEEYON文件夹下所有的内容，随后执行对应版本安装程序就能顺利安装，注意每个版本你的协同要安装在不同文件夹下了。

注册表位置在：cmd命令->regedit->打开注册表->计算机\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SEEYON

2、进入windows当前用户的文件夹下，比如我的用户名叫admin，则在目录C:\Users\admin\SiiFiles 下，找到所有.sii文件，全部删除。

3、准备好一个空数据库， 方便后续的操作。

4、执行安装程序。

5、准备对应版本的加密狗文件，就可以正常启动服务了。

关于提示无法继续安装的问题

安装过程中，安装程序会结合注册表、本地已经安装好的环境进行综合判断当前安装程序是否可以执行。前面已经提过，安装程序根据注册表和本地配置信息来决定：是升级还是全新安装，一切异常配置都会导致无法继续安装，如下图所示。

以上问题的情况就是：注册表信息和本地已经安装好的V5服务版本对不上，生产环境不会出这个问题，一般是开发环境动了一些东西导致。

这种问题的解决方法只有一种：删除注册表，重新执行安装程序做全新的安装。不要指望升级，因为环境已经乱了。

关于删除注册表，详见上一节操作：一台电脑安装多套不同版本