前言
以下内容面向群体:一线人员、客开人员。
作为开发人员,安装一个本地的协同环境,随时方便测试是必须的。
致远提供了完整的安装手册文档和安装程序,另外启动本地协同环境需要获得授权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集团版。
![](https://i-blog.csdnimg.cn/blog_migrate/b384da6c70437630845f6942d9c326a1.png)
4)安装过程不赘述,按照手册操作即可。这里介绍覆盖安装、升级安装原理。
这里提一个关于“重复安装”的注意事项:当前电脑第一次安装Seeyon服务时,会向注册表中写入版本信息,位置在:cmd命令->regedit->打开注册表->计算机\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SEEYON\A8
如果你已经安装过Seeyon服务,此时重新运行SeeyonInstall安装程序的话,程序会先从注册表读取信息,再与你运行的SeeyonInstall进行比对,根据对应情况对已安装的Seeyon进行升级或修复安装操作。
5)服务器配置工具:安装完成后,可以访问ApacheJetspeed\conf\SeeyonConfig.cmd这个文件来完成协同服务的端口、JVM配置,以及检查数据库连接/调整连接池大小等操作。
JVM配置最小4G
![](https://i-blog.csdnimg.cn/blog_migrate/1ef0342ef9a7780b75ba401b4f4713d3.png)
6)关于加密授权:受官方认可的加密狗获取方式只有一条通道--由致远客户经理提请,向致远商务申请的标准Licence!
从致远商务申请,有效的加密授权有四种:
- 通卡:这是一个USB硬件狗,插到电脑上就可以用,有5在线的限制,默认拥有所有插件的使用权限(但无Office控件权限)。需要向商务申请,并且交付押金。
- 正式硬加密狗:这也是一个USB硬件狗,里面有正式用户的授权,没有使用期限,插到服务器上就可以用。其功效跟下面正式软加密一模一样,唯一区别是它是一个USB Key,现在这种狗使用量较少,大多数用户采用正式软加密。
- 正式软加密:这是一个加密文件,里面有正式用户的授权,没有使用期限,将文件拷贝到客户服务器上激活后即可使用。我们的正式用户大多采用此方式。
- 试用软加密:这是一个加密文件,功能跟正式软加密一样,只是里面有使用期限限制(一般3个月左右),过期之后无法启动服务。
- V5 Seeyonconfig共享加密:机制是如果正式环境试用了一个正式或试用软加密文件,多个测试环境如果跟正式环境网络互通,就可以直接复用正式环境的软加密授权,只是最大登录限制是5并发,详情见下面“共享加密”专项说明。
客开长期使用,推荐申请USB Key的通狗;短期使用/需要给某个指定客户客开,推荐使用试用软加密或共享加密,让加密狗插件信息与客户完全保持一致,只是做个期限限制,这样才能最大程度还原客户环境。
至于通过别的渠道获取的.js、.jar类型的所谓的“通狗”都不是正规加密授权(有的只是研发内部专用授权),致远也不受理这类授权环境的咨询工单。
正式硬加密狗、正式软加密、试用软加密在申请下来之后都需要联网激活,激活工具在安装程序SeeyonInstall下面的updateDog文件夹里。
![](https://i-blog.csdnimg.cn/blog_migrate/438dd0f2d552b6db0c3079c22c7b0ab0.png)
正式软加密、试用软加密需要将激活之后的文件放置在本地协同服务器A8\base\license目录下。
7)启动本地服:开发人员推荐使用ApacheJetspeed\bin\startup.bat进行启动,启动需要一定时间,当出现“startup.Catalina.start Server startup in xxxxxx ms”字样则表示启动成功。如果你很长一段时间都没反应,可能是跟快速编辑模式有关,后面有解。
8)启动本地环境完成之后,本机使用浏览器访问:http://localhost/seeyon则会进入登录页。
![](https://i-blog.csdnimg.cn/blog_migrate/7758c795a17a0576e1bfc53433545089.png)
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服务。
![](https://i-blog.csdnimg.cn/blog_migrate/44cbb38fef7a348cb47d664e3a3d7195.png)
S1服务在\A8\S1目录下找到nssm_uninstall.bat、uninstall_s1_agent_link.bat这类带unistall的执行文件,以管理员身份运行并执行卸载。如果运行无反应,则考虑直接将整个S1文件夹删除掉。
![](https://i-blog.csdnimg.cn/blog_migrate/98d2a8b59c432dbec89333b3b872174b.png)
========================================================================================
关于共享加密
V5高版本(大约从V7.1开始)提供了共享加密的能力。
其使用场景为:只有一套加密狗的情况下,多个测试环境希望复用加密授权信息。此时通过正式环境、测试环境都通过Seeyonconfig应用配置器配置互通互信名单,没有加密狗的测试环境也可以立刻集成正式环境的加密授权,只是并发数只有5。
相关操作方法为:
1)测试环境(无加密狗)先配置好正式环境的地址:
![](https://i-blog.csdnimg.cn/blog_migrate/42c0e9f7d50617b24a608c9061b0c437.png)
2)正式环境(有加密狗)上配置好测试环境的IP,这样才能算信任相关服务
![](https://i-blog.csdnimg.cn/blog_migrate/22409885ca0afbb6490873a3ff235670.png)
3)首先正式环境一定要保持启动运行
4)在正式环境保持运行的状态下,启动测试环境,即可共享到正式环境相同的加密插件List。
========================================================================================
关于快速编辑模式
如果运行\ApacheJetspeed\bin\startup.bat打开Tomcat执行控制台之后,启动了N久都没反应,可以看看控制台上面是否有一个白色选中块↓↓↓
如果有白色选中块,就表示快速编辑模式:鼠标点到控制台上就会有一个白色块,此时会导致控制台完全阻塞,无法继续启动。
解决方法是:取消默认快速编辑模式的设置,关闭运行窗口,再重新运行startup.bat。
![](https://i-blog.csdnimg.cn/blog_migrate/d07cb4c686f2cf3b93b29a5f2ead62a1.png)
关于数据库连接工具
大众使用的Navicat premium涉及版权,开发人员可以使用免费开源版DBeaver Community | Free Universal Database Tool
![](https://i-blog.csdnimg.cn/blog_migrate/3737e6ba5281cfba61dcdeefe994ebeb.png)
关于一台电脑安装多套不同版本的协同
如果你想在一台电脑上使用SeeyonInatall的方式安装V6.0、V7.0、V8.0等多个版本的服务,让他们共存,那么你需要做的事情是:
1、先删除注册表中SEEYON文件夹以及SEEYON文件夹下所有的内容,随后执行对应版本安装程序就能顺利安装,注意每个版本你的协同要安装在不同文件夹下了。
注册表位置在:cmd命令->regedit->打开注册表->计算机\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SEEYON
![](https://i-blog.csdnimg.cn/blog_migrate/a9f6cfe3dffdfe4fa22536b8add15925.png)
2、进入windows当前用户的文件夹下,比如我的用户名叫admin,则在目录C:\Users\admin\SiiFiles 下,找到所有.sii文件,全部删除。
![](https://i-blog.csdnimg.cn/blog_migrate/01a3af39dc7dfc339b67801ca5140434.png)
3、准备好一个空数据库, 方便后续的操作。
4、执行安装程序。
5、准备对应版本的加密狗文件,就可以正常启动服务了。
关于提示无法继续安装的问题
安装过程中,安装程序会结合注册表、本地已经安装好的环境进行综合判断当前安装程序是否可以执行。前面已经提过,安装程序根据注册表和本地配置信息来决定:是升级还是全新安装,一切异常配置都会导致无法继续安装,如下图所示。
![](https://i-blog.csdnimg.cn/blog_migrate/a97af0008736edaf7a58b3c2c82063eb.png)
以上问题的情况就是:注册表信息和本地已经安装好的V5服务版本对不上,生产环境不会出这个问题,一般是开发环境动了一些东西导致。
这种问题的解决方法只有一种:删除注册表,重新执行安装程序做全新的安装。不要指望升级,因为环境已经乱了。
关于删除注册表,详见上一节操作:一台电脑安装多套不同版本