第2章 安装部署

2.1版本说明

请参考下表了解您所获取的版本。以 V5.2.02 为例

压缩包名称 版本类型 说明
SaCaDataViz V5.2.02 部署版20190211.zip 部署版 部署版只是一个应用,需要自己安装jre、Web容器、数据库,使用场景是生产环境正式部署。
SaCaDataViz V5.2.02 快速体验版20190211.zip 快速体验版 快速体验版可以一键启动,内置了jre、tomcat、db,使用场景是 “体验、试用”
SaCaDataViz V5.2.02 Report集成部署版20190211.zip Report集成部署版 在部署版基础上,集成了Unieap Report服务
SaCaDataViz V5.2.02 Report集成快速体验版20190211.zip Report集成快速体验版 在快速体验版基础上,集成了Unieap Report服务

【注意】 您获取的版本中不包含License,请联系我司商务人员申请。

如果您获取的是 “ 快速体验版 ”,按如下步骤启动即可,无需阅读后续内容

1.拷贝版本到Windows主机并解压
2.双击run.bat启动
3.打开浏览器,在网址栏中输入 http://127.0.0.1:8082/dataviz/src/index.html
4.输入账号、密码登录(内置管理员账户:admin/aaa123,演示账号:demo/1)

2.2部署版环境说明

服务器硬件环境要求:

硬件名称 硬件配置描述
内存 最小可用内存:4GB 推荐:8GB或更大内存
处理器 最低:2核2.0 GHz 推荐:4核2.5GHz或性能更好的处理器
硬盘 最小可用空间:10GB 推荐:100GB或更大可用空间。
网卡 千兆网卡以上

服务器软件环境要求:

软件名称 软件描述 备注
操作系统 Windows / Linux 推荐使用Windows Server版或Linux企业版
JAVA JDK1.8 及以上
WEB容器 Apache Tomcat 8.0及以上或支持Servlet2.5及以上的web容器
支撑数据库 MySQL5.7/Oracle10g/SQL Server2008 及以上 可扩展适配其他数据库,如DB2、达梦、Gbase

客户端软件环境要求:

软件名称 软件描述 备注
浏览器 Chrome,FireFox,IE11以上 推荐使用Chrome

2.3开始部署

整个部署安装包分为五个部分:

  1. dataviz-web:前端前web页面的展现部分.
  2. dataviz-service:后端提供接口服务的部分.
  3. dataviz-file:系统需要使用的资源文件.
  4. 数据库脚本:初始化数据库和升级数据库的脚本文件.
  5. 示例项目.zip : 样例项目,用于演示的DEMO,图册的模板功能也依赖于此.

2.3.1初始化支撑库

使用版本提供的数据库脚本初始化SaCa DataViz支撑库。

如果是升级版本请使用数据库升级脚本,否则会造成数据丢失,在升级前建议备份数据库数据。

【提示】
MySql在Linux下默认区分表名大小写,需要取消大小写做如下修改。

1.修改/etc/my.cnf  
2.在[mysqld]下加入一行:lower_case_table_names = 1  
3.重启数据库

2.3.2拷贝文件夹

dataviz-web和dataviz-service两个文件夹拷贝到apache-tomcat的webapps文件夹下。 dataviz-file内存储的是DataViz内置的及运行过程中生成的文件资源。需拷贝到合适的文件系统路径,比如:/opt。

2.3.3修改配置文件

假设本机IP为:10.4.45.236
修改以下配置文件:

2.3.3.1 dataviz-web/common/config.js

把第一行配置设置为

  window.charts_server = “http://10.4.45.236:8080/dataviz-service”

假设端口是8080,按实际情况改。
【说明】如果dataviz-web与dataviz-service部署在同一Web容器下可设置为相对路径,推荐这么做,如下

  window.charts_server = “/dataviz-service”

2.3.3.2 dataviz-service/WEB-INF/conf/datasource.properties

把以下配置分别修改为第一步中的数据库实际的访问地址及用户名和密码,请根据使用的数据库类型替换datasource.properties文件的内容。

假设数据库地址IP:10.4.45.236 数据库名称:dataviz,用户名:root,密码:root 如果是MySQL数据库:

datasource.driverClass=org.mariadb.jdbc.Driver
datasource.jdbcUrl=jdbc:mysql://10.4.45.236:3306/dataviz?characterEncoding=utf8
datasource.user=root
datasource.password=root
datasource.initialSize=2
datasource.maxActive=150
datasource.maxIdle=5
datasource.maxWait=5000
datasource.validationQuery=select 1
hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
hibernate.showSql=false
quartz.delegate=org.quartz.impl.jdbcjobstore.StdJDBCDelegate

