# OCIP部署手册
# 版本说明
手册示例为OCIP4.0版本，支持版本如下：G6V7.1/N4.0/V7.1SP1/V8.0/V8.0SP1/N5.0/N5.0SP1/V8.1/N8.1/V8.1SP1单、多组织以及 A8 V8.1/N8.1/V8.1SP1企业版、集团版的数据交换，其他版本需要单独开发适配，不支持历史版本升级。
# 名词术语
接入系统：需要接入平台的系统，例如当前使用的 OA 服务或者外部系统。
OCIP代理：又称ServerAgent，每个接入系统对应一个代理服务，对平台标准协议的实现，封装平台的基础功能，提供给其他业务系统与平台对接，降低业务系统接入难度。
OCIP平台：又称ServerNode，多个接入系统通过代理服务接入到OCIP平台，组成 OCIP服务。
# 部署示意图
# 环境说明
# 数据库部署
# mysql数据库部署
1.请参考：https://open.seeyoncloud.com/v5doc/142/1184/176.html
2.mysql数据库要求：字符集UTF-8,不区分大小写，数据引擎innodb。
# 信创据库
1.部署请参考对应厂商提供的部署文档。
2.达梦数据库要求：
自动提交：DDL_AUTO_COMMIT= 1
关键字过滤:EXCLUDE_RESERVED_WORDS=SECTION,section,TYPE,type,CONTEXT,context,REFERENCE,reference,LINK,link
修改 PK_WITH_CLUSTER 参数 如下：PK_WITH_CLUSTER = 0;
# OCIP平台服务安装
chmod -R 777 安装包路径 #给安装包下所有文件赋予可执行权限
sh SeeyonServerNodeInstall.sh #执行安装程序
选择安装路径
进入数据库连接信息页面，配置好数据库名称、地址、端口、用户名和口令
# ocip代理平台部署
sh SeeyonServerAgentInstall.sh #执行代理安装脚本
其他过程和ocip平台一样。
# 平台服务器参数配置及授权
# 参数配置
打开配置工具路径 OCIP 平台服务根目录 \tomcat-ocip\conf 下，双击运行 ConfigStart.cmd（在 Linux 系统下则运行：同路径下的 ConfigStart.sh）。 图中HTTP端口8080即为访问端口。
数据库配置和参数配置请按需调整，通讯网络设置中为服务端口49500和通信端口4900，远程ip端口为映射到外网的地址和端口，请按需填写
# 加密狗授权
加密狗维护-本地安装-导入授权
# 代理服务配置
打开配置工具路径， OCIP 代理服务根目录 ServerAgent\tomcat-ocip\conf 下，双击运行ConfigStart.cmd（在 Linux 系统下则运行：ConfigStart.sh）。 http端口为访问端口。
# 启动和访问服务
# 平台服务启动和访问
进入OCIP平台主目录的 ServerNode\tomcat-ocip\bin 下， Windows 点击 startup.bat（Linux 下点击 startup.sh）启动 tomcat，启动后的命令窗口不可关闭。
通过http://地址:端口 访问，默认平台账号syocip密码admin，默认系统管理员账号system密码admin。
# 代理服务启动和访问
进入 OCIP 代理服务主目录的 ServerAgent\tomcat-ocip\bin 下， Windows 点击 startup.bat（Linux 下点击 startup.sh）启动 tomcat，启动后的命令窗口不可关闭。
通过http://地址:端口 访问，默认管理员账号administrator密码123456。
# 接入系统OA配置
OA接入OCIP平台需要配置相关的参数信息，Windows下运行OA\ApacheJetspeed\conf\SeeyonConfig.cmd（Linux 下运行 SeeyonConfig.sh）启动配置工具：
开启webservice
# ocip代理配置
登录ocip代理访问页面，系统设置，录入配置信息，系统名称随便填写，下一步
此处填写接入系统的配置信息:
访问类型：支持选择 HTTP 和 HTTPS 协议。
网络地址：OA系统的IP及端口。注意没有 http://之类的前缀。
接口路径：系统默认值，用于标识 OA 的 WebService 接口路径，无需单独修改。
授权用户：WebService 接口路径访问用户，如果未开启 OA 端的 WebService 加密可不填写（即查看 OA 图形化配置界面【插件参数设置】 -【 webservice.password】是否配置密码）。默认用户名为 service-admin。
授权密码：同授权用户，WebService 接口路径访问密码，值与 OA 图形化配置界面【插件参数设置】 -【 webservice.password】保持一致即可。
开启V5token 验证：如果对应接入系统（ OA）为 V8.1/ V8.1SP1 及更高版本时，则此开关需要开启；如果接入系统为历史版本（比如 V7.1 版本等）则此开关要关闭。
单点登录路径：系统默认值，用于标识 OA 的单点登录路径，无需单独修改。
平台参数：
平台地址：平台的外网地址
平台端口：映射到外网的平台的访问端口，默认就是8080
发现端口：映射到外网的平台的服务端口，默认就是49500
代理参数：
注册地址：代理服务的外网地址和访问端口，端口默认为8080
通讯地址：默认即可
通讯端口：映射到外网的通讯端口，端口默认为49000
地址映射：代理服务的外网地址和通讯端口
接入系统：填写协同的地址和端口
配置完成后，保存配置，点平台管理-点注册-输入平台管理员的密码-注册成功后-点击启动。
# 启动顺序
服务启动顺序：OCIP平台(ServerNode) -> OCIP 代理（ServerAgent）-> 接入系统（OA） 说明：OCIP代理启动时会检测OCIP平台服务，若OCIP平台未启动，OCIP代理无法正常启动；接入系统首次启动时通过代理连接自动获取资源认证码，所以需要代理启动后,并配置好接入平台，且平台状态为“运行中”，再启动接入系统。
快速跳转
