# 安装协同系统
作为开发人员，安装一个本地的协同环境，随时方便本地测试、调试是必须的。
致远提供了完整的安装手册文档和安装程序，另外启动本地协同环境需要获得授权Lic，以上三件套均可以联系致远的客户经理获取。
安装程序和文档取自致远商务公布的统一下载地址，安装部署手册名叫《致远 协同管理软件 XX版本 产品安装维护手册.docx》。
# Windows环境安装步骤
# 操作总览
安装一个本地环境整体步骤如下：
- 安装本地数据库，推荐MySQL5.7
- 下载并运行安装程序，按照引导安装服务到本地
- 配置参数，放入Lic授权文件，启动系统
# 安装MySQL5.7
前提是您本地没有安装MySQL，如果您本地安装过MySQL，我们建议您重新安装，因为V5服务对MySQL数据库配置有要求，比如UTF8编码集、lower_case_table_names忽略大小写等配置。如果使用你原本的MySQL数据库，在安装过程中可能遇到各种莫名问题。
操作参考：https://www.cnblogs.com/jyiqing/p/6924062.html
1）下载绿色免安装zip版本
2）将MySQL5.7解压到指定目录，如D:\Develop\mysql-5.7.12-winx64
3）解压后的MySQL目录下默认没有data文件夹，也不要去创建data文件夹！
4）在MySQL目录下增加一个my.ini文件，my.ini文件内容包含如下代码片段（注意basedir和datadir由你自己存放目录决定，尤其是注意datadir是数据存放地址，并且先不要创建这个文件夹，这个文件夹由MySQL自动生成）
[mysqld]
port = 3306
basedir=D:\Develop\mysql-5.7.12-winx64
datadir=D:\Develop\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
5）以管理员身份运行cmd命令
6）在cmd命令窗口执行脚本，跳转到mysql的bin目录下
>d:
>cd cd D:\Develop\mysql-5.7.12-winx64\bin
7）完成上一步之后，在cmd命令窗口运行命令安装mysql
>mysqld –install
8）完成上一步之后，在cmd命令窗口执行初始化命令（我是执行的mysqld --initialize-insecure）
>mysqld --initialize-insecure --user=mysql --explicit_defaults_for_timestamp
9）完成上一步之后，在cmd命令窗口启动mysql服务
>net start mysql
10）完成上一步之后，在cmd命令窗口登录mysql（输入如下命令后回车会提示输入密码，默认密码为空，直接回车即可）
>mysql –u root –p
11）完成上一步之后，在cmd命令窗口修改数据库密码
# 先定位到mysql数据库，敲击回车
>use mysql;
# 再执行更新密码，回车
>update user set authentication_string=PASSWORD("seeyon123456") where user="root";
# 再更新权限，回车
>flush privileges;
# 最后退出mysql，重新登录就要求输入密码了
>quit;
12）安装完成后，MySQL会默认注册到服务中自启动，如果没有自启动就需要自己去设置开启：搜索“服务”，找到MySQL启动
13）为了方便mysql命令执行，可以将mysql的bin注册到环境变量PATH中，随后您就可以通过cmd命令行在任何地方运行mysql（操作方法可百度）
14）关于数据库连接工具，请使用正轨途径授权的工具或免费工具：
开源免费的可视化工具 dbeaver Community Edition (opens new window)
更多数据库调优见关联文档：https://open.seeyoncloud.com/v5doc/142/1184/144.html (opens new window)
# 安装V5服务
1）前期准备
- 首先保证本地电脑有足够内存资源，需占用内存4G
- 提前准备好加密狗License授权文件
- 提前准备好安装程序SeeyonInstall（一般从致远客户经理初获取下载链接）
- 提前下载好安装维护手册，以便随时查阅问题（一般从致远客户经理初获取下载链接）
2）确认安装的版本
安装程序是一个SeeyonInstall文件夹，文件夹里面的内容大概如下图所示，其中A6-1指A6+产品，A8-1指A8+企业版，A8-2指A8+集团版，你需要根据需求安装对应版本。同时你申请的加密狗License也会对应产品版本，加密文件和安装的版本不匹配也无法启动。
高版本开始，会检查服务器环境是否满足要求，有可能安装时会因为CPU核心数不足、虚拟内存不足不让安装。如果是本地个人使用，可以通过调整配置跳过限制，调整限制的配置文件路径SeeyonInstall\inst\check.yml，如何修改不做赘述，都是搞技术的，相信你看得懂。
数据库校验不通过，配置调整方法：https://open.seeyoncloud.com/v5doc/142/1184/144.html (opens new window)
3）上一步完成之后，开始按照引导进行一步一步的安装操作
缺省安装地址最好改一下，默认在C:\Seeyon\A8下，建议改为D:\Seeyon\A8，非系统盘毛病少些，后续操作均使用D:\Seeyon\A8目录做演示。
数据库设置：类型MySQL，数据库名自定义如v5，服务器地址localhost，端口3306，用户名root，口令是前面安装数据库设置的密码，如seeyon123456
注：MySQL无需提前连接到数据库去创建database，如果你所输入的数据库名不存在，安装程序会自动去创建
初次安装完成需要设置管理员密码，需要设置复杂一点，比如Seeyon123456
最终你的V5安装之后的文件存放在D:\Seeyon\A8，现在你需要在此目录下进行一些操作才能启动使用。
4）修改应用配置器
安装完成后，运行D:\Seeyon\A8\ApacheJetspeed\conf\SeeyonConfig.cmd这个文件，来完成协同服务的端口、JVM配置，以及检查数据库连接/调整连接池大小等操作。
JVM配置最小4G，再小很容易启动不了！
5）准备加密狗License授权文件
默认安装的服务没有授权文件，无法启动。
受官方认可的加密狗获取方式只有一条通道--由致远客户经理提请，向致远商务申请的标准Licence！
从致远商务申请，有效的加密授权有五种：
- 通卡：这是一个USB硬件狗，插到电脑上就可以用，最大登录限制是5并发，默认拥有所有插件的使用权限（但无Office控件权限）。需要向商务申请，并且交付押金。
- 正式硬加密狗：这也是一个USB硬件狗，里面有正式用户的授权，没有使用期限，插到服务器上就可以用。其功效跟下面正式软加密一模一样，唯一区别是它是一个USB Key，现在这种狗使用量较少，大多数用户采用正式软加密。
- 正式软加密：这是一个加密文件，里面有正式用户的授权，没有使用期限，将文件拷贝到客户服务器上激活后即可使用。我们的正式用户大多采用此方式。
- 试用软加密：这是一个加密文件，功能跟正式软加密一样，只是里面有使用期限限制（一般3个月左右），过期之后无法启动服务。
- Seeyonconfig共享加密：机制是多个测试环境可以共享主服务的加密授权，只是最大登录限制是5并发，详情见下面“共享加密”章节说明。
至于通过别的渠道获取的.js、.jar类型的所谓的“通狗”都不是正规加密授权（有的只是研发内部专用授权），致远也不受理这类授权环境的支持工单。
6）放置软加密文件
正式硬加密狗、正式软加密、试用软加密在申请下来之后都需要联网激活，激活工具在安装程序SeeyonInstall下面的updateDog文件夹里。
注册完成之后，将生成的软加密文件放置在本地协同服务器A8\base\license目录下。
7）启动本地服务
运行A8\ApacheJetspeed\bin\startup.bat进行启动，启动需要一定时间(大约5~10分钟），当出现“startup.Catalina.start Server startup in xxxxxx ms”字样则表示启动成功。如果你很长一段时间都没反应，可能是跟快速编辑模式有关，尝试取消快速编辑模式，再重新启动startup.bat。
8）浏览器访问V5系统，确认是否可以使用
启动本地环境完成之后，本机使用浏览器访问：http://localhost/seeyon ,进入登录页则表示启动成功。
9）登录系统，进行组织机构初始化
关于默认登录帐号，不同版本有不同的情况：
- （大约）V7.1SP3之前的系列版本，安装完成之后，默认预制了group-admin和system帐号，默认密码是123456
- （大约）V8.0~V8.0SP2系列版本，在安装过程中就会让你输入集团管理group-admin和系统管理员system的密码（这一切都为了安全考虑）
- V8.1版本开始，又有了新的预制变化：系统废弃了group-admin和system帐号，改为了一号多权（三员角色化模式），初始安装的时候只需要设置一个初始化管理员帐号即可
三员角色化：即公司的IT人员有自己的个人帐号，可以让自己的个人帐号绑定集团管理员和系统管理员，随后只需使用一个个人帐号即可快速切换到不同平台去做管理。
如果你按照前面规则安装V5服务，并且在安装过程中已经输入了对应帐号密码，则可以执行登录操作。首先使用集团管理员帐号，依次建岗位、职务级别、单位名称、单位管理员帐号。再登录自己创建的单位管理员帐号，进行本单位的部门、人员录入。
# 卸载操作
卸载协同的命令工具在：A8\Uninstall_A8\uninstall.bat，Windows下需要以管理员身份运行，并且注册表信息需要存在。如果你手动删除过注册表，则直接删除整个协同目录即可。
删除过程中如果遇无法卸载提示，则需要先卸载S1服务。S1服务在\A8\S1目录下找到nssm_uninstall.bat、uninstall_s1_agent_link.bat这类带unistall的执行文件，以管理员身份运行并执行卸载。如果运行无反应，则考虑直接将整个S1文件夹删除掉。
# 安装多版本
默认情况下，一台电脑只能安装一个版本，执行安装过程中会先读取注册表信息，如果注册表存在版本信息，安装程序会自动进入升级或修复安装，不会创建多版本。
注册表位置在：cmd命令->regedit->打开注册表->计算机\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SEEYON\A8
如果你想要安装多版本，则可以删除上面注册表的信息，随后就可以多版本共存了！
如果打不开注册表，可以用命令的形式删除，首先以管理员身份启动cmd窗口，然后在cmd中执行reg delete HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SEEYON /f也可以删除