如果是Oracle数据库:

datasource.driverClass=oracle.jdbc.driver.OracleDriver
datasource.jdbcUrl=jdbc:oracle:thin:@10.4.45.236:1521:orcl
datasource.user=dataviz
datasource.password=root
datasource.initialSize=2
datasource.maxActive=150
datasource.maxIdle=5
datasource.maxWait=5000
datasource.validationQuery=select 1 from dual
hibernate.dialect=org.hibernate.dialect.OracleDialect
hibernate.showSql=false
quartz.delegate=org.quartz.impl.jdbcjobstore.StdJDBCDelegate

默认提供mysql及oracle的初始化脚本及配置文件,如需使用其他类型数据库作为支撑库,请联系SaCa DataViz团队。

2.3.3.3 dataviz-service/WEB-INF/conf/internalConfig.properties

修改配置

  internal.customLocalFileStoreRoot=D:/dataviz-file

为实际的资源文件夹dataviz-file的绝对路径。路径中的分隔符要使用正斜杠“/”,或者双反斜杠“\\”,不能使用单个反斜杠“\”;

然后再把相同文件下的

  internal.fileServerURL=http://127.0.0.1:8080/dataviz-service/service

修改为:

  internal.fileServerURL=http://10.4.45.236:8080/dataviz-service/service (或相对路径/dataviz-service/service)

再将该文件下与任务调度相关的

  internal.filePdfExportURL=http://127.0.0.1:8080/dataviz-web/src/export.html

修改为:

  internal.filePdfExportURL=http://10.4.45.236:8080/dataviz-web/src/export.html

再将该文件下的

  internal.pdfCookiesSet=[{"name":"JSESSIONID","domain":"localhost","path":"/dataviz-service"}]

修改为:

  internal.pdfCookiesSet=[{"name":"JSESSIONID","domain":"10.4.45.236","path":"/dataviz-service"}]

2.3.3.4 dataviz-service/WEB-INF/conf/schedule/dataviz-schedular.properties

将该文件下的

  org.quartz.jobStore.driverDelegateClass = org.quartz.impl.jdbcjobstore.StdJDBCDelegate

修改为对应支撑库的方言配置,常见的几种方言供参考:

数据库类型 org.quartz.jobStore.driverDelegateClass
mysql org.quartz.impl.jdbcjobstore.StdJDBCDelegate
oracle org.quartz.impl.jdbcjobstore.oracle.OracleDelegate
sqlserver org.quartz.impl.jdbcjobstore.MSSQLDelegate
postgre org.quartz.impl.jdbcjobstore.PostgreSQLDelegate
db2 org.quartz.impl.jdbcjobstore.DB2v8Delegate

2.3.3.5 dataviz-service/WEB-INF/web.xml

修改文件中的防火墙和跨域拦截正则表达式。如果不修改,默认对所有请求都不进行拦截。

<init-param>
    <param-name>otherReferrer</param-name>
    <param-value>.*</param-value>
</init-param>

修改为:

<init-param>
    <param-name>otherReferrer</param-name>
    <param-value>^http://10\.4\.45\.236:\d+/.*$</param-value>
</init-param>

再把

<init-param>
    <param-name>otherOrigin</param-name>
    <param-value>.*</param-value> 
</init-param>

修改为:

<init-param>
    <param-name>otherOrigin</param-name>
    <param-value>^http://10\.4\.45\.236:\d+$</param-value> 
</init-param>

2.3.4 导入License

2.3.4.1 License说明

license分为试用、开发和部署三个版本

类型 说明
试用版 使用期限一个月
开发版 使用期限三个月
部署版 没有期限限制,需要绑定服务器设备

在左侧菜单中,点击系统设置中的许可信息页面可以查看license的详细信息。
example

2.3.4.2 License获取方法

联系与您接洽的商务人员。
或者登陆http://www.idataviz.com/download/ 申请。

2.3.4.3 License使用方法

两种方式:
a) 在线上传( 推荐
管理员 在许可信息页面支持License文件的上传更新,只需点击下方的“浏览”按钮选择新申请的License文件,再点击更新即可,如下图所示:
example
这种方式的好处是不需要重启后台服务,上传成功后页面会显示新的许可信息。

b) 直接覆盖
将申请到的license文件覆盖原dataviz-service/WEB-INF/conf/saca/license/ 目录下的saca.license文件即可。覆盖后需要重启后台服务。

2.3.5 启动服务并访问

启动Tomcat容器,然后在浏览器中输入

http://10.4.45.236:8080/dataviz-web/src/index.html

就可以访问系统了。
deployment/login
内置账号:

