申请License

运行 Smartbi 之前，您必须申请License以获得产品的许可验证。

请与销售人员联系获取License文件。

系统配置说明

在安装部署完Smartbi后，需要进行一些初始配置。具体步骤如下：

1、config登陆

1)服务器成功部署后，启动应用服务器。

2)登录到 Smartbi 配置管理页面，地址为 http://IP:PORT/smartbi/vision/config.jsp 。

通常系统部署后首次访问，会自动跳转到上述页面。

如果是首次访问，需要设置“管理员账号、密码”，以便下次登录配置界面时验证，防止他人篡改知识库信息。

这里设置的用户仅用于管理系统配置界面，与Smartbi系统登录用户无关。

如果是再次启动配置，提示输入系统配置管理员的用户名和密码，即您第一次登录时设置的用户名和密码。

2、系统配置页面

3、配置文件

“配置文件 Smartbi-config.xml存放位置”：smartbi-config.xml是Smartbi的配置文件，用于存储知识库连接、服务器日志属性、授权文件路径等信息，在系统配置完毕自动生成。

该文件可自由指定存放在服务器的某个位置上，但是设置存放路径时，路径中不要包括空格。

4、知识库设置

知识库指的是用于存储Smartbi系统相关信息的数据库。

各设置项说明如下：

设置项

说明

数据库类型

选择数据库。关于支持的数据库类型，详情请参考 系统环境要求。

使用集群部署的MySQL时，需勾选“MySQL ndb”。

驱动程序存放目录

驱动程序存放目录分为“产品内置”和“自定义”。默认为“产品内置”。

驱动包使用的优先级逻辑如下：

1)选择“产品内置”：系统自动从“产品内置”去寻找驱动。

2)驱动程序存放目录选择“自定义”，必须选择指定驱动存放的目录。系统默认先去“自定义目录”寻找驱动，找不到再去“自定义”寻找驱动，再找不到再去“产品内置”寻找驱动。

其中，各目录路径如下：

产品内置：【Smartbi\Tomcat\webapps\Smartbi\WEB-INF\lib】

自定义\自定义目录：【Smartbi\Tomcat\bin\dynamicLibraryPath】

服务器地址

知识库所在的服务器地址，包括端口号。

最大连接数

知识库最大连接数。

初始化连接数

默认知识库连接数。

数据库名

知识库的名称。

用户名和密码

访问知识库的用户和密码。密码支持加密保存。

校验方式

在连接知识库时进行校验。可选“获取连接时测试”和“返还时关闭连接”，一般默认即可。

初始化知识库语言

Smartbi支持英文、简体中文和繁体中文显示系统中的菜单、节点等。

此设置项生效的前提是所连接的知识库是一个空库，配置完重新启动后会自动创建系统表，生成对应的语言系统。

编码

作为知识库的数据库必须与此项编码一致。支持“UTF-8”和“GBK”。

版本信息

该项显示Smartbi升级类版本信息。

设置完信息后，点击页面右下角的 测试知识库连接，可验证知识库是否能正确连通。

如果连接失败，请点击对话框右下角的 详细信息 按钮，其中会有明确的错误原因说明。

5、产品授权

关于我们产品的授权，我们提供本地license授权验证，或者使用License Sever进行授权验证。二者任选一个即可。

使用本地license授权验证方式，需要保证部署smartbi的服务器的ip地址和MAC地址都是固定不变的。

使用License Sever授权验证方式，一般用于Smartbi部署在K8S环境，或者部署了多个节点的Smartbi，通过License Server方便License管理。

部署License Server的服务器必须是有固定的IP地址和MAC地址。

方式一：本地Licnese授权验证

默认选项是文件路径模式，点击浏览选择License的存储路径。点击选择，选中license文件，然后点击上传按钮，上传license到Smartbi服务器。

正常登录Smartbi之前，必须拥有产品许可验证。请将“申请License”中获得的License文件上传至服务器。各个设置项含义说明如下：

文件路径：license文件在服务器的实际存储路径。服务器启动时从该位置读取license文件。

服务器：需要配置license server。建议在部署多个Smartbi节点时使用。

方式二：License Server授权验证

1、获取License Server安装包

2、部署配置Smartbi License Server。

1)下载SmartbiLicenseServer.tar.gz，复制到需要服务器上，并解压。

2)修改StartLicenseServer.sh中的java路径，后执行StartLicenseServer.sh，启动。

如：执行  nohup ./StartLicenseServer.sh 来启动。

说明：License Server默认使用8700端口。

3)在浏览器中输入http://IP:8700/ 登录Smartbi License Server。

4)第一次登录需要配置密码。

5)上传Smartbi-License.xml。

3、为Smartbi指定License Server。

1) 参考相关文档部署Smartbi。

2)部署好后，登录config界面。

3)配置Smartbi License为“服务器”模式，并输入Smartbi License Server地址。

如：http://localhost:8700/

配置好后，重启Smartbi。

6、会话缓存

会话缓存是用于配置系统无状态的缓存服务器地址。默认为空表示不启用。缓存服务器部署方式参考部署Smartbi-Redis

7、用户管理

用户管理是用于配置与用户集成相关的二次开发内容。

各设置项说明如下：

设置项

说明

显示操作权限管理界面

是否在Smartbi中显示操作权限管理界面，系统默认是非开发模式。

如果要进行二次开发并自定义操作权限，请选择“是”。

加密类型

分为MD5、DES、CLASS。

MD5：系统默认使用的加密方式。

DES：系统提供的可选加密方式。

CLASS：选择这个加密方式后，登录验证类生效。

登录验证类

自定义的第三方登录验证类。

ad.propertirs文件存放位置

AD域登录验证。

