申请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系统相关信息的数据库。
| ||
| 数据库集群 | 当前数据库是否是集群。默认为“否”。 | |
驱动程序存放目录 | 驱动程序存放目录分为“产品内置”和“自定义”。默认为“产品内置”。 驱动包使用的优先级逻辑如下： |
1）不选驱动程序存放目录/驱动程序存放目录选择“产品内置”：系统自动从“产品内置”去寻找驱动。
2）驱动程序存放目录选择“自定义”，没指定“自定义目录”：系统默认先去“自定义”寻找驱动，找不到再去“产品内置”寻找驱动。
3）驱动程序存放目录选择“自定义”，并指定“自定义目录”：系统默认先去“自定义目录”寻找驱动，找不到再去“自定义”寻找驱动，再找不到再去“产品内置”寻找驱动。
1）选择“产品内置”：系统自动从“产品内置”去寻找驱动。 2）驱动程序存放目录选择“自定义”，必须选择指定驱动存放的目录。系统默认先去“自定义目录”寻找驱动，找不到再去“自定义”寻找驱动，再找不到再去“产品内置”寻找驱动。 其中，各目录路径如下：
| |
| 服务器地址 | 知识库所在的服务器地址，包括端口号。 |
| 最大连接数 |
| 知识库最大连接数。 | |
| 获取连接等待时间（秒） | 当连接池满时，连接需要等待再次连接的时间。 默认值为“－1”，表示无限等待。 |
| 初始化连接数 |
| 默认知识库连接数。 | |||
| 数据库名 | 知识库的名称。 | ||
| 用户名和密码 | 访问知识库的用户和密码。密码支持加密保存。 | ||
| 连接配置 | 根据当前数据库类型配置相关的连接属性，适用于需要通过jdbc代码设置的连接属性，格式如：key=value 示例：设置对oracle的超时检测
| ||
| 校验方式 | 在连接知识库时进行校验。可选“获取连接时测试”和“返还时关闭连接”，一般默认即可。 | ||
初始化知识库语言 | 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。
|
| 登录验证类 | 自定义的第三方登录验证类。 |
| ad.propertirs文件存放位置 | AD域登录验证。 |
| 同步通知类(多个时用分号分隔) | 是指当Smartbi新建（修改、删除）组、用户、角色及相关的操作的时候，通知第三方系统做相关的同步操作。 |
| 第三方用户同步类 | 配置实现的类，可以实现将第三方系统的用户同步到Smartbi中。 配置后在用户管理界面会出现“用户同步”按钮。 |
| 显示修改个人密码的入口 | 是否在Smartbi中提供修改个人密码的入口。 |
8、服务器日志
服务器日志文件是用于存放系统运行的过程信息，常用于错误排查、问题跟踪等。
各设置项说明如下：
| 设置项 | 说明 |
|---|---|
| 日志文件存放位置 | 日志文件可自由指定存放在服务器的某个位置上，建议与服务器部署域存放在一块。 |
全局日志级别 Smartbi日志级别 | 总共有四个级别“TRACE、INFO、DEBUG、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，通过 自动检测 按钮，系统按当前服务器的内存进行分配。
15、令牌登录
用约定的密钥去加密用户信息形成token
| 配置项 | 说明 |
|---|---|
| 密钥 | 用来解密token信息。客户端需要用密钥来进行加密用户信息。当密钥没有设置或为空字符串时，表示不支持令牌登录这种方式。密钥最小长度是8，当密钥大于8位时，实际上也只有前8位有效； |
| 令牌超时时间 | token有效时间。当【服务器解析请求时间戳 - token的生成的时间戳 > 超时设置 】成立时，则代表token已超时，不能进行登录； |
| 需要校验密码 | 设置token中是否要包含密码，使用密码来进行登录。
|
详情请参考 令牌登录功能说明