账号 密码 角色 备注
admin aaa123 系统管理员 登录后请立即修改密码

2.3.6 导入示例项目

deployment/example
先进入“示例演示”界面,默认该页面为空,单击右上角导入项目按键,选择示例项目.zip文件即可完成导入。

2.4其他配置

2.4.1部署到Linux系统时配置图册导出功能

当部署到Linux操作系统时,为保证图册导出功能正常可用,需要进行以下额外的部署工作。

2.4.1.1 Linux下配置可执行文件权限

修改dataviz-service/WEB-INF/conf/export/linux32(linux64)目录下的pictool文件的可执行权限。
可通过命令行修改:

chmod 755 pictool

也可以直接修改文件的属性:
deployment/3

2.4.1.2 Linux下确认安装freetype和fontconfig这两个包

先验证系统中是否安装了freetype,命令如下:

rpm –qa|grep freetype

如果返回结果中有安装freetype,则不需要安装,否则执行命令进行安装,
举例:

rpm –ivh freetype-2.3.11-6.el6_1.7.x86_64.rpm

然后验证系统中是否安装了fontconfig,命令如下:

rpm –qa|grep fontconfig

如果返回结果中有安装fontconfig,则不需要安装,否则执行命令安装。
举例:

rpm –ivh fontconfig-2.8.0-3.el6.x86_64.rpm

【注意】由于这两个包对其他包有依赖,建议配置好yum源(国内可使用163、阿里云的源,或者使用系统安装盘作为本地源),使用yum install进行安装。

2.4.1.3 Linux下确认安装了GLIBCXX_3.4.9和GLIBC_2.7

尽量使用新版本的linux系统(CentOS6以上,低于此版本的操作系统,需要确认GLIBC版本)。

2.4.1.4 Linux下安装字体(如果Linux中已经安装中文字体,此步骤可省略)

该步骤分为两部分:

  1. 为解决导出带有汉字的图表中汉字不显示问题
    打开windows 下的C:\WINDOWS\Fonts目录,选择所需要的字体文件,复制到linux下的/usr/share/fonts/目录即可。

  2. 为解决导出pdf时汉字不显示的问题
    在{jre}/lib/fonts目录里新建一个fallback文件夹。
    在windows下找名为想要的字体文件(在不同的操作系统中名字可能不一样,中文一般为宋体&新宋体等)
    复制或者链接字体文件到新建的文件夹里面

    【注意】{jre}是指应用服务器运行环境所使用的jre,如果安装了多个jre,需要找到对应运行环境的那个。

2.4.2 内网外网同时访问的配置方法

如果要支持内外网同时访问,服务需要同时支持内网地址和外网地址,前提是把Dataviz的前台后后台部署到同一个Tomcat容器中,这时一部分配置就可以使用相对路径
a) dataviz-web/common/config.js

window.charts_server =“/dataviz-service”

b) dataviz-service/WEB-INF/conf/internalConfig.properties

internal.fileServerURL= /dataviz-service/service

c) 关于PDF导出 V5.3之前的版本,PDF文件导出功能无法内外网同时生效,需二选一。

internal.pdfCookiesSet=[{"name":"JSESSIONID","domain":"{内网或外网的地址IP或域名}","path":"/dataviz-service"}]

V5.3以后的版本需做如下配置 dataviz-web/common/innerConfig.js

修改window.export_server为后台可访问的前端地址,例如:
window.export_server = "http://localhost:8080/dataviz-web";

dataviz-service/WEB-INF/conf/internalConfig.properties

internal.pdfCookiesSet=[{"name":"JSESSIONID","domain":"{后台可访问的前端页面地址的IP,通常是localhost}","path":"/dataviz-service"}]

c) dataviz-service/WEB-INF/web.xml
修改文件中的防火墙和跨域拦截正则表达式。如果不修改,默认对所有请求都不进行拦截。(假设外网地址为:120.36.103.26)

<init-param>
    <param-name>otherReferrer</param-name>
    <param-value>.*</param-value>
</init-param>

修改为:

<init-param>
    <param-name>otherReferrer</param-name>  
    <param-value>  
        ^http://10\.4\.45\.236:\d+/.*$|^http://120\.36\.103\.26:\d+/.*$
    </param-value>
</init-param>

再把

<init-param>
    <param-name>otherOrigin</param-name>
    <param-value>.*</param-value> 
</init-param>

修改为:

<init-param>
    <param-name>otherOrigin</param-name>
    <param-value>
        ^http://10\.4\.45\.236$|^http://120\.36\.103\.26$
    </param-value> 
</init-param>

results matching ""

    No results matching ""

    results matching ""

      No results matching ""