# 协同驾驶舱高级版安装手册
# 修订记录
修订时间 修订内容
2024年11月5日 初稿
# 部署要求
# 适用版本
协同驾驶舱高级版适用于致远协同办公管理软件（A6+、A8+、A8-N、G6、G6-N）V7.1SP1、V8.0、V8.0SP2LTS、V8.1、V8.1SP2、V8.2、V8.2SP1、V9.0、V9.0SP1版本。如果您的OA不在支持版本之列，请联系研发评估。
如果您的OA版本是V9.0SP1 20240731及其以下版本，需要在OA打补丁包，补丁包中包含sql脚本和class文件，先执行sql脚本，再打补丁包，然后重启OA。补丁包获取方式：
链接：https://pan.baidu.com/s/1em8hMWhkjHDP63up6fgW9A
提取码: r3af
网盘具体路径：协同驾驶舱高级版--->9.0以下版本兼容补丁包（如下图）
{width="5.772222222222222in"
height="1.818513779527559in"}
# 功能概述
协同驾驶舱高级版是一款为企业提供全面数据分析和决策支持的系统。通过直观的可视化界面，管理者可以实时监控企业运营的关键指标，并进行深入的数据分析。本手册将指导您完成协同驾驶舱高级版的安装和试用过程。
数据流向：协同驾驶舱高级版从OA抽取数据，放到数据仓库PostgreSQL中，经过ETL，配置成报告，在OA中授权，用户查看。
数据安全：无论在那个入口查看报告，均有权限校验。既校验角色，也校验数据行权限。
灾备：参考"日常运维-数据备份"，目前仅支持手动备份。
高可用：暂不支持集群模式。
# 环境要求（协同驾驶舱高级版服务器）
支持协同驾驶舱高级版和OA部署在同一台服务器上，但是不建议这样做。无论怎么部署，都需要满足下面的"网络互通要求"。
协同驾驶舱高级版支持HTTPS协议，如果OA是配置了域名和HTTPS证书，协同驾驶舱高级版要与之保持一致。协同驾驶舱高级版配置HTTPS证书，需要配合安装Ngnix，具体操作参考"安装部署步骤--->7、HTTPS配置（可选）"
在开始安装协同驾驶舱高级版之前，请确保您的系统满足以下要求：
# 浏览器版本要求：
推荐使用浏览器：Chrome 100+,Safari 13+,Ms Edge 100+,Firefox 100+
# 配套数据库要求：
安装使用协同驾驶舱高级版，必须配套PostgreSQL使用，PostgreSQL的作用是当作数据仓库。建议PostgreSQL11.22及其以上版本。安装手册参考《PostgreSQL安装手册》
# 服务器要求：
# Windows 系统要求：
Windows（仅支持64位）
系统：Windows7 或更高版本
JDK：JDK1.8（Oracle）
CPU：Intel Core i3-4代 或更快的处理器
内存：8G或以上
# 磁盘：至少5G可用空间
# Mac 系统要求：
Mac（64位）
系统：MacOS10 或更高版本
JDK：JDK1.8（Oracle）
CPU：Intel Core i3-4代 或更快的处理器
内存：8G或以上
# 磁盘：至少5G可用空间
# Linux 系统要求：
Linux
系统：Centos、RedHat 等常见 Linux 版本系统
JDK：JDK1.8（32位：Oracle；64位：Oracle、IBM J9）
CPU：Intel Core i3-4代 或更快的处理器
内存：8G或以上
# 磁盘：至少5G可用空间
备注：
（1）除上述列出的操作系统对应JDK外，也支持部分 openjdk，例如亚马逊、adopt 等。在安装前需确认当前操作系统的 CPU 及对应 JDK 版本、厂商，JDK 版本必须为 1.8 及以上，可去对应厂商处下载 JDK 版本安装部署，否则将无法正确安装。
（2）关于信创环境，协同驾驶舱高级版支持在东方通中部署；协同驾驶舱高级版和PostgreSQL支持麒麟、统信等国产化操作系统部署。OA支持的操作系统，协同驾驶舱高级版均支持。
协同驾驶舱高级版，如果要集成OA，需要访问OA的数据库，目前支持的数据库类型：MySQL、Oracle、SQL server、PostgreSQL、南大通用、人大金仓、达梦。 除此以外的均不支持。
# 阶梯资源要求（协同驾驶舱高级版服务器）
# 在线200以下用户
+------------+-----+--------------------------------------------------+ | 类别 | * | 具体参数 | | | *配 | | | | 置 | | | | ** | | +------------+-----+--------------------------------------------------+ | 应用服务器 | 硬 | CPU:2.3GHz以上，64位，三级缓存10M以上，8核以上 | | | 件 | | | | | 硬盘:SCSI/SAS硬盘，32GG以上 | | | | | | | | 内存:16G以上 | +------------+-----+--------------------------------------------------+ | Po | RAM | CPU:2.3GHz以上，64位，三级缓存10M以上，8核以上 | | stgreSQL数 | | | | 据库服务器 | | 硬盘:SCSI/SAS硬盘，32GG以上 | | | | | | | | 内存:8G以上 | +------------+-----+--------------------------------------------------+ | 网络 | 硬 | 局域网接入带宽>1Gbps | | | 件 | | | | | 数据中心网络和客户访问网络推荐分开 | +------------+-----+--------------------------------------------------+ | 操作系统 | OS | Windows Server 2008 | | | | Enterp | | | | riseEdition及以上，不建议Windows7旗舰版、Windows | | | | 10专业版等非Server 系列 | | | | | | | | Red Hat Enterprise edition 6.5及以上 | | | | | | | | SUSE Linux Enterprise 12及上 | +------------+-----+--------------------------------------------------+
# 在线200-500用户
+------------+-----+--------------------------------------------------+ | 类别 | * | 具体参数 | | | *配 | | | | 置 | | | | ** | | +------------+-----+--------------------------------------------------+ | 应用服务器 | 硬 | CPU:2.3GHz以上，64位，三级缓存10M以上，8核以上 | | | 件 | | | | | 硬盘:SCSI/SAS硬盘，32GG以上，建议做镜像 | | | | | | | | 内存:32G以上 | +------------+-----+--------------------------------------------------+ | Po | RAM | CPU:2.3GHz以上，64位，三级缓存10M以上，8核以上 | | stgreSQL数 | | | | 据库服务器 | | 硬盘:SCSI/SAS硬盘，32GG以上，建议做镜像 | | | | | | | | 内存:16G以上 | +------------+-----+--------------------------------------------------+ | 网络 | 硬 | 局域网接入带宽>1Gbps | | | 件 | | | | | 数据中心网络和客户访问网络推荐分开 | +------------+-----+--------------------------------------------------+ | 操作系统 | OS | Windows Server 2008 | | | | Enterp | | | | riseEdition及以上，不建议Windows7旗舰版、Windows | | | | 10专业版等非Server 系列 | | | | | | | | Red Hat Enterprise edition 6.5及以上 | | | | | | | | SUSE Linux Enterprise 12及上 | +------------+-----+--------------------------------------------------+
说明：
在线500以上用户，需要集群环境，目前暂不支持集群，请联系研发。
如果协同驾驶舱高级版和PostgreSQL数据库部署在一起，服务器内存要求是两个内存要求之和。
# 网络互通要求（协同驾驶舱高级版服务器）
# 不集成OA需要实现如下网络要求：
- 协同驾驶舱高级版需要访问PostgreSQL数据库
{width="4.6875in"
height="3.8541666666666665in"}
# 集成OA需要实现如下网络要求：
1、协同驾驶舱高级版服务器需要访问PostgreSQL数据库
协同驾驶舱高级版服务器需要访问OA的服务器
协同驾驶舱高级版服务器需要访问OA数据库
OA的服务器需要访问协同驾驶舱高级版服务器
{width="5.772222222222222in"
height="4.100267935258093in"}
# 协同驾驶舱高级版安装包获取
链接：https://pan.baidu.com/s/1em8hMWhkjHDP63up6fgW9A
提取码: r3af
网盘具体路径：协同驾驶舱高级版--->安装程序
Windows_x86环境选择：seeyon-dataPluse-windows.zip
Linux_x86环境选择：seeyon-dataPluse-linux.zip
Linux_arm环境选择：seeyon-dataPluse-linux.zip，解压后jdk换成ARM版本的jdk。
{width="5.772222222222222in"
height="2.0398075240594924in"}
# 注册授权步骤
使用协同驾驶舱高级版，需要申请永洪license。请对应的商务发授权申请单即可。申请单模板名称："客户产品申请单"，永洪license是一串英文字符串。如下图：
{width="5.772222222222222in"
height="3.2063451443569555in"}
如果要集成OA，需要找商务申请购买"协同驾驶舱高级版-运行平台"加密狗插件（插件id是bi-datamanager-platform）。目前只需要这一个插件，不再需要分析云插件。
# 安装部署步骤
备注：
（1）协同驾驶舱高级版 Windows、Linux操作系统安装步骤一样，安装的时候选取对应的安装包解压即可。
（2）如果遇到问题，请优先从常见问题中查找答案。
（3）安装使用协同驾驶舱高级版之前，必须准备一台可用的PostgreSQL数据库，PostgreSQL的作用是当作数据仓库。建议PostgreSQL11.22及其以上版本。安装手册参考《PostgreSQL安装手册》。
# 1、解压安装包（必须）
协同驾驶舱高级版安装包是绿色安装包，下载之后直接解压即可。解压后，打开看目录下是否有"校验中文文件夹解压是否乱码"目录，如果有，说明解压正常，如果没有，说明解压乱码，请更换解压缩工具解压安装包。
推荐使用：360压缩、好压、Bandizip。强烈不建议使用Windows自带的解压缩工具。
# 2、修改web.xml文件（必须）
修改DataPulse\webapps\report\WEB-INF\web.xml文件，
将"E:\yhBI-report\data-pulse-resource\DataPulse\webapps\yhome\bihome" 中的
"E:\yhBI-report\data-pulse-resource\" 改为安装包的目录地址。（注：此web.xml文件有两处需要修改）。参考下图：
第一处：
{width="5.768055555555556in"
height="3.6357884951881014in"}
第二处：
{width="5.768055555555556in"
height="2.264448818897638in"}
# 3、配置授权（必须）
# 永洪Licenses配置
永洪License有两种激活方式：
方式一：修改DataPulse\webapps\yhome\bihome\bi.properties 里的licenes值，如下图：
{width="5.754166666666666in"
height="0.8791666666666667in"}
方式二：启动之后访问http://127.0.0.1:8058/report/Viewer 输入license进行激活，如下图：
{width="5.772222222222222in"
height="3.0915791776027994in"}
# OA加密狗插件更新（如果不集成OA，非必须）
找商务申请"协同驾驶舱高级版-运行平台"插件，如果您的OA版本是V9.0SP1 20240731及其以下版本，需要打补丁包。然后使用UpdateDog程序更新加密狗，将加密文件放到OA服务器，与ApacheJetspeed同级目录base/license/下面。
# 4、启动程序（必须）
上面修改完配置之后，可以启动协同驾驶舱高级版程序。
Windows环境下启动方式：在DataPulse\bin 下右键使用系统管理员启动startup.bat。
{width="5.772222222222222in"
height="3.449443350831146in"}
Linux环境启动方式：cd DataPulse\bin目录下，执行 ./startup.sh 即可启动。
第一次启动由于永洪会初始化很多内容，会有点慢。默认端口8058，可以按需修改，请参考"6、修改默认访问端口（可选）"。
# 5、浏览器访问（必须）
当http://127.0.0.1:8058/report/Viewer 可以正常访问即说明启动成功，如下图：
{width="5.772222222222222in"
height="3.4694280402449693in"}
激活之后访问http://127.0.0.1:8058 进行初始化配置，如下图：
{width="5.772222222222222in"
height="3.2786909448818897in"}
初始化配置参考"初始化配置"。
# 6、修改默认访问端口（可选）
如果想要修改端口，下面几个文件必须要同步修改（如果不修改端口则不需要操作下面的1）、2）、3）、4)）：
# （1）修改tomcat的端口
如下图，修改DataPulse\conf\server.xml文件
{width="5.758333333333334in"
height="2.236111111111111in"}
# （2）修改单点登录地址和端口
如下图，修改DataPulse\webapps\yhome\bihome目录下的bi.properties单点登录地址和端口需改为协同驾驶舱高级版的访问地址和端口号
{width="5.767361111111111in"
height="2.088888888888889in"}
# （3）修改永洪交互端口
DataPulse\webapps\report\WEB-INF\classes下的config.properties里面所有的地址和端口号都改为协同驾驶舱高级版访问地址和端口
{width="5.761111111111111in"
height="1.8729166666666666in"}
# （4）修改协同驾驶舱高级版认证地址和端口
修改DataPulse\webapps\data-pulse\WEB-INF\classes下的application-dev.yml也需要修改地址和端口
{width="5.763194444444444in"
height="0.8208333333333333in"}
# 7、HTTPS配置（可选）
协同驾驶舱高级版支持HTTPS协议，如果OA是配置了域名和HTTPS证书，协同驾驶舱高级版要与之保持一致。协同驾驶舱高级版配置HTTPS证书，需要配合安装Ngnix。
Nginx安装配置：
（1）下载Ngnix包，并上传到服务器，解压
（2）Ngnix配置SSL证书
（3）修改nginx.conf
备注：
（1）"/bi"是待转换的来源目录，"/"转换的目标目录，请根据实际情况修改。
（2）需要行内防火墙开通对应的80和443端口
（3）server 192.168.4.5:8058;是协同驾驶舱高级版服务器IP和端口
（4）修改tomcat配置文件
配置 tomcat 支持 sameSite 属性：
修改配置文件 conf/context.xml
<CookieProcessor sameSiteCookies="none" />
{width="5.772222222222222in"
height="2.1720559930008747in"}
（5）启动Nginx
Windows 环境：鼠标双击nginx.exe
Linux环境：./nginx.sh
# 跨域问题配置（可选）
如果OA和协同驾驶舱高级版不在同一台服务器上，在栏目上配置协同驾驶舱高级版报表，有跨域问题，需要使用Nginx。在OA所在服务器上安装Nginx，Nginx转发到协同驾驶舱高级版服务器上。Nginx配置参考"HTTPS配置"，可以根据需求，选择是否安装SSL证书。
# 初始化配置
# 1、基础信息配置
"登录密码"为管理员admin的登录密码
{width="5.768055555555556in"
height="3.6708333333333334in"}
# 2、数据仓库配置
此处配置上面安装的postgresql数据库，自动创建数据库作为数仓。
{width="5.768055555555556in"
height="2.752083333333333in"}
# 3、协同数据库配置
此处配置oa的数据库
{width="5.7625in"
height="4.233333333333333in"}
# 4、协同地址配置
# 9.0以下版本
如下图，访问V5接口密码在 【系统管理员】->【信息集成配置】->【协同驾驶舱高级版BI连接】中生成
{width="5.7652777777777775in"
height="2.7534722222222223in"}
# 9.0以上版本配置
参考下图，【系统管理员】->【信息集成配置】->【协同驾驶舱连接】
内网地址：要配置协同驾驶舱高级版的IP和端口。点击"保存"按钮，生成应用ID和密钥，信道id填写上面生成的应用ID，信道Secret 填写上面的密钥。
{width="5.753472222222222in"
height="2.529166666666667in"}
{width="5.768055555555556in"
height="2.2736111111111112in"}
协同驾驶舱高级版页面配置：
{width="5.763888888888889in"
height="3.1743055555555557in"}
问题：什么情况下配置外网IP，什么情况下配置域名？
# 5、配置完成后登录
配置成功之后，跳转到登录页，用户名：admin，密码是第一步设置的密码，如下图：
{width="5.772222222222222in"
height="3.4745002187226595in"}
登录成功后页面：
{width="5.772222222222222in"
height="3.4856835083114612in"}
# 协同驾驶舱高级版，新建用户默认密码设置
{width="5.772222222222222in"
height="2.6125317147856517in"}
# 日常运维
# 检查服务状态
Widows环境：启动的黑窗口存在，并且访问正常，说明服务正常。
Linux环境：执行命令：ps -ef|grep java 查看Java进程
# 启动服务
Widows环境：DataPulse\bin\startup.bat
Linux环境：DataPulse\bin\startup.sh
# 停止服务
Widows环境：DataPulse\bin\shutdown.bat
Linux环境：DataPulse\bin\shutdown.bat
# 重启服务
先停止服务，然后启动服务。
# 卸载服务
直接删除应用包即可，绿色安装，没有写注册表。
# 更新服务
先备份如下文件及文件夹：
然后将升级包覆盖，最后重启即可。
# 重装服务
先备份，然后直接删除应用包，按照手册重新安装配置。
# 数据备份
协同驾驶舱高级版，目前还不支持高可用和集群模式，建议定期手动备份以下数据：
1、协同驾驶舱高级版内置数据库数据，将文件拷贝，放到其它磁盘或者服务器上。
- 数据仓库PostgreSQL
报告展示的数据，报告依赖的数据集数据都保存在PostgreSQL中，PostgreSQL备份请参考官方文档备份。
# 常见问题
# 什么情况下需要配置Nginx？
（1）OA是HTTPS协议，集成协同驾驶舱高级版，必须使用Nginx。
（2）OA和协同驾驶舱高级版没有部署在同一台服务器上，OA需要在栏目中配置协同驾驶舱高级版报表，必须使用Nginx。
# 2、查看报表报错："获取报表类型失败"
原因：在永洪改过名称或者移动过位置，如果改过需要重新绑一下。
# 3、系统管理员缺少配置协同驾驶舱菜单
原因：没有购买"协同驾驶舱高级版插件"
# 4、报表管理缺少协同驾驶舱菜单
原因：
如果是9.0SP1-20240731以下的版本，OA需要打补丁包，找研发要补丁包。
如果已经打补丁包，排查是否购买"协同驾驶舱高级版插件"。
# 5、登录提示：系统时间不正确，请确认您的系统时间是准确的，请联系管理员！
原因：修改了系统时间。
解决办法：DataPulse\webapps\yhome\bihome\bi.properties中的如下三个配置文件删除后重启服务即可。
{width="5.772222222222222in"
height="2.007996500437445in"}
# 6、缺少"协调分析（BI）管理员"角色
原因：
1、如果是9.0SP1-20240731以下的版本，OA需要打补丁包，找研发要补丁包。
- 如果A8企业版或者G6-N多组织等非A8集团版用户，需要打解除分析云和角色绑定补丁包。
# 7、启动提示：VM option 'UseG1GC' is experimental and must be enabled via -XX:+UnlockE
解决办法：修改配置文件：DataPulse\bin\catalina_custom.sh，删掉 -XX:+UseG1GC -XX:MaxGCPauseMillis=1000
{width="5.772222222222222in"
height="0.7235487751531059in"}
# 8、oa查看绑定的报表报错："No permission to view!"
原因：（1）oa和数脉网络不通；（2）查询oa的数据库不通。
# 9、OA低于9.0版本（8.2SP1、8.2等等），如果OA没有打低版本补丁包，插件无效。
{width="5.772222222222222in"
height="3.303244750656168in"}
补丁包获取方式：
{width="5.772222222222222in"
height="1.635787401574803in"}
# 结语
协同驾驶舱高级版为企业提供了一个强大的数据分析和决策支持平台。通过本手册，您已经了解了系统的安装和试用过程。希望您能够充分利用系统的功能，提升企业的管理效率和决策水平。
如果您在使用过程中遇到任何问题，欢迎联系我们的技术支持团队，我们将竭诚为您服务。
← 外部链接穿透