同步通知类(多个时用分号分隔)

是指当Smartbi新建(修改、删除)组、用户、角色及相关的操作的时候，通知第三方系统做相关的同步操作。

第三方用户同步类

配置实现的类，可以实现将第三方系统的用户同步到Smartbi中。

配置后在用户管理界面会出现“用户同步”按钮。

显示修改个人密码的入口

是否在Smartbi中提供修改个人密码的入口。

8、服务器日志

服务器日志文件是用于存放系统运行的过程信息，常用于错误排查、问题跟踪等。

各设置项说明如下：

设置项

说明

日志文件存放位置

日志文件可自由指定存放在服务器的某个位置上，建议与服务器部署域存放在一块。

全局日志级别

Smartbi日志级别

总共有四个级别“TRACE、INFO、DEBUG、WARN、ERROR”，

TRACE：追踪日志。会生成非常多的日志，一般不使用。

DEBUG：调试级别，一般是在产品测试和调试时使用。

INFO：用来反馈系统的当前状态给最终用户查看，一般在产品发布后使用。

WARN：警告信息，表示系统存在一些还没有被发现或者修改的小问题，但不会影响系统正常运行。

ERROR：错误信息，系统运行中出现错误，可能会影响系统运行。

不同级别输出的日志信息等级不同，“全局日志级别”默认为“INFO”；“Smartbi日志级别”默认为“DEBUG”。

日志文件大小

限制单个日志文件的大小，以防文件过大不易打开，一般为1024KB=1MB。

日志文件个数

限制允许生成的日志文件个数，以防文件太多占用系统硬盘控件，一般设置10个。

将java.util.logging重定向到log4j

将第三方代码中调用java.util.logger中打印日志的信息，重定向到log4j，即同时打印到Smartbi的日志中。

9、其他信息

其他相关设置。

各设置项说明如下：

设置项

说明

信息对话框默认标题

信息对话框上的标题显示的文字。

是否显示子菜单样式的选项

在门户定制页面的页面信息中是否显示子菜单样式的选项。默认为否，即不显示。

10、扩展包

扩展包是指基于 Smartbi 系统做的功能增强插件，例如项目定制化功能。

各设置项说明如下：

设置项

说明

扩展包存放路径

指扩展包在服务器上的存放路径。

上传扩展包文件

点击 选择 按钮，选择扩展包文件之后，选择 上传 按钮完成上传。

11、对象池

此两个设置项一般不需要设置。

12、业务驱动

动态驱动类是指JAVA动态类，它包含数据库驱动相关的jar包。

1、将jar包添加到指定路径下，不需要重启服务器，即可使用jar包。

2、系统中jar包查找顺序：

1)优先查找Smartbi的lib目录中的jar包。

2)其次查找JAVA动态类存放路径中的jar包。

3)最后查找扩展包中的jar包。

针对数据库驱动，由于按照上面顺序只要找到对应的驱动类就不会再往下查找，故无法覆盖Smartbi已有驱动类。

13、集群配置

集群配置是为了在资源创建、更新、删除时，通知所有集群内的Smartbi服务器同步缓存，防止仍然使用缓存中已经过期的内容(报表定义、数据缓存等)。

单节点服务器：单机部署，不设置集群

集群服务器：配置集群信息

集群服务器配置：

系统支持“自动” 和“手动”两种集群配置方式：

自动：表示通过组播协议自动维护当前子网内的Smartbi集群，当每启动或停止一个节点都会正常的维护集群之间的通讯列表。

手动：在禁止了组播的网络或Smartbi服务器不处于同一子网内时，只能手工指定集群内所有服务器的通讯列表。

服务器配置的说明如下：

配置项

说明

当前服务器地址

系统默认“自动检测”为设置项。

建议全部手动选择当前服务器的IP地址。

自动

分组地址

必须为组播地址224.0.1.0～238.255.255.255。

端口

组播端口。

手动

服务器地址列表

指定除自身之外的网络群体中其他提供同步的主机列表，逗号分隔多个服务器。格式为：hostname:RMI注册通讯端口。

端口

配置RMI宿主主机请求端口。该端口必须与“服务器地址列表”中端口保持一致。

远程访问端口

配置节点远程访问通讯端口，即remoteObjectPort属性端口。

通常不需要配置，在服务器间的防火墙只开放固定端口时需要指定。

若需要配置该端口，在端口“40001”未占用的前提下，建议配置端口号为“40001”。

备用端口监听增值：默认会在1024–49151之间随机生成端口。

配置示例：

集群节点一：192.168.137.110:8080

集群节点二：192.168.137.111:8080

配置集群步骤：

① 登陆集群节点一，在config页面进行集群配置，参考下图：

如果防火墙限制需要指定端口，需要配置端口监听增值。如下图，设置备用监听端口增值为100，会在节点一实际生成端口：40100，40101

端口(40000)+备用监听端口增值(100)=40100

远程访问端口(40001)+备用监听端口增值(100)=40101

② 登陆集群节点二，在config页面进行集群配置，参考下图：

如下图，设置备用监听端口增值为100，会在节点二实际生成端口：40100，40101

端口(40000)+备用监听端口增值(100)=40100

远程访问端口(40001)+备用监听端口增值(100)=40101

配置完成后，保存并重启Smartbi服务即可。

访问smartbi 系统监控页面，缓存，如下图所示：

如果服务器关闭防火墙，则无需设置远程访问端口和备用监听端口增值；

如果服务器开启防火墙，则需要开放smartbi集群内部通信端口：40000，40001，40100，40101。

集群节点中配置集群方式(手动或自动)必须相同。

14、缓存

内存对象数据默认值为10000，通过 自动检测 按钮，系统按当前服务器的内存进行分配。