第一章 概述

本手册主要介绍SaCa DataViz 在部署到应用服务器上的所需要的环境及步骤,通过阅读本手册,您将了解如下内容:
1.部署SaCa DataViz所需要的环境;
2.如何部署SaCa DataViz。

第二章 部署

2.1部署前提条件

服务器硬件环境要求:

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

服务器软件环境要求:

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

客户端软件环境要求:

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

2.2部署步骤

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

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

    假设本机IP为:10.4.45.236

2.2.1初始化支撑库

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

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

2.2.2拷贝文件夹

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

2.2.3修改配置文件

然后修改以下配置文件:

a) 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”

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

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

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

datasource.driverClass=com.mysql.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团队。
c) 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

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

  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"}]

d) dataviz-service/WEB-INF/conf/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

e) 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$</param-value> 
</init-param>

2.2.4 导入License

1.3.3.1 License说明

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

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

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

example

2.2.4.2 License获取方法

请联系与您接洽的商务人员。

2.2.4.3 License使用方法

两种方式:
a) 在线上传(推荐

管理员在许可信息页面支持License文件的上传更新,只需点击下方的“浏览”按钮选择新申请的License文件,再点击更新即可,如下图所示:

example

这种方式的好处是不需要重启后台服务,上传成功后页面会显示新的许可信息。

b) 直接覆盖

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

2.2.5 启动服务并访问

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

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

就可以访问系统了。

deployment/login

内置两个账号:

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

2.2.6 导入示例项目

deployment/example

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

2.3 其他配置

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

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

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

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

chmod 777 pictool

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

deployment/guichmod

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

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

rpm –qa|grepfreetype

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

rpm –ivhfreetype-2.3.11-6.el6_1.7.x86_64.rpm

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

rpm –qa|grepfontconfig

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

rpm –ivhfontconfig-2.8.0-3.el6.x86_64.rpm

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

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

较老版本的linux系统,比如CentOS5,这两个库的版本可能不够高。所以请尽量使用新版本的linux系统,例如CentOS6以上是没有问题的。

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

该步骤分为两部分:

  1. 为解决导出带有汉字的图表中汉字不显示问题
    打开windows 下的C:\WINDOWS\Fonts目录,选择所需要的字体文件,复制到linux下的/usr/share/fonts/目录即可。
  2. 为解决导出pdf时汉字不显示的问题
    在{jre}\lib\font目录里新建一个fallback文件夹。 在windows下找名为想要的字体文件(在不同的操作系统中名字可能不一样,中文一般为宋体&新宋体等)
    复制或者链接字体文件到新建的文件夹里面

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

2.3.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
internal.pdfCookiesSet=[{"name":"JSESSIONID","domain":null,"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 ""